模块 java.naming

软件包 javax.naming.directory

Class BasicAttributes

java.lang.Object

javax.naming.directory.BasicAttributes

实现的所有接口

Serializable ， Cloneable ， Attributes

public class BasicAttributes
extends Object
implements Attributes

此类提供Attributes接口的基本实现。

BasicAttributes区分大小写或不区分大小写（case-ignore）。 此属性是在调用BasicAttributes构造函数时确定的。 在不区分大小写的BasicAttributes中，在搜索属性或添加属性时会忽略其属性标识符的大小写。 在区分大小写的BasicAttributes中，案例非常重要。

当BasicAttributes类需要创建Attribute时，它使用BasicAttribute。 BasicAttribute没有其他依赖项。

请注意，对BasicAttributes的更新（例如添加或删除属性）不会影响目录中的相应表示。 只能使用DirContext接口中的操作来实现对目录的更新。

BasicAttributes实例未与并发多线程访问同步。 尝试访问和修改单个BasicAttributes实例的多个线程应该锁定该对象。

从以下版本开始：

1.3

另请参见：

DirContext.getAttributes(javax.naming.Name) ， DirContext.modifyAttributes(javax.naming.Name, int, javax.naming.directory.Attributes) ， DirContext.bind(javax.naming.Name, java.lang.Object, javax.naming.directory.Attributes) ， DirContext.rebind(javax.naming.Name, java.lang.Object, javax.naming.directory.Attributes) ， DirContext.createSubcontext(javax.naming.Name, javax.naming.directory.Attributes) ， DirContext.search(javax.naming.Name, javax.naming.directory.Attributes, java.lang.String[]) ， Serialized Form

构造方法摘要

构造方法

构造器	描述
BasicAttributes()	构造一个新的Attributes实例。
BasicAttributes(boolean ignoreCase)	构造一个新的Attributes实例。
BasicAttributes(String attrID, Object val)	使用一个属性构造一个新的Attributes实例。
BasicAttributes(String attrID, Object val, boolean ignoreCase)	使用一个属性构造一个新的Attributes实例。

方法摘要

变量和类型	方法	描述
boolean	equals(Object obj)	确定此 BasicAttributes是否等于另一个 Attributes如果两个 Attributes都是 Attributes实例，则它们是相等的，以相同的方式处理属性ID的情况，并包含相同的属性。
int	hashCode()	计算此BasicAttributes的哈希码。
String	toString()	生成此属性集的字符串表示形式。

声明方法的类 java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

声明方法的接口 javax.naming.directory.Attributes

clone, get, getAll, getIDs, isCaseIgnored, put, put, remove, size

构造方法详细信息

BasicAttributes

public BasicAttributes()

构造一个新的Attributes实例。 随后检索或添加属性时，属性标识符的字符大小写很重要。

BasicAttributes

public BasicAttributes(boolean ignoreCase)

构造一个新的Attributes实例。 如果ignoreCase为true，则忽略属性标识符的字符大小写; 否则案件很重要。

参数

ignoreCase - true表示此属性集在检索或添加属性时将忽略其属性标识符的大小写; 错误意味着案件受到尊重。

BasicAttributes

public BasicAttributes(String attrID,
                       Object val)

使用一个属性构造一个新的Attributes实例。 由attrID和val指定的属性将添加到新创建的属性中。 随后检索或添加属性时，属性标识符的字符大小写很重要。

参数

attrID - 非null要添加的属性的id。

val - 要添加的属性的值。 如果为null，则为属性添加空值。

BasicAttributes

public BasicAttributes(String attrID,
                       Object val,
                       boolean ignoreCase)

使用一个属性构造一个新的Attributes实例。 由attrID和val指定的属性将添加到新创建的属性中。 如果ignoreCase为true，则忽略属性标识符的字符大小写; 否则案件很重要。

参数

attrID - 非null要添加的属性的id。 如果此属性集忽略其属性id的字符大小写，则忽略attrID的大小写。

val - 要添加的属性的值。 如果为null，则为属性添加空值。

ignoreCase - true表示此属性集在检索或添加属性时将忽略其属性标识符的大小写; 错误意味着案件受到尊重。

方法详细信息

toString

public String toString()

生成此属性集的字符串表示形式。 该字符串由每个属性标识符和每个属性的内容组成。 此字符串的内容对于调试很有用，并不意味着以编程方式解释。

重写：

toString在类 Object

结果

列出此属性集内容的非空字符串。

equals

public boolean equals(Object obj)

确定此BasicAttributes是否等于另一个Attributes如果它们都是Attributes实例，则两个Attributes是相等的，以相同的方式处理属性ID的情况，并包含相同的属性。 使用Object.equals()检查此BasicAttributes每个Attribute是否相等，其可能已被Attribute的实现覆盖。 如果子类重写equals() ，它也应该重写hashCode() ，以便两个相等的Attributes实例具有相同的哈希码。

重写：

equals在类 Object

参数

obj - 要比较的可能为null的对象。

结果

如果obj等于此BasicAttributes，则为true。

另请参见：

hashCode()

hashCode

public int hashCode()

计算此BasicAttributes的哈希码。

通过添加该对象的属性的哈希码来计算哈希码。 如果此BasicAttributes忽略其属性ID的大小写，则会将一个添加到哈希代码中。 如果子类重写hashCode() ，它也应该重写equals() ，以便两个相等的Attributes实例具有相同的哈希码。

重写：

hashCode在类 Object

结果

一个int，表示此BasicAttributes实例的哈希码。

另请参见：

equals(java.lang.Object)