Package org.apache.syncope.core.provisioning.java.propagation

Class DefaultPropagationManager

java.lang.Object

org.apache.syncope.core.provisioning.java.propagation.DefaultPropagationManager

All Implemented Interfaces:

PropagationManager

@Transactional(rollbackFor=java.lang.Throwable.class)
public class DefaultPropagationManager
extends Object
implements PropagationManager

Manage the data propagation to external resources.

Field Summary

Fields

Modifier and Type	Field	Description
protected final AnyUtilsFactory	anyUtilsFactory
protected final ConnObjectUtils	connObjectUtils
protected final DerAttrHandler	derAttrHandler
protected final EntityFactory	entityFactory
protected static final Logger	LOG
protected final MappingManager	mappingManager
protected final ExternalResourceDAO	resourceDAO

Fields inherited from interface org.apache.syncope.core.provisioning.api.propagation.PropagationManager

MANDATORY_MISSING_ATTR_NAME, MANDATORY_NULL_OR_EMPTY_ATTR_NAME

Constructor Summary

Constructors

Constructor	Description
DefaultPropagationManager(ExternalResourceDAO resourceDAO, EntityFactory entityFactory, ConnObjectUtils connObjectUtils, MappingManager mappingManager, DerAttrHandler derAttrHandler, AnyUtilsFactory anyUtilsFactory)

Method Summary

Modifier and Type	Method	Description
protected List<PropagationTaskInfo>	createTasks(Any any, String password, List<String> changePwdRes, Boolean enable, PropagationByResource<String> propByRes, PropagationByResource<Pair<String,String>> propByLinkedAccount)	Create propagation tasks.
List<PropagationTaskInfo>	createTasks(Realm realm, PropagationByResource<String> propByRes, Collection<String> excludedResources)	Create the needed tasks for the realm for each resource associated, unless in excludedResources.
List<PropagationTaskInfo>	getCreateTasks(AnyTypeKind kind, String key, Boolean enable, PropagationByResource<String> propByRes, Collection<String> excludedResources)	Create the tasks for every associated resource, unless in excludedResources.
protected List<PropagationTaskInfo>	getCreateTasks(Any any, String password, Boolean enable, PropagationByResource<String> propByRes, PropagationByResource<Pair<String,String>> propByLinkedAccount, Collection<String> excludedResources)
List<PropagationTaskInfo>	getDeleteTasks(AnyTypeKind kind, String key, PropagationByResource<String> propByRes, PropagationByResource<Pair<String,String>> propByLinkedAccount, Collection<String> excludedResources)	Create the delete tasks from each resource associated, unless in excludedResources.
protected List<PropagationTaskInfo>	getDeleteTasks(Any any, PropagationByResource<String> propByRes, PropagationByResource<Pair<String,String>> propByLinkedAccount, Collection<String> excludedResources)
List<PropagationTaskInfo>	getUpdateTasks(AnyUR anyUR, AnyTypeKind kind, String key, List<String> changePwdRes, Boolean enable, PropagationByResource<String> propByRes, PropagationByResource<Pair<String,String>> propByLinkedAccount, Collection<String> excludedResources)	Create the update tasks on each resource associated, unless in excludedResources.
protected List<PropagationTaskInfo>	getUpdateTasks(AnyUR anyUR, Any any, String password, List<String> changePwdRes, Boolean enable, PropagationByResource<String> propByRes, PropagationByResource<Pair<String,String>> propByLinkedAccount, Collection<String> excludedResources)
List<PropagationTaskInfo>	getUserCreateTasks(String key, String password, Boolean enable, PropagationByResource<String> propByRes, PropagationByResource<Pair<String,String>> propByLinkedAccount, Collection<String> excludedResources)	Create the user tasks for every associated resource, unless in excludedResources.
List<PropagationTaskInfo>	getUserUpdateTasks(UserWorkflowResult<Pair<UserUR,Boolean>> wfResult)	Create the update tasks for the user on each resource associated; propagate password update only to requested resources.
List<PropagationTaskInfo>	getUserUpdateTasks(UserWorkflowResult<Pair<UserUR,Boolean>> wfResult, List<String> changePwdRes, Collection<String> excludedResources)	Create the update tasks for the user on each resource associated, unless in excludedResources.
protected boolean	isOrdinaryForAttrForDelta(Attribute attr)	Checks whether the given attribute shall be treated as an ordinary attribute or not, for purpose of building AttributeDelta instances.
PropagationTaskInfo	newTask(DerAttrHandler derAttrHandler, Any any, ExternalResource resource, ResourceOperation operation, Provision provision, Stream<Item> mappingItems, Pair<String,Set<Attribute>> preparedAttrs)
Map<Pair<String,String>,Set<Attribute>>	prepareAttrs(AnyTypeKind kind, String key, String password, List<String> changePwdRes, Boolean enable, Collection<String> excludedResources)	Prepare attributes for propagation.
Map<Pair<String,String>,Set<Attribute>>	prepareAttrs(Realm realm)	Prepare attributes for propagation.
List<PropagationTaskInfo>	setAttributeDeltas(List<PropagationTaskInfo> tasks, Map<Pair<String,String>,Set<Attribute>> beforeAttrs)	Enrich the provided tasks with attribute deltas.

