com.helger.jaxb

Class JAXBContextCache

java.lang.Object

com.helger.commons.cache.Cache<JAXBContextCacheKey,JAXBContext>

com.helger.jaxb.JAXBContextCache

All Implemented Interfaces:

com.helger.commons.cache.ICache<JAXBContextCacheKey,JAXBContext>, com.helger.commons.cache.IMutableCache<JAXBContextCacheKey,JAXBContext>, com.helger.commons.lang.IHasSize, com.helger.commons.name.IHasName

@ThreadSafe
 @Singleton
public final class JAXBContextCache
extends com.helger.commons.cache.Cache<JAXBContextCacheKey,JAXBContext>

Specific cache class for JAXB context elements. This is helpful, as the JAXB context creation is a very time consuming task.

Author:

Philip Helger

Field Summary

Fields inherited from class com.helger.commons.cache.Cache

m_aRWLock, STATISTICS_PREFIX

Method Summary

Modifier and Type	Method and Description
JAXBContext	getFromCache(Class<?> aClass) Get the JAXBContext from an existing Class object.
JAXBContext	getFromCache(Class<?> aClass, ClassLoader aClassLoader) Get the JAXBContext from an existing Class object.
JAXBContext	getFromCache(Package aPackage) Special overload with package and default ClassLoader.
JAXBContext	getFromCache(Package aPackage, ClassLoader aClassLoader) Special overload with package and ClassLoader.
static JAXBContextCache	getInstance()
static boolean	isInstantiated()
com.helger.commons.state.EChange	removeFromCache(Package aPackage)

Methods inherited from class com.helger.commons.cache.Cache

clearCache, createCache, getFromCache, getFromCacheNoStats, getFromCacheNoStatsNotLocked, getMaxSize, getName, hasMaxSize, isEmpty, isNotEmpty, putInCache, putInCacheNotLocked, removeFromCache, size, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.helger.commons.name.IHasName

getComparatorCollating, getComparatorName

Method Detail

isInstantiated

public static boolean isInstantiated()

getInstance

@Nonnull
public static JAXBContextCache getInstance()

getFromCache

@Nullable
public JAXBContext getFromCache(@Nonnull
                                           Package aPackage)

Special overload with package and default ClassLoader.

Parameters:

aPackage - Package to load. May not be null.

Returns:

null if package is null.

getFromCache

@Nullable
public JAXBContext getFromCache(@Nonnull
                                           Package aPackage,
                                           @Nullable
                                           ClassLoader aClassLoader)

Special overload with package and ClassLoader. In this case the resulting value is NOT cached!

Parameters:

aPackage - Package to load. May not be null.

aClassLoader - Class loader to use. May be null in which case the default class loader is used.

Returns:

null if package is null.

getFromCache

@Nullable
public JAXBContext getFromCache(@Nonnull
                                           Class<?> aClass)

Get the JAXBContext from an existing Class object. If the class's owning package is a valid JAXB package, this method redirects to getFromCache(Package) otherwise a new JAXB context is created and NOT cached.

Parameters:

aClass - The class for which the JAXB context is to be created. May not be null.

Returns:

May be null.

getFromCache

@Nullable
public JAXBContext getFromCache(@Nonnull
                                           Class<?> aClass,
                                           @Nullable
                                           ClassLoader aClassLoader)

Get the JAXBContext from an existing Class object. If the class's owning package is a valid JAXB package, this method redirects to getFromCache(Package) otherwise a new JAXB context is created and NOT cached.

Parameters:

aClass - The class for which the JAXB context is to be created. May not be null.

aClassLoader - Class loader to use. May be null in which case the default class loader is used.

Returns:

May be null.

removeFromCache

@Nonnull
public com.helger.commons.state.EChange removeFromCache(@Nonnull
                                                                  Package aPackage)