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

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_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(String configurationName)
void	checkRequestId(String requestId) The method checks if the request id is a valid one.
protected boolean	checkUserFromRegistrationExistence(org.nuxeo.ecm.core.api.DocumentModel registrationDoc)
org.nuxeo.ecm.core.api.NuxeoPrincipal	createUser(org.nuxeo.ecm.core.api.CoreSession session, org.nuxeo.ecm.core.api.DocumentModel registrationDoc)
void	deleteRegistrationRequests(org.nuxeo.ecm.core.api.CoreSession session, List<org.nuxeo.ecm.core.api.DocumentModel> registrationDocs) Delete a registration document
protected void	generateMail(String destination, String copy, String title, String content)
UserRegistrationConfiguration	getConfiguration()
UserRegistrationConfiguration	getConfiguration(org.nuxeo.ecm.core.api.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()
org.nuxeo.ecm.core.api.DocumentModel	getOrCreateRootDocument(org.nuxeo.ecm.core.api.CoreSession session, String configurationName)
RegistrationRules	getRegistrationRules(String configurationName) Get registration rules adapter
org.nuxeo.ecm.core.api.DocumentModel	getRegistrationRulesDocument(org.nuxeo.ecm.core.api.CoreSession session, String configurationName) Get documentmodel that stores request configuration using RegistrationConfiguration facet.
org.nuxeo.ecm.core.api.DocumentModelList	getRegistrationsForUser(String docId, String username) Retrieve registrations for a document givent the username
protected InvitationUserFactory	getRegistrationUserFactory(UserRegistrationConfiguration configuration)
protected String	getTargetRepositoryName()
String	getTestedRendering()
org.nuxeo.ecm.core.api.DocumentModel	getUserRegistrationModel(String configurationName) Create a document model for the UserRegistration doctype.
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(org.nuxeo.ecm.core.api.CoreSession session, org.nuxeo.ecm.core.api.DocumentModel registrationDoc, Map<String,Object> additionalInfos)
void	reviveRegistrationRequests(org.nuxeo.ecm.core.api.CoreSession session, List<org.nuxeo.ecm.core.api.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 org.nuxeo.ecm.core.event.EventContext	sendEvent(org.nuxeo.ecm.core.api.CoreSession session, org.nuxeo.ecm.core.api.DocumentModel source, String evName)
protected void	sendValidationEmail(Map<String,Serializable> additionnalInfo, org.nuxeo.ecm.core.api.DocumentModel registrationDoc)
String	submitRegistrationRequest(org.nuxeo.ecm.core.api.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, org.nuxeo.ecm.core.api.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, applicationStarted, deactivate, getAdapter, getApplicationStartedOrder, getLastModified, registerExtension, setLastModified, setModifiedNow, unregisterContribution, unregisterExtension

Methods inherited from class java.lang.Object

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

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 org.nuxeo.ecm.core.api.DocumentModel getUserRegistrationModel(String configurationName)
                                                              throws org.nuxeo.ecm.core.api.ClientException

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

Throws:

org.nuxeo.ecm.core.api.ClientException

getRegistrationRulesDocument

public org.nuxeo.ecm.core.api.DocumentModel getRegistrationRulesDocument(org.nuxeo.ecm.core.api.CoreSession session,
                                                                         String configurationName)
                                                                  throws org.nuxeo.ecm.core.api.ClientException

Description copied from interface: UserInvitationService

Get documentmodel that stores request configuration using RegistrationConfiguration facet.

Specified by:

getRegistrationRulesDocument in interface UserInvitationService

Returns:

Throws:

org.nuxeo.ecm.core.api.ClientException

getOrCreateRootDocument

public org.nuxeo.ecm.core.api.DocumentModel getOrCreateRootDocument(org.nuxeo.ecm.core.api.CoreSession session,
                                                                    String configurationName)
                                                             throws org.nuxeo.ecm.core.api.ClientException

Throws:

org.nuxeo.ecm.core.api.ClientException

sendEvent

protected org.nuxeo.ecm.core.event.EventContext sendEvent(org.nuxeo.ecm.core.api.CoreSession session,
                                                          org.nuxeo.ecm.core.api.DocumentModel source,
                                                          String evName)
                                                   throws UserRegistrationException

Throws:

UserRegistrationException

sendValidationEmail

protected void sendValidationEmail(Map<String,Serializable> additionnalInfo,
                                   org.nuxeo.ecm.core.api.DocumentModel registrationDoc)
                            throws org.nuxeo.ecm.core.api.ClientException

Throws:

org.nuxeo.ecm.core.api.ClientException

isTestModeSet

protected static boolean isTestModeSet()

checkUserFromRegistrationExistence

protected boolean checkUserFromRegistrationExistence(org.nuxeo.ecm.core.api.DocumentModel registrationDoc)
                                              throws org.nuxeo.ecm.core.api.ClientException

Throws:

org.nuxeo.ecm.core.api.ClientException

generateMail

protected void generateMail(String destination,
                            String copy,
                            String title,
                            String content)
                     throws Exception

Throws:

Exception

submitRegistrationRequest

public String submitRegistrationRequest(org.nuxeo.ecm.core.api.DocumentModel userRegistrationModel,
                                        Map<String,Serializable> additionnalInfo,
                                        UserInvitationService.ValidationMethod validationMethod,
                                        boolean autoAccept)
                                 throws org.nuxeo.ecm.core.api.ClientException

Description copied from interface: UserInvitationService

Stores a registration request and return a unique ID for it

Specified by:

submitRegistrationRequest in interface UserInvitationService

Returns:

Throws:

org.nuxeo.ecm.core.api.ClientException

submitRegistrationRequest

public String submitRegistrationRequest(String configurationName,
                                        org.nuxeo.ecm.core.api.DocumentModel userRegistrationModel,
                                        Map<String,Serializable> additionnalInfo,
                                        UserInvitationService.ValidationMethod validationMethod,
                                        boolean autoAccept)
                                 throws org.nuxeo.ecm.core.api.ClientException,
                                        UserRegistrationException

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

Throws:

org.nuxeo.ecm.core.api.ClientException

UserRegistrationException

buildEnterPasswordUrl

protected String buildEnterPasswordUrl(String configurationName)

acceptRegistrationRequest

public void acceptRegistrationRequest(String requestId,
                                      Map<String,Serializable> additionnalInfo)
                               throws org.nuxeo.ecm.core.api.ClientException,
                                      UserRegistrationException

Description copied from interface: UserInvitationService

accept the registration request

Specified by:

acceptRegistrationRequest in interface UserInvitationService

Throws:

org.nuxeo.ecm.core.api.ClientException

UserRegistrationException

rejectRegistrationRequest

public void rejectRegistrationRequest(String requestId,
                                      Map<String,Serializable> additionnalInfo)
                               throws org.nuxeo.ecm.core.api.ClientException,
                                      UserRegistrationException

Description copied from interface: UserInvitationService

reject the registration request

Specified by:

rejectRegistrationRequest in interface UserInvitationService

Throws:

org.nuxeo.ecm.core.api.ClientException

UserRegistrationException

validateRegistration

public Map<String,Serializable> validateRegistration(String requestId,
                                                     Map<String,Serializable> additionnalInfo)
                                              throws org.nuxeo.ecm.core.api.ClientException,
                                                     UserRegistrationException

Description copied from interface: UserInvitationService

Validate a registration request and generate the target User

Specified by:

validateRegistration in interface UserInvitationService

Throws:

org.nuxeo.ecm.core.api.ClientException

UserRegistrationException

validateRegistrationAndSendEmail

public Map<String,Serializable> validateRegistrationAndSendEmail(String requestId,
                                                                 Map<String,Serializable> additionnalInfo)
                                                          throws org.nuxeo.ecm.core.api.ClientException,
                                                                 UserRegistrationException

Description copied from interface: UserInvitationService

Validate a registration request and generate the target User

Specified by:

validateRegistrationAndSendEmail in interface UserInvitationService

Throws:

org.nuxeo.ecm.core.api.ClientException

UserRegistrationException

registerContribution

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

Overrides:

registerContribution in class DefaultComponent

Throws:

Exception

getRegistrationUserFactory

protected InvitationUserFactory getRegistrationUserFactory(UserRegistrationConfiguration configuration)

createUser

public org.nuxeo.ecm.core.api.NuxeoPrincipal createUser(org.nuxeo.ecm.core.api.CoreSession session,
                                                        org.nuxeo.ecm.core.api.DocumentModel registrationDoc)
                                                 throws org.nuxeo.ecm.core.api.ClientException,
                                                        UserRegistrationException

Specified by:

createUser in interface UserInvitationService

Throws:

org.nuxeo.ecm.core.api.ClientException

UserRegistrationException

getConfiguration

public UserRegistrationConfiguration getConfiguration()

Specified by:

getConfiguration in interface UserInvitationService

getConfiguration

public UserRegistrationConfiguration getConfiguration(org.nuxeo.ecm.core.api.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)
                                       throws org.nuxeo.ecm.core.api.ClientException

Description copied from interface: UserInvitationService

Get registration rules adapter

Specified by:

getRegistrationRules in interface UserInvitationService

Throws:

org.nuxeo.ecm.core.api.ClientException

reviveRegistrationRequests

public void reviveRegistrationRequests(org.nuxeo.ecm.core.api.CoreSession session,
                                       List<org.nuxeo.ecm.core.api.DocumentModel> registrationDocs)
                                throws org.nuxeo.ecm.core.api.ClientException

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

Throws:

org.nuxeo.ecm.core.api.ClientException

reviveRegistrationRequest

protected void reviveRegistrationRequest(org.nuxeo.ecm.core.api.CoreSession session,
                                         org.nuxeo.ecm.core.api.DocumentModel registrationDoc,
                                         Map<String,Object> additionalInfos)
                                  throws org.nuxeo.ecm.core.api.ClientException

Throws:

org.nuxeo.ecm.core.api.ClientException

deleteRegistrationRequests

public void deleteRegistrationRequests(org.nuxeo.ecm.core.api.CoreSession session,
                                       List<org.nuxeo.ecm.core.api.DocumentModel> registrationDocs)
                                throws org.nuxeo.ecm.core.api.ClientException

Description copied from interface: UserInvitationService

Delete a registration document

Specified by:

deleteRegistrationRequests in interface UserInvitationService

Throws:

org.nuxeo.ecm.core.api.ClientException

getConfigurationsName

public Set<String> getConfigurationsName()

Description copied from interface: UserInvitationService

List all registered onfiguration name

Specified by:

getConfigurationsName in interface UserInvitationService

getRegistrationsForUser

public org.nuxeo.ecm.core.api.DocumentModelList getRegistrationsForUser(String docId,
                                                                        String username)
                                                                 throws org.nuxeo.ecm.core.api.ClientException

Description copied from interface: UserInvitationService

Retrieve registrations for a document givent the username

Specified by:

getRegistrationsForUser in interface UserInvitationService

Throws:

org.nuxeo.ecm.core.api.ClientException

checkRequestId

public void checkRequestId(String requestId)
                    throws org.nuxeo.ecm.core.api.ClientException,
                           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:

org.nuxeo.ecm.core.api.ClientException

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.