Lightweight observable collections (used by VMF and VRL).
- Observable List
- Mapped List (keeps two lists with different element types in sync)
- coming sooner or later: ObservableMap and ObservableSet
public class Main { public static void main(String[] args) { // creates an ordinary list List<Integer> list = new ArrayList<>(); // to make the list observable, we wrap it in a VList VList<Integer> vList = VList.newInstance(list); // to get notified, we add a change listener to the VList Subscription subscription = vList.addChangeListener((evt) -> { // for now, we just print the changes System.out.println(EventUtil.toStringWithDetails(evt)); }); // add individual elements (generates 3 events) System.out.println(">> add 3 individual elements"); vList.add(1); vList.add(2); vList.add(3); // add collection of elements (generates only one event) System.out.println(">> add one collection of elements"); vList.addAll(Arrays.asList(4, 5, 6)); // remove individual elements (generates 3 events) System.out.println(">> remove 3 individual elements"); vList.remove((Integer) 1); vList.remove((Integer) 2); vList.remove((Integer) 3); // remove collection of elements (generates only one event) System.out.println(">> remove one collection of elements"); vList.removeAll(Arrays.asList(4,5,6)); // unsubscribe the listener from vList subscription.unsubscribe(); // add elements without generating events System.out.println(">> add one collection of elements without notification"); vList.addAll(Arrays.asList(4, 5, 6)); } }public class Main { public static void main(String[] args) { // creates an ordinary list List<Integer> list = new ArrayList<>(); // to make the list observable, we wrap it in a VList VList<Integer> vList = VList.newInstance(list); // How to make the list unmodifiable and still listen to changes? // THIS DOES NOT WORK: VList.newInstance(Collections.unmodifiableList(list)); VList<Integer> vListUnmodifiable = vList.asUnmodifiable(); // to get notified, we add a change listener to the unmodifiable VList Subscription subscription = vListUnmodifiable.addChangeListener((evt) -> { // for now, we just print the changes System.out.println(EventUtil.toStringWithDetails(evt)); }); // add element and generate event vList.add(1); // modifying the unmodifiable list results in RuntimeException... vListUnmodifiable.add(37); } }- Java >= 1.8
- Internet connection (dependencies are downloaded automatically)
- IDE: Gradle Plugin (not necessary for command line usage)
Open the VCollections Gradle project in your favourite IDE (tested with NetBeans 8.2) and build it by calling the assemble task.
Navigate to the Gradle project (e.g., path/to/VCollections) and enter the following command
bash gradlew assemble gradlew assemble