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 AnyObjectDAO	anyObjectDAO
protected AnyTypeDAO	anyTypeDAO
protected AnyUtilsFactory	anyUtilsFactory
protected ApplicationDAO	applicationDAO
protected DerAttrHandler	derAttrHandler
protected static Encryptor	ENCRYPTOR
protected GroupDAO	groupDAO
protected ImplementationDAO	implementationDAO
protected IntAttrNameParser	intAttrNameParser
protected static Logger	LOG
protected RealmDAO	realmDAO
protected RelationshipTypeDAO	relationshipTypeDAO
protected UserDAO	userDAO
protected VirAttrCache	virAttrCache
protected VirAttrHandler	virAttrHandler

Constructor Summary

Constructors

Constructor	Description
DefaultMappingManager(AnyTypeDAO anyTypeDAO, UserDAO userDAO, AnyObjectDAO anyObjectDAO, GroupDAO groupDAO, RelationshipTypeDAO relationshipTypeDAO, RealmDAO realmDAO, ApplicationDAO applicationDAO, ImplementationDAO implementationDAO, DerAttrHandler derAttrHandler, VirAttrHandler virAttrHandler, VirAttrCache virAttrCache, AnyUtilsFactory anyUtilsFactory, IntAttrNameParser intAttrNameParser)

Method Summary

Modifier and Type	Method	Description
protected 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, OrgUnit orgUnit)	Get connObjectKey internal value.
protected String	getGroupOwnerValue(ExternalResource resource, Provision provision, Any<?> any)
protected String	getIntValue(Realm realm, Item orgUnitItem)
Pair<AttrSchemaType,List<PlainAttrValue>>	getIntValues(ExternalResource resource, Provision provision, Item mapItem, 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 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, 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, OrgUnit orgUnit)	Prepare attributes for sending to a connector instance.
protected String	processPreparedAttr(Pair<String,Attribute> preparedAttr, Set<Attribute> attributes)
void	setIntValues(Item mapItem, 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 Detail

LOG

protected static final Logger LOG

ENCRYPTOR

protected static final Encryptor ENCRYPTOR

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

realmDAO

protected final RealmDAO realmDAO

applicationDAO

protected final ApplicationDAO applicationDAO

implementationDAO

protected final ImplementationDAO implementationDAO

derAttrHandler

protected final DerAttrHandler derAttrHandler

virAttrHandler

protected final VirAttrHandler virAttrHandler

virAttrCache

protected final VirAttrCache virAttrCache

anyUtilsFactory

protected final AnyUtilsFactory anyUtilsFactory

intAttrNameParser

protected final IntAttrNameParser intAttrNameParser

Constructor Detail

DefaultMappingManager

public DefaultMappingManager(AnyTypeDAO anyTypeDAO,
                             UserDAO userDAO,
                             AnyObjectDAO anyObjectDAO,
                             GroupDAO groupDAO,
                             RelationshipTypeDAO relationshipTypeDAO,
                             RealmDAO realmDAO,
                             ApplicationDAO applicationDAO,
                             ImplementationDAO implementationDAO,
                             DerAttrHandler derAttrHandler,
                             VirAttrHandler virAttrHandler,
                             VirAttrCache virAttrCache,
                             AnyUtilsFactory anyUtilsFactory,
                             IntAttrNameParser intAttrNameParser)

Method Detail

getTransformers

protected List<Implementation> getTransformers(Item item)

processPreparedAttr

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

getName

protected static Name getName(String evalConnObjectLink,
                              String connObjectKey)

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

getIntValue

protected String getIntValue(Realm realm,
                             Item orgUnitItem)

prepareAttrsFromRealm

public Pair<String,Set<Attribute>> prepareAttrsFromRealm(Realm realm,
                                                               OrgUnit orgUnit)

Description copied from interface: MappingManager

Prepare attributes for sending to a connector instance.

Specified by:

prepareAttrsFromRealm in interface MappingManager

Parameters:

realm - Realm

orgUnit - provision information

Returns:

connObjectLink + prepared attributes

decodePassword

protected String decodePassword(Account account)

getPasswordAttrValue

protected 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

getIntValues

@Transactional(readOnly=true)
public Pair<AttrSchemaType,List<PlainAttrValue>> getIntValues(ExternalResource resource,
                                                                    Provision provision,
                                                                    Item mapItem,
                                                                    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

mapItem - 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

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,
                                              OrgUnit orgUnit)

Description copied from interface: MappingManager

Get connObjectKey internal value.

Specified by:

getConnObjectKeyValue in interface MappingManager

Parameters:

realm - realm

orgUnit - orgUnit information

Returns:

connObjectKey internal value

setIntValues

@Transactional(readOnly=true)
public void setIntValues(Item mapItem,
                         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:

mapItem - 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

@Transactional(readOnly=true)
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