org.ametys.plugins.exchange

Class ExchangeConnector

java.lang.Object

org.ametys.runtime.plugin.component.AbstractLogEnabled

org.ametys.plugins.messagingconnector.AbstractMessagingConnector

org.ametys.plugins.exchange.ExchangeConnector

All Implemented Interfaces:

MessagingConnector, LogEnabled, Initializable, Component, Serviceable

public class ExchangeConnector
extends AbstractMessagingConnector

The connector used by the messaging connector plugin when the exchange mail server is used. Implements the methods of the MessagingConnector interface in order to get the informations from the mail server

Nested Class Summary

Nested classes/interfaces inherited from interface org.ametys.plugins.messagingconnector.MessagingConnector

MessagingConnector.AttendeeInformation, MessagingConnector.FreeBusyStatus, MessagingConnector.ResponseType

Field Summary

Fields

Modifier and Type	Field and Description
protected CurrentUserProvider	_currentUserProvider The current user provider
private UserManager	_userManager The user manager

Fields inherited from class org.ametys.plugins.messagingconnector.AbstractMessagingConnector

_userPopulationDAO

Fields inherited from interface org.ametys.plugins.messagingconnector.MessagingConnector

ROLE

Constructor Summary

Constructors

Constructor and Description
ExchangeConnector()

Method Summary

Modifier and Type	Method and Description
private MessagingConnector.ResponseType	_getResponseStatus(microsoft.exchange.webservices.data.core.enumeration.property.MeetingResponseType meetingResponseType)
private void	_setAttendees(microsoft.exchange.webservices.data.core.service.item.Appointment appointment, Map<String,Boolean> attendees)
private void	_setDataEvent(microsoft.exchange.webservices.data.core.ExchangeService service, microsoft.exchange.webservices.data.core.service.item.Appointment appointment, String title, String description, String place, boolean isAllDay, Date startDate, Date endDate, EventRecurrenceTypeEnum recurrenceType, Date untilDate, Map<String,Boolean> attendees)
private void	_setRecurrence(microsoft.exchange.webservices.data.core.service.item.Appointment appointment, Date startDate, EventRecurrenceTypeEnum recurrenceType, Date untilDate)
String	createEvent(String title, String description, String place, boolean isAllDay, Date startDate, Date endDate, EventRecurrenceTypeEnum recurrenceType, Date untilDate, Map<String,Boolean> attendees, UserIdentity organiser) Create an event
void	deleteEvent(String eventId, UserIdentity organiser) Delete an event
Map<String,MessagingConnector.AttendeeInformation>	getAttendees(String eventId, UserIdentity organiser) Get the map of attendees for an event
Map<String,MessagingConnector.FreeBusyStatus>	getFreeBusy(Date startDate, Date endDate, boolean isAllDay, Set<String> attendees, UserIdentity organiser) Get free/busy status for attendees for a time window
protected microsoft.exchange.webservices.data.core.ExchangeService	getService(UserIdentity userIdentity) Get the service of connexion to the server exchange
protected static String	html2text(String html) Converts a given html String into a plain text String
protected List<EmailMessage>	internalGetEmails(UserIdentity userIdentity, int maxEmails) Get emails (no caching)
protected int	internalGetEmailsCount(UserIdentity userIdentity) Get emails count (no caching)
protected List<CalendarEvent>	internalGetEvents(UserIdentity userIdentity, Date fromDate, Date untilDate, int maxEvents) Get events between two date (no caching)
protected int	internalGetEventsCount(UserIdentity userIdentity, Date fromDate, Date untilDate) Get events count between two date (no caching)
boolean	isEventExist(String eventId, UserIdentity organiser) True if the event exist in the messaging connector
boolean	isUserExist(UserIdentity userIdentity) True if the user exist
void	service(ServiceManager manager)
void	setAttendees(String eventId, Map<String,Boolean> attendees, UserIdentity organiser) Set attendees for an event
boolean	supportInvitation() Tell if the messaging connector supports event invitation
void	updateEvent(String eventId, String title, String description, String place, boolean isAllDay, Date startDate, Date endDate, EventRecurrenceTypeEnum recurrenceType, Date untilDate, Map<String,Boolean> attendees, UserIdentity organiser) Update an event

Methods inherited from class org.ametys.plugins.messagingconnector.AbstractMessagingConnector

getAllowedPopulationIds, getEvents, getEventsCount, getUnreadEmailCount, getUnreadEmails, initialize, isAllowed

Methods inherited from class org.ametys.runtime.plugin.component.AbstractLogEnabled

getLogger, setLogger

Methods inherited from class java.lang.Object

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

Field Detail

_currentUserProvider

