org.kuali.rice.kim.impl.identity
Class IdentityServiceImpl

java.lang.Object
  org.kuali.rice.kim.impl.identity.IdentityServiceImpl

All Implemented Interfaces:

IdentityService

Direct Known Subclasses:

LdapIdentityDelegateServiceImpl

public class IdentityServiceImpl
extends Object
implements IdentityService

Base implementation of the identity (identity) service. This version assumes the KimEntity and related data is located within the KIM database.

Author:

Kuali Rice Team (rice.collab@kuali.org)

Constructor Summary

IdentityServiceImpl()

Method Summary

EntityAddress	addAddressToEntity(EntityAddress address) This will create a EntityAddress exactly like the address passed in.
EntityAffiliation	addAffiliationToEntity(EntityAffiliation affiliation) This will create a EntityAffiliation exactly like the affiliation passed in.
EntityBioDemographics	addBioDemographicsToEntity(EntityBioDemographics bioDemographics) This will create a EntityBioDemographics exactly like the bioDemographics passed in.
EntityCitizenship	addCitizenshipToEntity(EntityCitizenship citizenship) This will create a EntityCitizenship exactly like the citizenship passed in.
EntityEmail	addEmailToEntity(EntityEmail email) This will create a EntityEmail exactly like the email passed in.
EntityEmployment	addEmploymentToEntity(EntityEmployment employment) This will create a EntityEmployment exactly like the employment passed in.
EntityTypeContactInfo	addEntityTypeContactInfoToEntity(EntityTypeContactInfo entityTypeData) This will create a EntityTypeContactInfo exactly like the entityTypeContactInfo passed in.
EntityEthnicity	addEthnicityToEntity(EntityEthnicity ethnicity) This will create a EntityEthnicity exactly like the ethnicity passed in.
EntityExternalIdentifier	addExternalIdentifierToEntity(EntityExternalIdentifier externalId) This will create a EntityExternalIdentifier exactly like the externalId passed in.
EntityName	addNameToEntity(EntityName name) This will create a EntityName exactly like the name passed in.
EntityPhone	addPhoneToEntity(EntityPhone phone) This will create a EntityPhone exactly like the phone passed in.
Principal	addPrincipalToEntity(Principal principal) This will create a Principal exactly like the principal passed in.
EntityPrivacyPreferences	addPrivacyPreferencesToEntity(EntityPrivacyPreferences privacyPreferences) This will create a EntityPrivacyPreferences exactly like the privacyPreferences passed in.
EntityResidency	addResidencyToEntity(EntityResidency residency) This will create a EntityResidency exactly like the residency passed in.
EntityVisa	addVisaToEntity(EntityVisa visa) This will create a EntityVisa exactly like the visa passed in.
Entity	createEntity(Entity entity) This will create a Entity exactly like the entity passed in.
EntityQueryResults	findEntities(QueryByCriteria queryByCriteria) This method finds Entities based on a query criteria.
EntityDefaultQueryResults	findEntityDefaults(QueryByCriteria queryByCriteria) This method finds EntityDefault data based on a query criteria.
protected EntityNameQueryResults	findNames(QueryByCriteria queryByCriteria)
CodedAttribute	getAddressType(String code) Gets the CodedAttribute for a given EntityAddressType code.
EntityAffiliationType	getAffiliationType(String code) Gets the EntityAffiliationType for a given EntityAffiliationType code.
CodedAttribute	getCitizenshipStatus(String code) Gets the CodedAttribute for a given EntityCitizenship status code.
CodedAttribute	getEmailType(String code) Gets the CodedAttribute for a given EntityEmail type code.
CodedAttribute	getEmploymentStatus(String code) Gets the CodedAttribute for a given EntityEmployment status code.
CodedAttribute	getEmploymentType(String code) Gets the CodedAttribute for a given EntityEmployment type code.
Entity	getEntity(String entityId) Gets a Entity from an id.
protected org.kuali.rice.kim.impl.identity.entity.EntityBo	getEntityBoByPrincipalId(String principalId)
protected org.kuali.rice.kim.impl.identity.entity.EntityBo	getEntityBoByPrincipalName(String principalName)
protected org.kuali.rice.kim.impl.identity.entity.EntityBo	getEntityByKeyValue(String key, String value) Generic helper method for performing a lookup through the business object service.
Entity	getEntityByPrincipalId(String principalId) Gets a Entity from a principalId.
Entity	getEntityByPrincipalName(String principalName) Gets a Entity from a principalName.
EntityDefault	getEntityDefault(String entityId) Gets a EntityDefault from an id.
EntityDefault	getEntityDefaultByPrincipalId(String principalId) Gets a EntityDefault from an principalId.
EntityDefault	getEntityDefaultByPrincipalName(String principalName) Gets a EntityDefault from an principalName.
EntityPrivacyPreferences	getEntityPrivacyPreferences(String entityId) Gets a EntityPrivacyPreferences for a given id.
CodedAttribute	getEntityType(String code) Gets the CodedAttribute for a given EntityType code.
EntityExternalIdentifierType	getExternalIdentifierType(String code) Gets the EntityExternalIdentifierType for a given type code.
CodedAttribute	getNameType(String code) Gets the CodedAttribute for a given EntityName type code.
CodedAttribute	getPhoneType(String code) Gets the CodedAttribute for a given EntityPhone type code.
Principal	getPrincipal(String principalId) Gets a Principal from an principalId.
Principal	getPrincipalByPrincipalName(String principalName) Gets a Principal from an principalName.
Principal	getPrincipalByPrincipalNameAndPassword(String principalName, String password) Gets a Principal from an principalName and password.
EntityAddress	inactivateAddress(String addressId) This will inactivate a EntityAddress with the id passed in.
EntityAffiliation	inactivateAffiliation(String id) This will inactivate a EntityAffiliation with the id passed in.
EntityCitizenship	inactivateCitizenship(String id) This will inactivate a EntityCitizenship with the unique id passed in.
EntityEmail	inactivateEmail(String emailId) This will inactivate the EntityEmail with the passed in id.
EntityEmployment	inactivateEmployment(String id) This will inactivate a EntityEmployment with the passed in id.
Entity	inactivateEntity(String entityId) This will inactivate a Entity.
EntityTypeContactInfo	inactivateEntityTypeContactInfo(String entityId, String entityTypeCode) This will inactivate a EntityTypeContactInfo with the passed in parameters.
EntityName	inactivateName(String id) This will inactivate a EntityName with the passed in id.
EntityPhone	inactivatePhone(String phoneId) This will inactivate the EntityPhone with the passed in id.
Principal	inactivatePrincipal(String principalId) This will inactivate a Principal.
Principal	inactivatePrincipalByName(String principalName) This will inactivate a Principal.
void	setBusinessObjectService(BusinessObjectService businessObjectService)
void	setCriteriaLookupService(CriteriaLookupService criteriaLookupService)
EntityAddress	updateAddress(EntityAddress address) This will update a EntityAddress exactly like the address passed in.
EntityAffiliation	updateAffiliation(EntityAffiliation affiliation) This will update a EntityAffiliation exactly like the affiliation passed in.
EntityBioDemographics	updateBioDemographics(EntityBioDemographics bioDemographics) This will update a EntityBioDemographics exactly like the bioDemographics passed in.
EntityCitizenship	updateCitizenship(EntityCitizenship citizenship) This will update a EntityCitizenship exactly like the citizenship passed in.
EntityEmail	updateEmail(EntityEmail email) This will update a EntityEmail exactly like the email passed in.
EntityEmployment	updateEmployment(EntityEmployment employment) This will update a EntityEmployment exactly like the employment passed in.
Entity	updateEntity(Entity entity) This will update a Entity.
EntityTypeContactInfo	updateEntityTypeContactInfo(EntityTypeContactInfo entityTypeContactInfo) This will update a EntityTypeContactInfo exactly like the entityTypeContactInfo passed in.
EntityEthnicity	updateEthnicity(EntityEthnicity ethnicity) This will update a EntityEthnicity exactly like the ethnicity passed in.
EntityExternalIdentifier	updateExternalIdentifier(EntityExternalIdentifier externalId) This will update a EntityExternalIdentifier exactly like the externalId passed in.
EntityName	updateName(EntityName name) This will update a EntityName exactly like the name passed in.
EntityPhone	updatePhone(EntityPhone phone) This will update a EntityPhone exactly like the phone passed in.
Principal	updatePrincipal(Principal principal) This will update a Principal exactly like the principal passed in.
EntityPrivacyPreferences	updatePrivacyPreferences(EntityPrivacyPreferences privacyPreferences) This will update a EntityPrivacyPreferences exactly like the privacyPreferences passed in.
EntityResidency	updateResidency(EntityResidency residency) This will update a EntityResidency exactly like the residency passed in.
EntityVisa	updateVisa(EntityVisa visa) This will update a EntityVisa exactly like the visa passed in.

