模块  java.naming
软件包  javax.naming.spi

Class DirectoryManager


  • public class DirectoryManager
    extends NamingManager
    此类包含支持DirContext实现的方法。

    此类是NamingManager的扩展。 它包含服务提供者用于访问对象工厂和状态工厂的方法,以及用于获取支持联合的延续上下文的方法。

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

    除非另有说明,一个NameAttributes传递给任何方法或环境参数由调用者所有。 实现不会修改对象或保留对它的引用,尽管它可以保留对克隆或副本的引用。

    从以下版本开始:
    1.3
    另请参见:
    DirObjectFactoryDirStateFactory
    • 方法详细信息

      • getObjectInstance

        public static Object getObjectInstance​(Object refInfo,
                                               Name name,
                                               Context nameCtx,
                                               Hashtable<?,​?> environment,
                                               Attributes attrs)
                                        throws 异常
        为指定的对象,属性和环境创建对象的实例。

        除以下差异外,此方法与NamingManager.getObjectInstance相同:

        • 它接受包含与对象关联的属性的Attributes参数。 DirObjectFactory可能使用这些属性来保存必须从目录中查找它们。
        • 尝试的对象工厂必须实现ObjectFactoryDirObjectFactory 如果它实现DirObjectFactory ,则使用DirObjectFactory.getObjectInstance() ,否则使用ObjectFactory.getObjectInstance()
        实现DirContext接口的服务提供商应使用此方法,而不是NamingManager.getObjectInstance()
        参数
        refInfo - 要为其创建对象的可能为null的对象。
        name - 此对象的名称相对于nameCtx 指定名称是可选的; 如果省略,则name应为null。
        nameCtx - 指定name参数的上下文。 如果为null,则name相对于默认初始上下文。
        environment - 用于创建对象工厂和对象的可能为null的环境。
        attrs - 与refInfo关联的可能为null的属性。 这可能不是refInfo的完整属性集; 您可以从目录中读取更多属性。
        结果
        使用refInfoattrs创建的对象; refInfo如果工厂无法创建对象。
        异常
        NamingException - 如果在尝试获取URL上下文时遇到命名异常,或者其中一个访问的工厂抛出NamingException。
        异常 - 如果访问的某个工厂抛出异常,或者在加载和实例化工厂和对象类时遇到错误。 如果工厂不希望在尝试创建对象时使用其他工厂,则工厂应该只抛出异常。 DirObjectFactory.getObjectInstance()
        从以下版本开始:
        1.3
        另请参见:
        NamingManager.getURLContext(java.lang.String, java.util.Hashtable<?, ?>)DirObjectFactoryDirObjectFactory.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实例,其中包含要绑定的对象以及绑定所附带的属性。 对象或属性可以为null。
        • 所尝试的州工厂必须各自实施StateFactoryDirStateFactory 如果它实现DirStateFactory ,则DirStateFactory.getStateToBind() ; 否则, StateFactory.getStateToBind()
        实现DirContext接口的服务提供商应使用此方法,而不是NamingManager.getStateToBind()

        有关如何确定要尝试的状态工厂列表的说明,请参阅NamingManager.getStateToBind()。

        此方法返回的对象由调用者拥有。 实施不会随后修改它。 它将包含同样由调用者拥有的新Attributes对象,或者包含对原始attrs参数的引用。

        参数
        obj - 要为其绑定状态的非null对象。
        name - 此对象相对于 nameCtx的名称,如果未指定名称,则为null。
        nameCtx - 指定 name参数的上下文,如果 name相对于默认初始上下文,则 name null。
        environment - 用于创建状态工厂和对象状态的可能为null的环境。
        attrs - 要与对象绑定的可能为null的属性。
        结果
        包含要绑定的对象和属性的非null DirStateFactory.Result。 如果没有状态工厂返回非空答案,则结果将包含具有原始属性的对象( obj )本身。
        异常
        NamingException - 如果在使用工厂时遇到命名异常。 如果工厂不希望在尝试创建对象时使用其他工厂,则工厂应该只抛出异常。 DirStateFactory.getStateToBind()
        从以下版本开始:
        1.3
        另请参见:
        DirStateFactoryDirStateFactory.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<?, ?>)