Property Detail

• final java.util.Set<Datastore> allDatastores

• final GormApiResolver apiResolver

• final java.util.Map<java.lang.String, Datastore> datastoresByQualifier

• final java.util.Map<java.lang.Class, Datastore> datastoresByType

• final GormInstanceApiRegistry instanceApiRegistry

• final GormStaticApiRegistry staticApiRegistry

• final GormValidationApiRegistry validationApiRegistry

Constructor Detail

• GormRegistry()

Method Detail

• DatastoreResolver createClassDatastoreResolver(java.lang.Class cls, java.lang.String qualifier)

  Create a DatastoreResolver for a class and optional qualifier.

• java.util.List<FinderMethod> createDynamicFinders(Datastore targetDatastore)

  Creates dynamic finders for the default datastore

  Returns:

  List of finder methods

• java.util.List<FinderMethod> createDynamicFinders(DatastoreResolver resolver, MappingContext mappingContext)

  Creates dynamic finders using the given resolver and mapping context.

  Parameters:

  resolver - The datastore resolver

  mappingContext - The mapping context

  Returns:

  List of finder methods

• GormInstanceApi createInstanceApi(java.lang.Class cls, Datastore datastore, boolean failOnError, boolean markDirty)

  Create a GormInstanceApi instance. Uses a bound resolver (always returns the given datastore) at registration time so that tenant-resolving DatastoreResolvers are not invoked before any tenant context is active.

• GormStaticApi createStaticApi(java.lang.Class cls, Datastore datastore, java.lang.String qualifier)

  Create a GormStaticApi instance. Uses a bound resolver (always returns the given datastore) at registration time so that tenant-resolving DatastoreResolvers are not invoked before any tenant context is active.

• GormValidationApi createValidationApi(java.lang.Class cls, Datastore datastore)

  Create a GormValidationApi instance. Uses a bound resolver (always returns the given datastore) at registration time so that tenant-resolving DatastoreResolvers are not invoked before any tenant context is active.

• static Datastore findDatastore(java.lang.Class entity)

• static Datastore findDatastore(java.lang.Class entity, java.lang.String qualifier)

• <D> static GormInstanceApi<D> findInstanceApi(java.lang.Class<D> entity)

• <D> static GormInstanceApi<D> findInstanceApi(java.lang.Class<D> entity, java.lang.String qualifier)

• PlatformTransactionManager findSingleTransactionManager()

  Finds a single transaction manager if only one datastore is registered. Nominally unused, but invoked at compile-time by transactional AST transformations.

• PlatformTransactionManager findSingleTransactionManager(java.lang.String qualifier)

  Finds a single transaction manager for a specific qualifier. Nominally unused, but invoked at compile-time by transactional AST transformations.

• <D> static GormStaticApi<D> findStaticApi(java.lang.Class<D> entity)

• <D> static GormStaticApi<D> findStaticApi(java.lang.Class<D> entity, java.lang.String qualifier)

• PlatformTransactionManager findTransactionManager(java.lang.Class entityClass, java.lang.String qualifier)

  Finds a transaction manager for a specific entity class and qualifier. Nominally unused, but invoked at compile-time by transactional/service AST transformations.

• PlatformTransactionManager findTransactionManager(java.lang.Class entityClass)

  Finds a transaction manager for a specific entity class. Nominally unused, but invoked at compile-time by transactional/service AST transformations.

• <D> static GormValidationApi<D> findValidationApi(java.lang.Class<D> entity)

• <D> static GormValidationApi<D> findValidationApi(java.lang.Class<D> entity, java.lang.String qualifier)

• GormApiFactory getApiFactory(Datastore datastore)

• Datastore getDatastore(java.lang.String qualifier)

  Finds a datastore for a specific qualifier (connection name).

• Datastore getDatastore(java.lang.Class entityClass)

  Finds a datastore for a specific entity class. Part of the public API for external integrations and manual datastore lookup.