Methods inherited from class java.lang.Object

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

Constructor Detail

IdentityServiceImpl

public IdentityServiceImpl()

Method Detail

getEntity

public Entity getEntity(String entityId)
                 throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets a Entity from an id.

This method will return null if the Entity does not exist.

Specified by:

getEntity in interface IdentityService

Parameters:

entityId - the unique id to retrieve the entity by. cannot be null.

Returns:

a Entity or null

Throws:

RiceIllegalArgumentException

getEntityByPrincipalId

public Entity getEntityByPrincipalId(String principalId)
                              throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets a Entity from a principalId.

This method will return null if the Entity does not exist.

Specified by:

getEntityByPrincipalId in interface IdentityService

Parameters:

principalId - the unique id to retrieve the entity by. cannot be null.

Returns:

a Entity or null

Throws:

RiceIllegalArgumentException

getEntityByPrincipalName

public Entity getEntityByPrincipalName(String principalName)
                                throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets a Entity from a principalName.

This method will return null if the Entity does not exist.

Specified by:

getEntityByPrincipalName in interface IdentityService

Parameters:

principalName - the unique id to retrieve the entity by. cannot be null.

Returns:

a Entity or null

Throws:

RiceIllegalArgumentException

getEntityDefault

public EntityDefault getEntityDefault(String entityId)
                               throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets a EntityDefault from an id. EntityDefault is a condensed version of Entity that contains default values of its subclasses

