Package org.onosproject.store.service
Interface TransactionalSet<E>
-
- Type Parameters:
E
- type of element.
public interface TransactionalSet<E>
Transactional Set data structure.A TransactionalSet is implemented with the help of TransactionalMap data structure. All operations performed on this set within a transaction boundary are invisible externally until the point when the transaction commits. A commit usually succeeds in the absence of conflicts.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description boolean
add(E e)
Adds the specified element to this set if it is not already present (optional operation).boolean
contains(E e)
Returns true if this set contains the specified element.boolean
remove(E e)
Removes the specified element from this set if it is present (optional operation).
-
-
-
Method Detail
-
add
boolean add(E e)
Adds the specified element to this set if it is not already present (optional operation). More formally, adds the specified element e to this set if the set contains no element e2 such that (e==null ? e2==null : e.equals(e2)). If this set already contains the element, the call leaves the set unchanged and returns false. In combination with the restriction on constructors, this ensures that sets never contain duplicate elements.- Parameters:
e
- element to be added to this set- Returns:
- true if this set did not already contain the specified element
-
remove
boolean remove(E e)
Removes the specified element from this set if it is present (optional operation). More formally, removes an element e such that (o==null ? e==null : o.equals(e)), if this set contains such an element. Returns true if this set contained the element (or equivalently, if this set changed as a result of the call). (This set will not contain the element once the call returns.)- Parameters:
e
- element to be removed to this set- Returns:
- true if this set contained the specified element
-
contains
boolean contains(E e)
Returns true if this set contains the specified element. More formally, returns true if and only if this set contains an element e such that (o==null ? e==null : o.equals(e)).- Parameters:
e
- element whose presence in this set is to be tested- Returns:
- true if this set contains the specified element
- Throws:
java.lang.ClassCastException
- if the type of the specified element is incompatible with this setjava.lang.NullPointerException
- if the specified element is null and this set does not permit null elements
-
-