Methods inherited from class java.lang.Object

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

Field Details

LOG

protected static final Logger LOG

resourceDAO

protected final ExternalResourceDAO resourceDAO

entityFactory

protected final EntityFactory entityFactory

connObjectUtils

protected final ConnObjectUtils connObjectUtils

mappingManager

protected final MappingManager mappingManager

derAttrHandler

protected final DerAttrHandler derAttrHandler

anyUtilsFactory

protected final AnyUtilsFactory anyUtilsFactory

Constructor Details

DefaultPropagationManager

public DefaultPropagationManager(ExternalResourceDAO resourceDAO,
 EntityFactory entityFactory,
 ConnObjectUtils connObjectUtils,
 MappingManager mappingManager,
 DerAttrHandler derAttrHandler,
 AnyUtilsFactory anyUtilsFactory)

Method Details

getCreateTasks

public List<PropagationTaskInfo> getCreateTasks(AnyTypeKind kind,
 String key,
 Boolean enable,
 PropagationByResource<String> propByRes,
 Collection<String> excludedResources)

Description copied from interface: PropagationManager

Create the tasks for every associated resource, unless in excludedResources.

Specified by:

getCreateTasks in interface PropagationManager

Parameters:

kind - any type kind

key - any key

enable - whether any should be enabled or not

propByRes - operation to be performed per resource

excludedResources - external resources performing not to be considered for propagation

Returns:

list of propagation tasks

getUserCreateTasks

public List<PropagationTaskInfo> getUserCreateTasks(String key,
 String password,
 Boolean enable,
 PropagationByResource<String> propByRes,
 PropagationByResource<Pair<String,String>> propByLinkedAccount,
 Collection<String> excludedResources)

Description copied from interface: PropagationManager

Create the user tasks for every associated resource, unless in excludedResources.

Specified by:

getUserCreateTasks in interface PropagationManager

Parameters:

key - user key

password - to be set

enable - whether user must be enabled or not

propByRes - operation to be performed per resource

propByLinkedAccount - operation to be performed for linked accounts

excludedResources - external resources not to be considered for propagation

Returns:

list of propagation tasks

getCreateTasks

protected List<PropagationTaskInfo> getCreateTasks(Any any,
 String password,
 Boolean enable,
 PropagationByResource<String> propByRes,
 PropagationByResource<Pair<String,String>> propByLinkedAccount,
 Collection<String> excludedResources)

getUpdateTasks

public List<PropagationTaskInfo> getUpdateTasks(AnyUR anyUR,
 AnyTypeKind kind,
 String key,
 List<String> changePwdRes,
 Boolean enable,
 PropagationByResource<String> propByRes,
 PropagationByResource<Pair<String,String>> propByLinkedAccount,
 Collection<String> excludedResources)

Description copied from interface: PropagationManager

Create the update tasks on each resource associated, unless in excludedResources.

Specified by:

getUpdateTasks in interface PropagationManager

Parameters:

anyUR - update request

kind - any type kind

key - any key

changePwdRes - the resources in which the password must be included in the propagation attributes

enable - whether any should be enabled or not, may be null to leave unchanged

propByRes - operation to be performed per resource

propByLinkedAccount - operation to be performed for linked accounts

excludedResources - external resource keys not to be considered for propagation

Returns:

list of propagation tasks

getUserUpdateTasks

public List<PropagationTaskInfo> getUserUpdateTasks(UserWorkflowResult<Pair<UserUR,Boolean>> wfResult,
 List<String> changePwdRes,
 Collection<String> excludedResources)

Description copied from interface: PropagationManager

Create the update tasks for the user on each resource associated, unless in excludedResources.

Specified by:

getUserUpdateTasks in interface PropagationManager

Parameters:

wfResult - user to be propagated (and info associated), as per result from workflow

changePwdRes - the resources in which the password must be included in the propagation attributes

excludedResources - external resources not to be considered for propagation

Returns:

list of propagation tasks

getUserUpdateTasks

public List<PropagationTaskInfo> getUserUpdateTasks(UserWorkflowResult<Pair<UserUR,Boolean>> wfResult)

Description copied from interface: PropagationManager

Create the update tasks for the user on each resource associated; propagate password update only to requested resources.

Specified by:

