javax.naming.spi
类 DirectoryManager

java.lang.Object
  javax.naming.spi.NamingManager
      javax.naming.spi.DirectoryManager

public class DirectoryManager
extends NamingManager

此类包含支持 DirContext 实现的方法。

此类是 NamingManager 的一个扩展。它包含一些方法供服务提供者用来访问对象工厂和状态工厂，并用来获得连续上下文以支持联合。

将 DirectoryManager 用于多个线程的并发访问是安全的。

除非另有说明，否则传递给任何方法的 Name、Attributes 或环境参数都归调用者所有。该实现不会修改对象或保持对该对象的引用，尽管可能保持对其副本的引用。

从以下版本开始：

1.3

另请参见：

DirObjectFactory, DirStateFactory

getContinuationDirContext

public static DirContext getContinuationDirContext(CannotProceedException cpe)
                                            throws NamingException

创建一个将继续某个 DirContext 操作的上下文。此方法的运行非常类似于 NamingManager.getContinuationContext()，唯一的不同是它返回的连续上下文是一个 DirContext。

参数：

cpe - 触发此连续的非 null 异常。

返回：

用于继续该操作的非 null DirContext 对象。

抛出：

NamingException - 如果发生命名异常。

另请参见：

NamingManager.getContinuationContext(CannotProceedException)

getObjectInstance

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

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

除以下不同之处外，此方法与 NamingManager.getObjectInstance 相同：

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

实现 DirContext 接口的服务提供者应该使用此方法而不是 NamingManager.getObjectInstance()。

参数：

refInfo - 将为之创建对象的对象（可能为 null）。

name - 此对象的相对于 nameCtx 的名称。指定名称是可选操作；如果忽略名称，则 name 应该为 null。

nameCtx - 一个上下文，name 参数是相对于该上下文指定的。如果为 null，则 name 相对于默认初始上下文。

environment - 将在创建对象和对象工厂时使用的环境（可能为 null）。

attrs - 与 refInfo 关联的属性（可能为 null）。这些属性可能不是用于 refInfo 的完整属性集，可以从目录中读取更多的属性。

返回：

使用 refInfo 和 attrs 创建的对象；如果无法通过工厂创建对象，则返回 refInfo。

抛出：

NamingException - 如果在试图获得 URL 上下文时遇到命名异常，或者受访问的工厂之一抛出 NamingException。

Exception - 如果受访问的工厂之一抛出异常，或者加载和实例化工厂和对象类时遇到错误。工厂只有在不希望试图使用其他工厂创建对象时才抛出异常。请参见 DirObjectFactory.getObjectInstance()。

从以下版本开始：

1.3

另请参见：

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 参数。
• 它返回一个非 null DirStateFactory.Result 实例，该实例包含将被绑定的对象，以及伴随该绑定的属性。该对象和属性都可以为 null。
• 每个所尝试的状态工厂都必须实现 StateFactory 或 DirStateFactory。如果它实现 DirStateFactory，则调用 DirStateFactory.getStateToBind()；否则调用 StateFactory.getStateToBind()。

实现 DirContext 接口的服务提供者应该使用此方法而不是 NamingManager.getStateToBind()。

有关如何确定要尝试的状态工厂列表的描述，请参见 NamingManager.getStateToBind()。

此方法返回的对象归调用者所有。该实现随后不会对它进行修改。它或者包含一个同样归调用者所有的新 Attributes 对象，或者包含对原始 attrs 参数的引用。

参数：

obj - 将为其获得要绑定的状态的非 null 对象。

name - 此对象相对于 nameCtx 的名称，如果没有指定名称，则该参数为 null。

nameCtx - 一个上下文，name 参数是相对于该上下文指定的，如果 name 相对于默认初始上下文，则该参数为 null。

environment - 将在创建状态工厂和对象状态时使用的环境（可能为 null）。

attrs - 将与对象绑定在一起的属性（可能为 null）。

返回：

一个非 null DirStateFactory.Result，它包含要绑定的对象和属性。如果没有任何状态工厂返回非 null 应答，则结果将包含该对象本身 (obj) 以及原始属性。

抛出：

NamingException - 如果使用这些工厂时遇到命名异常。工厂只有在不希望试图使用其他工厂创建对象时才抛出异常。请参见 DirStateFactory.getStateToBind()。

从以下版本开始：

1.3

另请参见：

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)

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