java.lang.Objectjavax.naming.InitialContext
javax.naming.directory.InitialDirContext
public class InitialDirContext
此类是执行目录操作的初始上下文。InitialContext 的类描述中的文档(包括关于同步的那些文档)在此处同样适用。
InitialContext
字段摘要 |
---|
从类 javax.naming.InitialContext 继承的字段 |
---|
defaultInitCtx, gotDefault, myProps |
从接口 javax.naming.directory.DirContext 继承的字段 |
---|
ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE |
构造方法摘要 | |
---|---|
|
InitialDirContext() 构造一个初始 DirContext。 |
protected |
InitialDirContext(boolean lazy) 构造一个具有不进行初始化的选项的初始 DirContext。 |
|
InitialDirContext(Hashtable<?,?> environment) 使用所提供的环境构造一个初始 DirContext。 |
方法摘要 | |
---|---|
void |
bind(Name name, Object obj, Attributes attrs) 将名称与关联的属性一起绑定到一个对象。 |
void |
bind(String name, Object obj, Attributes attrs) 将名称与关联的属性一起绑定到一个对象。 |
DirContext |
createSubcontext(Name name, Attributes attrs) 创建并绑定新的上下文及关联的属性。 |
DirContext |
createSubcontext(String name, Attributes attrs) 创建并绑定新的上下文及关联的属性。 |
Attributes |
getAttributes(Name name) 检索与命名对象关联的所有属性。 |
Attributes |
getAttributes(Name name, String[] attrIds) 检索与命名对象关联的选定属性。 |
Attributes |
getAttributes(String name) 检索所有与命名对象关联的属性。 |
Attributes |
getAttributes(String name, String[] attrIds) 检索与命名对象关联的选定属性。 |
DirContext |
getSchema(Name name) 检索与命名对象关联的模式。 |
DirContext |
getSchema(String name) 检索与命名对象关联的模式。 |
DirContext |
getSchemaClassDefinition(Name name) 检索包含命名对象类定义的模式对象的上下文。 |
DirContext |
getSchemaClassDefinition(String name) 检索包含命名对象类定义的模式对象的上下文。 |
void |
modifyAttributes(Name name, int mod_op, Attributes attrs) 修改与命名对象关联的属性。 |
void |
modifyAttributes(Name name, ModificationItem[] mods) 使用有序的修改列表修改与命名对象关联的属性。 |
void |
modifyAttributes(String name, int mod_op, Attributes attrs) 修改与命名对象关联的属性。 |
void |
modifyAttributes(String name, ModificationItem[] mods) 使用有序的修改列表修改与命名对象关联的属性。 |
void |
rebind(Name name, Object obj, Attributes attrs) 将名称与关联的属性一起绑定到一个对象,并重写任何现有绑定。 |
void |
rebind(String name, Object obj, Attributes attrs) 将名称与关联的属性一起绑定到一个对象,并重写任何现有绑定。 |
NamingEnumeration<SearchResult> |
search(Name name, Attributes matchingAttributes) 在单个上下文中搜索包含指定属性集的对象。 |
NamingEnumeration<SearchResult> |
search(Name name, Attributes matchingAttributes, String[] attributesToReturn) 在单个上下文中搜索包含指定属性集的对象,并检索选定的属性。 |
NamingEnumeration<SearchResult> |
search(Name name, String filterExpr, Object[] filterArgs, SearchControls cons) 在命名上下文或对象中搜索符合给定搜索过滤器的项。 |
NamingEnumeration<SearchResult> |
search(Name name, String filter, SearchControls cons) 在命名上下文或对象中搜索符合给定搜索过滤器的项。 |
NamingEnumeration<SearchResult> |
search(String name, Attributes matchingAttributes) 在单个上下文中搜索包含指定属性集的对象。 |
NamingEnumeration<SearchResult> |
search(String name, Attributes matchingAttributes, String[] attributesToReturn) 在单个上下文中搜索包含指定属性集的对象,并检索选定的属性。 |
NamingEnumeration<SearchResult> |
search(String name, String filterExpr, Object[] filterArgs, SearchControls cons) 在命名上下文或对象中搜索符合给定搜索过滤器的项。 |
NamingEnumeration<SearchResult> |
search(String name, String filter, SearchControls cons) 在命名上下文或对象中搜索符合给定搜索过滤器的项。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
从接口 javax.naming.Context 继承的方法 |
---|
addToEnvironment, bind, bind, close, composeName, composeName, createSubcontext, createSubcontext, destroySubcontext, destroySubcontext, getEnvironment, getNameInNamespace, getNameParser, getNameParser, list, list, listBindings, listBindings, lookup, lookup, lookupLink, lookupLink, rebind, rebind, removeFromEnvironment, rename, rename, unbind, unbind |
构造方法详细信息 |
---|
protected InitialDirContext(boolean lazy) throws NamingException
lazy
- 为 true 表示不初始化该初始 DirContext;为 false 等效于调用
new InitialDirContext()
NamingException
- 如果遇到命名异常
InitialContext.init(Hashtable)
public InitialDirContext() throws NamingException
NamingException
- 如果遇到命名异常
InitialDirContext(Hashtable)
public InitialDirContext(Hashtable<?,?> environment) throws NamingException
此构造方法不会修改 environment 或保存一个对它的引用,但可能保存一个副本。
environment
- 用于创建初始 DirContext 的环境。null 指示一个空环境。
NamingException
- 如果遇到命名异常
方法详细信息 |
---|
public Attributes getAttributes(String name) throws NamingException
DirContext
复制的描述
DirContext.getAttributes(Name)
。
DirContext
中的
getAttributes
name
- 对象名,通过该对象名检索属性
name
关联的属性集
NamingException
- 如果遇到命名异常
public Attributes getAttributes(String name, String[] attrIds) throws NamingException
DirContext
复制的描述
DirContext.getAttributes(Name, String[])
。
DirContext
中的
getAttributes
name
- 对象名,通过该对象名检索属性
attrIds
- 要检索的属性的标识符。null 指示应该检索所有属性;空数组指示不应检索任何属性。
NamingException
- 如果遇到命名异常
public Attributes getAttributes(Name name) throws NamingException
DirContext
复制的描述
DirContext
中的
getAttributes
name
- 对象名,通过该对象名检索属性
name
关联的属性集。如果名称没有属性,则返回空属性集;永远不为 null。
NamingException
- 如果遇到命名异常
DirContext.getAttributes(String)
,
DirContext.getAttributes(Name, String[])
public Attributes getAttributes(Name name, String[] attrIds) throws NamingException
DirContext
复制的描述
如果对象没有指定的属性,则目录将忽略不存在的属性,并返回那些对象所具有的请求属性。
目录返回的属性可能多于请求(请参阅类描述中的属性类型名称),但不允许返回任意的、无关的属性。
另请参阅类描述中的操作属性。
DirContext
中的
getAttributes
name
- 对象名,通过该对象名检索属性
attrIds
- 要检索的属性的标识符。null 指示应该检索所有属性;空数组指示不应检索任何属性。
NamingException
- 如果遇到命名异常
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
- 如果遇到命名异常
public void modifyAttributes(Name name, int mod_op, Attributes attrs) throws NamingException
DirContext
复制的描述
DirContext
中的
modifyAttributes
name
- 属性将被更新的对象的名称
mod_op
- 修改操作,为以下操作之一:
ADD_ATTRIBUTE
、
REPLACE_ATTRIBUTE
和
REMOVE_ATTRIBUTE
。
attrs
- 要用于修改的属性;不能为 null
AttributeModificationException
- 如果不能成功完成修改
NamingException
- 如果遇到命名异常
DirContext.modifyAttributes(Name, ModificationItem[])
public void modifyAttributes(String name, ModificationItem[] mods) throws NamingException
DirContext
复制的描述
DirContext.modifyAttributes(Name, ModificationItem[])
。
DirContext
中的
modifyAttributes
name
- 属性将被更新的对象的名称
mods
- 要执行的修改的有序序列;不能为 null
AttributeModificationException
- 如果不能成功完成修改
NamingException
- 如果遇到命名异常
public void modifyAttributes(Name name, ModificationItem[] mods) throws NamingException
DirContext
复制的描述
DirContext
中的
modifyAttributes
name
- 属性将被更新的对象的名称
mods
- 要执行的修改的有序序列;不能为 null
AttributeModificationException
- 如果不能成功完成修改
NamingException
- 如果遇到命名异常
DirContext.modifyAttributes(Name, int, Attributes)
,
ModificationItem
public void bind(String name, Object obj, Attributes attrs) throws NamingException
DirContext
复制的描述
DirContext.bind(Name, Object, Attributes)
。
DirContext
中的
bind
name
- 要绑定的名称;不能为空
obj
- 要绑定的对象;可能为 null
attrs
- 要与绑定关联的属性
NameAlreadyBoundException
- 如果已经绑定了 name
InvalidAttributesException
- 如果没有提供绑定的某些“强制”属性
NamingException
- 如果遇到命名异常
public void bind(Name name, Object obj, Attributes attrs) throws NamingException
DirContext
复制的描述
DirContext
中的
bind