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

Class DefaultMappingManager

java.lang.Object

org.apache.syncope.core.provisioning.java.DefaultMappingManager

All Implemented Interfaces:

MappingManager

public class DefaultMappingManager
extends Object
implements MappingManager

Field Summary

Fields

Modifier and Type	Field	Description
protected final AnyObjectDAO	anyObjectDAO
protected final AnyTypeDAO	anyTypeDAO
protected final DerAttrHandler	derAttrHandler
protected final EncryptorManager	encryptorManager
protected final GroupDAO	groupDAO
protected final ImplementationDAO	implementationDAO
protected final IntAttrNameParser	intAttrNameParser
protected static final Logger	LOG
protected final RealmSearchDAO	realmSearchDAO
protected final RelationshipTypeDAO	relationshipTypeDAO
protected final UserDAO	userDAO

Constructor Summary

Constructors

Constructor	Description
DefaultMappingManager(AnyTypeDAO anyTypeDAO, UserDAO userDAO, AnyObjectDAO anyObjectDAO, GroupDAO groupDAO, RelationshipTypeDAO relationshipTypeDAO, RealmSearchDAO realmSearchDAO, ImplementationDAO implementationDAO, DerAttrHandler derAttrHandler, IntAttrNameParser intAttrNameParser, EncryptorManager encryptorManager)

Method Summary

Modifier and Type	Method	Description
protected static PlainAttrValue	clonePlainAttrValue(PlainAttrValue src)
protected Optional<String>	decodePassword(Account account)
protected Name	evaluateNAME(Any any, Provision provision, String connObjectKey)	Build __NAME__ for propagation.
protected Name	evaluateNAME(Realm realm, OrgUnit orgUnit, String connObjectKey)	Build __NAME__ for propagation.
Optional<String>	getConnObjectKeyValue(Any any, ExternalResource resource, Provision provision)	Get connObjectKey internal value.
Optional<String>	getConnObjectKeyValue(Realm realm, ExternalResource resource)	Get connObjectKey internal value.
protected String	getGroupOwnerValue(ExternalResource resource, Provision provision, Any any)
Pair<AttrSchemaType,List<PlainAttrValue>>	getIntValues(ExternalResource resource, Item item, IntAttrName intAttrName, AttrSchemaType schemaType, Realm realm)	Get attribute values for the given Item and realm.
Pair<AttrSchemaType,List<PlainAttrValue>>	getIntValues(ExternalResource resource, Provision provision, Item item, IntAttrName intAttrName, AttrSchemaType schemaType, Any any, AccountGetter usernameAccountGetter, PlainAttrGetter plainAttrGetter)	Get attribute values for the given Item and any object.
protected static Name	getName(String evalConnObjectLink, String connObjectKey)
protected Optional<String>	getPasswordAttrValue(Account account, String defaultValue)
protected List<Implementation>	getTransformers(Item item)
boolean	hasMustChangePassword(Provision provision)	Checks if there is a mapping item in the given Provision for mustChangePassword.
Pair<String,Attribute>	prepareAttr(ExternalResource resource, Item item, Realm realm)	Prepare attribute for sending to a connector instance.
Pair<String,Attribute>	prepareAttr(ExternalResource resource, Provision provision, Item item, Any any, String password, AccountGetter usernameAccountGetter, AccountGetter passwordAccountGetter, PlainAttrGetter plainAttrGetter)	Prepare attribute for sending to a connector instance.
Pair<String,Set<Attribute>>	prepareAttrsFromAny(Any any, String password, boolean changePwd, Boolean enable, ExternalResource resource, Provision provision)	Prepare attributes for sending to a connector instance.
Set<Attribute>	prepareAttrsFromLinkedAccount(User user, LinkedAccount account, String password, boolean changePwd, Provision provision)	Prepare attributes for sending to a connector instance.
Pair<String,Set<Attribute>>	prepareAttrsFromRealm(Realm realm, ExternalResource resource)	Prepare attributes for sending to a connector instance.
protected static Optional<String>	processPreparedAttr(Pair<String,Attribute> preparedAttr, Set<Attribute> attributes)
void	setIntValues(Item item, Attribute attr, AnyTO anyTO)	Set attribute values, according to the given Item, to any object from attribute received from connector.
void	setIntValues(Item item, Attribute attr, RealmTO realmTO)	Set attribute values, according to the given Item, to realm from attribute received from connector.

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

