org.argeo.people.core

Class PeopleServiceImpl

java.lang.Object

org.argeo.connect.core.AbstractAppService

org.argeo.people.core.PeopleServiceImpl

All Implemented Interfaces:

AppService, PeopleNames, PeopleService

public class PeopleServiceImpl
extends AbstractAppService
implements PeopleService, PeopleNames

Concrete access to PeopleService

Field Summary

Fields inherited from interface org.argeo.people.PeopleNames

PEOPLE_ACCOUNT_HOLDER, PEOPLE_ACCOUNT_NB, PEOPLE_ALT_LANGS, PEOPLE_BANK_NAME, PEOPLE_BANK_NB, PEOPLE_BIC, PEOPLE_BIRTH_DATE, PEOPLE_CITY, PEOPLE_CONTACT_VALUE, PEOPLE_CONTACTS, PEOPLE_COUNTRY, PEOPLE_CURRENCY, PEOPLE_DATE_BEGIN, PEOPLE_DATE_END, PEOPLE_DEPARTMENT, PEOPLE_DISPLAY_NAME, PEOPLE_FIRST_NAME, PEOPLE_GENDER, PEOPLE_GEOPOINT, PEOPLE_HONORIFIC_TITLE, PEOPLE_IBAN, PEOPLE_IS_CURRENT, PEOPLE_IS_PRIMARY, PEOPLE_JOBS, PEOPLE_LAST_NAME, PEOPLE_LATIN_PHONETIC_SPELLING, PEOPLE_LEGAL_FORM, PEOPLE_LEGAL_NAME, PEOPLE_MAIDEN_NAME, PEOPLE_MAILING_LISTS, PEOPLE_MEMBERS, PEOPLE_MIDDLE_NAME, PEOPLE_NAME_SUFFIX, PEOPLE_NICKNAME, PEOPLE_ORG_REF_UID, PEOPLE_PAYMENT_ACCOUNTS, PEOPLE_PMAIL, PEOPLE_PMOBILE, PEOPLE_PORG, PEOPLE_POSTAL_ADDRESS_PROPS, PEOPLE_PPOSTAL_ADDRESS, PEOPLE_PRIMARY_EMAIL, PEOPLE_PTELEPHONE_NUMBER, PEOPLE_PURL, PEOPLE_REF_TITLE, PEOPLE_REF_UID, PEOPLE_ROLE, PEOPLE_SALUTATION, PEOPLE_SPOKEN_LANGUAGES, PEOPLE_STATE, PEOPLE_STREET, PEOPLE_STREET_COMPLEMENT, PEOPLE_TIME_ZONE, PEOPLE_UNSUBSCRIBED_MAILING_LISTS, PEOPLE_USE_POLITE_FORM, PEOPLE_USERNAME, PEOPLE_VAT_ID_NB, PEOPLE_ZIP_CODE

Constructor Summary

Constructors

Constructor and Description
PeopleServiceImpl()

Method Summary

Modifier and Type	Method and Description
Node	createEntityReference(Node referencingNode, Node referencedNode, java.lang.String role) Creates and returns a model specific Node to store a reference, depending on the two object we want to link together.
void	destroy() Clean shutdown of the backend.
java.lang.String	getAppBaseName() Returns the current App name
java.lang.String	getBaseRelPath(java.lang.String nodeType)
ContactService	getContactService() Returns the corresponding ContactService
java.lang.String	getDefaultRelPath(Node entity) Computes the App specific relative path for a known type based on properties of the passed node
java.lang.String	getDefaultRelPath(Session session, java.lang.String nodeType, java.lang.String peopleUid) Computes the App specific relative path for this known node type based on the passed id
java.lang.String	getDisplayName(Node entity) Returns a display name that is app specific and that depends on one or more of the entity properties.
Node	getEntityFromNodeReference(Node node, java.lang.String propName) Returns the corresponding people entity using the People UID that is stored under propName.
java.lang.String	getMainNodeType(Node entity) Returns the App specific main type of a node, that can be its primary type or one of its mixin, typically for the People App.
PersonService	getPersonService() Returns the corresponding PersonService
java.util.List<Node>	getRelatedEntities(Node entity, java.lang.String linkNodeType, java.lang.String relatedEntityType) Returns all entities with the given NodeType related to this entity or null if none has been found.
void	init() Deprecated.
boolean	isKnownType(Node entity) Simply checks if the passed entity has a primary or mixin type that is known and thus can be managed by the this App
boolean	isKnownType(java.lang.String nodeType) Simply checks if the passed type is known and thus can be managed by the this App.
Node	publishEntity(Node parent, java.lang.String nodeType, Node srcNode, boolean removeSrc)
Node	saveEntity(Node entity, boolean publish) Try to save and optionally publish a business object after applying context specific rules and special behaviours (typically cache updates).
void	setResourcesService(ResourcesService resourcesService)
void	setUserAdminService(UserAdminService userAdminService)
void	updatePrimaryCache(Node entity) Simply looks for primary information and updates the primary cache if needed

Methods inherited from class org.argeo.connect.core.AbstractAppService

createDraftEntity, getDraftParent, getEntityByUid

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.argeo.connect.AppService

