org.tangram.mutable

Class AbstractMutableBeanFactory

java.lang.Object

org.tangram.content.AbstractBeanFactory

org.tangram.mutable.AbstractMutableBeanFactory

All Implemented Interfaces:

org.tangram.content.BeanFactory, MutableBeanFactory

public abstract class AbstractMutableBeanFactory
extends org.tangram.content.AbstractBeanFactory
implements MutableBeanFactory

Common stuff for all bean factories dealing with mutable content.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Map<java.lang.String,org.tangram.content.Content>	cache
protected java.util.Map<java.lang.Class<? extends org.tangram.content.Content>,java.util.List<java.lang.Class<? extends org.tangram.content.Content>>>	implementingClassesMap mapping from classes or interfaces to non abstract classes implementing them
protected java.util.List<java.lang.Class<? extends org.tangram.content.Content>>	modelClasses
protected static java.lang.String	QUERY_CACHE_KEY
protected java.util.Map<java.lang.String,java.util.List<java.lang.String>>	queryCache
protected org.tangram.PersistentRestartCache	startupCache
protected org.tangram.monitor.Statistics	statistics
protected java.util.Map<java.lang.String,java.lang.Class<? extends org.tangram.content.Content>>	tableNameMapping

Constructor Summary

Constructors

Constructor and Description
AbstractMutableBeanFactory()

Method Summary

Methods

Modifier and Type	Method and Description
void	addListener(java.lang.Class<? extends org.tangram.content.Content> cls, org.tangram.content.BeanListener listener) attach a listener for any changes dealing with classes of the given type.
protected abstract <T extends org.tangram.content.Content> void	apiDelete(T bean) Wrap API specific deletion call.
protected abstract <T extends org.tangram.content.Content> void	apiPersist(T bean) Wrap API specific persistence call.
void	clearCacheFor(java.lang.Class<? extends org.tangram.content.Content> cls) clear caches for instances depending on the given type.
<T extends org.tangram.content.Content> T	createBean(java.lang.Class<T> cls) remember that the newly created bean has to be persisted in the now open transaction!
<T extends org.tangram.content.Content> boolean	delete(T bean) Delete a given bean from persistence storage.
protected <T extends org.tangram.content.Content> void	filterExactClass(java.lang.Class<T> cls, java.util.List<? extends java.lang.Object> rawList, java.util.List<T> filteredList) Filter a list of objects for instances of a given class.
java.util.Set<java.lang.String>	getBasePackages()
<T extends org.tangram.content.Content> T	getBean(java.lang.Class<T> cls, java.lang.String id)
protected abstract <T extends org.tangram.content.Content> T	getBean(java.lang.Class<T> cls, java.lang.String kind, java.lang.String internalId)
java.util.Collection<java.lang.Class<? extends org.tangram.content.Content>>	getClasses() return a collection of all content classes available for mutable contents.
protected <T extends org.tangram.content.Content> java.lang.Class<T>	getClassForName(java.lang.String className) Gets the class for a given type name.
protected java.lang.String	getClassNamesCacheKey() Cache key for the persistent cache to store all class names.
<T extends org.tangram.content.Content> java.util.List<java.lang.Class<T>>	getImplementingClasses(java.lang.Class<T> baseClass) Get the classes implementing a given baseClass.
protected java.util.List<java.lang.Class<? extends org.tangram.content.Content>>	getImplementingClassesForModelClass(java.lang.Class<? extends org.tangram.content.Content> baseClass)
java.util.Map<java.lang.Class<? extends org.tangram.content.Content>,java.util.List<java.lang.Class<? extends org.tangram.content.Content>>>	getImplementingClassesMap() just to support JSP's weak calling of methods.
protected <T extends org.tangram.content.Content> java.lang.Class<T>	getKeyClass(java.lang.String key) Get class name from query cache key.
protected java.util.Map<java.lang.Class<? extends org.tangram.content.Content>,java.util.List<org.tangram.content.BeanListener>>	getListeners()
protected abstract boolean	hasManager() Check if the underlying API implementation of the bean factory really has the needed managing instance of some sort at hand.
boolean	isActivateCaching()
boolean	isActivateQueryCaching()
<T extends org.tangram.content.Content> java.util.List<T>	listBeans(java.lang.Class<T> cls, java.lang.String queryString, java.lang.String orderProperty, java.lang.Boolean ascending)
<T extends org.tangram.content.Content> boolean	persist(T bean) Persist a given bean.
<T extends org.tangram.content.Content> boolean	persistUncommitted(T bean) Persist a given bean and don't close the open transaction.
void	setActivateCaching(boolean activateCaching)
void	setActivateQueryCaching(boolean activateQueryCaching)
void	setBasePackages(java.util.Set<java.lang.String> basePackages)

