类 javax.naming.NamingException 的使用 (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

javax.naming 中 NamingException 的使用

 

javax.naming 中 NamingException 的子类
class	AuthenticationException           当访问命名或目录服务发生身份验证错误时，抛出此异常。
class	AuthenticationNotSupportedException           当所请求身份验证的特定 flavor 不受支持时，抛出此异常。
class	CannotProceedException           抛出此异常指示操作到达了名称中的某一点，在该点上操作无法继续进行。
class	CommunicationException           当客户端无法与目录或命名服务通信时，抛出此异常。
class	ConfigurationException           当存在配置问题时，抛出此异常。
class	ContextNotEmptyException           当试图销毁一个不为空的上下文时，抛出此异常。
class	InsufficientResourcesException           当无法使用资源完成所请求的操作时，抛出此异常。
class	InterruptedNamingException           当正被调用的命名操作已经被中断时，抛出此异常。
class	InvalidNameException           此异常指示被指定的名称不符合命名系统的命名语法。
class	LimitExceededException           当某一方法因为用户或系统指定的限制而异常终止时，抛出此异常。
class	LinkException           此异常用于描述解析链接时遇到的问题。
class	LinkLoopException           当检测到的某个循环试图解析某一链接，或者已达到某一特定于实现的链接计数限制时，抛出此异常。
class	MalformedLinkException           如果在解析或构造链接时遇到错误链接，则抛出此异常。
class	NameAlreadyBoundException           一些方法抛出此异常来指示因为名称已经绑定到另一个对象而无法添加某一绑定。
class	NameNotFoundException           当名称的组件由于没有被绑定而无法解析时，抛出此异常。
class	NamingSecurityException           此异常是 Context 和 DirContext 接口中的操作所抛出的与安全有关的异常的超类。
class	NoInitialContextException           当不能创建任何初始上下文实现时，抛出此异常。
class	NoPermissionException           当试图执行某一操作，而客户端没有执行该操作的权限时，抛出此异常。
class	NotContextException           当命名操作进行到需要上下文来继续该操作的某处，而解析的对象不是一个上下文时，抛出此异常。
class	OperationNotSupportedException           当上下文实现不支持将调用的操作时，抛出此异常。
class	PartialResultException           抛出此异常指示结果正在返回或者到目前为止只返回了部分结果，并且操作无法完成。
class	ReferralException           此抽象类用于表示一个反向链接 (referral) 异常，该异常是在响应某一反向链接（比如 LDAP v3 服务器返回的反向链接）时生成的。
class	ServiceUnavailableException           当试图与目录或命名服务通信，而该服务不可用时，抛出此异常。
class	SizeLimitExceededException           当某一方法生成的结果超出与大小有关的限制时，抛出此异常。
class	TimeLimitExceededException           当某一方法没有在指定的时间限制内终止时，抛出此异常。

 

抛出 NamingException 的 javax.naming 中的方法
Object	Context.addToEnvironment(String propName, Object propVal)           将一个新环境属性添加到此上下文的环境中。
Object	InitialContext.addToEnvironment(String propName, Object propVal)
void	Context.bind(Name name, Object obj)           将名称绑定到对象。
void	InitialContext.bind(Name name, Object obj)
void	Context.bind(String name, Object obj)           将名称绑定到对象。
void	InitialContext.bind(String name, Object obj)
void	Context.close()           关闭此上下文。
void	NamingEnumeration.close()           关闭此枚举。
void	InitialContext.close()
Name	Context.composeName(Name name, Name prefix)           将此上下文的名称与相对于此上下文的名称组合。
Name	InitialContext.composeName(Name name, Name prefix)           将此上下文的名称与相对于此上下文的名称组合。
String	Context.composeName(String name, String prefix)           将此上下文的名称与相对于此上下文的名称组合。
String	InitialContext.composeName(String name, String prefix)           将此上下文的名称与相对于此上下文的名称组合。
Context	Context.createSubcontext(Name name)           创建并绑定一个新上下文。
Context	InitialContext.createSubcontext(Name name)
Context	Context.createSubcontext(String name)           创建并绑定一个新上下文。
Context	InitialContext.createSubcontext(String name)
void	Context.destroySubcontext(Name name)           销毁指定上下文，并将它从名称空间中移除。
void	InitialContext.destroySubcontext(Name name)
void	Context.destroySubcontext(String name)           销毁指定上下文，并将它从名称空间中移除。
void	InitialContext.destroySubcontext(String name)
protected  Context	InitialContext.getDefaultInitCtx()           通过调用 NamingManager.getInitialContext() 检索初始上下文，并将它缓存在 defaultInitCtx 中。
Hashtable<?,?>	Context.getEnvironment()           检索对此上下文有效的环境。
Hashtable<?,?>	InitialContext.getEnvironment()
String	LinkRef.getLinkName()           检索此链接的名称。
String	Context.getNameInNamespace()           在此上下文自己的名称空间中检索其完全名称。
String	InitialContext.getNameInNamespace()
NameParser	Context.getNameParser(Name name)           检索与指定上下文关联的解析器。
NameParser	InitialContext.getNameParser(Name name)
NameParser	Context.getNameParser(String name)           检索与指定上下文关联的解析器。
NameParser	InitialContext.getNameParser(String name)
Reference	Referenceable.getReference()           检索此对象的 Reference。
abstract  Context	ReferralException.getReferralContext()           检索继续该方法的上下文。
abstract  Context	ReferralException.getReferralContext(Hashtable<?,?> env)           使用环境属性检索继续该方法的上下文。
protected  Context	InitialContext.getURLOrDefaultInitCtx(Name name)           检索用来解析 name 的上下文。
protected  Context	InitialContext.getURLOrDefaultInitCtx(String name)           检索用来解析字符串名称 name 的上下文。
boolean	NamingEnumeration.hasMore()           确定枚举中是否还有元素。
protected  void	InitialContext.init(Hashtable<?,?> environment)           使用所提供的环境初始化初始上下文。
NamingEnumeration<NameClassPair>	Context.list(Name name)           枚举绑定在指定上下文中的名称，以及绑定到这些名称的对象的类名称。
NamingEnumeration<NameClassPair>	InitialContext.list(Name name)
NamingEnumeration<NameClassPair>	Context.list(String name)           枚举绑定在指定上下文中的名称，以及绑定到这些名称的对象的类名称。
NamingEnumeration<NameClassPair>	InitialContext.list(String name)
NamingEnumeration<Binding>	Context.listBindings(Name name)           枚举绑定在指定上下文中的名称，以及绑定到这些名称的对象。
NamingEnumeration<Binding>	InitialContext.listBindings(Name name)
NamingEnumeration<Binding>	Context.listBindings(String name)           枚举绑定在指定上下文中的名称，以及绑定到这些名称的对象。
NamingEnumeration<Binding>	InitialContext.listBindings(String name)
Object	Context.lookup(Name name)           检索指定的对象。
Object	InitialContext.lookup(Name name)
Object	Context.lookup(String name)           检索指定的对象。
Object	InitialContext.lookup(String name)
Object	Context.lookupLink(Name name)           按照除名称的最终原子组件以外的链接检索指定对象。
Object	InitialContext.lookupLink(Name name)
Object	Context.lookupLink(String name)           按照除名称的最终原子组件以外的链接检索指定对象。
Object	InitialContext.lookupLink(String name)
T	NamingEnumeration.next()           检索枚举中的下一个元素。
Name	NameParser.parse(String name)           将某一名称解析成其组件。
void	Context.rebind(Name name, Object obj)           将名称绑定到对象，重写任何现有绑定。
void	InitialContext.rebind(Name name, Object obj)
void	Context.rebind(String name, Object obj)           将名称绑定到对象，重写所有现有绑定。
void	InitialContext.rebind(String name, Object obj)
Object	Context.removeFromEnvironment(String propName)           从此上下文的环境中移除一个环境属性。
Object	InitialContext.removeFromEnvironment(String propName)
void	Context.rename(Name oldName, Name newName)           将一个新名称绑定到已经被绑定到某一旧名称的对象上，并取消对旧名称的绑定。
void	InitialContext.rename(Name oldName, Name newName)
void	Context.rename(String oldName, String newName)           将一个新名称绑定到已经被绑定到某一旧名称的对象上，并取消对旧名称的绑定。
void	InitialContext.rename(String oldName, String newName)
void	Context.unbind(Name name)           取消对指定对象的绑定。
void	InitialContext.unbind(Name name)
void	Context.unbind(String name)           取消对指定对象的绑定。
void	InitialContext.unbind(String name)

 

抛出 NamingException 的 javax.naming 中的构造方法
InitialContext()           构造一个初始上下文。
InitialContext(boolean lazy)           构造一个具有不进行初始化的选项的初始上下文。
InitialContext(Hashtable<?,?> environment)           使用所提供的环境构造一个初始上下文。

 

javax.naming.directory 中 NamingException 的使用

 

javax.naming.directory 中 NamingException 的子类
class	AttributeInUseException           当操作试图添加已经存在的属性时抛出此异常。
class	AttributeModificationException           当试图添加、移除或修改与属性的（模式）定义或属性的状态有冲突的属性、属性标识符或属性值时抛出此异常。
class	InvalidAttributeIdentifierException           在试图用无效的属性标识符创建属性时，抛出此异常。
class	InvalidAttributesException           在尝试添加或修改不完全或不正确地指定的属性集时，抛出此异常。
class	InvalidAttributeValueException           在尝试添加一个与属性的模式定义有冲突的属性时，抛出此类。
class	InvalidSearchControlsException           在为搜索操作指定的 SearchControls 无效时，抛出此异常。
class	InvalidSearchFilterException           当指定的搜索过滤器无效时，抛出此异常。
class	NoSuchAttributeException           尝试访问不存在的属性时，抛出此异常。
class	SchemaViolationException           当方法在某些方面违反模式时，抛出此异常。

 

抛出 NamingException 的 javax.naming.directory 中的方法
void	InitialDirContext.bind(Name name, Object obj, Attributes attrs)
void	DirContext.bind(Name name, Object obj, Attributes attrs)           将名称与关联的属性一起绑定到一个对象。
void	InitialDirContext.bind(String name, Object obj, Attributes attrs)
void	DirContext.bind(String name, Object obj, Attributes attrs)           将名称与关联的属性一起绑定到一个对象。
DirContext	InitialDirContext.createSubcontext(Name name, Attributes attrs)
DirContext	DirContext.createSubcontext(Name name, Attributes attrs)           创建并绑定新的上下文及关联的属性。
DirContext	InitialDirContext.createSubcontext(String name, Attributes attrs)
DirContext	DirContext.createSubcontext(String name, Attributes attrs)           创建并绑定新的上下文及关联的属性。
Object	BasicAttribute.get()           检索此属性的其中一个值。
Object	Attribute.get()           检索此属性的其中一个值。
Object	BasicAttribute.get(int ix)
Object	Attribute.get(int ix)           从属性值的有序列表中检索属性值。
NamingEnumeration<?>	BasicAttribute.getAll()           检索此属性值的枚举。
NamingEnumeration<?>	Attribute.getAll()           检索属性值的枚举。
DirContext	BasicAttribute.getAttributeDefinition()           检索此属性的模式定义。
DirContext	Attribute.getAttributeDefinition()           检索属性的模式定义。
Attributes	InitialDirContext.getAttributes(Name name)
Attributes	DirContext.getAttributes(Name name)           检索与命名对象关联的所有属性。
Attributes	InitialDirContext.getAttributes(Name name, String[] attrIds)
Attributes	DirContext.getAttributes(Name name, String[] attrIds)           检索与命名对象关联的选定属性。
Attributes	InitialDirContext.getAttributes(String name)
Attributes	DirContext.getAttributes(String name)           检索所有与命名对象关联的属性。
Attributes	InitialDirContext.getAttributes(String name, String[] attrIds)
Attributes	DirContext.getAttributes(String name, String[] attrIds)           检索与命名对象关联的选定属性。
DirContext	BasicAttribute.getAttributeSyntaxDefinition()           检索与此属性关联的语法定义。
DirContext	Attribute.getAttributeSyntaxDefinition()           检索与属性关联的语法定义。
DirContext	InitialDirContext.getSchema(Name name)
DirContext	DirContext.getSchema(Name name)           检索与命名对象关联的模式。
DirContext	InitialDirContext.getSchema(String name)
DirContext	DirContext.getSchema(String name)           检索与命名对象关联的模式。
DirContext	InitialDirContext.getSchemaClassDefinition(Name name)
DirContext	DirContext.getSchemaClassDefinition(Name name)           检索包含命名对象类定义的模式对象的上下文。
DirContext	InitialDirContext.getSchemaClassDefinition(String name)
DirContext	DirContext.getSchemaClassDefinition(String name)           检索包含命名对象类定义的模式对象的上下文。
void	InitialDirContext.modifyAttributes(Name name, int mod_op, Attributes attrs)
void	DirContext.modifyAttributes(Name name, int mod_op, Attributes attrs)           修改与命名对象关联的属性。
void	InitialDirContext.modifyAttributes(Name name, ModificationItem[] mods)
void	DirContext.modifyAttributes(Name name, ModificationItem[] mods)           使用有序的修改列表修改与命名对象关联的属性。
void	InitialDirContext.modifyAttributes(String name, int mod_op, Attributes attrs)
void	DirContext.modifyAttributes(String name, int mod_op, Attributes attrs)           修改与命名对象关联的属性。
void	InitialDirContext.modifyAttributes(String name, ModificationItem[] mods)
void	DirContext.modifyAttributes(String name, ModificationItem[] mods)           使用有序的修改列表修改与命名对象关联的属性。
void	InitialDirContext.rebind(Name name, Object obj, Attributes attrs)
void	DirContext.rebind(Name name, Object obj, Attributes attrs)           将名称与关联的属性一起绑定到一个对象，并重写任何现有绑定。
void	InitialDirContext.rebind(String name, Object obj, Attributes attrs)
void	DirContext.rebind(String name, Object obj, Attributes attrs)           将名称与关联的属性一起绑定到一个对象，并重写任何现有绑定。
NamingEnumeration<SearchResult>	InitialDirContext.search(Name name, Attributes matchingAttributes)
NamingEnumeration<SearchResult>	DirContext.search(Name name, Attributes matchingAttributes)           在单个上下文中搜索包含指定属性集的对象。
NamingEnumeration<SearchResult>	InitialDirContext.search(Name name, Attributes matchingAttributes, String[] attributesToReturn)
NamingEnumeration<SearchResult>	DirContext.search(Name name, Attributes matchingAttributes, String[] attributesToReturn)           在单个上下文中搜索包含指定属性集的对象，并检索选定的属性。
NamingEnumeration<SearchResult>	InitialDirContext.search(Name name, String filterExpr, Object[] filterArgs, SearchControls cons)
NamingEnumeration<SearchResult>	DirContext.search(Name name, String filterExpr, Object[] filterArgs, SearchControls cons)           在命名上下文或对象中搜索符合给定搜索过滤器的项。
NamingEnumeration<SearchResult>	InitialDirContext.search(Name name, String filter, SearchControls cons)
NamingEnumeration<SearchResult>	DirContext.search(Name name, String filter, SearchControls cons)           在命名上下文或对象中搜索符合给定搜索过滤器的项。
NamingEnumeration<SearchResult>	InitialDirContext.search(String name, Attributes matchingAttributes)
NamingEnumeration<SearchResult>	DirContext.search(String name, Attributes matchingAttributes)           在单个上下文中搜索包含指定属性集的对象。
NamingEnumeration<SearchResult>	InitialDirContext.search(String name, Attributes matchingAttributes, String[] attributesToReturn)
NamingEnumeration<SearchResult>	DirContext.search(String name, Attributes matchingAttributes, String[] attributesToReturn)           在单个上下文中搜索包含指定属性集的对象，并检索选定的属性。
NamingEnumeration<SearchResult>	InitialDirContext.search(String name, String filterExpr, Object[] filterArgs, SearchControls cons)
NamingEnumeration<SearchResult>	DirContext.search(String name, String filterExpr, Object[] filterArgs, SearchControls cons)           在命名上下文或对象中搜索符合给定搜索过滤器的项。
NamingEnumeration<SearchResult>	InitialDirContext.search(String name, String filter, SearchControls cons)
NamingEnumeration<SearchResult>	DirContext.search(String name, String filter, SearchControls cons)           在命名上下文或对象中搜索符合给定搜索过滤器的项。

 

抛出 NamingException 的 javax.naming.directory 中的构造方法
InitialDirContext()           构造一个初始 DirContext。
InitialDirContext(boolean lazy)           构造一个具有不进行初始化的选项的初始 DirContext。
InitialDirContext(Hashtable<?,?> environment)           使用所提供的环境构造一个初始 DirContext。

 

javax.naming.event 中 NamingException 的使用

 

返回 NamingException 的 javax.naming.event 中的方法
NamingException	NamingExceptionEvent.getException()           检索抛出的异常。

 

抛出 NamingException 的 javax.naming.event 中的方法
void	EventContext.addNamingListener(Name target, int scope, NamingListener l)           添加接收命名事件的侦听器，这些事件在目标和范围所标识的对象发生更改时触发。
void	EventDirContext.addNamingListener(Name target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l)           添加接收命名事件的侦听器，这些事件在修改由 target 指定的对象上的搜索过滤器 filter 和过滤器参数标识的对象时触发。
void	EventDirContext.addNamingListener(Name target, String filter, SearchControls ctls, NamingListener l)           添加接收命名事件的侦听器，这些事件在修改由 target 指定的对象上的搜索过滤器 filter 标识的对象时触发。
void	EventContext.addNamingListener(String target, int scope, NamingListener l)           添加接收命名事件的侦听器，这些事件在目标名称和范围指定的对象发生更改时触发。
void	EventDirContext.addNamingListener(String target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l)           添加接收命名事件的侦听器，这些事件在修改由字符串目标名称指定的对象上的搜索过滤器 filter 和过滤器参数标识的对象时触发。
void	EventDirContext.addNamingListener(String target, String filter, SearchControls ctls, NamingListener l)           添加接收命名事件的侦听器，这些事件在修改由字符串目标名称指定的对象上的搜索过滤器 filter 标识的对象时触发。
void	EventContext.removeNamingListener(NamingListener l)           从此 EventContext 触发的接收命名事件中移除一个侦听器。
boolean	EventContext.targetMustExist()           确定侦听器是否可以注册不存在的感兴趣目标。

 

参数类型为 NamingException 的 javax.naming.event 中的构造方法
NamingExceptionEvent(EventContext source, NamingException exc)           使用在抛出过 NamingException 的上下文和抛出的异常构造一个 NamingExceptionEvent 的实例。

 

javax.naming.ldap 中 NamingException 的使用

 

javax.naming.ldap 中 NamingException 的子类
class	LdapReferralException           此抽象类用于表示 LDAP 反向链接 (referral) 异常。

 

返回 NamingException 的 javax.naming.ldap 中的方法
NamingException	UnsolicitedNotification.getException()           检索使用服务器发送的信息构造的异常。
NamingException	SortResponseControl.getException()           检索适合结果代码的 NamingException。

 

抛出 NamingException 的 javax.naming.ldap 中的方法
ExtendedResponse	StartTlsRequest.createExtendedResponse(String id, byte[] berValue, int offset, int length)           创建与 LDAP StartTLS 扩展请求相对应的扩展响应对象。
ExtendedResponse	ExtendedRequest.createExtendedResponse(String id, byte[] berValue, int offset, int length)           创建与此请求对应的响应对象。
ExtendedResponse	LdapContext.extendedOperation(ExtendedRequest request)           执行扩展操作。
ExtendedResponse	InitialLdapContext.extendedOperation(ExtendedRequest request)
Control[]	LdapContext.getConnectControls()           检索对此上下文有效的连接请求控件。
Control[]	InitialLdapContext.getConnectControls()
abstract  Control	ControlFactory.getControlInstance(Control ctl)           使用此控件工厂创建控件。
static Control	ControlFactory.getControlInstance(Control ctl, Context ctx, Hashtable<?,?> env)           使用已知控件工厂创建控件。
Control[]	HasControls.getControls()           从实现此接口的对象中检索 Control 数组。
abstract  Context	LdapReferralException.getReferralContext()           使用上下文的环境（但不使用控件）检索继续该方法的上下文。
abstract  Context	LdapReferralException.getReferralContext(Hashtable<?,?> env)           使用环境属性（但不使用控件）检索继续该方法的上下文。
abstract  Context	LdapReferralException.getReferralContext(Hashtable<?,?> env, Control[] reqCtls)           使用请求控件和环境属性检索继续该方法的上下文。
Control[]	LdapContext.getRequestControls()           检索对此上下文有效的请求控件。
Control[]	InitialLdapContext.getRequestControls()
Control[]	LdapContext.getResponseControls()           检索对此上下文调用的最后一个方法所生成的响应控件。
Control[]	InitialLdapContext.getResponseControls()
LdapContext	LdapContext.newInstance(Control[] requestControls)           创建此上下文的新实例，使用请求控件进行初始化。
LdapContext	InitialLdapContext.newInstance(Control[] reqCtls)
void	LdapContext.reconnect(Control[] connCtls)           使用提供的控件和此上下文的环境重新连接到 LDAP 服务器。
void	InitialLdapContext.reconnect(Control[] connCtls)
void	LdapContext.setRequestControls(Control[] requestControls)           为在此上下文上后续调用的方法设置请求控件。
void	InitialLdapContext.setRequestControls(Control[] requestControls)

 

抛出 NamingException 的 javax.naming.ldap 中的构造方法
InitialLdapContext()           不使用任何环境属性或连接请求控件构造初始上下文。
InitialLdapContext(Hashtable<?,?> environment, Control[] connCtls)           使用环境属性或连接请求控件构造初始上下文。

 

javax.naming.spi 中 NamingException 的使用

 

抛出 NamingException 的 javax.naming.spi 中的方法
InitialContextFactory	InitialContextFactoryBuilder.createInitialContextFactory(Hashtable<?,?> environment)           使用指定环境创建一个初始上下文工厂。
ObjectFactory	ObjectFactoryBuilder.createObjectFactory(Object obj, Hashtable<?,?> environment)           使用所提供的环境创建一个新对象工厂。
static Context	NamingManager.getContinuationContext(CannotProceedException cpe)           创建一个将继续上下文操作的上下文。
static DirContext	DirectoryManager.getContinuationDirContext(CannotProceedException cpe)           创建一个将继续某个 DirContext 操作的上下文。
static Context	NamingManager.getInitialContext(Hashtable<?,?> env)           使用指定环境属性创建一个初始上下文工厂。
Context	InitialContextFactory.getInitialContext(Hashtable<?,?> environment)           创建一个初始上下文，以便开始进行名称解析。
Object	StateFactory.getStateToBind(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment)           检索用于绑定的对象状态。
static Object	NamingManager.getStateToBind(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment)           检索用于绑定的对象的状态。
static DirStateFactory.Result	DirectoryManager.getStateToBind(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment, Attributes attrs)           在给定初始对象及其属性时，检索用于绑定的对象的状态。
DirStateFactory.Result	DirStateFactory.getStateToBind(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment, Attributes inAttrs)           在给定要传输的对象和属性的情况下检索用于绑定的对象的状态。
static Context	NamingManager.getURLContext(String scheme, Hashtable<?,?> environment)           为给定的 URL 方案 id 创建一个上下文。
ResolveResult	Resolver.resolveToClass(Name name, Class<? extends Context> contextType)           部分解析某一名称。
ResolveResult	Resolver.resolveToClass(String name, Class<? extends Context> contextType)           部分解析某一名称。
static void	NamingManager.setInitialContextFactoryBuilder(InitialContextFactoryBuilder builder)           将 InitialContextFactory 生成器设置为生成器。
static void	NamingManager.setObjectFactoryBuilder(ObjectFactoryBuilder builder)           ObjectFactoryBuilder 确定尝试加载对象工厂时使用的策略。

 

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。