org.eclipse.persistence.indirection

Class IndirectCollectionsFactory

java.lang.Object

org.eclipse.persistence.indirection.IndirectCollectionsFactory

public final class IndirectCollectionsFactory
extends java.lang.Object

Provides factory methods to create JDK specific implementation of particular type of IndirectCollection.

See Also:

IndirectCollection, IndirectList, IndirectMap, IndirectSet

Author:

Lukas Jungmann

Since:

EclipseLink 2.6.0

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	IndirectCollectionsFactory.IndirectCollectionsProvider Define API providers of IndirectCollection implementations must conform to.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.Class	IndirectList_Class Class implementing IndirectList.
static java.lang.Class	IndirectMap_Class Class implementing IndirectMap.
static java.lang.Class	IndirectSet_Class Class implementing IndirectSet.

Constructor Summary

Constructors

Constructor and Description
IndirectCollectionsFactory()

Method Summary

Modifier and Type	Method and Description
static <E> IndirectList<E>	createIndirectList() Construct an empty IndirectList with the default initial capacity (10) and default capacity increment (0).
static <E> IndirectList<E>	createIndirectList(java.util.Collection<? extends E> collection) Construct an IndirectList containing the elements of the specified collection, in the order they are returned by the collection's iterator.
static <E> IndirectList<E>	createIndirectList(int initialCapacity) Construct an empty IndirectList with the specified initial capacity and default capacity increment (0).
static <K,V> IndirectMap<K,V>	createIndirectMap() Construct a new, empty IndirectMap with the default initial capacity (11) and the default load factor (0.75).
static <K,V> IndirectMap<K,V>	createIndirectMap(int initialCapacity) Construct a new, empty IndirectMap with the specified initial capacity and the default load factor (0.75).
static <K,V> IndirectMap<K,V>	createIndirectMap(java.util.Map<? extends K,? extends V> map) Construct a new IndirectMap with the same mappings as the given Map.
static <E> IndirectSet<E>	createIndirectSet() Construct an empty IndirectSet with the default initial capacity (10) and the default load factor (0.75).
static <E> IndirectSet<E>	createIndirectSet(java.util.Collection<? extends E> collection) Constructs an IndirectSet containing the elements of the specified collection.
static <E> IndirectSet<E>	createIndirectSet(int initialCapacity) Construct an empty IndirectSet with the specified initial capacity and the default load factor (0.75).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

IndirectList_Class

public static final java.lang.Class IndirectList_Class

Class implementing IndirectList.

IndirectSet_Class

public static final java.lang.Class IndirectSet_Class

Class implementing IndirectSet.

IndirectMap_Class

public static final java.lang.Class IndirectMap_Class

Class implementing IndirectMap.

Constructor Detail

IndirectCollectionsFactory

public IndirectCollectionsFactory()

Method Detail

createIndirectList

public static <E> IndirectList<E> createIndirectList()

Construct an empty IndirectList with the default initial capacity (10) and default capacity increment (0).

Type Parameters:

E - the class of the objects in the list

Returns:

an empty IndirectList with the default initial capacity and default capacity increment

createIndirectList

public static <E> IndirectList<E> createIndirectList(int initialCapacity)

Construct an empty IndirectList with the specified initial capacity and default capacity increment (0).

Type Parameters:

E - the class of the objects in the list

Parameters:

initialCapacity - the initial capacity of the vector

Returns:

an empty IndirectList with the specified initial capacity and default capacity increment

Throws:

java.lang.IllegalArgumentException - if the specified initial capacity is negative

createIndirectList

public static <E> IndirectList<E> createIndirectList(java.util.Collection<? extends E> collection)

Construct an IndirectList containing the elements of the specified collection, in the order they are returned by the collection's iterator.

Type Parameters:

E - the class of the objects in the list

Parameters:

collection - a collection containing the elements to construct the IndirectList with.

Returns:

an IndirectList containing the elements of the specified collection

createIndirectSet

public static <E> IndirectSet<E> createIndirectSet()

Construct an empty IndirectSet with the default initial capacity (10) and the default load factor (0.75).

Returns:

an empty IndirectSet with the default initial capacity and the default load factor

createIndirectSet

public static <E> IndirectSet<E> createIndirectSet(int initialCapacity)

Construct an empty IndirectSet with the specified initial capacity and the default load factor (0.75).

Parameters:

initialCapacity - the initial capacity of the set

Returns:

an empty IndirectSet with the specified initial capacity and the default load factor

Throws:

java.lang.IllegalArgumentException - if the specified initial capacity is negative

createIndirectSet

public static <E> IndirectSet<E> createIndirectSet(java.util.Collection<? extends E> collection)

Constructs an IndirectSet containing the elements of the specified collection.

Parameters:

collection - a collection containing the elements to construct the IndirectSet with

Returns:

an IndirectSet containing the elements of the specified collection

Throws:

java.lang.NullPointerException - if the specified collection is null

createIndirectMap

public static <K,V> IndirectMap<K,V> createIndirectMap()

Construct a new, empty IndirectMap with the default initial capacity (11) and the default load factor (0.75).

Returns:

a new, empty IndirectMap with the default initial capacity and the default load factor

createIndirectMap

public static <K,V> IndirectMap<K,V> createIndirectMap(int initialCapacity)

Construct a new, empty IndirectMap with the specified initial capacity and the default load factor (0.75).

Parameters:

initialCapacity - the initial capacity of the IndirectMap

Returns:

a new, empty IndirectMap with the specified initial capacity and the default load factor

Throws:

java.lang.IllegalArgumentException - if the initial capacity is less than or equal to zero

createIndirectMap

public static <K,V> IndirectMap<K,V> createIndirectMap(java.util.Map<? extends K,? extends V> map)

Construct a new IndirectMap with the same mappings as the given Map. The IndirectMap is created with a capacity of twice the number of entries in the given Map or 11 (whichever is greater), and a default load factor, which is 0.75.

Parameters:

map - the map whose mappings are to be placed into created IndirectMap

Returns:

a new IndirectMap with the same mappings as the given Map

Throws:

java.lang.NullPointerException - if the specified map is null