Package ch.tocco.nice2.businessunit.impl

Class BusinessUnitManagerImpl

java.lang.Object

ch.tocco.nice2.businessunit.impl.BusinessUnitManagerImpl

All Implemented Interfaces:

BusinessUnitManager

@Component
public class BusinessUnitManagerImpl
extends Object
implements BusinessUnitManager

Constructor Summary

Constructors

Constructor	Description
BusinessUnitManagerImpl(org.slf4j.Logger log, Context context, SecurityManager securityManager, PrincipalManager principalManager, CommandExecutor executor)

Method Summary

Modifier and Type	Method	Description
List<BusinessUnit>	getAllBusinessUnits()
BusinessUnit	getBusinessUnit(Entity entity)	Returns the business unit of the provided entity.
@Nullable BusinessUnit	getBusinessUnitById(String buId)	Returns the business unit of the specified unique_id.
@Nullable BusinessUnitHolder	getBusinessUnitContext()
Optional<Entity>	getBusinessUnitEntity(BusinessUnit businessUnit)	Returns the Business_unit entity that is corresponding to a given BusinessUnit object if it contains a PrimaryKey
List<BusinessUnit>	getBusinessUnits(Principal principal)	Returns all business units that the principal is associated to.
Iterable<BusinessUnit>	getBusinessUnits(Principal principal, String roleId)	Returns all business units that the principal is associated to by the specified roleId.
BusinessUnit	getCurrentBusinessUnit()	Returns the business unit of the current thread or BusinessUnit.NULL_BUSINESS_UNIT if none exists.
Optional<Entity>	getCurrentBusinessUnitEntity()	Returns the Business_unit entity that is corresponding to the current BusinessUnit if the current BusinessUnit contains a PrimaryKey.
boolean	hasBusinessUnit(Entity entity)
void	setBusinessUnit(BusinessUnit bu)	Sets the specified business unit to the current thread overwriting any existing one! It does NOT re-login the principal.
void	setBusinessUnitContext(BusinessUnitHolder h)
void	setDefaultBusinessUnit(String principal, BusinessUnit preferredBusinessUnit)	Sets the default business unit for the specified principal only if no current business unit is found.
void	setListeners(List<BusinessUnitChangeListener> listeners)
void	switchBusinessUnit(BusinessUnit bu, boolean saveChange)	Sets the specified business unit to the current thread and triggers all necessary updates (re-login).
Invoker	withBusinessUnit(BusinessUnitChange buChange)	Get an invoker to execute something with a certain business unit.
Invoker	withBusinessUnitOfEntity(Entity entity)	Get an invoker to execute something with the business unit of the given entity.
<A, B> PersistTask<A,B>	withinBusinessUnit(BusinessUnit bu, PersistTask<A,B> delegate)	Returns a new task that executes the given task within the given business unit.
Invoker	withNullBusinessUnit()	Get an invoker to execute something with the BusinessUnit.NULL_BUSINESS_UNIT.
Invoker	withoutBusinessUnitInterceptor()

Methods inherited from class java.lang.Object

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

Constructor Details

BusinessUnitManagerImpl

public BusinessUnitManagerImpl(org.slf4j.Logger log,
 @Lazy
 Context context,
 @Lazy
 SecurityManager securityManager,
 @Lazy
 PrincipalManager principalManager,
 @Lazy
 CommandExecutor executor)

Method Details

setListeners

@Autowired
public void setListeners(List<BusinessUnitChangeListener> listeners)

setDefaultBusinessUnit

public void setDefaultBusinessUnit(String principal,
 BusinessUnit preferredBusinessUnit)

Description copied from interface: BusinessUnitManager

Sets the default business unit for the specified principal only if no current business unit is found.

The business unit is retrieved from the user settings. If not available some business-unit for the principal is set. The default implementation sets the business unit with the lowest primary key.

Used after login to apply an initial business unit.

Specified by:

setDefaultBusinessUnit in interface BusinessUnitManager

Parameters:

principal - the username of the principal

withBusinessUnit

public Invoker withBusinessUnit(BusinessUnitChange buChange)

Description copied from interface: BusinessUnitManager

Get an invoker to execute something with a certain business unit.

Specified by:

withBusinessUnit in interface BusinessUnitManager

Parameters:

buChange - the desired business unit.

Returns:

the invoker.

See Also:

• BusinessUnitManager.withBusinessUnitOfEntity(Entity)
• BusinessUnitManager.withNullBusinessUnit()

withBusinessUnitOfEntity

public Invoker withBusinessUnitOfEntity(Entity entity)

Description copied from interface: BusinessUnitManager

Get an invoker to execute something with the business unit of the given entity.

Specified by:

withBusinessUnitOfEntity in interface BusinessUnitManager

Parameters:

entity - the business unit dependent entity.

Returns:

the invoker.

withNullBusinessUnit

public Invoker withNullBusinessUnit()

Description copied from interface: BusinessUnitManager

Get an invoker to execute something with the BusinessUnit.NULL_BUSINESS_UNIT.

