ExtendedMetadata.Impl (OMERO API)

java.lang.Object
- ome.tools.spring.OnContextRefreshedEventListener
- - ome.tools.hibernate.ExtendedMetadata.Impl

All Implemented Interfaces:

EventListener, ExtendedMetadata, org.springframework.context.ApplicationContextAware, org.springframework.context.ApplicationListener<org.springframework.context.event.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()

Constructors
Constructor and Description
`Impl()`

Method Summary

All Methods Instance Methods Concrete Methods
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(org.springframework.context.event.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(org.springframework.context.event.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

Class ExtendedMetadata.Impl

Nested Class Summary

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

Constructor Summary

Method Summary

Methods inherited from class ome.tools.spring.OnContextRefreshedEventListener

Methods inherited from class java.lang.Object

Constructor Detail

Impl

Method Detail

handleContextRefreshedEvent

setSessionFactory

getClasses

getHibernateClass

getRelationship

getSQLJoin

getAnnotatableTypes

getAnnotationTypes

getLockCandidates

getLockCandidateChecks

getLockChecks

countLocks

getImmutableFields

getCountQuery

getTargetType

mayHaveMapProperties

getMapProperties