org.exoplatform.agenda.service

Interface AgendaEventAttendeeService

public interface AgendaEventAttendeeService

Method Summary

Modifier and Type	Method and Description
org.exoplatform.social.core.identity.model.Identity	decryptUserIdentity(long eventId, String token, EventAttendeeResponse response) Reads token content and retrieves user Social Identity from email or username contained in token
String	generateEncryptedToken(long eventId, String email) Generates a token that will be used to authenticate user when requesting REST API in anonymous mode
String	generateEncryptedToken(long eventId, String emailOrUsername, EventAttendeeResponse response) Generates a token that will be used to authenticate user when requesting REST API in anonymous mode.
List<EventAttendee>	getEventAttendees(long eventId) Return the list of attendees of an event
EventAttendeeResponse	getEventResponse(long eventId, long identityId) Retrieves the event response of a user.
boolean	isEventAttendee(long eventId, long identityId) Checks whether the user is an attendee of the event or not
void	saveEventAttendees(Event event, List<EventAttendee> attendees, long creatorIdentityId, boolean sendInvitations, boolean resetResponses, EventModificationType eventModificationType)
void	sendEventResponse(long eventId, long identityId, EventAttendeeResponse response)
void	sendInvitations(Event event, List<EventAttendee> eventAttendees, EventModificationType eventModificationType) Sends an invitation to event attendees of type: user, space or external user.

Method Detail

getEventAttendees

List<EventAttendee> getEventAttendees(long eventId)

Return the list of attendees of an event

Parameters:

eventId - agenda Event identifier

Returns:

List of EventAttendee

sendInvitations

void sendInvitations(Event event,
                     List<EventAttendee> eventAttendees,
                     EventModificationType eventModificationType)

Sends an invitation to event attendees of type: user, space or external user.

Parameters:

event - Event

eventAttendees - List of EventAttendee of the event

eventModificationType - flag to indicate if event is added, updated or deleted

saveEventAttendees

void saveEventAttendees(Event event,
                        List<EventAttendee> attendees,
                        long creatorIdentityId,
                        boolean sendInvitations,
                        boolean resetResponses,
                        EventModificationType eventModificationType)

Parameters:

event - Event to attach attendees

attendees - List of EventAttendee to save for event

creatorIdentityId - technical identifier if Identity updating event

sendInvitations - whether send invitations to other attendees or not

resetResponses - whether reset attendees responses or not to default EventAttendeeResponse.NEEDS_ACTION

eventModificationType - flag to indicate if event is added, updated or deleted

generateEncryptedToken

String generateEncryptedToken(long eventId,
                              String email)

Generates a token that will be used to authenticate user when requesting REST API in anonymous mode

Parameters:

eventId - Event technical identifier

email - User email

Returns:

encrypted token containing "EVENT_ID|EMAIL"

generateEncryptedToken

String generateEncryptedToken(long eventId,
                              String emailOrUsername,
                              EventAttendeeResponse response)

Generates a token that will be used to authenticate user when requesting REST API in anonymous mode. This

Parameters:

eventId - Event technical identifier

emailOrUsername - User name or email

response - EventAttendeeResponse value for chosen answer

Returns:

encrypted token containing "EVENT_ID|EMAIL|ATTENDEE_RESPONSE"

decryptUserIdentity

org.exoplatform.social.core.identity.model.Identity decryptUserIdentity(long eventId,
                                                                        String token,
                                                                        EventAttendeeResponse response)
                                                                 throws IllegalAccessException

Reads token content and retrieves user Social Identity from email or username contained in token

Parameters:

token - encrypted token

eventId - Event technical identifier

response - EventAttendeeResponse value for chosen answer

Returns:

Identity of user

Throws:

IllegalAccessException - when the token has bad format

getEventResponse

EventAttendeeResponse getEventResponse(long eventId,
                                       long identityId)
                                throws org.exoplatform.commons.exception.ObjectNotFoundException,
                                       IllegalAccessException

Retrieves the event response of a user. If the user didn't responded to the event, the default value EventAttendeeResponse.NEEDS_ACTION will be retrieved.

Parameters:

eventId - Technical identifier of Event

identityId - Identity technical identifier of user

Returns:

EventAttendeeResponse, no null value is returned

Throws:

org.exoplatform.commons.exception.ObjectNotFoundException - when event with provided identifier doesn't exists

IllegalAccessException - when user is not an invitee of the event

sendEventResponse

void sendEventResponse(long eventId,
                       long identityId,
                       EventAttendeeResponse response)
                throws org.exoplatform.commons.exception.ObjectNotFoundException,
                       IllegalAccessException

Parameters:

eventId - Technical identifier of Event

identityId - Identity technical identifier of user

response - User response of type EventAttendeeResponse to the event. The value EventAttendeeResponse.NEEDS_ACTION isn't allowed.

Throws:

org.exoplatform.commons.exception.ObjectNotFoundException - when event with provided identifier doesn't exists

IllegalAccessException - when user is not an invitee of the event

isEventAttendee

boolean isEventAttendee(long eventId,
                        long identityId)

Checks whether the user is an attendee of the event or not

Parameters:

eventId - Technical identifier of Event

identityId - user name

Returns:

true if user is an attendee of the event, else return false