compact3

javax.naming.spi

Class DirectoryManager

java.lang.Object

javax.naming.spi.NamingManager

javax.naming.spi.DirectoryManager

public class DirectoryManager
extends NamingManager

这个类包含了支持 DirContext实现方法。

本课程是NamingManager延伸。它包含用于访问对象工厂和状态工厂的服务提供商使用的方法，以及用于获得支持联邦的连续上下文。

DirectoryManager安全的多线程并发访问。

除非另有说明，一个Name，Attributes，或环境参数通过任何方法的调用方拥有。该实现将不会修改对象或保持引用它，虽然它可能会保留一个复制或复制的参考。

从以下版本开始：

一点三

另请参见：

DirObjectFactory， DirStateFactory

Field Summary

Fields inherited from class javax.naming.spi.NamingManager

CPE

方法摘要

Modifier and Type	Method and Description
static DirContext	getContinuationDirContext(CannotProceedException cpe) 创建一个背景，继续 DirContext操作。
static Object	getObjectInstance(Object refInfo, Name name, Context nameCtx, Hashtable<?,?> environment, Attributes attrs) 为指定的对象、属性和环境创建一个对象的实例。
static DirStateFactory.Result	getStateToBind(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment, Attributes attrs) 获取给定对象和它的属性时绑定的对象的状态。

Methods inherited from class javax.naming.spi.NamingManager

getContinuationContext, getInitialContext, getObjectInstance, getStateToBind, getURLContext, hasInitialContextFactoryBuilder, setInitialContextFactoryBuilder, setObjectFactoryBuilder

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细信息

getContinuationDirContext

public static DirContext getContinuationDirContext(CannotProceedException cpe)
                                            throws NamingException

创建一个背景，继续 DirContext操作。就像 NamingManager.getContinuationContext()，只有返回的是一个 DirContext延续文脉。

参数

cpe -非空的异常触发的延续。

结果

继续运行一个非空的 DirContext对象。

异常

如果发生异常 NamingException命名。

另请参见：

NamingManager.getContinuationContext(CannotProceedException)

getObjectInstance

public static Object getObjectInstance(Object refInfo,
                                       Name name,
                                       Context nameCtx,
                                       Hashtable<?,?> environment,
                                       Attributes attrs)
                                throws 异常

为指定的对象、属性和环境创建一个对象的实例。

这种方法是一样的NamingManager.getObjectInstance除了以下差异：

• 它接受与对象相关联的Attributes参数包含属性。的DirObjectFactory可以使用这些属性来保存有看从目录。
• 对象工厂试必须实现ObjectFactory或DirObjectFactory。如果它实现了DirObjectFactory，DirObjectFactory.getObjectInstance()使用，否则，ObjectFactory.getObjectInstance()使用。

服务提供商，实现 DirContext接口应该使用这种方法，不 NamingManager.getObjectInstance()。

参数

refInfo -它创建一个对象可能的空对象。

name -这个物体相对于 nameCtx名称。指定一个名称是可选的；如果是省略， name应为。

nameCtx的上下文相关的 name参数指定。如果为空， name相对于默认初始上下文。

environment -用于对象的工厂和对象的创建可能的空环境。

attrs -与refinfo可能的空属性。这可能不是属性refinfo成套；你可以从目录中读取多个属性。

结果

使用 refInfo和 attrs创建一个对象；或 refInfo如果对象不能由工厂创建。

异常

NamingException -如果在试图得到一个URL命名上下文中遇到的一个例外，如果一个工厂访问抛出一个namingexception。

异常 -如果一个工厂访问抛出一个异常，如果出现了一个错误的同时，加载和实例化的工厂和对象类。如果一个工厂不希望其他工厂尝试创建一个对象，则应该只抛出一个异常。看到 DirObjectFactory.getObjectInstance()。

从以下版本开始：

一点三

另请参见：

NamingManager.getURLContext(java.lang.String, java.util.Hashtable<?, ?>)， DirObjectFactory， DirObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>, javax.naming.directory.Attributes)

getStateToBind

public static DirStateFactory.Result getStateToBind(Object obj,
                                                    Name name,
                                                    Context nameCtx,
                                                    Hashtable<?,?> environment,
                                                    Attributes attrs)
                                             throws NamingException

获取给定对象和它的属性时绑定的对象的状态。

这种方法就像是NamingManager.getStateToBind除了以下差异：

• 它接受包含属性被传递到DirContext.bind()方法Attributes参数。
• 它返回一个非空的DirStateFactory.Result实例包含对象被束缚，并陪绑定属性。无论是对象或属性可能是空的。
• 国家工厂试都必须实现StateFactory或DirStateFactory。如果它实现了DirStateFactory，然后DirStateFactory.getStateToBind()叫；否则，StateFactory.getStateToBind()叫做。

服务提供商，实现 DirContext接口应该使用这种方法，不 NamingManager.getStateToBind()。

看到namingmanager。getstatetobind()用于描述国有工厂受审名单确定。

由该方法返回的对象是调用方所拥有的。该实现将不会随后修改它。它将包含一个新的Attributes对象，同样是由调用方拥有，或参考原始attrs参数。

参数

obj -非空对象，获得国家绑定。

name -此对象的名称相对 nameCtx，或null，如果没有指定名称。

nameCtx的上下文相关的 name参数指定，或null如果 name相对于默认初始上下文。

environment -可能的空环境中使用的创作状态的工厂和对象的状态。

attrs -可能的空属性是要绑定的对象。

结果

一个非空的dirstatefactory。包含对象和属性是必然结果。如果没有国家的工厂返回一个非空的答案，结果将包含对象（ obj）本身的原始属性。

异常

NamingException如果同时使用工厂遇到的是一个命名的例外。如果一个工厂不希望其他工厂尝试创建一个对象，则应该只抛出一个异常。看到 DirStateFactory.getStateToBind()。

从以下版本开始：

一点三

另请参见：

DirStateFactory， DirStateFactory.getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>, javax.naming.directory.Attributes)， NamingManager.getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>)