org.exoplatform.container.multitenancy

Interface TenantsService

All Known Implementing Classes:

TenantsServiceImpl

public interface TenantsService

Provides convenient methods to get an information about Current Tenant and provides support for multi-tenant capable services.

Author:

Peter Nedonosko

Method Summary

Methods

Modifier and Type	Method and Description
void	addListener(TenantsStateListener listener) Add listener for Tenant events in Multitenancy sub-system.
Tenant	getCurrentTenant() Return Current Tenant or throws an exception if Current Tenant not set in current thread.
boolean	hasCurrentTenant() Answers if Current Tenant is set in current thread.
void	removeListener(TenantsStateListener listener) Remove Tenant events listener from Multitenancy sub-system.

Method Detail

getCurrentTenant

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.

Returns:

Tenant Current Tenant descriptor.

Throws:

CurrentTenantNotSetException - if Current Tenant not found or not set.

hasCurrentTenant

boolean hasCurrentTenant()

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

Returns:

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

See Also:

getCurrentTenant()

addListener

void addListener(TenantsStateListener listener)

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

Parameters:

listener - TenantsStateListener

removeListener

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.

Parameters:

listener - TenantsStateListener