getUserUpdateTasks in interface PropagationManager

Parameters:

wfResult - user to be propagated (and info associated), as per result from workflow

Returns:

list of propagation tasks

getUpdateTasks

protected List<PropagationTaskInfo> getUpdateTasks(AnyUR anyUR,
 Any any,
 String password,
 List<String> changePwdRes,
 Boolean enable,
 PropagationByResource<String> propByRes,
 PropagationByResource<Pair<String,String>> propByLinkedAccount,
 Collection<String> excludedResources)

getDeleteTasks

public List<PropagationTaskInfo> getDeleteTasks(AnyTypeKind kind,
 String key,
 PropagationByResource<String> propByRes,
 PropagationByResource<Pair<String,String>> propByLinkedAccount,
 Collection<String> excludedResources)

Description copied from interface: PropagationManager

Create the delete tasks from each resource associated, unless in excludedResources.

Specified by:

getDeleteTasks in interface PropagationManager

Parameters:

kind - any type kind

key - any key

propByRes - operation to be performed per resource

propByLinkedAccount - operation to be performed for linked accounts

excludedResources - external resource keys not to be considered for propagation

Returns:

list of propagation tasks

getDeleteTasks

protected List<PropagationTaskInfo> getDeleteTasks(Any any,
 PropagationByResource<String> propByRes,
 PropagationByResource<Pair<String,String>> propByLinkedAccount,
 Collection<String> excludedResources)

newTask

public PropagationTaskInfo newTask(DerAttrHandler derAttrHandler,
 Any any,
 ExternalResource resource,
 ResourceOperation operation,
 Provision provision,
 Stream<Item> mappingItems,
 Pair<String,Set<Attribute>> preparedAttrs)

Specified by:

newTask in interface PropagationManager

createTasks

protected List<PropagationTaskInfo> createTasks(Any any,
 String password,
 List<String> changePwdRes,
 Boolean enable,
 PropagationByResource<String> propByRes,
 PropagationByResource<Pair<String,String>> propByLinkedAccount)

Create propagation tasks.

Parameters:

any - to be provisioned

password - clear text password to be provisioned

changePwdRes - the resources in which the password must be included in the propagation attributes

enable - whether user must be enabled or not

propByRes - operation to be performed per resource

propByLinkedAccount - operation to be performed on linked accounts

Returns:

list of propagation tasks created

createTasks

public List<PropagationTaskInfo> createTasks(Realm realm,
 PropagationByResource<String> propByRes,
 Collection<String> excludedResources)

Description copied from interface: PropagationManager

Create the needed tasks for the realm for each resource associated, unless in excludedResources.

Specified by:

createTasks in interface PropagationManager

Parameters:

realm - realm

propByRes - operation to be performed per resource

excludedResources - external resource keys not to be considered for propagation

Returns:

list of propagation tasks

prepareAttrs

@Transactional(readOnly=true,
               propagation=REQUIRES_NEW)
public Map<Pair<String,String>,Set<Attribute>> prepareAttrs(AnyTypeKind kind,
 String key,
 String password,
 List<String> changePwdRes,
 Boolean enable,
 Collection<String> excludedResources)

Description copied from interface: PropagationManager

Prepare attributes for propagation.

Specified by:

prepareAttrs in interface PropagationManager

Parameters:

kind - any type kind

key - any key

password - to be set (for users)

changePwdRes - the resources in which the password must be included in the propagation attributes (for users)

enable - whether any should be enabled or not, may be null to leave unchanged

excludedResources - external resource keys not to be considered for propagation

Returns:

map with prepared attributes per External Resource

prepareAttrs

@Transactional(readOnly=true,
               propagation=REQUIRES_NEW)
public Map<Pair<String,String>,Set<Attribute>> prepareAttrs(Realm realm)

Description copied from interface: PropagationManager

Prepare attributes for propagation.

Specified by:

prepareAttrs in interface PropagationManager

Parameters:

realm - realm

Returns:

map with prepared attributes per External Resource

isOrdinaryForAttrForDelta

protected boolean isOrdinaryForAttrForDelta(Attribute attr)

Checks whether the given attribute shall be treated as an ordinary attribute or not, for purpose of building AttributeDelta instances.

Parameters:

attr - ConnId attribute

Returns:

whether the condition is matched or not

setAttributeDeltas

public List<PropagationTaskInfo> setAttributeDeltas(List<PropagationTaskInfo> tasks,
 Map<Pair<String,String>,Set<Attribute>> beforeAttrs)

Description copied from interface: PropagationManager

Enrich the provided tasks with attribute deltas.

Specified by:

setAttributeDeltas in interface PropagationManager

Parameters:

tasks - propagation tasks

beforeAttrs - attribute values before update

Returns:

enriched propagation tasks