createDraftEntity, getDraftParent, getEntityByUid, getLabel, publishEntity

Constructor Detail

PeopleServiceImpl

public PeopleServiceImpl()

Method Detail

publishEntity

public Node publishEntity(Node parent,
                          java.lang.String nodeType,
                          Node srcNode,
                          boolean removeSrc)
                   throws RepositoryException

Specified by:

publishEntity in interface AppService

Overrides:

publishEntity in class AbstractAppService

Throws:

RepositoryException

saveEntity

public Node saveEntity(Node entity,
                       boolean publish)
                throws PeopleException

Description copied from class: AbstractAppService

Try to save and optionally publish a business object after applying context specific rules and special behaviours (typically cache updates).

Specified by:

saveEntity in interface AppService

Overrides:

saveEntity in class AbstractAppService

publish - also publishes the corresponding node

Returns:

the entity that has been saved (and optionally published): note that in some cases (typically, the first save of a draft node in the business sub tree) the returned node is not the same as the one that has been passed

Throws:

PeopleException - If one of the rule defined for this type is not respected. Use getMessage to display to the user if needed

getAppBaseName

public java.lang.String getAppBaseName()

Description copied from interface: AppService

Returns the current App name

Specified by:

getAppBaseName in interface AppService

getBaseRelPath

public java.lang.String getBaseRelPath(java.lang.String nodeType)

Specified by:

getBaseRelPath in interface AppService

getDefaultRelPath

public java.lang.String getDefaultRelPath(Node entity)
                                   throws RepositoryException

Description copied from interface: AppService

Computes the App specific relative path for a known type based on properties of the passed node

Specified by:

getDefaultRelPath in interface AppService

Throws:

RepositoryException

getDefaultRelPath

public java.lang.String getDefaultRelPath(Session session,
                                          java.lang.String nodeType,
                                          java.lang.String peopleUid)

Description copied from interface: AppService

Computes the App specific relative path for this known node type based on the passed id

Specified by:

getDefaultRelPath in interface AppService

Parameters:

session - TODO

isKnownType

public boolean isKnownType(Node entity)

Description copied from interface: AppService

Simply checks if the passed entity has a primary or mixin type that is known and thus can be managed by the this App

Specified by:

isKnownType in interface AppService

isKnownType

public boolean isKnownType(java.lang.String nodeType)

Description copied from interface: AppService

Simply checks if the passed type is known and thus can be managed by the this App. It might be a primary or mixin type

Specified by:

isKnownType in interface AppService

getMainNodeType

public java.lang.String getMainNodeType(Node entity)

Description copied from interface: AppService

Returns the App specific main type of a node, that can be its primary type or one of its mixin, typically for the People App.

Specified by:

getMainNodeType in interface AppService

getDisplayName

public java.lang.String getDisplayName(Node entity)

Description copied from class: AbstractAppService

Returns a display name that is app specific and that depends on one or more of the entity properties. The user can always set a flag to force the value to something else. The Display name is usually stored in the JCR_TITLE property.

Specified by:

getDisplayName in interface AppService

Overrides:

getDisplayName in class AbstractAppService

updatePrimaryCache

public void updatePrimaryCache(Node entity)
                        throws PeopleException,
                               RepositoryException

Simply looks for primary information and updates the primary cache if needed

Specified by:

updatePrimaryCache in interface PeopleService

Throws:

PeopleException

RepositoryException

getEntityFromNodeReference

public Node getEntityFromNodeReference(Node node,
                                       java.lang.String propName)

Description copied from interface: PeopleService

Returns the corresponding people entity using the People UID that is stored under propName. Returns null if the property is undefined or if there is no entity with this people UID

Specified by:

getEntityFromNodeReference in interface PeopleService

createEntityReference

public Node createEntityReference(Node referencingNode,
                                  Node referencedNode,
                                  java.lang.String role)

Creates and returns a model specific Node to store a reference, depending on the two object we want to link together. Overwrite to add some new link type

Specified by:

createEntityReference in interface PeopleService

getRelatedEntities

public java.util.List<Node> getRelatedEntities(Node entity,
                                               java.lang.String linkNodeType,
                                               java.lang.String relatedEntityType)

Description copied from interface: PeopleService

Returns all entities with the given NodeType related to this entity or null if none has been found. Key for relation is implementation specific: it might be a JCR Identifier but must not.

Specified by:

getRelatedEntities in interface PeopleService

relatedEntityType - Optionally, the type of the grand-parent node typically to choose between an organisation, a group or a person in a group

getPersonService

public PersonService getPersonService()

Description copied from interface: PeopleService

Returns the corresponding PersonService

Specified by:

getPersonService in interface PeopleService

getContactService

public ContactService getContactService()

Description copied from interface: PeopleService

Returns the corresponding ContactService

Specified by:

getContactService in interface PeopleService

init

@Deprecated
public void init()

Deprecated.

Call by each startup in order to make sure the backend is ready to receive/provide data.

destroy

public void destroy()

Clean shutdown of the backend.

setResourcesService

public void setResourcesService(ResourcesService resourcesService)

setUserAdminService

public void setUserAdminService(UserAdminService userAdminService)