org.nuxeo.ecm.user.invite

Class UserInvitationComponent

java.lang.Object

org.nuxeo.runtime.model.DefaultComponent

org.nuxeo.ecm.user.invite.UserInvitationComponent

All Implemented Interfaces:

UserInvitationService, Adaptable, Component, Extensible, TimestampedService

Direct Known Subclasses:

UserRegistrationComponent

public class UserInvitationComponent
extends DefaultComponent
implements UserInvitationService

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	UserInvitationComponent.RegistrationAcceptator
protected class	UserInvitationComponent.RegistrationApprover
protected class	UserInvitationComponent.RegistrationCreator
protected class	UserInvitationComponent.RegistrationRejector
protected class	UserInvitationComponent.RequestIdValidator
protected class	UserInvitationComponent.RootDocumentGetter
protected class	UserInvitationComponent.UserRegistrationModelCreator

Nested classes/interfaces inherited from interface org.nuxeo.ecm.user.invite.UserInvitationService

UserInvitationService.ValidationMethod

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<String,UserRegistrationConfiguration>	configurations
protected static org.apache.commons.logging.Log	log
static String	NUXEO_URL_KEY
protected String	repoName
protected RenderingHelper	rh
protected String	testRendering

Fields inherited from class org.nuxeo.runtime.model.DefaultComponent

lastModified

Fields inherited from interface org.nuxeo.ecm.user.invite.UserInvitationService

REGISTRATION_CONFIGURATION_NAME, REGISTRATION_DATA_DOC, REGISTRATION_DATA_USER

Constructor Summary

Constructors

Constructor and Description
UserInvitationComponent()

Method Summary

Modifier and Type	Method and Description
void	acceptRegistrationRequest(String requestId, Map<String,Serializable> additionnalInfo) accept the registration request
protected String	buildEnterPasswordUrl(UserRegistrationConfiguration configuration)
void	checkRequestId(String requestId) The method checks if the request id is a valid one.
protected boolean	checkUserFromRegistrationExistence(DocumentModel registrationDoc)
NuxeoPrincipal	createUser(CoreSession session, DocumentModel registrationDoc)
void	deleteRegistrationRequests(CoreSession session, List<DocumentModel> registrationDocs) Delete a registration document
protected void	generateMail(String destination, String copy, String title, String content)
UserRegistrationConfiguration	getConfiguration()
UserRegistrationConfiguration	getConfiguration(DocumentModel requestDoc)
UserRegistrationConfiguration	getConfiguration(String name) Return specific configuration for the specified name
Set<String>	getConfigurationsName() List all registered onfiguration name
protected String	getJavaMailJndiName()
String	getNameEventRegistrationAccepted()
String	getNameEventRegistrationRejected()
String	getNameEventRegistrationSubmitted()
String	getNameEventRegistrationValidated()
DocumentModel	getOrCreateRootDocument(CoreSession session, String configurationName)
RegistrationRules	getRegistrationRules(String configurationName) Get registration rules adapter
DocumentModel	getRegistrationRulesDocument(CoreSession session, String configurationName) Get documentmodel that stores request configuration using RegistrationConfiguration facet.
DocumentModelList	getRegistrationsForUser(String docId, String username, String configurationName) Retrieve registrations for a document givent the username
protected InvitationUserFactory	getRegistrationUserFactory(UserRegistrationConfiguration configuration)
protected String	getTargetRepositoryName()
String	getTestedRendering()
DocumentModel	getUserRegistrationModel(String configurationName) Create a document model for the UserRegistration doctype.
protected static boolean	isEmailExist(UserRegistrationConfiguration configuration, DocumentModel userRegistration)
protected static boolean	isTestModeSet()
void	registerContribution(Object contribution, String extensionPoint, ComponentInstance contributor)
void	rejectRegistrationRequest(String requestId, Map<String,Serializable> additionnalInfo) reject the registration request
protected void	reviveRegistrationRequest(CoreSession session, DocumentModel registrationDoc, Map<String,Serializable> additionalInfos)
void	reviveRegistrationRequests(CoreSession session, List<DocumentModel> registrationDocs) Send a mail to the invited user to revive his invitation If an error occured while sending an email, it logs it and continue.
protected void	sendEmail(Map<String,Serializable> additionnalInfo, DocumentModel registrationDoc, String emailTemplatePath, String emailTitle)
protected EventContext	sendEvent(CoreSession session, DocumentModel source, String evName)
protected void	sendValidationEmail(Map<String,Serializable> additionnalInfo, DocumentModel registrationDoc)
String	submitRegistrationRequest(DocumentModel userRegistrationModel, Map<String,Serializable> additionnalInfo, UserInvitationService.ValidationMethod validationMethod, boolean autoAccept) Stores a registration request and return a unique ID for it
String	submitRegistrationRequest(String configurationName, DocumentModel userRegistrationModel, Map<String,Serializable> additionnalInfo, UserInvitationService.ValidationMethod validationMethod, boolean autoAccept) Stores a resgitration request like submitRegistrationRequest with Document information
protected boolean	userAlreadyExists(UserRegistrationInfo userRegistrationInfo)
Map<String,Serializable>	validateRegistration(String requestId, Map<String,Serializable> additionnalInfo) Validate a registration request and generate the target User
Map<String,Serializable>	validateRegistrationAndSendEmail(String requestId, Map<String,Serializable> additionnalInfo) Validate a registration request and generate the target User

