Spec-Zone .ru
спецификации, руководства, описания, API
|
|
JavaTM 2 Platform Std. Ed. v1.3.1 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
This interface represents a collection of attributes.
In a directory, named objects can have associated with them attributes. The Attributes interface represents a collection of attributes. For example, you can request from the directory the attributes associated with an object. Those attributes are returned in an object that implements the Attributes interface.
Attributes in an object that implements the Attributes interface are unordered. The object can have zero or more attributes. Attributes is either case-sensitive or case-insensitive (case-ignore). This property is determined at the time the Attributes object is created. (see BasicAttributes constructor for example). In a case-insensitive Attributes, the case of its attribute identifiers is ignored when searching for an attribute, or adding attributes. In a case-sensitive Attributes, the case is significant.
Note that updates to Attributes (such as adding or removing an attribute) do not affect the corresponding representation in the directory. Updates to the directory can only be effected using operations in the DirContext interface.
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[])
,
BasicAttributes
Method Summary | |
Object |
clone()
Makes a copy of the attribute set. |
Attribute |
get(String attrID)
Retrieves the attribute with the given attribute id from the attribute set. |
NamingEnumeration |
getAll()
Retrieves an enumeration of the attributes in the attribute set. |
NamingEnumeration |
getIDs()
Retrieves an enumeration of the ids of the attributes in the attribute set. |
boolean |
isCaseIgnored()
Determines whether the attribute set ignores the case of attribute identifiers when retrieving or adding attributes. |
Attribute |
put(Attribute attr)
Adds a new attribute to the attribute set. |
Attribute |
put(String attrID,
Object val)
Adds a new attribute to the attribute set. |
Attribute |
remove(String attrID)
Removes the attribute with the attribute id 'attrID' from the attribute set. |
int |
size()
Retrieves the number of attributes in the attribute set. |
Method Detail |
public boolean isCaseIgnored()
public int size()
public Attribute get(String attrID)
attrID
- The non-null id of the attribute to retrieve.
If this attribute set ignores the character
case of its attribute ids, the case of attrID
is ignored.put(java.lang.String, java.lang.Object)
,
remove(java.lang.String)
public NamingEnumeration getAll()
public NamingEnumeration getIDs()
public Attribute put(String attrID, Object val)
attrID
- non-null The id of the attribute to add.
If the attribute set ignores the character
case of its attribute ids, the case of attrID
is ignored.val
- The possibly null value of the attribute to add.
If null, the attribute does not have any values.remove(java.lang.String)
public Attribute put(Attribute attr)
attr
- The non-null attribute to add.
If the attribute set ignores the character
case of its attribute ids, the case of
attr's identifier is ignored.remove(java.lang.String)
public Attribute remove(String attrID)
attrID
- The non-null id of the attribute to remove.
If the attribute set ignores the character
case of its attribute ids, the case of
attrID is ignored.public Object clone()
clone
in class Object
|
JavaTM 2 Platform Std. Ed. v1.3.1 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2001 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.