protected CurrentUserProvider _currentUserProvider

The current user provider

_userManager

private UserManager _userManager

The user manager

Constructor Detail

ExchangeConnector

public ExchangeConnector()

Method Detail

service

public void service(ServiceManager manager)
             throws ServiceException

Specified by:

service in interface Serviceable

Overrides:

service in class AbstractMessagingConnector

Throws:

ServiceException

getService

protected microsoft.exchange.webservices.data.core.ExchangeService getService(UserIdentity userIdentity)
                                                                       throws URISyntaxException

Get the service of connexion to the server exchange

Parameters:

userIdentity - The user identity

Returns:

the service

Throws:

URISyntaxException - if an error occurred

internalGetEvents

protected List<CalendarEvent> internalGetEvents(UserIdentity userIdentity,
                                                Date fromDate,
                                                Date untilDate,
                                                int maxEvents)
                                         throws MessagingConnectorException

Description copied from class: AbstractMessagingConnector

Get events between two date (no caching)

Specified by:

internalGetEvents in class AbstractMessagingConnector

Parameters:

userIdentity - The user identity

fromDate - The date to start search

untilDate - The date to end search

maxEvents - The maximum number of events to retrieve

Returns:

The calendar events

Throws:

MessagingConnectorException - if failed to get events from server

internalGetEventsCount

protected int internalGetEventsCount(UserIdentity userIdentity,
                                     Date fromDate,
                                     Date untilDate)
                              throws MessagingConnectorException

Description copied from class: AbstractMessagingConnector

Get events count between two date (no caching)

Specified by:

internalGetEventsCount in class AbstractMessagingConnector

Parameters:

userIdentity - The user identity

fromDate - The date to start search

untilDate - The date to end search

Returns:

The number of calendar events

Throws:

MessagingConnectorException - if failed to get events from server

internalGetEmails

protected List<EmailMessage> internalGetEmails(UserIdentity userIdentity,
                                               int maxEmails)
                                        throws MessagingConnectorException

Description copied from class: AbstractMessagingConnector

Get emails (no caching)

Specified by:

internalGetEmails in class AbstractMessagingConnector

Parameters:

userIdentity - The user identity

maxEmails - The maximum number of emails to retrieve

Returns:

The emails

Throws:

MessagingConnectorException - if failed to get events from server

internalGetEmailsCount

protected int internalGetEmailsCount(UserIdentity userIdentity)
                              throws MessagingConnectorException

Description copied from class: AbstractMessagingConnector

Get emails count (no caching)

Specified by:

internalGetEmailsCount in class AbstractMessagingConnector

Parameters:

userIdentity - The user identity

Returns:

The emails count

Throws:

MessagingConnectorException - if failed to get events from server

supportInvitation

public boolean supportInvitation()
                          throws MessagingConnectorException

Description copied from interface: MessagingConnector

Tell if the messaging connector supports event invitation

Specified by:

supportInvitation in interface MessagingConnector

Overrides:

supportInvitation in class AbstractMessagingConnector

Returns:

true if the messaging connector supports event invitation

Throws:

MessagingConnectorException - if failed to get events from server

isEventExist

public boolean isEventExist(String eventId,
                            UserIdentity organiser)
                     throws MessagingConnectorException

Description copied from interface: MessagingConnector

True if the event exist in the messaging connector

Specified by:

isEventExist in interface MessagingConnector

Overrides:

isEventExist in class AbstractMessagingConnector

Parameters:

eventId - the event id

organiser - the organiser

Returns:

true if the event exist

Throws:

MessagingConnectorException - if an error occurred

createEvent

public String createEvent(String title,
                          String description,
                          String place,
                          boolean isAllDay,
                          Date startDate,
                          Date endDate,
                          EventRecurrenceTypeEnum recurrenceType,
                          Date untilDate,
                          Map<String,Boolean> attendees,
                          UserIdentity organiser)
                   throws MessagingConnectorException

Description copied from interface: MessagingConnector

Create an event

Specified by:

createEvent in interface MessagingConnector

Overrides:

createEvent in class AbstractMessagingConnector

Parameters:

title - the event title

description - the event description

place - the event place

isAllDay - if the event is all day

startDate - the event start date

endDate - the event end date

recurrenceType - recurrence type

untilDate - until date of the recurring event

attendees - the map of attendees (email -> optional or requested) to set

organiser - the event organiser

Returns:

the id of the event created

Throws:

MessagingConnectorException - if failed to get events from server

updateEvent

public void updateEvent(String eventId,
                        String title,
                        String description,
                        String place,
                        boolean isAllDay,
                        Date startDate,
                        Date endDate,
                        EventRecurrenceTypeEnum recurrenceType,
                        Date untilDate,
                        Map<String,Boolean> attendees,
                        UserIdentity organiser)
                 throws MessagingConnectorException