Methods inherited from class org.nuxeo.runtime.model.DefaultComponent

activate, deactivate, getAdapter, getLastModified, registerExtension, setLastModified, setModifiedNow, start, stop, unregisterContribution, unregisterExtension

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.nuxeo.runtime.model.Component

applicationStarted, getApplicationStartedOrder

Field Detail

log

protected static org.apache.commons.logging.Log log

NUXEO_URL_KEY

public static final String NUXEO_URL_KEY

See Also:

Constant Field Values

repoName

protected String repoName

testRendering

protected String testRendering

rh

protected RenderingHelper rh

configurations

protected Map<String,UserRegistrationConfiguration> configurations

Constructor Detail

UserInvitationComponent

public UserInvitationComponent()

Method Detail

getTestedRendering

public String getTestedRendering()

getTargetRepositoryName

protected String getTargetRepositoryName()

userAlreadyExists

protected boolean userAlreadyExists(UserRegistrationInfo userRegistrationInfo)

getJavaMailJndiName

protected String getJavaMailJndiName()

getUserRegistrationModel

public DocumentModel getUserRegistrationModel(String configurationName)

Description copied from interface: UserInvitationService

Create a document model for the UserRegistration doctype.

Specified by:

getUserRegistrationModel in interface UserInvitationService

Parameters:

configurationName - The name of the configuration.

Returns:

The document model

getRegistrationRulesDocument

public DocumentModel getRegistrationRulesDocument(CoreSession session,
                                                  String configurationName)

Description copied from interface: UserInvitationService

Get documentmodel that stores request configuration using RegistrationConfiguration facet.

Specified by:

getRegistrationRulesDocument in interface UserInvitationService

Returns:

getOrCreateRootDocument

public DocumentModel getOrCreateRootDocument(CoreSession session,
                                             String configurationName)

sendEvent

protected EventContext sendEvent(CoreSession session,
                                 DocumentModel source,
                                 String evName)
                          throws UserRegistrationException

Throws:

UserRegistrationException

sendValidationEmail

protected void sendValidationEmail(Map<String,Serializable> additionnalInfo,
                                   DocumentModel registrationDoc)

sendEmail

protected void sendEmail(Map<String,Serializable> additionnalInfo,
                         DocumentModel registrationDoc,
                         String emailTemplatePath,
                         String emailTitle)

isTestModeSet

protected static boolean isTestModeSet()

checkUserFromRegistrationExistence

protected boolean checkUserFromRegistrationExistence(DocumentModel registrationDoc)

generateMail

protected void generateMail(String destination,
                            String copy,
                            String title,
                            String content)
                     throws NamingException,
                            javax.mail.MessagingException

Throws:

NamingException

javax.mail.MessagingException

submitRegistrationRequest

public String submitRegistrationRequest(DocumentModel userRegistrationModel,
                                        Map<String,Serializable> additionnalInfo,
                                        UserInvitationService.ValidationMethod validationMethod,
                                        boolean autoAccept)

Description copied from interface: UserInvitationService

Stores a registration request and return a unique ID for it

Specified by:

submitRegistrationRequest in interface UserInvitationService

Returns:

getRegistrationsForUser

public DocumentModelList getRegistrationsForUser(String docId,
                                                 String username,
                                                 String configurationName)

Description copied from interface: UserInvitationService

Retrieve registrations for a document givent the username

Specified by:

getRegistrationsForUser in interface UserInvitationService

isEmailExist

protected static boolean isEmailExist(UserRegistrationConfiguration configuration,
                                      DocumentModel userRegistration)

submitRegistrationRequest

public String submitRegistrationRequest(String configurationName,
                                        DocumentModel userRegistrationModel,
                                        Map<String,Serializable> additionnalInfo,
                                        UserInvitationService.ValidationMethod validationMethod,
                                        boolean autoAccept)

Description copied from interface: UserInvitationService

Stores a resgitration request like submitRegistrationRequest with Document information

Specified by:

submitRegistrationRequest in interface UserInvitationService

Returns:

a unique ID for it

buildEnterPasswordUrl

protected String buildEnterPasswordUrl(UserRegistrationConfiguration configuration)

