org.apache.ws.commons.schema.utils

Class CollectionFactory

java.lang.Object

org.apache.ws.commons.schema.utils.CollectionFactory

public final class CollectionFactory
extends java.lang.Object

There are many collections of XML Schema objects inside XmlSchema. This class provides consistent construction to centralize policy for thread synchronization and the like.

Field Summary

Fields

Modifier and Type	Field and Description
private static boolean	DEFAULT_PROTECT_READ_ONLY_COLLECTIONS
private static java.lang.ThreadLocal<java.lang.Boolean>	PROTECT_READ_ONLY_COLLECTIONS
private static java.lang.String	PROTECT_READ_ONLY_COLLECTIONS_PROP

Constructor Summary

Constructors

Modifier	Constructor and Description
private	CollectionFactory()

Method Summary

Modifier and Type	Method and Description
static void	clearProtection()
static <T> java.util.List<T>	getList(java.lang.Class<T> type)
static <T> java.util.List<T>	getProtectedList(java.util.List<T> list) Call this to obtain a list to return from a public API where the caller is not supposed to modify the list.
static <K,V> java.util.Map<K,V>	getProtectedMap(java.util.Map<K,V> map) Call this to obtain a map to return from a public API where the caller is not supposed to modify the map.
static <T> java.util.Set<T>	getSet(java.lang.Class<T> type)
private static boolean	isProtected()
static void	setProtected(boolean b) Turns on or off protection of collections for this thread.
static void	withSchemaModifiable(java.lang.Runnable action)

Methods inherited from class java.lang.Object

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

Field Detail

PROTECT_READ_ONLY_COLLECTIONS_PROP

private static final java.lang.String PROTECT_READ_ONLY_COLLECTIONS_PROP

See Also:

Constant Field Values

DEFAULT_PROTECT_READ_ONLY_COLLECTIONS

private static final boolean DEFAULT_PROTECT_READ_ONLY_COLLECTIONS

PROTECT_READ_ONLY_COLLECTIONS

private static final java.lang.ThreadLocal<java.lang.Boolean> PROTECT_READ_ONLY_COLLECTIONS

Constructor Detail

CollectionFactory

private CollectionFactory()

Method Detail

getList

public static <T> java.util.List<T> getList(java.lang.Class<T> type)

getSet

public static <T> java.util.Set<T> getSet(java.lang.Class<T> type)

isProtected

private static boolean isProtected()

setProtected

public static void setProtected(boolean b)

Turns on or off protection of collections for this thread. Note that this sets a thread local. If you want to return the thread to default state, use the clearProtection method.

Parameters:

b -

clearProtection

public static void clearProtection()

getProtectedList

public static <T> java.util.List<T> getProtectedList(java.util.List<T> list)

Call this to obtain a list to return from a public API where the caller is not supposed to modify the list. If org.apache.ws.commons.schema.protectReadOnlyCollections is 'true', this will return a list that checks at runtime.

Type Parameters:

T - Generic parameter type of the list.

Parameters:

list - the list.

Returns:

getProtectedMap

public static <K,V> java.util.Map<K,V> getProtectedMap(java.util.Map<K,V> map)

Call this to obtain a map to return from a public API where the caller is not supposed to modify the map. If org.apache.ws.commons.schema.protectReadOnlyCollections is 'true', this will return a map that checks at runtime.

Type Parameters:

K - key type

V - value type

Parameters:

map - the map.

Returns:

withSchemaModifiable

public static void withSchemaModifiable(java.lang.Runnable action)