This method will return null if the Entity does not exist.

Specified by:

getEntityDefault in interface IdentityService

Parameters:

entityId - the unique id to retrieve the entity by. cannot be null.

Returns:

a EntityDefault or null

Throws:

RiceIllegalArgumentException

getEntityDefaultByPrincipalId

public EntityDefault getEntityDefaultByPrincipalId(String principalId)
                                            throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets a EntityDefault from an principalId. EntityDefault is a condensed version of Entity that contains default values of its subclasses

This method will return null if the Entity does not exist.

Specified by:

getEntityDefaultByPrincipalId in interface IdentityService

Parameters:

principalId - the unique id to retrieve the entity by. cannot be null.

Returns:

a EntityDefault or null

Throws:

RiceIllegalArgumentException

getEntityDefaultByPrincipalName

public EntityDefault getEntityDefaultByPrincipalName(String principalName)
                                              throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets a EntityDefault from an principalName. EntityDefault is a condensed version of Entity that contains default values of its subclasses

This method will return null if the Entity does not exist.

Specified by:

getEntityDefaultByPrincipalName in interface IdentityService

Parameters:

principalName - the unique id to retrieve the entity by. cannot be null.

Returns:

a EntityDefault or null

Throws:

RiceIllegalArgumentException

getPrincipalByPrincipalNameAndPassword

public Principal getPrincipalByPrincipalNameAndPassword(String principalName,
                                                        String password)
                                                 throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets a Principal from an principalName and password.

This method will return null if the Principal does not exist or the password is incorrect.

Specified by:

getPrincipalByPrincipalNameAndPassword in interface IdentityService

Parameters:

principalName - the unique id to retrieve the principal by. cannot be null.

password - the password for the principal

Returns:

a Principal or null

Throws:

RiceIllegalArgumentException

addPrincipalToEntity

public Principal addPrincipalToEntity(Principal principal)
                               throws RiceIllegalArgumentException,
                                      RiceIllegalStateException

Description copied from interface: IdentityService

This will create a Principal exactly like the principal passed in. The principal object passed in must be populated with an entityId and a principalName

Specified by:

addPrincipalToEntity in interface IdentityService

Parameters:

principal - the principal to create

Returns:

the newly created Principal object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

updatePrincipal

public Principal updatePrincipal(Principal principal)
                          throws RiceIllegalArgumentException,
                                 RiceIllegalStateException

Description copied from interface: IdentityService

This will update a Principal exactly like the principal passed in.

Specified by:

updatePrincipal in interface IdentityService

Parameters:

principal - the principal to update

Returns:

the updated Principal object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

inactivatePrincipal

public Principal inactivatePrincipal(String principalId)
                              throws RiceIllegalArgumentException,
                                     RiceIllegalStateException

Description copied from interface: IdentityService

This will inactivate a Principal.

Specified by:

inactivatePrincipal in interface IdentityService

Parameters:

principalId - the unique id of the principal to inactivate

Returns:

the inactivated Principal object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

inactivatePrincipalByName

public Principal inactivatePrincipalByName(String principalName)
                                    throws RiceIllegalArgumentException,
                                           RiceIllegalStateException

Description copied from interface: IdentityService

This will inactivate a Principal.

Specified by:

inactivatePrincipalByName in interface IdentityService

Parameters:

principalName - the unique principalName of the principal to inactivate

Returns:

the inactivated Principal object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

addEntityTypeContactInfoToEntity

public EntityTypeContactInfo addEntityTypeContactInfoToEntity(EntityTypeContactInfo entityTypeData)
                                                       throws RiceIllegalArgumentException,
                                                              RiceIllegalStateException

Description copied from interface: IdentityService

This will create a EntityTypeContactInfo exactly like the entityTypeContactInfo passed in. The EntityTypeContactInfo object passed in must be populated with an entityId and a entityTypeCode

Specified by:

addEntityTypeContactInfoToEntity in interface IdentityService

Parameters:

entityTypeData - the EntityTypeContactInfo to create

Returns:

the newly created EntityTypeContactInfo object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

updateEntityTypeContactInfo

public EntityTypeContactInfo updateEntityTypeContactInfo(EntityTypeContactInfo entityTypeContactInfo)
                                                  throws RiceIllegalArgumentException,
                                                         RiceIllegalStateException

