edu.amc.sakai.user

Class EntryAttributeToUserTypeMapper

java.lang.Object

edu.amc.sakai.user.EntryAttributeToUserTypeMapper

All Implemented Interfaces:

UserTypeMapper

public class EntryAttributeToUserTypeMapper
extends Object
implements UserTypeMapper

Maps from a user entry's attribute to a Sakai user type. Will consider attribute values in the order received, returning the first non-null mapping. If no non-null mappings can be found, will return either a configurable default or the first attribute value, unmodified. TODO: could probably refactor to reduce code duplication with EntryContainerRdnToUserTypeMapper

Author:

Dan McCallum, Unicon Inc

Constructor Summary

Constructors

Constructor and Description
EntryAttributeToUserTypeMapper()

Method Summary

Modifier and Type	Method and Description
Map<String,String>	getAttributeValueToSakaiUserTypeMap() Retrieve the current attribute value-to-Sakai user type map.
String	getDefaultSakaiUserType() Retrieve the default Sakai user type, which will be returned from mapLdapEntryToSakaiUserType(LDAPEntry, LdapAttributeMapper) if no mapping was found and isReturnLiteralAttributeValueIfNoMapping() is false
String	getLogicalAttributeName() Access the key to a physical attribute name which will be used to resolve Sakai user types.
protected com.novell.ldap.LDAPAttribute	getUserTypeAttribute(com.novell.ldap.LDAPEntry ldapEntry, LdapAttributeMapper mapper) Extracts the LDAPAttribute which represents the LDAPEntry's group membership.
boolean	isReturnLiteralAttributeValueIfNoMapping() Check the behavior when attribute values cannot be mapped to a Sakai user type.
String	mapLdapEntryToSakaiUserType(com.novell.ldap.LDAPEntry ldapEntry, LdapAttributeMapper mapper) Maps the attribute values associated with the specified LDAPEntry to a Sakai user type.
protected String	mapUserTypeAttributeValue(String attrValue) Effectively the same as getAttributeValueToSakaiUserTypeMap().get(attrValue).
protected String	mapUserTypeAttributeValues(String[] attrValues) Maps the given list of attribute values to a single Sakai user type by passing each received String value, in order, to mapUserTypeAttributeValue(String).
void	setAttributeValueToSakaiUserTypeMap(Map<String,String> attributeValueToSakaiUserTypeMap) Assign the attribute value-to-Sakai user type map.
void	setDefaultSakaiUserType(String defaultSakaiUserType) Assign the default Sakai user type.
void	setLogicalAttributeName(String logicalAttributeName) Assign the key to a physical attribute name which will be used to resolve Sakai user types.
void	setReturnLiteralAttributeValueIfNoMapping(boolean returnLiteralAttributeValueIfNoMapping) Assign the behavior for calculating Sakai user types when attribute values fail to map.

Methods inherited from class java.lang.Object

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

Constructor Detail

EntryAttributeToUserTypeMapper

public EntryAttributeToUserTypeMapper()

Method Detail

mapLdapEntryToSakaiUserType

public String mapLdapEntryToSakaiUserType(com.novell.ldap.LDAPEntry ldapEntry,
                                          LdapAttributeMapper mapper)

Maps the attribute values associated with the specified LDAPEntry to a Sakai user type. setLogicalAttributeName(String) defines the attribute name to consult. setAttributeValueToSakaiUserTypeMap(Map) controls the attribute value mappings. setReturnLiteralAttributeValueIfNoMapping(boolean) controls behavior when attribute value mapping fails. setDefaultSakaiUserType(String) assigns the String to return if attribute value mapping fails and literal value returns have been disabled.

Specified by:

mapLdapEntryToSakaiUserType in interface UserTypeMapper

Parameters:

ldapEntry - the LDAPEntry to map

mapper - a container for attribute mapping config

Returns:

a Sakai user type, possibly null

See Also:

getUserTypeAttribute(LDAPEntry, LdapAttributeMapper)

getUserTypeAttribute