anyTypeDAO

protected final AnyTypeDAO anyTypeDAO

userDAO

protected final UserDAO userDAO

anyObjectDAO

protected final AnyObjectDAO anyObjectDAO

groupDAO

protected final GroupDAO groupDAO

relationshipTypeDAO

protected final RelationshipTypeDAO relationshipTypeDAO

realmSearchDAO

protected final RealmSearchDAO realmSearchDAO

implementationDAO

protected final ImplementationDAO implementationDAO

derAttrHandler

protected final DerAttrHandler derAttrHandler

intAttrNameParser

protected final IntAttrNameParser intAttrNameParser

encryptorManager

protected final EncryptorManager encryptorManager

Constructor Details

DefaultMappingManager

public DefaultMappingManager(AnyTypeDAO anyTypeDAO,
 UserDAO userDAO,
 AnyObjectDAO anyObjectDAO,
 GroupDAO groupDAO,
 RelationshipTypeDAO relationshipTypeDAO,
 RealmSearchDAO realmSearchDAO,
 ImplementationDAO implementationDAO,
 DerAttrHandler derAttrHandler,
 IntAttrNameParser intAttrNameParser,
 EncryptorManager encryptorManager)

Method Details

processPreparedAttr

protected static Optional<String> processPreparedAttr(Pair<String,Attribute> preparedAttr,
 Set<Attribute> attributes)

getName

protected static Name getName(String evalConnObjectLink,
 String connObjectKey)

clonePlainAttrValue

protected static PlainAttrValue clonePlainAttrValue(PlainAttrValue src)

getTransformers

protected List<Implementation> getTransformers(Item item)

evaluateNAME

protected Name evaluateNAME(Any any,
 Provision provision,
 String connObjectKey)

Build __NAME__ for propagation. First look if there is a defined connObjectLink for the given resource (and in this case evaluate as JEXL); otherwise, take given connObjectKey.

Parameters:

any - given any object

provision - external resource

connObjectKey - connector object key

Returns:

the value to be propagated as __NAME__

evaluateNAME

protected Name evaluateNAME(Realm realm,
 OrgUnit orgUnit,
 String connObjectKey)

Build __NAME__ for propagation. First look if there is a defined connObjectLink for the given resource (and in this case evaluate as JEXL); otherwise, take given connObjectKey.

Parameters:

realm - given any object

orgUnit - external resource

connObjectKey - connector object key

Returns:

the value to be propagated as __NAME__

prepareAttrsFromAny

@Transactional(readOnly=true)
public Pair<String,Set<Attribute>> prepareAttrsFromAny(Any any,
 String password,
 boolean changePwd,
 Boolean enable,
 ExternalResource resource,
 Provision provision)

Description copied from interface: MappingManager

Prepare attributes for sending to a connector instance.

Specified by:

prepareAttrsFromAny in interface MappingManager

Parameters:

any - given any object

password - clear-text password

changePwd - whether password should be included for propagation attributes or not

enable - whether any object must be enabled or not

resource - resource information

provision - provision information

Returns:

connObjectLink + prepared attributes

prepareAttrsFromLinkedAccount

@Transactional(readOnly=true)
public Set<Attribute> prepareAttrsFromLinkedAccount(User user,
 LinkedAccount account,
 String password,
 boolean changePwd,
 Provision provision)

Description copied from interface: MappingManager

Prepare attributes for sending to a connector instance.

Specified by:

prepareAttrsFromLinkedAccount in interface MappingManager

Parameters:

user - given user

account - linked account

password - user's clear-text password, to use as default value in case

changePwd - whether password should be included for propagation attributes or not

provision - provision information

Returns:

prepared attributes

prepareAttrsFromRealm

public Pair<String,Set<Attribute>> prepareAttrsFromRealm(Realm realm,
 ExternalResource resource)

Description copied from interface: MappingManager

Prepare attributes for sending to a connector instance.

Specified by:

prepareAttrsFromRealm in interface MappingManager

Parameters:

realm - Realm

resource - resource information

Returns:

connObjectLink + prepared attributes

decodePassword

protected Optional<String> decodePassword(Account account)

getPasswordAttrValue

protected Optional<String> getPasswordAttrValue(Account account,
 String defaultValue)

prepareAttr

