ome.tools.hibernate

Class ExtendedMetadata.Impl

java.lang.Object

ome.tools.spring.OnContextRefreshedEventListener

ome.tools.hibernate.ExtendedMetadata.Impl

All Implemented Interfaces:

EventListener, ExtendedMetadata, ApplicationContextAware, ApplicationListener<ContextRefreshedEvent>

Enclosing interface:

ExtendedMetadata

public static class ExtendedMetadata.Impl
extends OnContextRefreshedEventListener
implements ExtendedMetadata

Sole implementation of ExtendedMetadata. The separation is intended to make unit testing without a full ExtendedMetadata possible.

Nested Class Summary

Nested classes/interfaces inherited from interface ome.tools.hibernate.ExtendedMetadata

ExtendedMetadata.Immutables, ExtendedMetadata.Impl, ExtendedMetadata.Locks, ExtendedMetadata.Relationship

Constructor Summary

Constructors

Constructor and Description
Impl()

Method Summary

Modifier and Type	Method and Description
Map<String,Long>	countLocks(org.hibernate.Session session, Long id, String[][] checks, String clause) Takes the lock checks returned by ExtendedMetadata.getLockChecks(Class) and performs the actual check returning a map from class to total number of locks.
Set<Class<IAnnotated>>	getAnnotatableTypes() Returns all the classes which implement IAnnotated
Set<Class<Annotation>>	getAnnotationTypes() Returns all the classes which subclass Annotation
Set<String>	getClasses()
String	getCountQuery(String field) Returns the query for obtaining the number of collection items to a particular instance.
Class<IObject>	getHibernateClass(String table) Given the name of a database table or alternatively the simple class name (non-fully qualified) of an IObject, this method returns the class which Hibernate will map that table to.
String[]	getImmutableFields(Class<? extends IObject> klass)
String[][]	getLockCandidateChecks(Class<? extends IObject> k, boolean onlyWithGroups) Rather than iterating over an IObject like ExtendedMetadata.getLockCandidates(IObject) this method returns type/field name pairs (like ExtendedMetadata.getLockChecks(Class)) to allow performing the queries manually.
IObject[]	getLockCandidates(IObject iObject) walks the IObject argument non-recursively and gathers all IObject instances which will be linked to by the creation or updating of the argument.
String[][]	getLockChecks(Class<? extends IObject> klass) returns all class/field name pairs which may possibly link to an object of type klass.
Set<String>	getMapProperties(String className) Get the names of any String→RString map properties this class has, otherwise an empty set if none.
String	getRelationship(String from, String to) Walks the data on what locks what for "from" argument to see if there is any direct relationship to the "to" argument.
String	getSQLJoin(String fromType, String fromAlias, String toType, String toAlias) Note: this implementation does not yet take into account the mapping of joined subclasses like Job->UpdateJob.
Class<IObject>	getTargetType(String field) Returns the IObject type which a given field points to.
void	handleContextRefreshedEvent(ContextRefreshedEvent cre) Listener method which waits for a ContextRefreshedEvent and then extracts the SessionFactory from the ApplicationContext and pases it to setSessionFactory(SessionFactory).
boolean	mayHaveMapProperties(Class<? extends IObject> iObjectClass) Check if an object of this class may have map properties.
void	setSessionFactory(org.hibernate.SessionFactory sessionFactory) Initializes the metadata needed by this instance.

Methods inherited from class ome.tools.spring.OnContextRefreshedEventListener

onApplicationEvent, setApplicationContext

Methods inherited from class java.lang.Object

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

Constructor Detail

Impl

public Impl()

Method Detail

handleContextRefreshedEvent

public void handleContextRefreshedEvent(ContextRefreshedEvent cre)

Listener method which waits for a ContextRefreshedEvent and then extracts the SessionFactory from the ApplicationContext and pases it to setSessionFactory(SessionFactory).

Specified by:

handleContextRefreshedEvent in class OnContextRefreshedEventListener

setSessionFactory

public void setSessionFactory(org.hibernate.SessionFactory sessionFactory)

Initializes the metadata needed by this instance.

Parameters:

sessionFactory - the Hibernate session factory

See Also:

SessionFactory.getAllClassMetadata()

getClasses

public Set<String> getClasses()

Specified by:

getClasses in interface ExtendedMetadata

getHibernateClass

public Class<IObject> getHibernateClass(String table)

Description copied from interface: ExtendedMetadata

Given the name of a database table or alternatively the simple class name (non-fully qualified) of an IObject, this method returns the class which Hibernate will map that table to.

Specified by:

getHibernateClass in interface ExtendedMetadata

Parameters:

table - a database table name, or simple class name of a model object

Returns:

the corresponding mapped class

getRelationship

public String getRelationship(String from,
                              String to)

