Java javax.naming.directory 类 InitialDirContext（JDK5）

所有类

javax.naming.directory
类 InitialDirContext

java.lang.Object
  javax.naming.InitialContext
      javax.naming.directory.InitialDirContext

所有已实现的接口：

Context, DirContext

直接已知子类：

InitialLdapContext

public class InitialDirContext
   
   
   
   
   
extends InitialContext
   
   
   
   
   
   
   
   
   
   
implements DirContext
   
   
   
   
   

此类是执行目录操作的初始上下文。InitialContext 的类描述中的文档（包括关于同步的那些文档）在此处同样适用。

从以下版本开始：

1.3

另请参见：

InitialContext

InitialDirContext

protected InitialDirContext(boolean lazy)
                     throws NamingException

构造一个具有不进行初始化的选项的初始 DirContext。如果子类在调用 InitialDirContext 构造方法时仍然未知环境属性的值，则可以在其中使用此构造方法。子类的构造方法将调用此构造方法，计算环境的值，然后在返回之前调用 init()。

参数：

lazy - 为 true 表示不初始化该初始 DirContext；为 false 等效于调用 new InitialDirContext()

抛出：

NamingException - 如果遇到命名异常

从以下版本开始：

1.3

另请参见：

InitialContext.init(Hashtable)

InitialDirContext

public InitialDirContext()
                  throws NamingException

构造一个初始 DirContext。不提供环境属性。等效于 new InitialDirContext(null)。

抛出：

NamingException - 如果遇到命名异常

另请参见：

InitialDirContext(Hashtable)

InitialDirContext

public InitialDirContext(Hashtable<?,?> environment)
                  throws NamingException

使用所提供的环境构造一个初始 DirContext。环境属性已在 javax.naming.InitialContext 类描述中讨论。

此构造方法不会修改 environment 或保存一个对它的引用，但可能保存一个副本。

参数：

environment - 用于创建初始 DirContext 的环境。null 指示一个空环境。

抛出：

NamingException - 如果遇到命名异常

getAttributes

public Attributes getAttributes(String name)
                         throws NamingException

从接口 DirContext 复制的描述

检索所有与命名对象关联的属性。有关详细信息，请参阅 DirContext.getAttributes(Name)。

指定者：

接口 DirContext 中的 getAttributes

参数：

name - 对象名，通过该对象名检索属性

返回：

与 name 关联的属性集

抛出：

NamingException - 如果遇到命名异常

getAttributes

public Attributes getAttributes(String name,
                                String[] attrIds)
                         throws NamingException

从接口 DirContext 复制的描述

检索与命名对象关联的选定属性。有关详细信息，请参阅 DirContext.getAttributes(Name, String[])。

指定者：

接口 DirContext 中的 getAttributes

参数：

name - 对象名，通过该对象名检索属性

attrIds - 要检索的属性的标识符。null 指示应该检索所有属性；空数组指示不应检索任何属性。

返回：

请求的属性；永远不为 null

抛出：

NamingException - 如果遇到命名异常

getAttributes

public Attributes getAttributes(Name name)
                         throws NamingException

从接口 DirContext 复制的描述

检索与命名对象关联的所有属性。请参阅关于属性模型、属性类型名称和操作属性的类描述。

指定者：

接口 DirContext 中的 getAttributes

参数：

name - 对象名，通过该对象名检索属性

返回：

与 name 关联的属性集。如果名称没有属性，则返回空属性集；永远不为 null。

抛出：

NamingException - 如果遇到命名异常

另请参见：

DirContext.getAttributes(String), DirContext.getAttributes(Name, String[])

getAttributes

public Attributes getAttributes(Name name,
                                String[] attrIds)
                         throws NamingException

从接口 DirContext 复制的描述

检索与命名对象关联的选定属性。请参阅关于属性模型、属性类型名称和操作属性的类描述。

如果对象没有指定的属性，则目录将忽略不存在的属性，并返回那些对象所具有的请求属性。

目录返回的属性可能多于请求（请参阅类描述中的属性类型名称），但不允许返回任意的、无关的属性。

另请参阅类描述中的操作属性。

指定者：

接口 DirContext 中的 getAttributes

参数：

name - 对象名，通过该对象名检索属性

attrIds - 要检索的属性的标识符。null 指示应该检索所有属性；空数组指示不应检索任何属性。

返回：

请求的属性；永远不为 null

抛出：

NamingException - 如果遇到命名异常

modifyAttributes

public void modifyAttributes(String name,
                             int mod_op,
                             Attributes attrs)
                      throws NamingException

从接口 DirContext 复制的描述

修改与命名对象关联的属性。有关详细信息，请参阅 DirContext.modifyAttributes(Name, int, Attributes)。

指定者：

接口 DirContext 中的 modifyAttributes

参数：

name - 属性将被更新的对象的名称

mod_op - 修改操作，为以下操作之一：ADD_ATTRIBUTE、REPLACE_ATTRIBUTE 和 REMOVE_ATTRIBUTE。

attrs - 要用于修改的属性；不能为 null

抛出：

AttributeModificationException - 如果不能成功完成修改

NamingException - 如果遇到命名异常