Description copied from interface: IdentityService

This will update a EntityTypeContactInfo exactly like the entityTypeContactInfo passed in.

Specified by:

updateEntityTypeContactInfo in interface IdentityService

Parameters:

entityTypeContactInfo - the EntityTypeContactInfo to update

Returns:

the updated EntityTypeContactInfo object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

inactivateEntityTypeContactInfo

public EntityTypeContactInfo inactivateEntityTypeContactInfo(String entityId,
                                                             String entityTypeCode)
                                                      throws RiceIllegalArgumentException,
                                                             RiceIllegalStateException

Description copied from interface: IdentityService

This will inactivate a EntityTypeContactInfo with the passed in parameters.

Specified by:

inactivateEntityTypeContactInfo in interface IdentityService

Parameters:

entityId - the entityId of the EntityTypeContactInfo to inactivate

entityTypeCode - the entityTypeCode of the EntityTypeContactInfo to inactivate

Returns:

the inactivated EntityTypeContactInfo object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

addAddressToEntity

public EntityAddress addAddressToEntity(EntityAddress address)
                                 throws RiceIllegalArgumentException,
                                        RiceIllegalStateException

Description copied from interface: IdentityService

This will create a EntityAddress exactly like the address passed in. The EntityAddress object passed in must be populated with an entityId and a entityTypeCode

Specified by:

addAddressToEntity in interface IdentityService

Parameters:

address - the EntityAddress to create

Returns:

the newly created EntityAddress object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

updateAddress

public EntityAddress updateAddress(EntityAddress address)
                            throws RiceIllegalArgumentException,
                                   RiceIllegalStateException

Description copied from interface: IdentityService

This will update a EntityAddress exactly like the address passed in.

Specified by:

updateAddress in interface IdentityService

Parameters:

address - the EntityAddress to update

Returns:

the updated EntityAddress object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

inactivateAddress

public EntityAddress inactivateAddress(String addressId)
                                throws RiceIllegalArgumentException,
                                       RiceIllegalStateException

Description copied from interface: IdentityService

This will inactivate a EntityAddress with the id passed in.

Specified by:

inactivateAddress in interface IdentityService

Parameters:

addressId - the unique id of the EntityAddress to inactivate

Returns:

the updated EntityAddress object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

addEmailToEntity

public EntityEmail addEmailToEntity(EntityEmail email)
                             throws RiceIllegalArgumentException,
                                    RiceIllegalStateException

Description copied from interface: IdentityService

This will create a EntityEmail exactly like the email passed in. The EntityEmail object passed in must be populated with an entityId and a entityTypeCode

Specified by:

addEmailToEntity in interface IdentityService

Parameters:

email - the EntityEmail to create

Returns:

the newly created EntityEmail object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

updateEmail

public EntityEmail updateEmail(EntityEmail email)
                        throws RiceIllegalArgumentException,
                               RiceIllegalStateException

Description copied from interface: IdentityService

This will update a EntityEmail exactly like the email passed in.

Specified by:

updateEmail in interface IdentityService

Parameters:

email - the EntityEmail to update

Returns:

the updated EntityEmail object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

inactivateEmail

public EntityEmail inactivateEmail(String emailId)
                            throws RiceIllegalArgumentException,
                                   RiceIllegalStateException

Description copied from interface: IdentityService

This will inactivate the EntityEmail with the passed in id.

Specified by:

inactivateEmail in interface IdentityService

Parameters:

emailId - the unique id of the EntityEmail to inactivate

Returns:

the inactivated EntityEmail object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

addPhoneToEntity

public EntityPhone addPhoneToEntity(EntityPhone phone)
                             throws RiceIllegalArgumentException,
                                    RiceIllegalStateException

Description copied from interface: IdentityService

This will create a EntityPhone exactly like the phone passed in. The EntityPhone object passed in must be populated with an entityId and a entityTypeCode

Specified by:

addPhoneToEntity in interface IdentityService

Parameters:

phone - the EntityPhone to create

Returns:

the newly created EntityPhone object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

updatePhone

public EntityPhone updatePhone(EntityPhone phone)
                        throws RiceIllegalArgumentException,
                               RiceIllegalStateException

Description copied from interface: IdentityService

This will update a EntityPhone exactly like the phone passed in.

Specified by:

updatePhone in interface IdentityService

Parameters:

phone - the EntityPhone to update

Returns:

the updated EntityPhone object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

inactivatePhone

public EntityPhone inactivatePhone(String phoneId)
                            throws RiceIllegalArgumentException,
                                   RiceIllegalStateException

Description copied from interface: IdentityService

This will inactivate the EntityPhone with the passed in id.

Specified by:

inactivatePhone in interface IdentityService

Parameters:

phoneId - the unique id of the EntityPhone to inactivate

Returns:

the inactivated EntityPhone object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

addExternalIdentifierToEntity