Description copied from interface: MessagingConnector

Update an event

Specified by:

updateEvent in interface MessagingConnector

Overrides:

updateEvent in class AbstractMessagingConnector

Parameters:

eventId - the event id to delete

title - the event title

description - the event description

place - the event place

isAllDay - if the event is all day

startDate - the event start date

endDate - the event end date

recurrenceType - recurrence type

untilDate - until date of the recurring event

attendees - the map of attendees (email -> optional or requested) to set

organiser - the event organiser

Throws:

MessagingConnectorException - if failed to get events from server

_setDataEvent

private void _setDataEvent(microsoft.exchange.webservices.data.core.ExchangeService service,
                           microsoft.exchange.webservices.data.core.service.item.Appointment appointment,
                           String title,
                           String description,
                           String place,
                           boolean isAllDay,
                           Date startDate,
                           Date endDate,
                           EventRecurrenceTypeEnum recurrenceType,
                           Date untilDate,
                           Map<String,Boolean> attendees)
                    throws Exception

Throws:

Exception

_setRecurrence

private void _setRecurrence(microsoft.exchange.webservices.data.core.service.item.Appointment appointment,
                            Date startDate,
                            EventRecurrenceTypeEnum recurrenceType,
                            Date untilDate)
                     throws Exception

Throws:

Exception

deleteEvent

public void deleteEvent(String eventId,
                        UserIdentity organiser)
                 throws MessagingConnectorException

Description copied from interface: MessagingConnector

Delete an event

Specified by:

deleteEvent in interface MessagingConnector

Overrides:

deleteEvent in class AbstractMessagingConnector

Parameters:

eventId - the event id to delete

organiser - the event organiser

Throws:

MessagingConnectorException - if failed to get events from server

getAttendees

public Map<String,MessagingConnector.AttendeeInformation> getAttendees(String eventId,
                                                                       UserIdentity organiser)
                                                                throws MessagingConnectorException

Description copied from interface: MessagingConnector

Get the map of attendees for an event

Specified by:

getAttendees in interface MessagingConnector

Overrides:

getAttendees in class AbstractMessagingConnector

Parameters:

eventId - the event id

organiser - the event organiser

Returns:

the map of attendees (email -> attendee information)

Throws:

MessagingConnectorException - if failed to get events from server

setAttendees

public void setAttendees(String eventId,
                         Map<String,Boolean> attendees,
                         UserIdentity organiser)
                  throws MessagingConnectorException

Description copied from interface: MessagingConnector

Set attendees for an event

Specified by:

setAttendees in interface MessagingConnector

Overrides:

setAttendees in class AbstractMessagingConnector

Parameters:

eventId - the event id

attendees - the map of attendees (email -> optional or requested) to set

organiser - the event organiser

Throws:

MessagingConnectorException - if failed to get events from server

getFreeBusy

public Map<String,MessagingConnector.FreeBusyStatus> getFreeBusy(Date startDate,
                                                                 Date endDate,
                                                                 boolean isAllDay,
                                                                 Set<String> attendees,
                                                                 UserIdentity organiser)
                                                          throws MessagingConnectorException

Description copied from interface: MessagingConnector

Get free/busy status for attendees for a time window

Specified by:

getFreeBusy in interface MessagingConnector

Overrides:

getFreeBusy in class AbstractMessagingConnector

Parameters:

startDate - the start date

endDate - the end date

isAllDay - true if is an allday event

attendees - the list of attendees email

organiser - the event organiser

Returns:

the map of attendees (email -> freeBusy status)

Throws:

MessagingConnectorException - if failed to get events from server

isUserExist

public boolean isUserExist(UserIdentity userIdentity)
                    throws MessagingConnectorException

Description copied from interface: MessagingConnector

True if the user exist

Specified by:

isUserExist in interface MessagingConnector

Overrides:

isUserExist in class AbstractMessagingConnector

Parameters:

userIdentity - the user identity

Returns:

true if the user exist

Throws:

MessagingConnectorException - if failed to get events from server

_getResponseStatus

private MessagingConnector.ResponseType _getResponseStatus(microsoft.exchange.webservices.data.core.enumeration.property.MeetingResponseType meetingResponseType)

_setAttendees

private void _setAttendees(microsoft.exchange.webservices.data.core.service.item.Appointment appointment,
                           Map<String,Boolean> attendees)
                    throws Exception

Throws:

Exception

html2text

protected static String html2text(String html)

Converts a given html String into a plain text String

Parameters:

html - the html String that will be converted

Returns:

a String plain text of the given html