Class COM.odi.util.OSAbstractSet

java.lang.Object
   |
   +----COM.odi.util.OSAbstractSet

public class OSAbstractSet
extends Object
implements IPersistent, Set
OSAbstract provides a skeletal implementation of the persistent Set interface. It is extended by other COM.odi.util classes that implement Set.


Method Index

 o add(Object)
Adds the specified element to this Set if it is not already present (optional operation).
 o addAll(Collection)
Adds all of the elements in the specified Collection to this Collection.
 o clear()
Removes all of the elements from this Set (optional operation).
 o contains(Object)
Returns true if this Set contains the specified element.
 o containsAll(Collection)
Returns true if this Collection contains all of the elements in the specified Collection.
 o equals(Object)
Compares the specified Object with this Set for equality.
 o flushContents(GenericObject)
Stores the values of the fields of an active persistent object in an instance of GenericObject.
 o hashCode()
UNSUPPORTED IN THIS RELEASE OF PSE.
 o initializeContents(GenericObject)
Initializes the values of the fields of a hollow persistent object from data contained in an instance of GenericObject.
 o isEmpty()
Returns true if this Set contains no elements.
 o iterator()
Returns an Iterator over the elements in this Set.
 o remove(Object)
Removes the given element from this Set if it is present (optional operation).
 o removeAll(Collection)
Removes from this Collection all of its elements that are contained in the specified Collection.
 o retainAll(Collection)
Retains only the elements in this Collection that are contained in the specified Collection.
 o size()
Returns the number of elements in this Set (its cardinality).
 o toArray()
Returns an array containing all of the elements in this Set.

Methods

 o containsAll
  public boolean containsAll(Collection c)
Returns true if this Collection contains all of the elements in the specified Collection. The specified collection is treated as a set, even if it has duplicates.

See Also:
contains
 o addAll
  public boolean addAll(Collection c)
Adds all of the elements in the specified Collection to this Collection. The behavior of this operation is undefined if the specified Collection is modified while the operation is in progress. (This implies that the behavior of this call is undefined if the the specified Collection is this Collection, and this Collection is nonempty.)

Parameters:
c - elements to be inserted into this Collection.
Returns:
true if this Collection changed as a result of the call.
See Also:
add
 o removeAll
  public boolean removeAll(Collection c)
Removes from this Collection all of its elements that are contained in the specified Collection. After this call returns, this Collection will contains no elements in common with the specified Collection.

Parameters:
c - elements to be removed from this Collection.
Returns:
true if this Collection changed as a result of the call.
See Also:
remove, contains
 o retainAll
  public boolean retainAll(Collection coll)
Retains only the elements in this Collection that are contained in the specified Collection. In other words, removes from this Collection all of its elements that are not contained in the specified Collection.

Parameters:
c - elements to be retained in this Collection.
Returns:
true if this Collection changed as a result of the call.
See Also:
remove, contains
 o equals
  public boolean equals(Object obj)
Compares the specified Object with this Set for equality. Returns true if the given object is also a Set, and the two Sets have the same size, and every element of the given Set is also an element of this Set. Note that this meets the JDK1.2 specification for Set.equals, but that it means that it is not appropriate to store an instance of a Set in any hash-based collection, because its hash code will change if the Set is modified.

Parameters:
o - Object to be compared for equality with this Map.
Returns:
true if the specified Object is equal to this Map.
Overrides:
equals in class Object
 o hashCode
  public int hashCode()
UNSUPPORTED IN THIS RELEASE OF PSE. THIS METHOD WILL BE CHANGED TO PROVIDE A BEHAVIOR COMPATIBLE WITH THE JDK1.2 SET SPECIFICATION, WHEN THE JDK1.2 IS RELEASED.

Throws: UnsupportedOperationException
If you try to call this method. Returns the hash code value for this Set. The hash code of a Set is defined to be the sum of the hashCodes of the elements in the Set. This ensures that t1.equals(t2) implies that t1.hashCode()==t2.hashCode() for any two Sets t1 and t2, as required by the general contract of Object.hashCode. Note that this meets the JDK1.2 specification for Set.equals, but that it means that it is not appropriate to store an instance of OSHashSet in any hash-based collection, because its hash code will change if the OSHashSet is modified.
Overrides:
hashCode in class Object
See Also:
hashCode, equals, equals

Copyright © 1996, 1997, 1998 Object Design, Inc. All rights reserved.