public EntityExternalIdentifier addExternalIdentifierToEntity(EntityExternalIdentifier externalId)
                                                       throws RiceIllegalArgumentException,
                                                              RiceIllegalStateException

Description copied from interface: IdentityService

This will create a EntityExternalIdentifier exactly like the externalId passed in. The EntityExternalIdentifier object passed in must be populated with an entityId and a externalIdentifierTypeCode

Specified by:

addExternalIdentifierToEntity in interface IdentityService

Parameters:

externalId - the EntityExternalIdentifier to create

Returns:

the newly created EntityExternalIdentifier object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

updateExternalIdentifier

public EntityExternalIdentifier updateExternalIdentifier(EntityExternalIdentifier externalId)
                                                  throws RiceIllegalArgumentException,
                                                         RiceIllegalStateException

Description copied from interface: IdentityService

This will update a EntityExternalIdentifier exactly like the externalId passed in.

Specified by:

updateExternalIdentifier in interface IdentityService

Parameters:

externalId - the EntityExternalIdentifier to update

Returns:

the updated EntityExternalIdentifier object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

addAffiliationToEntity

public EntityAffiliation addAffiliationToEntity(EntityAffiliation affiliation)
                                         throws RiceIllegalArgumentException,
                                                RiceIllegalStateException

Description copied from interface: IdentityService

This will create a EntityAffiliation exactly like the affiliation passed in. The EntityAffiliation object passed in must be populated with an entityId and a affiliationType

Specified by:

addAffiliationToEntity in interface IdentityService

Parameters:

affiliation - the EntityAffiliation to create

Returns:

the newly created EntityAffiliation object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

updateAffiliation

public EntityAffiliation updateAffiliation(EntityAffiliation affiliation)
                                    throws RiceIllegalArgumentException,
                                           RiceIllegalStateException

Description copied from interface: IdentityService

This will update a EntityAffiliation exactly like the affiliation passed in.

Specified by:

updateAffiliation in interface IdentityService

Parameters:

affiliation - the EntityAffiliation to update

Returns:

the updated EntityAffiliation object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

inactivateAffiliation

public EntityAffiliation inactivateAffiliation(String id)
                                        throws RiceIllegalArgumentException,
                                               RiceIllegalStateException

Description copied from interface: IdentityService

This will inactivate a EntityAffiliation with the id passed in.

Specified by:

inactivateAffiliation in interface IdentityService

Parameters:

id - the unique id of the EntityAffiliation to inactivate

Returns:

the updated EntityAffiliation object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

findEntities

public EntityQueryResults findEntities(QueryByCriteria queryByCriteria)
                                throws RiceIllegalArgumentException

Description copied from interface: IdentityService

This method finds Entities based on a query criteria. The criteria cannot be null.

Specified by:

findEntities in interface IdentityService

Parameters:

queryByCriteria - the criteria. Cannot be null.

Returns:

query results. will never return null.

Throws:

RiceIllegalArgumentException

findEntityDefaults

public EntityDefaultQueryResults findEntityDefaults(QueryByCriteria queryByCriteria)
                                             throws RiceIllegalArgumentException

Description copied from interface: IdentityService

This method finds EntityDefault data based on a query criteria. The criteria cannot be null.

Specified by:

findEntityDefaults in interface IdentityService

Parameters:

queryByCriteria - the criteria. Cannot be null.

Returns:

query results. will never return null.

Throws:

RiceIllegalArgumentException

findNames

protected EntityNameQueryResults findNames(QueryByCriteria queryByCriteria)

getEntityPrivacyPreferences

public EntityPrivacyPreferences getEntityPrivacyPreferences(String entityId)
                                                     throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets a EntityPrivacyPreferences for a given id.

This method will return null if the EntityPrivacyPreferences does not exist.

Specified by:

getEntityPrivacyPreferences in interface IdentityService

Parameters:

entityId - the unique id to retrieve the EntityPrivacyPreferences by. Cannot be null.

Returns:

a EntityPrivacyPreferences or null

Throws:

RiceIllegalArgumentException

getPrincipal

public Principal getPrincipal(String principalId)
                       throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets a Principal from an principalId.

This method will return null if the Principal does not exist.

Specified by:

getPrincipal in interface IdentityService

Parameters:

principalId - the unique id to retrieve the principal by. cannot be null.

Returns:

a Principal or null

Throws:

RiceIllegalArgumentException

getPrincipalByPrincipalName

public Principal getPrincipalByPrincipalName(String principalName)
                                      throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets a Principal from an principalName.

This method will return null if the Principal does not exist.

Specified by:

getPrincipalByPrincipalName in interface IdentityService

Parameters:

principalName - the unique id to retrieve the principal by. cannot be null.

Returns:

a Principal or null

Throws:

RiceIllegalArgumentException

getEntityBoByPrincipalName

protected org.kuali.rice.kim.impl.identity.entity.EntityBo getEntityBoByPrincipalName(String principalName)

See Also:

IdentityService.getEntityByPrincipalName(java.lang.String)

getEntityBoByPrincipalId

protected org.kuali.rice.kim.impl.identity.entity.EntityBo getEntityBoByPrincipalId(String principalId)

See Also:

IdentityService.getEntityByPrincipalId(java.lang.String)

getEntityByKeyValue

protected org.kuali.rice.kim.impl.identity.entity.EntityBo getEntityByKeyValue(String key,
                                                                               String value)

Generic helper method for performing a lookup through the business object service.

getAddressType

public CodedAttribute getAddressType(String code)
                              throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets the CodedAttribute for a given EntityAddressType code.

This method will return null if the code does not exist.

Specified by:

getAddressType in interface IdentityService

Parameters:

code - the unique id to retrieve the Type by. Cannot be null.

Returns:

a CodedAttribute or null

Throws:

RiceIllegalArgumentException

getAffiliationType

public EntityAffiliationType getAffiliationType(String code)
                                         throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets the EntityAffiliationType for a given EntityAffiliationType code.

This method will return null if the code does not exist.

Specified by:

getAffiliationType in interface IdentityService

Parameters:

code - the unique id to retrieve the EntityAffiliationType by. Cannot be null.

Returns:

a EntityAffiliationType or null

Throws:

RiceIllegalArgumentException

getCitizenshipStatus

public CodedAttribute getCitizenshipStatus(String code)
                                    throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets the CodedAttribute for a given EntityCitizenship status code.

This method will return null if the code does not exist.

Specified by:

getCitizenshipStatus in interface IdentityService

Parameters:

code - the unique id to retrieve the Type by. Cannot be null.

Returns:

a CodedAttribute or null

Throws:

RiceIllegalArgumentException

getEmailType

public CodedAttribute getEmailType(String code)
                            throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets the CodedAttribute for a given EntityEmail type code.

This method will return null if the code does not exist.

Specified by:

getEmailType in interface IdentityService

Parameters:

code - the unique id to retrieve the Type by. Cannot be null.

Returns:

a CodedAttribute or null

Throws:

RiceIllegalArgumentException

getEmploymentStatus

public CodedAttribute getEmploymentStatus(String code)
                                   throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets the CodedAttribute for a given EntityEmployment status code.

This method will return null if the code does not exist.

Specified by:

getEmploymentStatus in interface IdentityService

Parameters:

code - the unique id to retrieve the Type by. Cannot be null.

Returns:

a CodedAttribute or null

Throws:

RiceIllegalArgumentException

getEmploymentType

public CodedAttribute getEmploymentType(String code)
                                 throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets the CodedAttribute for a given EntityEmployment type code.

This method will return null if the code does not exist.

Specified by:

getEmploymentType in interface IdentityService

Parameters:

code - the unique id to retrieve the Type by. Cannot be null.

Returns:

a CodedAttribute or null

Throws:

RiceIllegalArgumentException

getNameType

public CodedAttribute getNameType(String code)
                           throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets the CodedAttribute for a given EntityName type code.

This method will return null if the code does not exist.

Specified by:

getNameType in interface IdentityService

Parameters:

code - the unique id to retrieve the Type by. Cannot be null.

Returns:

a CodedAttribute or null

Throws:

RiceIllegalArgumentException

getEntityType

public CodedAttribute getEntityType(String code)
                             throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets the CodedAttribute for a given EntityType code.

This method will return null if the code does not exist.

Specified by:

getEntityType in interface IdentityService

Parameters:

code - the unique id to retrieve the Type by. Cannot be null.

Returns:

a CodedAttribute or null

Throws:

RiceIllegalArgumentException

getExternalIdentifierType

public EntityExternalIdentifierType getExternalIdentifierType(String code)
                                                       throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets the EntityExternalIdentifierType for a given type code.

This method will return null if the code does not exist.

Specified by:

getExternalIdentifierType in interface IdentityService

Parameters:

code - the unique id to retrieve the EntityExternalIdentifierType by. Cannot be null.

Returns:

a CodedAttribute or null

Throws:

RiceIllegalArgumentException

getPhoneType

public CodedAttribute getPhoneType(String code)
                            throws RiceIllegalArgumentException

Description copied from interface: IdentityService

Gets the CodedAttribute for a given EntityPhone type code.

This method will return null if the code does not exist.

Specified by:

getPhoneType in interface IdentityService

Parameters:

code - the unique id to retrieve the Type by. Cannot be null.

Returns:

a CodedAttribute or null

Throws:

RiceIllegalArgumentException

createEntity

public Entity createEntity(Entity entity)
                    throws RiceIllegalArgumentException,
                           RiceIllegalStateException

Description copied from interface: IdentityService

This will create a Entity exactly like the entity passed in.

Specified by:

createEntity in interface IdentityService

Parameters:

entity - the entity to create

Returns:

the newly created Entity object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