protected com.novell.ldap.LDAPAttribute getUserTypeAttribute(com.novell.ldap.LDAPEntry ldapEntry,
                                                             LdapAttributeMapper mapper)

Extracts the LDAPAttribute which represents the LDAPEntry's group membership. This is accomplished by querying the given LdapAttributeMapper for an attribute name corresponding to getLogicalAttributeName().

Parameters:

ldapEntry - the LDAPEntry from which to extract a LDAPAttribute

mapper - a container for attribute mapping config

Returns:

a user type LDAPAttribute or null if none could be found on the given LDAPEntry

mapUserTypeAttributeValues

protected String mapUserTypeAttributeValues(String[] attrValues)

Maps the given list of attribute values to a single Sakai user type by passing each received String value, in order, to mapUserTypeAttributeValue(String). Exits with the first non-null return from that method or a value dependent on current value of isReturnLiteralAttributeValueIfNoMapping()

Parameters:

attrValues - String values to test

Returns:

a Sakai user type, possibly null

mapUserTypeAttributeValue

protected String mapUserTypeAttributeValue(String attrValue)

Effectively the same as getAttributeValueToSakaiUserTypeMap().get(attrValue). Returns null if no mapping has been assigned.

Parameters:

attrValue - the attribute value to map

Returns:

the mapped value or null if no map or mapping

getAttributeValueToSakaiUserTypeMap

public Map<String,String> getAttributeValueToSakaiUserTypeMap()

Retrieve the current attribute value-to-Sakai user type map.

Returns:

a map of attribute values to Sakai user types

setAttributeValueToSakaiUserTypeMap

public void setAttributeValueToSakaiUserTypeMap(Map<String,String> attributeValueToSakaiUserTypeMap)

Assign the attribute value-to-Sakai user type map.

Parameters:

attributeValueToSakaiUserTypeMap - a map of attribute values to Sakai user types

getDefaultSakaiUserType

public String getDefaultSakaiUserType()

Retrieve the default Sakai user type, which will be returned from mapLdapEntryToSakaiUserType(LDAPEntry, LdapAttributeMapper) if no mapping was found and isReturnLiteralAttributeValueIfNoMapping() is false

Returns:

the default Sakai user type to return from mapLdapEntryToSakaiUserType(LDAPEntry, LdapAttributeMapper)

setDefaultSakaiUserType

public void setDefaultSakaiUserType(String defaultSakaiUserType)

Assign the default Sakai user type.

Parameters:

defaultSakaiUserType - the default Sakai user type to return from mapLdapEntryToSakaiUserType(LDAPEntry, LdapAttributeMapper)

See Also:

getDefaultSakaiUserType()

getLogicalAttributeName

public String getLogicalAttributeName()

Access the key to a physical attribute name which will be used to resolve Sakai user types. Physical names are retrieved by querying the LdapAttributeMapper passed to mapLdapEntryToSakaiUserType(LDAPEntry, LdapAttributeMapper).

Returns:

a logical attribute name

setLogicalAttributeName

public void setLogicalAttributeName(String logicalAttributeName)

Assign the key to a physical attribute name which will be used to resolve Sakai user types.

Parameters:

logicalAttributeName -

See Also:

getLogicalAttributeName()

isReturnLiteralAttributeValueIfNoMapping

public boolean isReturnLiteralAttributeValueIfNoMapping()

Check the behavior when attribute values cannot be mapped to a Sakai user type. If true, mapLdapEntryToSakaiUserType(LDAPEntry, LdapAttributeMapper) will return the first attribute value encountered, otherwise will return the current value of getDefaultSakaiUserType(). Defaults to false.

Returns:

true if failed mappings should return literal attribute values.

setReturnLiteralAttributeValueIfNoMapping

public void setReturnLiteralAttributeValueIfNoMapping(boolean returnLiteralAttributeValueIfNoMapping)

Assign the behavior for calculating Sakai user types when attribute values fail to map.

Parameters:

returnLiteralAttributeValueIfNoMapping -

See Also:

isReturnLiteralAttributeValueIfNoMapping()