oracle.ldap.util
Class PropertySetCollection

java.lang.Object
  |
  +--oracle.ldap.util.PropertySetCollection

public class PropertySetCollection

extends java.lang.Object

This class represents a collection of PropertySets. In other words, it represents a set of search result entries from a given search.

Constructor Summary

PropertySetCollection(int initSize)

Method Summary

java.lang.String[]	getDns() Returns an array of String containing the name of all the property sets - the DN's of all the search entries in this search result.
PropertySet	getPropertySet(int i) Returns the i-th property set of this property set collection - the i-th search entry of this search result.
PropertySet	getPropertySet(java.lang.String dn) Returns the property set identified by dn - the search entry with the given DN
java.lang.String	getUniquePropertyValue(java.lang.String propName) Provides a short cut for caller to retrieve value of a specific property from the PropertySetCollection.
boolean	isEmpty() Returns true if the property set collection does not contain any property set; false otherwise
int	size() Returns the size of the property set collection - the number of search entries in the search result

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PropertySetCollection

public PropertySetCollection(int initSize)

Method Detail

isEmpty

public final boolean isEmpty()

Returns true if the property set collection does not contain any property set; false otherwise

Returns:

boolean indicating whether the property set is empty or not

size

public final int size()

Returns the size of the property set collection - the number of search entries in the search result

Returns:

an int indicating the number of property sets in the collection -

getDns

public final java.lang.String[] getDns()

Returns an array of String containing the name of all the property sets - the DN's of all the search entries in this search result.

Returns:

a String array containing all the property set names.

getPropertySet

public final PropertySet getPropertySet(int i)

Returns the i-th property set of this property set collection - the i-th search entry of this search result.

Returns:

a PropertySet representing the i-th property set.

getPropertySet

public final PropertySet getPropertySet(java.lang.String dn)

Returns the property set identified by dn - the search entry with the given DN

Returns:

a PropertySet with given dn.

getUniquePropertyValue

public java.lang.String getUniquePropertyValue(java.lang.String propName)
                                        throws UtilException

Provides a short cut for caller to retrieve value of a specific property from the PropertySetCollection. The property must be unique among the collection of PropertySet(s). And it must be a single value attribute/property.

Returns:

String - value of the specified property.

Throws:

UtilException - - when the PropertySetCollection is empty - when the specified property does not have value. - when there is more than 1 matching PropertySet. - when the specified property have more than 1 value.