• Datastore getDatastore(java.lang.Class entityClass, java.lang.String qualifier)

  Finds a datastore for a specific entity class and qualifier.

• Datastore getDatastore(java.lang.String className, java.lang.String qualifier)

  Finds a datastore for an entity class name and qualifier.

• Datastore getDatastoreByString(java.lang.String className, java.lang.String qualifier)

  Internal method to avoid ambiguity.

• Datastore getDatastoreDirect(java.lang.String normalizedClassName, java.lang.String normalizedQualifier)

  Internal method to avoid redundant normalization.

• Datastore getDefaultDatastore()

  Returns:

  The default datastore

• static GormRegistry getInstance()

• GormInstanceApi getInstanceApi(java.lang.Class entityClass)

• GormInstanceApi getInstanceApi(java.lang.Class entityClass, java.lang.String qualifier)

• GormInstanceApi getInstanceApi(java.lang.String className)

• GormInstanceApi getInstanceApi(java.lang.String className, java.lang.String qualifier)

• GormStaticApi getStaticApi(java.lang.Class entityClass)

• GormStaticApi getStaticApi(java.lang.Class entityClass, java.lang.String qualifier)

• GormStaticApi getStaticApi(java.lang.String className)

• GormStaticApi getStaticApi(java.lang.String className, java.lang.String qualifier)

• GormValidationApi getValidationApi(java.lang.Class entityClass)

• GormValidationApi getValidationApi(java.lang.Class entityClass, java.lang.String qualifier)

• GormValidationApi getValidationApi(java.lang.String className)

• GormValidationApi getValidationApi(java.lang.String className, java.lang.String qualifier)

• void initializeDatastore(Datastore datastore)

  Initializes a datastore, registering its type and default qualifier.

• void initializeDatastore(java.lang.Object datastore, java.lang.String defaultQualifier)

  Initialize a datastore with GORM. Orchestrates datastore registration. Constraint registration is handled by GormEnhancer.registerConstraints; entity-specific registration is still handled by GormEnhancer.

  Parameters:

  datastore - The datastore to initialize

  defaultQualifier - The default connection source qualifier

• boolean isDatastoreRegisteredForEntity(java.lang.String className, Datastore datastore)

  Checks if a specific datastore is explicitly registered for an entity.

• java.lang.String normalizeEntityKey(java.lang.Object entityKey)

• @java.lang.Deprecated
  java.lang.String normalizeEntityKeyFromClass(java.lang.Class entityClass)

  deprecated:

  Use normalizeEntityKey(Class).

• java.lang.String normalizeQualifier(java.lang.String qualifier)

• @java.lang.Deprecated
  java.lang.String normalizeQualifierByString(java.lang.String qualifier)

  deprecated:

  Use normalizeQualifier(String).

• void registerApi(java.lang.String className, GormStaticApi staticApi, GormInstanceApi instanceApi, GormValidationApi validationApi)

  Registers GORM APIs for an entity.

• void registerApiFactory(java.lang.Class datastoreType, GormApiFactory factory)

  Registers a custom GormApiFactory for a specific datastore type. Nominally unused within the core mapping module, but invoked dynamically by external datastore implementations (e.g. Hibernate, MongoDB) to customize API generation.

• void registerDatastore(java.lang.String qualifier, Datastore datastore)

  Registers a datastore for a qualifier. (O(N) part)

• void registerDatastore(Datastore datastore)

  Registers a datastore.

• void registerDatastoreByQualifier(java.lang.String qualifier, Datastore datastore)

  Registers a datastore by qualifier only, without adding it to the global type-based discovery.

• void registerDatastoreByType(Datastore datastore)

  Registers a datastore by its type. Nominally unused in core mapping runtime code, but used by test suites and external integrations.