updateEntity

public Entity updateEntity(Entity entity)
                    throws RiceIllegalArgumentException,
                           RiceIllegalStateException

Description copied from interface: IdentityService

This will update a Entity.

Specified by:

updateEntity in interface IdentityService

Parameters:

entity - the entity to update

Returns:

the updated Entity object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

inactivateEntity

public Entity inactivateEntity(String entityId)
                        throws RiceIllegalArgumentException,
                               RiceIllegalStateException

Description copied from interface: IdentityService

This will inactivate a Entity.

Specified by:

inactivateEntity in interface IdentityService

Parameters:

entityId - the unique id of the entity to inactivate

Returns:

the inactivated Entity object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

addPrivacyPreferencesToEntity

public EntityPrivacyPreferences addPrivacyPreferencesToEntity(EntityPrivacyPreferences privacyPreferences)
                                                       throws RiceIllegalArgumentException,
                                                              RiceIllegalStateException

Description copied from interface: IdentityService

This will create a EntityPrivacyPreferences exactly like the privacyPreferences passed in. The EntityPrivacyPreferences object passed in must be populated with an entityId

Specified by:

addPrivacyPreferencesToEntity in interface IdentityService

Parameters:

privacyPreferences - the EntityPrivacyPreferences to create

Returns:

the newly created EntityPrivacyPreferences object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

updatePrivacyPreferences

public EntityPrivacyPreferences updatePrivacyPreferences(EntityPrivacyPreferences privacyPreferences)
                                                  throws RiceIllegalArgumentException,
                                                         RiceIllegalStateException

Description copied from interface: IdentityService

This will update a EntityPrivacyPreferences exactly like the privacyPreferences passed in.

Specified by:

updatePrivacyPreferences in interface IdentityService

Parameters:

privacyPreferences - the EntityPrivacyPreferences to update

Returns:

the updated EntityPrivacyPreferences object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

addCitizenshipToEntity

public EntityCitizenship addCitizenshipToEntity(EntityCitizenship citizenship)
                                         throws RiceIllegalArgumentException,
                                                RiceIllegalStateException

Description copied from interface: IdentityService

This will create a EntityCitizenship exactly like the citizenship passed in. The EntityCitizenship object passed in must be populated with an entityId and a status

Specified by:

addCitizenshipToEntity in interface IdentityService

Parameters:

citizenship - the EntityCitizenship to create

Returns:

the newly created EntityCitizenship object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

updateCitizenship

public EntityCitizenship updateCitizenship(EntityCitizenship citizenship)
                                    throws RiceIllegalArgumentException,
                                           RiceIllegalStateException

Description copied from interface: IdentityService

This will update a EntityCitizenship exactly like the citizenship passed in.

Specified by:

updateCitizenship in interface IdentityService

Parameters:

citizenship - the EntityCitizenship to update

Returns:

the updated EntityCitizenship object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

inactivateCitizenship

public EntityCitizenship inactivateCitizenship(String id)
                                        throws RiceIllegalArgumentException,
                                               RiceIllegalStateException

Description copied from interface: IdentityService

This will inactivate a EntityCitizenship with the unique id passed in.

Specified by:

inactivateCitizenship in interface IdentityService

Parameters:

id - the id of the EntityCitizenship to inactivate

Returns:

the inactivated EntityCitizenship object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

addEthnicityToEntity

public EntityEthnicity addEthnicityToEntity(EntityEthnicity ethnicity)
                                     throws RiceIllegalArgumentException

Description copied from interface: IdentityService

This will create a EntityEthnicity exactly like the ethnicity passed in. The EntityEthnicity object passed in must be populated with an entityId and a ethnicity code

Specified by:

addEthnicityToEntity in interface IdentityService

Parameters:

ethnicity - the EntityEthnicity to create

Returns:

the newly created EntityEthnicity object.

Throws:

RiceIllegalArgumentException

updateEthnicity

public EntityEthnicity updateEthnicity(EntityEthnicity ethnicity)
                                throws RiceIllegalArgumentException,
                                       RiceIllegalStateException

Description copied from interface: IdentityService

This will update a EntityEthnicity exactly like the ethnicity passed in.

Specified by:

updateEthnicity in interface IdentityService

Parameters:

ethnicity - the EntityEthnicity to update

Returns:

the updated EntityEthnicity object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

addResidencyToEntity

public EntityResidency addResidencyToEntity(EntityResidency residency)
                                     throws RiceIllegalArgumentException,
                                            RiceIllegalStateException

Description copied from interface: IdentityService

This will create a EntityResidency exactly like the residency passed in. The EntityResidency object passed in must be populated with an entityId

Specified by:

addResidencyToEntity in interface IdentityService

Parameters:

residency - the EntityResidency to create

Returns:

the newly created EntityResidency object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

updateResidency

public EntityResidency updateResidency(EntityResidency residency)
                                throws RiceIllegalArgumentException,
                                       RiceIllegalStateException

