Module java.naming
Package javax.naming.directory

Interface Attributes

所有超级接口:
Cloneable, Serializable
所有已知实现类:
BasicAttributes
public interface Attributes extends Cloneable, Serializable
此接口表示属性的集合。

在目录中，命名对象可以有与其关联的属性。Attributes接口表示属性的集合。例如，您可以从目录中请求与对象关联的属性。这些属性以实现Attributes接口的对象返回。

实现Attributes接口的对象中的属性是无序的。对象可以具有零个或多个属性。Attributes可以是区分大小写的，也可以是不区分大小写的（忽略大小写）。此属性在创建Attributes对象时确定。（例如，请参阅BasicAttributes构造函数的示例）。在不区分大小写的Attributes中，在搜索属性或添加属性时会忽略属性标识符的大小写。在区分大小写的Attributes中，大小写是重要的。

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

自版本:
1.3
另请参阅:

  • Method Details

    • isCaseIgnored

      boolean isCaseIgnored()
      确定属性集在检索或添加属性时是否忽略属性标识符的大小写。
      返回:
      如果忽略大小写，则为true；否则为false。

    • size

      int size()
      检索属性集中属性的数量。
      返回:
      此属性集中属性的非负数数量。

    • get

      Attribute get(String attrID)
      从属性集中检索具有给定属性ID的属性。
      参数:
      attrID - 要检索的属性的非空ID。如果此属性集忽略其属性ID的字符大小写，则会忽略attrID的大小写。
      返回:
      由attrID标识的属性；如果未找到，则为null。
      另请参阅:

    • getAll

      NamingEnumeration<? extends Attribute> getAll()
      检索属性集中属性的枚举。对此枚举的更新对此枚举的影响是未定义的。
      返回:
      此属性集中属性的非空枚举。枚举的每个元素都是Attribute类的实例。如果属性集没有属性，则返回空枚举。

    • getIDs

      NamingEnumeration<String> getIDs()
      检索属性集中属性的ID的枚举。对此枚举的更新对此枚举的影响是未定义的。
      返回:
      此属性集中属性的ID的非空枚举。枚举的每个元素都是String类的实例。如果属性集没有属性，则返回空枚举。

    • put

      Attribute put(String attrID, Object val)
      向属性集中添加新属性。
      参数:
      attrID - 非空 要添加的属性的ID。如果属性集忽略其属性ID的字符大小写，则会忽略attrID的大小写。
      val - 要添加的可能为null的属性值。如果为null，则属性没有任何值。
      返回:
      先前在此属性集中的具有attrID的属性；如果不存在此类属性，则为null。
      另请参阅:

    • put

      Attribute put(Attribute attr)
      向属性集中添加新属性。
      参数:
      attr - 非空 要添加的属性。如果属性集忽略其属性ID的字符大小写，则会忽略attr的标识符的大小写。
      返回:
      先前在此属性集中的与attr具有相同ID的属性；如果不存在此类属性，则为null。
      另请参阅:

    • remove

      Attribute remove(String attrID)
      从属性集中删除具有属性ID“attrID”的属性。如果属性不存在，则忽略。
      参数:
      attrID - 要删除的属性的非空ID。如果属性集忽略其属性ID的字符大小写，则会忽略attrID的大小写。
      返回:
      先前在属性集中的与attrID相同ID的属性；如果不存在此类属性，则为null。

    • clone

      Object clone()
      复制属性集。新集合包含与原始集合相同的属性：属性本身不会被克隆。对副本的更改不会影响原始集合，反之亦然。
      返回:
      此属性集的非空副本。