public Pair<String,Attribute> prepareAttr(ExternalResource resource,
 Provision provision,
 Item item,
 Any any,
 String password,
 AccountGetter usernameAccountGetter,
 AccountGetter passwordAccountGetter,
 PlainAttrGetter plainAttrGetter)

Description copied from interface: MappingManager

Prepare attribute for sending to a connector instance.

Specified by:

prepareAttr in interface MappingManager

Parameters:

resource - resource information

provision - provision information

item - mapping item

any - given any object

password - clear-text password

usernameAccountGetter - function to get actual account instance for username

passwordAccountGetter - function to get actual account instance for password

plainAttrGetter - function to get PlainAttr instances

Returns:

connObjectLink (if it is the case) + prepared attribute

prepareAttr

public Pair<String,Attribute> prepareAttr(ExternalResource resource,
 Item item,
 Realm realm)

Description copied from interface: MappingManager

Prepare attribute for sending to a connector instance.

Specified by:

prepareAttr in interface MappingManager

Parameters:

resource - resource information

item - mapping item

realm - given realm

Returns:

connObjectLink (if it is the case) + prepared attribute

getIntValues

@Transactional(readOnly=true)
public Pair<AttrSchemaType,List<PlainAttrValue>> getIntValues(ExternalResource resource,
 Provision provision,
 Item item,
 IntAttrName intAttrName,
 AttrSchemaType schemaType,
 Any any,
 AccountGetter usernameAccountGetter,
 PlainAttrGetter plainAttrGetter)

Description copied from interface: MappingManager

Get attribute values for the given Item and any object.

Specified by:

getIntValues in interface MappingManager

Parameters:

resource - resource information

provision - provision information

item - mapping item

intAttrName - int attr name

schemaType - schema type

any - any object

usernameAccountGetter - function to get actual account instance for username

plainAttrGetter - function to get PlainAttr instances

Returns:

attribute values and their type

getIntValues

@Transactional(readOnly=true)
public Pair<AttrSchemaType,List<PlainAttrValue>> getIntValues(ExternalResource resource,
 Item item,
 IntAttrName intAttrName,
 AttrSchemaType schemaType,
 Realm realm)

Description copied from interface: MappingManager

Get attribute values for the given Item and realm.

Specified by:

getIntValues in interface MappingManager

Parameters:

resource - resource information

item - mapping item

intAttrName - int attr name

schemaType - schema type

realm - realm

Returns:

attribute values and their type

getGroupOwnerValue

protected String getGroupOwnerValue(ExternalResource resource,
 Provision provision,
 Any any)

getConnObjectKeyValue

@Transactional(readOnly=true)
public Optional<String> getConnObjectKeyValue(Any any,
 ExternalResource resource,
 Provision provision)

Description copied from interface: MappingManager

Get connObjectKey internal value.

Specified by:

getConnObjectKeyValue in interface MappingManager

Parameters:

any - any object

resource - resource information

provision - provision information

Returns:

connObjectKey internal value

getConnObjectKeyValue

@Transactional(readOnly=true)
public Optional<String> getConnObjectKeyValue(Realm realm,
 ExternalResource resource)

Description copied from interface: MappingManager

Get connObjectKey internal value.

Specified by:

getConnObjectKeyValue in interface MappingManager

Parameters:

realm - realm

resource - resource information

Returns:

connObjectKey internal value

setIntValues

@Transactional(readOnly=true)
public void setIntValues(Item item,
 Attribute attr,
 AnyTO anyTO)

Description copied from interface: MappingManager

Set attribute values, according to the given Item, to any object from attribute received from connector.

Specified by:

setIntValues in interface MappingManager

Parameters:

item - mapping item

attr - attribute received from connector

anyTO - any object

setIntValues

public void setIntValues(Item item,
 Attribute attr,
 RealmTO realmTO)

Description copied from interface: MappingManager

Set attribute values, according to the given Item, to realm from attribute received from connector.

Specified by:

setIntValues in interface MappingManager

Parameters:

item - mapping item

attr - attribute received from connector

realmTO - realm

hasMustChangePassword

public boolean hasMustChangePassword(Provision provision)

Description copied from interface: MappingManager

Checks if there is a mapping item in the given Provision for mustChangePassword.

Specified by:

hasMustChangePassword in interface MappingManager

Parameters:

provision - provision

Returns:

if there is a mapping item in the given provision for mustChangePassword