org.cyclos.impl.users

Interface ProductsUserServiceLocal

All Superinterfaces:

BaseProductsOwnerService<UserLocatorVO>, BaseProductsOwnerServiceLocal<User,UserLocatorVO>, ProductsUserService, Service

public interface ProductsUserServiceLocal
extends ProductsUserService, BaseProductsOwnerServiceLocal<User,UserLocatorVO>

Local interface for user / products relationship

Author:

rinke

Method Summary

Modifier and Type	Method and Description
void	applyProductGainActions(User owner, java.util.Collection<Product> gainedProducts) Applies all additional actions to be performed in case of gain of the specified products.
void	applyProductLossActions(User owner, java.util.Collection<Product> lostProducts, java.util.Collection<Product> gainedProducts) Applies all additional actions to be performed in case of loss of the specified products.
java.util.Set<UserAccount>	getLostAccounts(User user, java.util.Collection<Product> lostProducts, java.util.Collection<Product> gainedProducts) gets the accounts which the user will loose if the given products are unassigned, so the user doesn't have access to the products anymore.

Methods inherited from interface org.cyclos.services.users.ProductsUserService

getUserProductLogs

Methods inherited from interface org.cyclos.impl.users.BaseProductsOwnerServiceLocal

canHaveProductUnassigned, getData

Methods inherited from interface org.cyclos.services.users.BaseProductsOwnerService

assign, getActiveProducts, unassign

Method Detail

applyProductGainActions

void applyProductGainActions(User owner,
                             java.util.Collection<Product> gainedProducts)

Applies all additional actions to be performed in case of gain of the specified products. Does NOT assign the products; that is the task of the calling method.
The Actions taken are:

• create the associated accounts.

Parameters:

owner - the user loosing access to the given products.

gainedProducts - the regained products in case of a group changes; these are the products of the new group.

applyProductLossActions

void applyProductLossActions(User owner,
                             java.util.Collection<Product> lostProducts,
                             java.util.Collection<Product> gainedProducts)

Applies all additional actions to be performed in case of loss of the specified products. Does NOT unassign the products; that is the task of the calling method.
The Actions taken are:

• Dispose the account, @see org.cyclos.impl.banking.AccountServiceLocal#disposeAccounts(User, Collection)
• remove brokerings

Parameters:

owner - The user loosing access to the given products.

lostProducts - The products to which the user will loose access.

gainedProducts - The products he has at the same time gained. For example, when changing groups. Otherwise, null.

getLostAccounts

java.util.Set<UserAccount> getLostAccounts(User user,
                                           java.util.Collection<Product> lostProducts,
                                           java.util.Collection<Product> gainedProducts)

gets the accounts which the user will loose if the given products are unassigned, so the user doesn't have access to the products anymore.

Parameters:

user -

lostProducts - all products which will be unassigned to the user.

gainedProducts - all products which will be assigned to the user in case of a group change. This can be null or an empty collection in case of a plain product unassignment.

Returns:

a list with lost user accounts as a result of the unassignment or group change.