java.lang.Object
- ca.odell.glazedlists.AbstractEventList<E>
- - ca.odell.glazedlists.TransformedList<S,E>
  - - ca.odell.glazedlists.CollectionList<EventList<E>,E>
    - - ca.odell.glazedlists.CompositeList<E>

All Implemented Interfaces:: ListEventListener<EventList<E>>, EventList<E>, java.lang.Iterable<E>, java.util.Collection<E>, java.util.EventListener, java.util.List<E>

public class CompositeList<E>
extends CollectionList<EventList<E>,E>

An EventList composed of multiple source EventLists. This list shows the contents of its source lists.

Note that all contained EventLists must use the same ListEventPublisher and ReadWriteLock, particularly if this EventList is to be used by multiple threads concurrently. To construct an EventList that shares the ListEventPublisher and ReadWriteLock with this CompositeList, use createMemberList().

Warning: This class is thread ready but not thread safe. See EventList for an example of thread safe code.

EventList Overview
Writable:	only `CollectionList.set(int,Object)` and `CollectionList.remove(int)`
Concurrency:	not thread safe
Performance:	reads: O(log N), writes O(log N)
Memory:	96 bytes per element
Unit Tests:	N/A
Issues:	25 93 96 162

Author:: Jesse Wilson

Nested Class Summary
- Nested classes/interfaces inherited from class ca.odell.glazedlists.CollectionList
  CollectionList.Model<E,S>

Field Summary
- Fields inherited from class ca.odell.glazedlists.TransformedList
  source
- Fields inherited from class ca.odell.glazedlists.AbstractEventList
  publisher, readWriteLock, updates

Constructor Summary

Constructors
Constructor	Description
`CompositeList()`
`CompositeList(ListEventPublisher publisher, ReadWriteLock lock)`	Create a `CompositeList` that uses the given `publisher` and `lock`.
`CompositeList(ReadWriteLock lock)`	Deprecated. replaced by `CompositeList(ListEventPublisher, ReadWriteLock)`, because prebuilt member lists should share lock and publisher with the CompositeList.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`void`	`addMemberList(EventList<E> member)`	Adds the specified `EventList` as a source to this `CompositeList`.
`<E> EventList<E>`	`createMemberList()`	Creates a new `EventList` that shares its `ReadWriteLock` and `ListEventPublisher` with this `CompositeList`.
`void`	`removeMemberList(EventList<E> list)`	Removes the specified `EventList` as a source `EventList` to this `CompositeList`.

Methods inherited from class ca.odell.glazedlists.CollectionList
childEndingIndex, childStartingIndex, dispose, get, isWritable, listChanged, remove, set, size

Methods inherited from class ca.odell.glazedlists.TransformedList
add, addAll, clear, getSourceIndex, removeAll, retainAll

Methods inherited from class ca.odell.glazedlists.AbstractEventList
add, addAll, addListEventListener, contains, containsAll, equals, getPublisher, getReadWriteLock, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, removeListEventListener, subList, toArray, toArray, toString

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Collection
parallelStream, removeIf, stream, toArray

Methods inherited from interface java.lang.Iterable
forEach

Methods inherited from interface java.util.List
replaceAll, sort, spliterator

- Constructor Detail
  - CompositeList
```
public CompositeList()
```
  - CompositeList
```
public CompositeList(ReadWriteLock lock)
```
    Deprecated.
    replaced by CompositeList(ListEventPublisher, ReadWriteLock), because prebuilt member lists should share lock and publisher with the CompositeList.
    
    Create a CompositeList that uses the given lock. Note that this lock will also be used when building new member lists.
    This can be a convenient constructor to use when the member lists are prebuilt ahead of time with a common ReadWriteLock and it is desirable to compose their union with a CompositeList.
    
    Parameters:
    
    lock - the ReadWriteLock to use within the CompositeList
  - CompositeList
```
public CompositeList(ListEventPublisher publisher,
                     ReadWriteLock lock)
```
    Create a CompositeList that uses the given publisher and lock. Note that this publisher and lock will also be used when building new member lists.
    This can be a convenient constructor to use when the member lists are prebuilt ahead of time with a common ListEventPublisher and ReadWriteLock and it is desirable to compose their union with a CompositeList.
    
    Parameters:
    
    publisher - the ListEventPublisher to use within the CompositeList
    
    lock - the ReadWriteLock to use within the CompositeList
- Method Detail
  - addMemberList
```
public void addMemberList(EventList<E> member)
```
    Adds the specified EventList as a source to this CompositeList.
    To ensure correct behaviour when this CompositeList is used by multiple threads, the specified EventList has to share the same ReadWriteLock and ListEventPublisher with this CompositeList.
    
    Throws:
    
    java.lang.IllegalArgumentException - if the specified EventList uses a different ReadWriteLock or ListEventPublisher
    
    See Also:
    
    createMemberList()
  - createMemberList
```
public <E> EventList<E> createMemberList()
```
    Creates a new EventList that shares its ReadWriteLock and ListEventPublisher with this CompositeList. This is necessary when this CompositeList will be used by multiple threads.
    Note that the created EventList must be explicitly added as a member to this CompositeList using addMemberList(EventList).
    
    Returns:
    
    a new EventList appropriate for use as a {#link #addMemberList member list} of this CompositeList
  - removeMemberList
```
public void removeMemberList(EventList<E> list)
```
    Removes the specified EventList as a source EventList to this CompositeList.

Class CompositeList<E>

Nested Class Summary

Nested classes/interfaces inherited from class ca.odell.glazedlists.CollectionList

Field Summary

Fields inherited from class ca.odell.glazedlists.TransformedList

Fields inherited from class ca.odell.glazedlists.AbstractEventList

Constructor Summary

Method Summary

Methods inherited from class ca.odell.glazedlists.CollectionList

Methods inherited from class ca.odell.glazedlists.TransformedList

Methods inherited from class ca.odell.glazedlists.AbstractEventList

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Collection

Methods inherited from interface java.lang.Iterable

Methods inherited from interface java.util.List

Constructor Detail

CompositeList

CompositeList

CompositeList

Method Detail

addMemberList

createMemberList

removeMemberList