Description copied from interface: IdentityService

This will update a EntityResidency exactly like the residency passed in.

Specified by:

updateResidency in interface IdentityService

Parameters:

residency - the EntityResidency to update

Returns:

the updated EntityResidency object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

addVisaToEntity

public EntityVisa addVisaToEntity(EntityVisa visa)
                           throws RiceIllegalArgumentException,
                                  RiceIllegalStateException

Description copied from interface: IdentityService

This will create a EntityVisa exactly like the visa passed in. The EntityVisa object passed in must be populated with an entityId and a visaTypeKey

Specified by:

addVisaToEntity in interface IdentityService

Parameters:

visa - the EntityVisa to create

Returns:

the newly created EntityVisa object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

updateVisa

public EntityVisa updateVisa(EntityVisa visa)
                      throws RiceIllegalArgumentException,
                             RiceIllegalStateException

Description copied from interface: IdentityService

This will update a EntityVisa exactly like the visa passed in.

Specified by:

updateVisa in interface IdentityService

Parameters:

visa - the EntityVisa to update

Returns:

the updated EntityVisa object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

addNameToEntity

public EntityName addNameToEntity(EntityName name)
                           throws RiceIllegalArgumentException,
                                  RiceIllegalStateException

Description copied from interface: IdentityService

This will create a EntityName exactly like the name passed in. The EntityName object passed in must be populated with an entityId and a nameType

Specified by:

addNameToEntity in interface IdentityService

Parameters:

name - the EntityName to create

Returns:

the newly created EntityName object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

updateName

public EntityName updateName(EntityName name)
                      throws RiceIllegalArgumentException,
                             RiceIllegalStateException

Description copied from interface: IdentityService

This will update a EntityName exactly like the name passed in.

Specified by:

updateName in interface IdentityService

Parameters:

name - the EntityName to update

Returns:

the updated EntityName object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

inactivateName

public EntityName inactivateName(String id)
                          throws RiceIllegalArgumentException,
                                 RiceIllegalStateException

Description copied from interface: IdentityService

This will inactivate a EntityName with the passed in id.

Specified by:

inactivateName in interface IdentityService

Parameters:

id - the unique id of the EntityName to inactivate

Returns:

the inactivated EntityName object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

addEmploymentToEntity

public EntityEmployment addEmploymentToEntity(EntityEmployment employment)
                                       throws RiceIllegalArgumentException,
                                              RiceIllegalStateException

Description copied from interface: IdentityService

This will create a EntityEmployment exactly like the employment passed in. The EntityEmployment object passed in must be populated with an entityId and a employmentType

Specified by:

addEmploymentToEntity in interface IdentityService

Parameters:

employment - the EntityEmployment to create

Returns:

the newly created EntityName object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

updateEmployment

public EntityEmployment updateEmployment(EntityEmployment employment)
                                  throws RiceIllegalArgumentException,
                                         RiceIllegalStateException

Description copied from interface: IdentityService

This will update a EntityEmployment exactly like the employment passed in.

Specified by:

updateEmployment in interface IdentityService

Parameters:

employment - the EntityEmployment to update

Returns:

the updated EntityEmployment object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

inactivateEmployment

public EntityEmployment inactivateEmployment(String id)
                                      throws RiceIllegalArgumentException,
                                             RiceIllegalStateException

Description copied from interface: IdentityService

This will inactivate a EntityEmployment with the passed in id.

Specified by:

inactivateEmployment in interface IdentityService

Parameters:

id - the unique id of the EntityEmployment to inactivate

Returns:

the inactivated EntityEmployment object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

addBioDemographicsToEntity

public EntityBioDemographics addBioDemographicsToEntity(EntityBioDemographics bioDemographics)
                                                 throws RiceIllegalArgumentException,
                                                        RiceIllegalStateException

Description copied from interface: IdentityService

This will create a EntityBioDemographics exactly like the bioDemographics passed in. The EntityBioDemographics object passed in must be populated with an entityId

Specified by:

addBioDemographicsToEntity in interface IdentityService

Parameters:

bioDemographics - the EntityBioDemographics to create

Returns:

the newly created EntityBioDemographics object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

updateBioDemographics

public EntityBioDemographics updateBioDemographics(EntityBioDemographics bioDemographics)
                                            throws RiceIllegalArgumentException,
                                                   RiceIllegalStateException

Description copied from interface: IdentityService

This will update a EntityBioDemographics exactly like the bioDemographics passed in.

Specified by:

updateBioDemographics in interface IdentityService

Parameters:

bioDemographics - the EntityBioDemographics to update

Returns:

the updated EntityBioDemographics object.

Throws:

RiceIllegalArgumentException

RiceIllegalStateException

setCriteriaLookupService

public void setCriteriaLookupService(CriteriaLookupService criteriaLookupService)

setBusinessObjectService

public void setBusinessObjectService(BusinessObjectService businessObjectService)