Package groovy.util

Class ObservableSet<E>

java.lang.Object
groovy.util.ObservableSet<E>
All Implemented Interfaces:
Iterable<E>, Collection<E>, Set<E>

public class ObservableSet<E>
extends Object
implements Set<E>
Set decorator that will trigger PropertyChangeEvents when a value changes.
An optional Closure may be specified and will work as a filter, if it returns true the property will trigger an event (if the value indeed changed), otherwise it won't. The Closure may receive 1 or 2 parameters, the single one being the value, the other one both the key and value, for example:
 // skip all properties whose value is a closure
 def set = new ObservableSet( {!(it instanceof Closure)} )
 <p/>
 // skip all properties whose name matches a regex
 def set = new ObservableSet( { name, value -> !(name =˜ /[A-Z+]/) } )
 
The current implementation will trigger specialized events in the following scenarios, you need not register a different listener as those events extend from PropertyChangeEvent
  • ObservableSet.ElementAddedEvent - a new element is added to the set
  • ObservableSet.ElementRemovedEvent - an element is removed from the set
  • ObservableSet.ElementUpdatedEvent - an element changes value (same as regular PropertyChangeEvent)
  • ObservableSet.ElementClearedEvent - all elements have been removed from the list
  • ObservableSet.MultiElementAddedEvent - triggered by calling set.addAll()
  • ObservableSet.MultiElementRemovedEvent - triggered by calling set.removeAll()/set.retainAll()

Bound properties

  • content - read-only.
  • size - read-only.
  • Field Details

  • Constructor Details

    • ObservableSet

      public ObservableSet()
    • ObservableSet

      public ObservableSet​(Set<E> delegate)
    • ObservableSet

      public ObservableSet​(Closure test)
    • ObservableSet

      public ObservableSet​(Set<E> delegate, Closure test)
  • Method Details