org.exoplatform.container.multitenancy.bridge

Class TenantsServiceImpl

java.lang.Object

org.exoplatform.container.multitenancy.bridge.TenantsServiceImpl

All Implemented Interfaces:

ThreadContextHolder, TenantsService

public class TenantsServiceImpl
extends Object
implements TenantsService, ThreadContextHolder

Implementation of TenantsService based on plugins. Following kinds of plugin supported:

• CurrentTenantLookup
• TenantStateObserver

NOTE: TenantsServiceImpl can be consumed before the container start (e.g. to add a listener or check current tenant).

Author:

Peter Nedonosko

Field Summary

Fields

Modifier and Type	Field and Description
protected static Log	LOG
protected List<CurrentTenantLookup>	lookups List of registered CurrentTenantLookup implementations.
protected List<TenantStateObserver>	observers List of registered TenantStateObserver implementations.

Fields inherited from interface org.exoplatform.container.component.ThreadContextHolder

MANAGE_THREAD_LOCAL

Constructor Summary

Constructors

Constructor and Description
TenantsServiceImpl() Constructor without dependencies.

Method Summary

Methods

Modifier and Type	Method and Description
void	addListener(TenantsStateListener listener) Add listener for Tenant events in Multitenancy sub-system.
void	addPlugin(ComponentPlugin plugin) Register component plugin.
Tenant	getCurrentTenant() Return Current Tenant or throws an exception if Current Tenant not set in current thread.
ThreadContext	getThreadContext() Gives the value corresponding to the context of the thread
boolean	hasCurrentTenant() Answers if Current Tenant is set in current thread.
void	removeListener(TenantsStateListener listener) Remove Tenant events listener from Multitenancy sub-system.

Methods inherited from class java.lang.Object

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

Field Detail

LOG

protected static final Log LOG

lookups

protected final List<CurrentTenantLookup> lookups

List of registered CurrentTenantLookup implementations.

observers

protected final List<TenantStateObserver> observers

List of registered TenantStateObserver implementations.

Constructor Detail

TenantsServiceImpl

public TenantsServiceImpl()

Constructor without dependencies.

Method Detail

addPlugin

public void addPlugin(ComponentPlugin plugin)

Register component plugin. Used by container during the service instantiation. Not recommended for use in runtime.

Parameters:

plugin - ComponentPlugin

addListener

public void addListener(TenantsStateListener listener)

Add listener for Tenant events in Multitenancy sub-system. Added listener later can be removed by TenantsService.removeListener(TenantsStateListener) method.

Specified by:

addListener in interface TenantsService

Parameters:

listener - TenantsStateListener

removeListener

public void removeListener(TenantsStateListener listener)

Remove Tenant events listener from Multitenancy sub-system.
Take in account that it's possible to remove only explicitly added listeners. Listeners available as components in eXo Container don't affected by this method.

Specified by:

removeListener in interface TenantsService

Parameters:

listener - TenantsStateListener

getCurrentTenant

public Tenant getCurrentTenant()
                        throws CurrentTenantNotSetException

Return Current Tenant or throws an exception if Current Tenant not set in current thread. Current Tenant can be not set in two cases:

• Thread runs not in a context of multitenant request (e.g. web request). It can be a server startup or some custom thread.
• Multitenant request wasn't properly initialized on eXo Cloud level. This might have a place in case of internal errors of the cloud.

In both cases an application should not rely on multitenant environment in this thread.

Specified by:

getCurrentTenant in interface TenantsService

Returns:

Tenant Current Tenant descriptor.

Throws:

CurrentTenantNotSetException - if Current Tenant not found or not set.

hasCurrentTenant

public boolean hasCurrentTenant()

Answers if Current Tenant is set in current thread. See TenantsService.getCurrentTenant() for details.

Specified by:

hasCurrentTenant in interface TenantsService

Returns:

boolean, true if current tenant is set in current thread, false otherwise.

See Also:

TenantsService.getCurrentTenant()

getThreadContext

public ThreadContext getThreadContext()

Gives the value corresponding to the context of the thread

Specified by:

getThreadContext in interface ThreadContextHolder

Returns:

a new instance of ThreadContext if there are some valuable ThreadLocal variables to share otherwise null is expected