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.

Method Summary

void	addPropertySet(PropertySet propSet)
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
boolean	isSizeLimitExceeded() Returns true if sizelimit is exceeded for during the query from which this PropertySetCollection is generated
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

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 -

isSizeLimitExceeded

public final boolean isSizeLimitExceeded()

Returns true if sizelimit is exceeded for during the query from which this PropertySetCollection is generated

Returns:

true if sizelimit is exceeded. Otherwise false

addPropertySet

public void addPropertySet(PropertySet propSet)

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.

Parameters:

i - the index of the property set to be retrieved

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

Parameters:

dn - the DN of the property set to be retrieved

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.

Parameters:

propName - - Name of the 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.