Methods inherited from class org.tangram.content.AbstractBeanFactory

convert, listBeans, listBeans, listBeans, listBeansOfExactClass

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.tangram.mutable.MutableBeanFactory

beginTransaction, commitTransaction, getAllClasses, getBaseClass, getManager, rollbackTransaction

Methods inherited from interface org.tangram.content.BeanFactory

getBean, listBeans, listBeans, listBeans, listBeansOfExactClass, listBeansOfExactClass

Field Detail

QUERY_CACHE_KEY

protected static final java.lang.String QUERY_CACHE_KEY

See Also:

Constant Field Values

statistics

@Inject
protected org.tangram.monitor.Statistics statistics

startupCache

@Inject
protected org.tangram.PersistentRestartCache startupCache

implementingClassesMap

protected java.util.Map<java.lang.Class<? extends org.tangram.content.Content>,java.util.List<java.lang.Class<? extends org.tangram.content.Content>>> implementingClassesMap

mapping from classes or interfaces to non abstract classes implementing them

modelClasses

protected java.util.List<java.lang.Class<? extends org.tangram.content.Content>> modelClasses

tableNameMapping

protected java.util.Map<java.lang.String,java.lang.Class<? extends org.tangram.content.Content>> tableNameMapping

cache

protected java.util.Map<java.lang.String,org.tangram.content.Content> cache

queryCache

protected java.util.Map<java.lang.String,java.util.List<java.lang.String>> queryCache

Constructor Detail

AbstractMutableBeanFactory

public AbstractMutableBeanFactory()

Method Detail

getBasePackages

public java.util.Set<java.lang.String> getBasePackages()

setBasePackages

public void setBasePackages(java.util.Set<java.lang.String> basePackages)

isActivateCaching

public boolean isActivateCaching()

setActivateCaching

public void setActivateCaching(boolean activateCaching)

isActivateQueryCaching

public boolean isActivateQueryCaching()

setActivateQueryCaching

public void setActivateQueryCaching(boolean activateQueryCaching)

getListeners

protected java.util.Map<java.lang.Class<? extends org.tangram.content.Content>,java.util.List<org.tangram.content.BeanListener>> getListeners()

hasManager

protected abstract boolean hasManager()

Check if the underlying API implementation of the bean factory really has the needed managing instance of some sort at hand. common case to check for persisting and deleting instanced though highly API specific in detail.

apiPersist

protected abstract <T extends org.tangram.content.Content> void apiPersist(T bean)

Wrap API specific persistence call. Higher level methods in this class in turn deal with exception and cachce handling.

Type Parameters:

T -

Parameters:

bean -

apiDelete

protected abstract <T extends org.tangram.content.Content> void apiDelete(T bean)

Wrap API specific deletion call. Higher level methods in this class in turn deal with exception and cachce handling.

Type Parameters:

T -

Parameters:

bean -

createBean

public <T extends org.tangram.content.Content> T createBean(java.lang.Class<T> cls)
                                                 throws java.lang.InstantiationException,
                                                        java.lang.IllegalAccessException

remember that the newly created bean has to be persisted in the now open transaction!

Specified by:

createBean in interface MutableBeanFactory

Type Parameters:

T - type of bean to create

Parameters:

cls - instance of that type

Returns:

newly created instance

Throws:

java.lang.IllegalAccessException

java.lang.InstantiationException

getClassNamesCacheKey

protected java.lang.String getClassNamesCacheKey()

Cache key for the persistent cache to store all class names. The stored values are taken from the class path package scan and asumed to be persistent over re-starts of the applicaion.

Returns:

String to be used as a cache key

persistUncommitted

public <T extends org.tangram.content.Content> boolean persistUncommitted(T bean)

Description copied from interface: MutableBeanFactory

Persist a given bean and don't close the open transaction.

Specified by:

persistUncommitted in interface MutableBeanFactory

Returns:

true if persisting could be completed successfully

delete

public <T extends org.tangram.content.Content> boolean delete(T bean)