• void registerEntity(PersistentEntity persistentEntity, GormEnhancer enhancer)

  Register a persistent entity with GORM, orchestrating API and datastore registration. This delegates to a GormEnhancer for creating the API instances.

  Parameters:

  entity - The persistent entity to register

  enhancer - The GormEnhancer that provides API creation

• void registerEntityApis(java.lang.String className, GormStaticApi staticApi, GormInstanceApi instanceApi, GormValidationApi validationApi)

  Register API objects for a persistent entity. Creates and registers StaticApi, InstanceApi, and ValidationApi for the given entity. Part of the public API for external plugins and test environments.

  Parameters:

  className - The entity class name

  staticApi - The static API implementation

  instanceApi - The instance API implementation

  validationApi - The validation API implementation

• void registerEntityApis(java.lang.Class cls, GormStaticApi staticApi, GormInstanceApi instanceApi, GormValidationApi validationApi)

  Register API objects for a persistent entity. Part of the public API for external plugins and test environments.

• void registerEntityDatastore(java.lang.String className, java.lang.String qualifier, Datastore datastore)

  Registers an entity-specific datastore override.

• void registerEntityDatastores(java.lang.String className, java.lang.Object datastore, java.util.List<java.lang.String> connectionSourceNames, java.lang.Object entity)

  Register datastores for a persistent entity across multiple connection sources. Handles entity-specific datastore mappings for multi-tenant and multi-datasource scenarios.

  Parameters:

  className - The entity class name

  datastore - The datastore to register

  connectionSourceNames - The connection source names to register the datastore for

  entity - The persistent entity (for entity-specific qualifier resolution)

• @groovy.transform.CompileDynamic
  void removeConstraints()

  De-registers the old Grails 2 'unique' constraint, if present. Mirrors GormEnhancer.registerConstraints's reflective, soft-dependency lookup - a no-op outside a Grails 2 environment. Not scoped to a specific datastore (the underlying constraint registry this clears is global), so takes no parameters, same as the original. Lives here, not on GormEnhancer, because removeDatastore(Datastore) already owns every other piece of teardown for a datastore going away (API deregistration, datastore mapping cleanup, metaclass cleanup); constraint removal is one more.

• void removeDatastore(Datastore datastore)

  Completely removes a datastore from the registry.

• void removeDatastoreByType(java.lang.Class datastoreType)

  Removes a datastore from discovery by its class type. Nominally unused in core mapping runtime code, but used by testing frameworks to clean up dynamic datastores.

• void removeDatastoreByType(Datastore datastore)

  Removes a datastore from discovery by its instance type. Nominally unused in core mapping runtime code, but used by testing frameworks to clean up dynamic datastores.

• void removeDatastoreFromDiscovery(Datastore datastore)

  Removes a datastore from global discovery (allDatastores and datastoresByType) but keeps it in datastoresByQualifier. Nominally unused in core mapping runtime code, but used by test suites to verify multi-datastore isolation.

• void removeEntityDatastore(java.lang.String className, Datastore datastore)

  Removes a datastore for a specific entity.

• static void reset()

  Resets the registry. Nominally unused in core mapping runtime code, but heavily used by testing frameworks to reset state between spec executions.

• GormInstanceApi resolveInstanceApi(java.lang.Class entityClass)

• GormInstanceApi resolveInstanceApi(java.lang.Class entityClass, java.lang.String qualifier)

• GormStaticApi resolveStaticApi(java.lang.Class entityClass)

• GormStaticApi resolveStaticApi(java.lang.Class entityClass, java.lang.String qualifier)

• GormValidationApi resolveValidationApi(java.lang.Class entityClass)

  Resolves the validation API for the given entity class. Nominally unused in core mapping runtime code, but invoked at compile-time by GORM's AST transformations.

• GormValidationApi resolveValidationApi(java.lang.Class entityClass, java.lang.String qualifier)

  Resolves the validation API for the given entity class and qualifier. Nominally unused in core mapping runtime code, but invoked at compile-time by GORM's AST transformations.