acceptRegistrationRequest

public void acceptRegistrationRequest(String requestId,
                                      Map<String,Serializable> additionnalInfo)
                               throws UserRegistrationException

Description copied from interface: UserInvitationService

accept the registration request

Specified by:

acceptRegistrationRequest in interface UserInvitationService

Throws:

UserRegistrationException

rejectRegistrationRequest

public void rejectRegistrationRequest(String requestId,
                                      Map<String,Serializable> additionnalInfo)
                               throws UserRegistrationException

Description copied from interface: UserInvitationService

reject the registration request

Specified by:

rejectRegistrationRequest in interface UserInvitationService

Throws:

UserRegistrationException

validateRegistration

public Map<String,Serializable> validateRegistration(String requestId,
                                                     Map<String,Serializable> additionnalInfo)
                                              throws UserRegistrationException

Description copied from interface: UserInvitationService

Validate a registration request and generate the target User

Specified by:

validateRegistration in interface UserInvitationService

Throws:

UserRegistrationException

validateRegistrationAndSendEmail

public Map<String,Serializable> validateRegistrationAndSendEmail(String requestId,
                                                                 Map<String,Serializable> additionnalInfo)
                                                          throws UserRegistrationException

Description copied from interface: UserInvitationService

Validate a registration request and generate the target User

Specified by:

validateRegistrationAndSendEmail in interface UserInvitationService

Throws:

UserRegistrationException

registerContribution

public void registerContribution(Object contribution,
                                 String extensionPoint,
                                 ComponentInstance contributor)

Overrides:

registerContribution in class DefaultComponent

getRegistrationUserFactory

protected InvitationUserFactory getRegistrationUserFactory(UserRegistrationConfiguration configuration)

createUser

public NuxeoPrincipal createUser(CoreSession session,
                                 DocumentModel registrationDoc)
                          throws UserRegistrationException

Specified by:

createUser in interface UserInvitationService

Throws:

UserRegistrationException

getConfiguration

public UserRegistrationConfiguration getConfiguration()

Specified by:

getConfiguration in interface UserInvitationService

getConfiguration

public UserRegistrationConfiguration getConfiguration(DocumentModel requestDoc)

Specified by:

getConfiguration in interface UserInvitationService

getConfiguration

public UserRegistrationConfiguration getConfiguration(String name)

Description copied from interface: UserInvitationService

Return specific configuration for the specified name

Specified by:

getConfiguration in interface UserInvitationService

Parameters:

name - configuration name

getRegistrationRules

public RegistrationRules getRegistrationRules(String configurationName)

Description copied from interface: UserInvitationService

Get registration rules adapter

Specified by:

getRegistrationRules in interface UserInvitationService

reviveRegistrationRequests

public void reviveRegistrationRequests(CoreSession session,
                                       List<DocumentModel> registrationDocs)

Description copied from interface: UserInvitationService

Send a mail to the invited user to revive his invitation If an error occured while sending an email, it logs it and continue.

Specified by:

reviveRegistrationRequests in interface UserInvitationService

reviveRegistrationRequest

protected void reviveRegistrationRequest(CoreSession session,
                                         DocumentModel registrationDoc,
                                         Map<String,Serializable> additionalInfos)

deleteRegistrationRequests

public void deleteRegistrationRequests(CoreSession session,
                                       List<DocumentModel> registrationDocs)

Description copied from interface: UserInvitationService

Delete a registration document

Specified by:

deleteRegistrationRequests in interface UserInvitationService

getConfigurationsName

public Set<String> getConfigurationsName()

Description copied from interface: UserInvitationService

List all registered onfiguration name

Specified by:

getConfigurationsName in interface UserInvitationService

checkRequestId

public void checkRequestId(String requestId)
                    throws UserRegistrationException

Description copied from interface: UserInvitationService

The method checks if the request id is a valid one.

Specified by:

checkRequestId in interface UserInvitationService

Parameters:

requestId - The value of the request id.

Throws:

UserRegistrationException

getNameEventRegistrationSubmitted

public String getNameEventRegistrationSubmitted()

Specified by:

getNameEventRegistrationSubmitted in interface UserInvitationService

Returns:

The name of the event when the registration is submitted.

getNameEventRegistrationAccepted

public String getNameEventRegistrationAccepted()

Specified by:

getNameEventRegistrationAccepted in interface UserInvitationService

Returns:

The name of the event when the registration is accepted.

getNameEventRegistrationRejected

public String getNameEventRegistrationRejected()

Specified by:

getNameEventRegistrationRejected in interface UserInvitationService

Returns:

The name of the event when the registration is rejected.

getNameEventRegistrationValidated

public String getNameEventRegistrationValidated()

Specified by:

getNameEventRegistrationValidated in interface UserInvitationService

Returns:

The name of the event when the registration is validated.