Tenants (GORM for Hibernate 5

grails.gorm.multitenancy.Tenants

@groovy.transform.CompileStatic
@groovy.util.logging.Slf4j
class Tenants
extends java.lang.Object

Helper methods for working with multi tenancy

Authors:: Graeme Rocher

Since:: 6.0

Nested Class Summary

Nested classes
Modifiers	Name	Description
`static class`	`Tenants.DatastoreLocator`

Properties Summary

Properties
Type	Name and description
`static Tenants.DatastoreLocator`	`datastoreLocator` Pluggable locator for Datastore instances, allowing for easier testing.

Constructor Summary

Constructors
Constructor and description
`Tenants()`

Methods Summary

Methods
Type Params	Return Type	Name and description
	`static java.io.Serializable`	`currentId()` Returns: The current tenant id
	`static java.io.Serializable`	`currentId(MultiTenantCapableDatastore multiTenantCapableDatastore)` The current id for the given datastore
	`static java.io.Serializable`	`currentId(java.lang.Class<? extends Datastore> datastoreClass)` Returns: The current tenant id for the given datastore type
	`static void`	`eachTenant(groovy.lang.Closure callable)` Execute the given closure for each tenant.
	`static void`	`eachTenant(java.lang.Class<? extends Datastore> datastoreClass, groovy.lang.Closure callable)` Execute the given closure for each tenant.
	`static void`	`eachTenant(MultiTenantCapableDatastore multiTenantCapableDatastore, groovy.lang.Closure callable)` Execute the given closure for each tenant for the given datastore.
`<T>`	`static T`	`withCurrent(groovy.lang.Closure<T> callable)` Execute the given closure with the current tenant
`<T>`	`static T`	`withCurrent(java.lang.Class<? extends Datastore> datastoreClass, groovy.lang.Closure<T> callable)` Execute the given closure with the current tenant
`<T>`	`static T`	`withId(java.io.Serializable tenantId, groovy.lang.Closure<T> callable)` Execute the given closure with given tenant id
`<T>`	`static T`	`withId(java.lang.Class domainClass, java.io.Serializable tenantId, groovy.lang.Closure<T> callable)` Execute the given closure with given tenant id
`<T>`	`static T`	`withId(MultiTenantCapableDatastore multiTenantCapableDatastore, java.io.Serializable tenantId, groovy.lang.Closure<T> callable)` Execute the given closure with given tenant id for the given datastore.
`<T>`	`static T`	`withTenant(java.io.Serializable tenantId, groovy.lang.Closure<T> callable)` Binds the given tenant id to the current thread for the duration of the closure.
`<T>`	`static T`	`withTenant(java.lang.Class domainClass, java.io.Serializable tenantId, groovy.lang.Closure<T> callable)` Binds the given tenant id to the current thread for the datastore that maps the given domain class, for the duration of the closure.
`<T>`	`static T`	`withoutId(groovy.lang.Closure<T> callable)` Execute the given closure without any tenant id.
`<T>`	`static T`	`withoutId(MultiTenantCapableDatastore multiTenantCapableDatastore, groovy.lang.Closure<T> callable)` Execute the given closure without tenant id for the given datastore.

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class java.lang.Object`	`java.lang.Object#equals(java.lang.Object), java.lang.Object#getClass(), java.lang.Object#hashCode(), java.lang.Object#notify(), java.lang.Object#notifyAll(), java.lang.Object#toString(), java.lang.Object#wait(), java.lang.Object#wait(long), java.lang.Object#wait(long, int)`

- Property Detail
  - static Tenants.DatastoreLocator datastoreLocator
    
    Pluggable locator for Datastore instances, allowing for easier testing.
- Constructor Detail
  - Tenants()
- Method Detail
  - static java.io.Serializable currentId()
    
    throws:
    org.grails.datastore.mapping.multitenancy.exceptions.TenantNotFoundException if no current tenant is found
    
    Returns:
    The current tenant id
  - static java.io.Serializable currentId(MultiTenantCapableDatastore multiTenantCapableDatastore)
    
    The current id for the given datastore
    Parameters:
    multiTenantCapableDatastore - The multi tenant capable datastore
    Returns:
    The current id
  - static java.io.Serializable currentId(java.lang.Class<? extends Datastore> datastoreClass)
    
    throws:
    org.grails.datastore.mapping.multitenancy.exceptions.TenantNotFoundException if no current tenant is found
    
    Returns:
    The current tenant id for the given datastore type
  - static void eachTenant(groovy.lang.Closure callable)
    
    Execute the given closure for each tenant.
    Parameters:
    callable - The closure
    Returns:
    The result of the closure
  - static void eachTenant(java.lang.Class<? extends Datastore> datastoreClass, groovy.lang.Closure callable)
    
    Execute the given closure for each tenant.
    Parameters:
    callable - The closure
    Returns:
    The result of the closure
  - static void eachTenant(MultiTenantCapableDatastore multiTenantCapableDatastore, groovy.lang.Closure callable)
    
    Execute the given closure for each tenant for the given datastore. This method will create a new datastore session for the scope of the call and hence is designed to be used to manage the connection life cycle
    Parameters:
    callable - The closure
    Returns:
    The result of the closure
  - <T> static T withCurrent(groovy.lang.Closure<T> callable)
    
    Execute the given closure with the current tenant
    Parameters:
    callable - The closure
    Returns:
    The result of the closure
  - <T> static T withCurrent(java.lang.Class<? extends Datastore> datastoreClass, groovy.lang.Closure<T> callable)
    
    Execute the given closure with the current tenant
    Parameters:
    datastoreClass - The datastore class
    callable - The closure
    Returns:
    The result of the closure
  - <T> static T withId(java.io.Serializable tenantId, groovy.lang.Closure<T> callable)
    
    Execute the given closure with given tenant id
    Parameters:
    tenantId - The tenant id
    callable - The closure
    Returns:
    The result of the closure
  - <T> static T withId(java.lang.Class domainClass, java.io.Serializable tenantId, groovy.lang.Closure<T> callable)
    
    Execute the given closure with given tenant id
    Parameters:
    tenantId - The tenant id
    callable - The closure
    Returns:
    The result of the closure
  - <T> static T withId(MultiTenantCapableDatastore multiTenantCapableDatastore, java.io.Serializable tenantId, groovy.lang.Closure<T> callable)
    
    Execute the given closure with given tenant id for the given datastore. This method will create a new datastore session for the scope of the call and hence is designed to be used to manage the connection life cycle
    Parameters:
    tenantId - The tenant id
    callable - The closure
    Returns:
    The result of the closure
  - <T> static T withTenant(java.io.Serializable tenantId, groovy.lang.Closure<T> callable)
    
    Binds the given tenant id to the current thread for the duration of the closure. This binds the tenant only. Unlike withId(Serializable, Closure) it opens no session and manages no connection life cycle: the closure runs in whatever session the caller has already established, and the caller remains responsible for opening and closing it. Reach for withId when the tenant's work needs a session of its own - in DATABASE mode that is also what selects the tenant's connection.
    Parameters:
    tenantId - The tenant id
    callable - The closure
    Returns:
    The result of the closure
  - <T> static T withTenant(java.lang.Class domainClass, java.io.Serializable tenantId, groovy.lang.Closure<T> callable)
    
    Binds the given tenant id to the current thread for the datastore that maps the given domain class, for the duration of the closure. This binds the tenant only. Unlike withId(Class, Serializable, Closure) it opens no session and manages no connection: the caller owns the session the closure runs in.
    Parameters:
    domainClass - The domain class whose datastore the tenant should be bound for
    tenantId - The tenant id
    callable - The closure
    Returns:
    The result of the closure
  - <T> static T withoutId(groovy.lang.Closure<T> callable)
    
    Execute the given closure without any tenant id. In Multi tenancy mode SINGLE this will execute against the default data source. If multi tenancy mode MULTI this will execute without including the "tenantId" on any query. Use with caution.
    Parameters:
    callable - The closure
    Returns:
    The result of the closure
  - <T> static T withoutId(MultiTenantCapableDatastore multiTenantCapableDatastore, groovy.lang.Closure<T> callable)
    
    Execute the given closure without tenant id for the given datastore. This method will create a new datastore session for the scope of the call and hence is designed to be used to manage the connection life cycle
    Parameters:
    callable - The closure
    Returns:
    The result of the closure

Summary:
Nested
Property
Constructor
Method

| Detail:
Property
Constructor
Method

[Groovy] Class Tenants

Nested Class Summary

Properties Summary

Constructor Summary

Methods Summary

Inherited Methods Summary

Property Detail

static Tenants.DatastoreLocator datastoreLocator

Constructor Detail

Tenants()

Method Detail

static java.io.Serializable currentId()

static java.io.Serializable currentId(MultiTenantCapableDatastore multiTenantCapableDatastore)

static java.io.Serializable currentId(java.lang.Class<? extends Datastore> datastoreClass)

static void eachTenant(groovy.lang.Closure callable)

static void eachTenant(java.lang.Class<? extends Datastore> datastoreClass, groovy.lang.Closure callable)

static void eachTenant(MultiTenantCapableDatastore multiTenantCapableDatastore, groovy.lang.Closure callable)

<T> static T withCurrent(groovy.lang.Closure<T> callable)

<T> static T withCurrent(java.lang.Class<? extends Datastore> datastoreClass, groovy.lang.Closure<T> callable)

<T> static T withId(java.io.Serializable tenantId, groovy.lang.Closure<T> callable)

<T> static T withId(java.lang.Class domainClass, java.io.Serializable tenantId, groovy.lang.Closure<T> callable)

<T> static T withId(MultiTenantCapableDatastore multiTenantCapableDatastore, java.io.Serializable tenantId, groovy.lang.Closure<T> callable)

<T> static T withTenant(java.io.Serializable tenantId, groovy.lang.Closure<T> callable)

<T> static T withTenant(java.lang.Class domainClass, java.io.Serializable tenantId, groovy.lang.Closure<T> callable)

<T> static T withoutId(groovy.lang.Closure<T> callable)

<T> static T withoutId(MultiTenantCapableDatastore multiTenantCapableDatastore, groovy.lang.Closure<T> callable)