Walks the data on what locks what for "from" argument to see if there is any direct relationship to the "to" argument. If there is, the name will be returned. Otherwise, null.

Specified by:

getRelationship in interface ExtendedMetadata

getSQLJoin

public String getSQLJoin(String fromType,
                         String fromAlias,
                         String toType,
                         String toAlias)

Note: this implementation does not yet take into account the mapping of joined subclasses like Job->UpdateJob.

Specified by:

getSQLJoin in interface ExtendedMetadata

getAnnotatableTypes

public Set<Class<IAnnotated>> getAnnotatableTypes()

Description copied from interface: ExtendedMetadata

Returns all the classes which implement IAnnotated

Specified by:

getAnnotatableTypes in interface ExtendedMetadata

Returns:

the annotatable types

getAnnotationTypes

public Set<Class<Annotation>> getAnnotationTypes()

Description copied from interface: ExtendedMetadata

Returns all the classes which subclass Annotation

Specified by:

getAnnotationTypes in interface ExtendedMetadata

Returns:

the types of annotation

getLockCandidates

public IObject[] getLockCandidates(IObject iObject)

walks the IObject argument non-recursively and gathers all IObject instances which will be linked to by the creation or updating of the argument. (Previously this was called "locking" since a flag was set on the object to mark it as linked, but this was removed in 4.2)

Specified by:

getLockCandidates in interface ExtendedMetadata

Parameters:

iObject - A newly created or updated IObject instance which might possibly lock other IObjects. A null argument will return an empty array to be checked.

Returns:

A non-null array of IObjects which will be linked to.

getLockCandidateChecks

public String[][] getLockCandidateChecks(Class<? extends IObject> k,
                                         boolean onlyWithGroups)

Description copied from interface: ExtendedMetadata

Rather than iterating over an IObject like ExtendedMetadata.getLockCandidates(IObject) this method returns type/field name pairs (like ExtendedMetadata.getLockChecks(Class)) to allow performing the queries manually. If onlyWithGroups is true, then only checks which point to non-IGlobal objects will be returned.

Specified by:

getLockCandidateChecks in interface ExtendedMetadata

Parameters:

k - Not null.

onlyWithGroups - if should omit checks that point to IGlobals

Returns:

the lock candidates for checking

getLockChecks

public String[][] getLockChecks(Class<? extends IObject> klass)

returns all class/field name pairs which may possibly link to an object of type klass.

Specified by:

getLockChecks in interface ExtendedMetadata

Parameters:

klass - Non-null subclass of IObject

Returns:

A non-null array of String queries which can be used to determine if an IObject instance can be unlocked.

countLocks

public Map<String,Long> countLocks(org.hibernate.Session session,
                                   Long id,
                                   String[][] checks,
                                   String clause)

Description copied from interface: ExtendedMetadata

Takes the lock checks returned by ExtendedMetadata.getLockChecks(Class) and performs the actual check returning a map from class to total number of locks. The key "*" contains the total value. If the id argument is null, then checks will be against all rows rather than individual objects, e.g.

 select count(x) from Linker x, Linked y where x.$FIELD.id = y.id $CLAUSE;
 

otherwise

 select count(x) from Linker x where x.$FIELD.id = :id $CLAUSE'
 

If the clause argument is null or empty it will be omitted.

Specified by:

countLocks in interface ExtendedMetadata

getImmutableFields

public String[] getImmutableFields(Class<? extends IObject> klass)

getCountQuery

public String getCountQuery(String field)
                     throws ApiUsageException

Returns the query for obtaining the number of collection items to a particular instance. All such queries will return a ResultSet with rows of the form: 0 (Long) id of the locked class 1 (Long) count of the instances locking that class

Specified by:

getCountQuery in interface ExtendedMetadata

Parameters:

field - Field name as specified in the class.

Returns:

String query. Never null.

Throws:

ApiUsageException - if return value would be null.

getTargetType

public Class<IObject> getTargetType(String field)
                             throws ApiUsageException

Returns the IObject type which a given field points to. E.g. getTargetType(ImageAnnotation.IMAGE) returns Image.class.

Throws:

ApiUsageException

mayHaveMapProperties

public boolean mayHaveMapProperties(Class<? extends IObject> iObjectClass)

Description copied from interface: ExtendedMetadata

Check if an object of this class may have map properties.

Specified by:

mayHaveMapProperties in interface ExtendedMetadata

Parameters:

iObjectClass - a class

Returns:

if this object or any of its mapped subclasses have any map properties

getMapProperties

public Set<String> getMapProperties(String className)

Description copied from interface: ExtendedMetadata

Get the names of any String→RString map properties this class has, otherwise an empty set if none.

Specified by:

getMapProperties in interface ExtendedMetadata

Parameters:

className - the name of a class, as from Class.getName()

Returns:

the class' map property names