Specified by:

withNullBusinessUnit in interface BusinessUnitManager

Returns:

the invoker.

withoutBusinessUnitInterceptor

public Invoker withoutBusinessUnitInterceptor()

Specified by:

withoutBusinessUnitInterceptor in interface BusinessUnitManager

Returns:

an invoker that disables the business unit query interceptor. This means that results from queries always contain results from all business units.

See Also:

• This does *not* cause a login (and thus does not apply any roles) and should only be used in privileged mode (because roles are not relevant for queries in privileged mode)! Note that BusinessUnitManager#getCurrentBusinessUnit() returns the previously set business unit and not necessarily the null business unit. This invoker can be faster than BusinessUnitManager#withNullBusinessUnit() because the login is avoided (which also causes the conditions cache to be cleared).

withinBusinessUnit

public <A,
B> PersistTask<A,B> withinBusinessUnit(BusinessUnit bu,
 PersistTask<A,B> delegate)

Description copied from interface: BusinessUnitManager

Returns a new task that executes the given task within the given business unit.

Specified by:

withinBusinessUnit in interface BusinessUnitManager

switchBusinessUnit

public void switchBusinessUnit(BusinessUnit bu,
 boolean saveChange)

Description copied from interface: BusinessUnitManager

Sets the specified business unit to the current thread and triggers all necessary updates (re-login). This is a permanent change to the given business unit. The `saveChange` parameter controls whether the new business unit is saved in the usersettings.

Specified by:

switchBusinessUnit in interface BusinessUnitManager

hasBusinessUnit

public boolean hasBusinessUnit(Entity entity)

Specified by:

hasBusinessUnit in interface BusinessUnitManager

Parameters:

entity - entity

Returns:

true if the entity-model has a business unit

getBusinessUnit

public BusinessUnit getBusinessUnit(Entity entity)

Description copied from interface: BusinessUnitManager

Returns the business unit of the provided entity. Throws a IllegalArgumentException if the provided entity is not business-unit dependent.

Specified by:

getBusinessUnit in interface BusinessUnitManager

Parameters:

entity - a entity

Returns:

the business unit of the provided entity

getBusinessUnits

public List<BusinessUnit> getBusinessUnits(Principal principal)

Description copied from interface: BusinessUnitManager

Returns all business units that the principal is associated to.

Specified by:

getBusinessUnits in interface BusinessUnitManager

getBusinessUnits

public Iterable<BusinessUnit> getBusinessUnits(Principal principal,
 String roleId)

Description copied from interface: BusinessUnitManager

Returns all business units that the principal is associated to by the specified roleId.

Specified by:

getBusinessUnits in interface BusinessUnitManager

Parameters:

principal - the Principal

roleId - the unique_id of the role

getAllBusinessUnits

public List<BusinessUnit> getAllBusinessUnits()

Specified by:

getAllBusinessUnits in interface BusinessUnitManager

Returns:

all business units (except the BusinessUnit.NULL_BUSINESS_UNIT)

getBusinessUnitById

@Nullable
public @Nullable BusinessUnit getBusinessUnitById(String buId)

Description copied from interface: BusinessUnitManager

Returns the business unit of the specified unique_id.

Specified by:

getBusinessUnitById in interface BusinessUnitManager

setBusinessUnit

public void setBusinessUnit(BusinessUnit bu)

Description copied from interface: BusinessUnitManager

Sets the specified business unit to the current thread overwriting any existing one! It does NOT re-login the principal.

Specified by:

setBusinessUnit in interface BusinessUnitManager

Parameters:

bu - new business unit to set

getCurrentBusinessUnit

public BusinessUnit getCurrentBusinessUnit()

Description copied from interface: BusinessUnitManager

Returns the business unit of the current thread or BusinessUnit.NULL_BUSINESS_UNIT if none exists.

Specified by:

getCurrentBusinessUnit in interface BusinessUnitManager

getBusinessUnitEntity

public Optional<Entity> getBusinessUnitEntity(BusinessUnit businessUnit)

Description copied from interface: BusinessUnitManager

Returns the Business_unit entity that is corresponding to a given BusinessUnit object if it contains a PrimaryKey

Specified by:

getBusinessUnitEntity in interface BusinessUnitManager

Returns:

Business_unit entity

getCurrentBusinessUnitEntity

public Optional<Entity> getCurrentBusinessUnitEntity()

Description copied from interface: BusinessUnitManager

Returns the Business_unit entity that is corresponding to the current BusinessUnit if the current BusinessUnit contains a PrimaryKey.

Specified by:

getCurrentBusinessUnitEntity in interface BusinessUnitManager

Returns:

Business_unit entity

getBusinessUnitContext

@Nullable
public @Nullable BusinessUnitHolder getBusinessUnitContext()

Specified by:

getBusinessUnitContext in interface BusinessUnitManager

setBusinessUnitContext

public void setBusinessUnitContext(BusinessUnitHolder h)

Specified by:

setBusinessUnitContext in interface BusinessUnitManager