GormEnhancer (Grace Data

org.grails.datastore.gorm.GormEnhancer

All Implemented Interfaces and Traits:

Closeable
```
@Slf4j
@CompileStatic
class GormEnhancer
extends Object
implements Closeable
```
Enhances a class with GORM behavior
Authors:
Graeme Rocher

Nested Class Summary

Nested classes
Modifiers	Name	Description
`class`	`GormEnhancer.1`

Properties Summary

Properties
Type	Name and description
`Datastore`	`datastore`
`boolean`	`dynamicEnhance` Whether to enhance classes dynamically using meta programming as well, only necessary for Java classes
`boolean`	`failOnError`
`List<FinderMethod>`	`finders`
`boolean`	`includeExternal` Whether to include external entities
`boolean`	`markDirty`
`org.springframework.transaction.PlatformTransactionManager`	`transactionManager`

Constructor Summary

Constructors
Constructor and description
`GormEnhancer(Datastore datastore)`
`GormEnhancer(Datastore datastore, org.springframework.transaction.PlatformTransactionManager transactionManager, boolean failOnError, boolean dynamicEnhance, boolean markDirty)`
`GormEnhancer(Datastore datastore, org.springframework.transaction.PlatformTransactionManager transactionManager, ConnectionSourceSettings settings)` Construct a new GormEnhancer for the given arguments

Methods Summary

Methods
Type Params	Return Type	Name and description
	`protected void`	`addInstanceMethods(PersistentEntity e, boolean onlyExtendedMethods)`
	`protected void`	`addStaticMethods(PersistentEntity e, boolean onlyExtendedMethods)`
	`List<String>`	`allQualifiers(Datastore datastore, PersistentEntity entity)` Obtain all of the qualifiers (typically the connection names) for the datastore and entity
	`protected boolean`	`appliesToDatastore(Datastore datastore, PersistentEntity entity)`
	`void`	`close()` Closes the enhancer clearing any stored static state
	`protected List<FinderMethod>`	`createDynamicFinders()`
	`protected List<FinderMethod>`	`createDynamicFinders(Datastore targetDatastore)`
	`static GormQueryOperations`	`createNamedQuery(Class entity, String queryName)` Finds a named query for the given entity
	`static GormQueryOperations`	`createNamedQuery(Class entity, String queryName, Object[] args)` Finds a named query for the given entity
	`protected static boolean`	`doesRealMethodExist(MetaClass mc, String methodName, Class[] parameterTypes, boolean staticScope)`
	`void`	`enhance(boolean onlyExtendedMethods)` Enhances all persistent entities.
	`void`	`enhance(PersistentEntity e, boolean onlyExtendedMethods)` Enhance and individual entity
	`static Datastore`	`findDatastore(Class entity, String qualifier)` Find a datastore for the give entity type and qualifier (the connection name)
	`static Datastore`	`findDatastoreByType(Class<? extends Datastore> datastoreType)` Finds a datastore by type
	`static PersistentEntity`	`findEntity(Class entity, String qualifier)` Find the entity for the given type
`<D>`	`static GormInstanceApi<D>`	`findInstanceApi(Class<D> entity, String qualifier)` Find an instance API for the give entity type and qualifier (the connection name)
	`static GormQueryOperations`	`findNamedQuery(Class entity, String queryName)` deprecated: Use #createNamedQuery(entity, queryName) instead
	`static Datastore`	`findSingleDatastore()` Finds a single datastore
	`static org.springframework.transaction.PlatformTransactionManager`	`findSingleTransactionManager(String connectionName)` Finds a single available transaction manager
`<D>`	`static GormStaticApi<D>`	`findStaticApi(Class<D> entity, String qualifier)` Find a static API for the give entity type and qualifier (the connection name)
	`protected static String`	`findTenantId(Class entity)` Find the tenant id for the given entity
	`static org.springframework.transaction.PlatformTransactionManager`	`findTransactionManager(Class<? extends Datastore> datastoreType, String connectionName)` Finds a single available transaction manager
`<D>`	`static GormValidationApi<D>`	`findValidationApi(Class<D> entity, String qualifier)` Find a validation API for the give entity type and qualifier (the connection name)
	`List<FinderMethod>`	`getFinders()`
`<D>`	`protected GormInstanceApi<D>`	`getInstanceApi(Class<D> cls, String qualifier)`
`<D>`	`protected List<AbstractGormApi<D>>`	`getInstanceMethodApiProviders(Class<D> cls)`
`<D>`	`protected GormStaticApi<D>`	`getStaticApi(Class<D> cls, String qualifier)`
`<D>`	`protected GormValidationApi<D>`	`getValidationApi(Class<D> cls, String qualifier)`
	`protected static boolean`	`isRealMethod(MetaMethod existingMethod)`
	`protected void`	`registerConstraints(Datastore datastore)`
	`void`	`registerEntity(PersistentEntity entity)` Registers a new entity with the GORM enhancer
	`protected Object`	`registerInstanceMethod(Class cls, ExpandoMetaClass mc, AbstractGormApi apiProvider, String methodName, Class[] parameterTypes)`
	`protected void`	`registerStaticMethod(ExpandoMetaClass mc, String methodName, Class<?>[] parameterTypes, GormStaticApi staticApiProvider)`

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class Object`	`equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- Property Detail
  - final Datastore datastore
  - final boolean dynamicEnhance
    
    Whether to enhance classes dynamically using meta programming as well, only necessary for Java classes
  - boolean failOnError
  - List<FinderMethod> finders
  - boolean includeExternal
    
    Whether to include external entities
  - boolean markDirty
  - org.springframework.transaction.PlatformTransactionManager transactionManager
- Constructor Detail
  - GormEnhancer(Datastore datastore)
  - GormEnhancer(Datastore datastore, org.springframework.transaction.PlatformTransactionManager transactionManager, boolean failOnError, boolean dynamicEnhance, boolean markDirty)
  - GormEnhancer(Datastore datastore, org.springframework.transaction.PlatformTransactionManager transactionManager, ConnectionSourceSettings settings)
    
    Construct a new GormEnhancer for the given arguments
    Parameters:
    datastore - The datastore
    transactionManager - The transaction manager
    settings - The settings
- Method Detail
  - @CompileStatic
    protected void addInstanceMethods(PersistentEntity e, boolean onlyExtendedMethods)
  - @CompileStatic
    protected void addStaticMethods(PersistentEntity e, boolean onlyExtendedMethods)
  - List<String> allQualifiers(Datastore datastore, PersistentEntity entity)
    
    Obtain all of the qualifiers (typically the connection names) for the datastore and entity
    Parameters:
    datastore - The datastore
    entity - The entity
    Returns:
    The qualifiers
  - protected boolean appliesToDatastore(Datastore datastore, PersistentEntity entity)
  - @Override
    @CompileStatic
    void close()
    
    Closes the enhancer clearing any stored static state
    throws:
    IOException
  - @CompileStatic
    protected List<FinderMethod> createDynamicFinders()
  - @CompileStatic
    protected List<FinderMethod> createDynamicFinders(Datastore targetDatastore)
  - static GormQueryOperations createNamedQuery(Class entity, String queryName)
    
    Finds a named query for the given entity
    Parameters:
    entity - The entity name
    queryName - The query name
    Returns:
    The named query or null if it doesn't exist
  - static GormQueryOperations createNamedQuery(Class entity, String queryName, Object[] args)
    
    Finds a named query for the given entity
    Parameters:
    entity - The entity name
    queryName - The query name
    Returns:
    The named query or null if it doesn't exist
  - @CompileStatic
    protected static boolean doesRealMethodExist(MetaClass mc, String methodName, Class[] parameterTypes, boolean staticScope)
  - @CompileStatic
    void enhance(boolean onlyExtendedMethods)
    
    Enhances all persistent entities.
    Parameters:
    onlyExtendedMethods - If only to add additional methods provides by subclasses of the GORM APIs
  - @CompileStatic
    void enhance(PersistentEntity e, boolean onlyExtendedMethods)
    
    Enhance and individual entity
    Parameters:
    e - The entity
    onlyExtendedMethods - If only to add additional methods provides by subclasses of the GORM APIs
  - static Datastore findDatastore(Class entity, String qualifier)
    
    Find a datastore for the give entity type and qualifier (the connection name)
    throws:
    IllegalStateException if no datastore is found for the type
    
    Parameters:
    entity - The entity class
    qualifier - The qualifier
    Returns:
    A datastore
  - static Datastore findDatastoreByType(Class<? extends Datastore> datastoreType)
    
    Finds a datastore by type
    throws:
    IllegalStateException If no datastore is found for the type
    
    Parameters:
    datastoreType - The datastore type
    Returns:
    The datastore
  - static PersistentEntity findEntity(Class entity, String qualifier)
    
    Find the entity for the given type
    throws:
    IllegalStateException if no entity is found for the type
    
    Parameters:
    entity - The entity class
    qualifier - The qualifier
    Returns:
    A entity
  - <D> static GormInstanceApi<D> findInstanceApi(Class<D> entity, String qualifier)
    
    Find an instance API for the give entity type and qualifier (the connection name)
    throws:
    IllegalStateException if no instance API is found for the type
    
    Parameters:
    entity - The entity class
    qualifier - The qualifier
    Returns:
    An instance API
  - @Deprecated
    static GormQueryOperations findNamedQuery(Class entity, String queryName)
    
    deprecated:
    Use #createNamedQuery(entity, queryName) instead
  - static Datastore findSingleDatastore()
    
    Finds a single datastore
    throws:
    IllegalStateException If no datastore is found or more than one is configured
  - static org.springframework.transaction.PlatformTransactionManager findSingleTransactionManager(String connectionName)
    
    Finds a single available transaction manager
    throws:
    TransactionSystemException If the current implementation does not support transactions
    throws:
    IllegalStateException If no GORM implementation has been bootstrapped and configured
    
    Returns:
    The transaction manager
  - <D> static GormStaticApi<D> findStaticApi(Class<D> entity, String qualifier)
    
    Find a static API for the give entity type and qualifier (the connection name)
    throws:
    IllegalStateException if no static API is found for the type
    
    Parameters:
    entity - The entity class
    qualifier - The qualifier
    Returns:
    A static API
  - protected static String findTenantId(Class entity)
    
    Find the tenant id for the given entity @return
    Parameters:
    entity
  - static org.springframework.transaction.PlatformTransactionManager findTransactionManager(Class<? extends Datastore> datastoreType, String connectionName)
    
    Finds a single available transaction manager
    throws:
    TransactionSystemException If the current implementation does not support transactions
    throws:
    IllegalStateException If no GORM implementation has been bootstrapped and configured
    
    Returns:
    The transaction manager
  - <D> static GormValidationApi<D> findValidationApi(Class<D> entity, String qualifier)
    
    Find a validation API for the give entity type and qualifier (the connection name)
    throws:
    IllegalStateException if no validation API is found for the type
    
    Parameters:
    entity - The entity class
    qualifier - The qualifier
    Returns:
    A validation API
  - @CompileStatic
    List<FinderMethod> getFinders()
  - <D> @CompileStatic
    protected GormInstanceApi<D> getInstanceApi(Class<D> cls, String qualifier)
  - <D> @CompileDynamic
    protected List<AbstractGormApi<D>> getInstanceMethodApiProviders(Class<D> cls)
  - <D> @CompileStatic
    protected GormStaticApi<D> getStaticApi(Class<D> cls, String qualifier)
  - <D> @CompileStatic
    protected GormValidationApi<D> getValidationApi(Class<D> cls, String qualifier)
  - @CompileStatic
    protected static boolean isRealMethod(MetaMethod existingMethod)
  - protected void registerConstraints(Datastore datastore)
  - void registerEntity(PersistentEntity entity)
    
    Registers a new entity with the GORM enhancer
    Parameters:
    entity - The entity
  - protected Object registerInstanceMethod(Class cls, ExpandoMetaClass mc, AbstractGormApi apiProvider, String methodName, Class[] parameterTypes)
  - @CompileDynamic
    protected void registerStaticMethod(ExpandoMetaClass mc, String methodName, Class<?>[] parameterTypes, GormStaticApi staticApiProvider)

Summary:
Nested
Property
Constructor
Method

| Detail:
Property
Constructor
Method

Groovy Documentation

[Groovy] Class GormEnhancer

Nested Class Summary

Properties Summary

Constructor Summary

Methods Summary

Inherited Methods Summary

Property Detail

final Datastore datastore

final boolean dynamicEnhance

boolean failOnError

List<FinderMethod> finders

boolean includeExternal

boolean markDirty

org.springframework.transaction.PlatformTransactionManager transactionManager

Constructor Detail

GormEnhancer(Datastore datastore)

GormEnhancer(Datastore datastore, org.springframework.transaction.PlatformTransactionManager transactionManager, boolean failOnError, boolean dynamicEnhance, boolean markDirty)

GormEnhancer(Datastore datastore, org.springframework.transaction.PlatformTransactionManager transactionManager, ConnectionSourceSettings settings)

Method Detail

@CompileStaticprotected void addInstanceMethods(PersistentEntity e, boolean onlyExtendedMethods)

@CompileStaticprotected void addStaticMethods(PersistentEntity e, boolean onlyExtendedMethods)

List<String> allQualifiers(Datastore datastore, PersistentEntity entity)

protected boolean appliesToDatastore(Datastore datastore, PersistentEntity entity)

@Override@CompileStaticvoid close()

@CompileStaticprotected List<FinderMethod> createDynamicFinders()

@CompileStaticprotected List<FinderMethod> createDynamicFinders(Datastore targetDatastore)

static GormQueryOperations createNamedQuery(Class entity, String queryName)

static GormQueryOperations createNamedQuery(Class entity, String queryName, Object[] args)

@CompileStaticprotected static boolean doesRealMethodExist(MetaClass mc, String methodName, Class[] parameterTypes, boolean staticScope)

@CompileStaticvoid enhance(boolean onlyExtendedMethods)

@CompileStaticvoid enhance(PersistentEntity e, boolean onlyExtendedMethods)

static Datastore findDatastore(Class entity, String qualifier)

static Datastore findDatastoreByType(Class<? extends Datastore> datastoreType)

static PersistentEntity findEntity(Class entity, String qualifier)

<D> static GormInstanceApi<D> findInstanceApi(Class<D> entity, String qualifier)

@Deprecatedstatic GormQueryOperations findNamedQuery(Class entity, String queryName)

static Datastore findSingleDatastore()

static org.springframework.transaction.PlatformTransactionManager findSingleTransactionManager(String connectionName)

<D> static GormStaticApi<D> findStaticApi(Class<D> entity, String qualifier)

protected static String findTenantId(Class entity)

static org.springframework.transaction.PlatformTransactionManager findTransactionManager(Class<? extends Datastore> datastoreType, String connectionName)

<D> static GormValidationApi<D> findValidationApi(Class<D> entity, String qualifier)

@CompileStaticList<FinderMethod> getFinders()

<D> @CompileStaticprotected GormInstanceApi<D> getInstanceApi(Class<D> cls, String qualifier)

<D> @CompileDynamicprotected List<AbstractGormApi<D>> getInstanceMethodApiProviders(Class<D> cls)

<D> @CompileStaticprotected GormStaticApi<D> getStaticApi(Class<D> cls, String qualifier)

<D> @CompileStaticprotected GormValidationApi<D> getValidationApi(Class<D> cls, String qualifier)

@CompileStaticprotected static boolean isRealMethod(MetaMethod existingMethod)

protected void registerConstraints(Datastore datastore)

void registerEntity(PersistentEntity entity)

protected Object registerInstanceMethod(Class cls, ExpandoMetaClass mc, AbstractGormApi apiProvider, String methodName, Class[] parameterTypes)

@CompileDynamicprotected void registerStaticMethod(ExpandoMetaClass mc, String methodName, Class<?>[] parameterTypes, GormStaticApi staticApiProvider)

@CompileStatic
protected void addInstanceMethods(PersistentEntity e, boolean onlyExtendedMethods)

@CompileStatic
protected void addStaticMethods(PersistentEntity e, boolean onlyExtendedMethods)

@Override
@CompileStatic
void close()

@CompileStatic
protected List<FinderMethod> createDynamicFinders()

@CompileStatic
protected List<FinderMethod> createDynamicFinders(Datastore targetDatastore)

@CompileStatic
protected static boolean doesRealMethodExist(MetaClass mc, String methodName, Class[] parameterTypes, boolean staticScope)

@CompileStatic
void enhance(boolean onlyExtendedMethods)

@CompileStatic
void enhance(PersistentEntity e, boolean onlyExtendedMethods)

@Deprecated
static GormQueryOperations findNamedQuery(Class entity, String queryName)

@CompileStatic
List<FinderMethod> getFinders()

<D> @CompileStatic
protected GormInstanceApi<D> getInstanceApi(Class<D> cls, String qualifier)

<D> @CompileDynamic
protected List<AbstractGormApi<D>> getInstanceMethodApiProviders(Class<D> cls)

<D> @CompileStatic
protected GormStaticApi<D> getStaticApi(Class<D> cls, String qualifier)

<D> @CompileStatic
protected GormValidationApi<D> getValidationApi(Class<D> cls, String qualifier)

@CompileStatic
protected static boolean isRealMethod(MetaMethod existingMethod)

@CompileDynamic
protected void registerStaticMethod(ExpandoMetaClass mc, String methodName, Class<?>[] parameterTypes, GormStaticApi staticApiProvider)