Description copied from interface: MutableBeanFactory

Delete a given bean from persistence storage. This method uses a transaction and closes it or does a roll back.

Specified by:

delete in interface MutableBeanFactory

Returns:

true if deleting could be completed successfully

persist

public <T extends org.tangram.content.Content> boolean persist(T bean)

Description copied from interface: MutableBeanFactory

Persist a given bean.

Specified by:

persist in interface MutableBeanFactory

Returns:

true if persisting could be completed successfully

getClassForName

protected <T extends org.tangram.content.Content> java.lang.Class<T> getClassForName(java.lang.String className)

Gets the class for a given type name. Be aware of different class loaders - like with groovy based classes.

Type Parameters:

T - content sub class described by given class name

Parameters:

className - fully qualified name of the class

Returns:

resulting class or null if not possible (should never happen...)

getKeyClass

protected <T extends org.tangram.content.Content> java.lang.Class<T> getKeyClass(java.lang.String key)

Get class name from query cache key. Keys are supposed to be in the form of :

Type Parameters:

T -

Parameters:

key -

Returns:

Class for the given key or null if the key does not map to any class

clearCacheFor

public void clearCacheFor(java.lang.Class<? extends org.tangram.content.Content> cls)

Description copied from interface: MutableBeanFactory

clear caches for instances depending on the given type. Never dare to issue changes for abstract classes or interfaces! (You cannot have instances of those types anyway) The calll is only relevant for the attached listeners.

Specified by:

clearCacheFor in interface MutableBeanFactory

addListener

public void addListener(java.lang.Class<? extends org.tangram.content.Content> cls,
               org.tangram.content.BeanListener listener)

attach a listener for any changes dealing with classes of the given type.

Specified by:

addListener in interface org.tangram.content.BeanFactory

Parameters:

cls -

listener -

filterExactClass

protected <T extends org.tangram.content.Content> void filterExactClass(java.lang.Class<T> cls,
                                                            java.util.List<? extends java.lang.Object> rawList,
                                                            java.util.List<T> filteredList)

Filter a list of objects for instances of a given class. No instances of subclasses are inserted into the filtered result.

Type Parameters:

T -

Parameters:

cls - type to filter for

rawList -

filteredList -

getBean

protected abstract <T extends org.tangram.content.Content> T getBean(java.lang.Class<T> cls,
                                                java.lang.String kind,
                                                java.lang.String internalId)
                                                          throws java.lang.Exception

Throws:

java.lang.Exception

getBean

public <T extends org.tangram.content.Content> T getBean(java.lang.Class<T> cls,
                                                java.lang.String id)

Specified by:

getBean in interface org.tangram.content.BeanFactory

getImplementingClassesForModelClass

protected java.util.List<java.lang.Class<? extends org.tangram.content.Content>> getImplementingClassesForModelClass(java.lang.Class<? extends org.tangram.content.Content> baseClass)

getImplementingClassesMap

public java.util.Map<java.lang.Class<? extends org.tangram.content.Content>,java.util.List<java.lang.Class<? extends org.tangram.content.Content>>> getImplementingClassesMap()

just to support JSP's weak calling of methods. It does not allow any parameters.

Specified by:

getImplementingClassesMap in interface MutableBeanFactory

Returns:

map to map abstract classes to all non-abstract classes implementing/extending them

getImplementingClasses

public <T extends org.tangram.content.Content> java.util.List<java.lang.Class<T>> getImplementingClasses(java.lang.Class<T> baseClass)

Get the classes implementing a given baseClass.

Specified by:

getImplementingClasses in interface MutableBeanFactory

Type Parameters:

T -

Parameters:

baseClass -

Returns:

list of non-abstract classes that can be assigned to the given base class

listBeans

public <T extends org.tangram.content.Content> java.util.List<T> listBeans(java.lang.Class<T> cls,
                                                                  java.lang.String queryString,
                                                                  java.lang.String orderProperty,
                                                                  java.lang.Boolean ascending)

Specified by:

listBeans in interface org.tangram.content.BeanFactory

getClasses

public java.util.Collection<java.lang.Class<? extends org.tangram.content.Content>> getClasses()

Description copied from interface: MutableBeanFactory

return a collection of all content classes available for mutable contents. No abstract classes will be in the returned collection.

Specified by:

getClasses in interface MutableBeanFactory

Returns:

collection of content classes