davmail.exchange.graph

Class GraphExchangeSession

java.lang.Object

davmail.exchange.ExchangeSession

davmail.exchange.graph.GraphExchangeSession

public class GraphExchangeSession
extends ExchangeSession

Implement ExchangeSession based on Microsoft Graph

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	GraphExchangeSession.Contact
protected class	GraphExchangeSession.Event
protected static class	GraphExchangeSession.ExistsCondition
protected class	GraphExchangeSession.Folder Graph folder is identified by mailbox and id
protected static class	GraphExchangeSession.FolderId
protected static class	GraphExchangeSession.HeaderCondition
protected static class	GraphExchangeSession.IsNullCondition
static class	GraphExchangeSession.WellKnownFolderName

Nested classes/interfaces inherited from class davmail.exchange.ExchangeSession

ExchangeSession.Condition, ExchangeSession.ContactPhoto, ExchangeSession.FreeBusy, ExchangeSession.Item, ExchangeSession.ItemResult, ExchangeSession.MessageList, ExchangeSession.MonoCondition, ExchangeSession.Operator

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	APPLICATION_ICS
protected static String	ARCHIVE_ROOT
protected static HashSet<String>	CALENDAR_ITEM_REQUEST_PROPERTIES
protected static HashSet<GraphField>	CONTACT_ATTRIBUTES
protected static HashSet<GraphField>	EVENT_ATTRIBUTES
protected static HashSet<GraphField>	EVENT_LIST_ATTRIBUTES EVENT_ATTRIBUTES to retrieve all fields including modified occurences, EVENT_LIST_ATTRIBUTES for search
protected static HashSet<String>	EVENT_REQUEST_PROPERTIES
protected static HashSet<GraphField>	FOLDER_PROPERTIES Default folder properties list
static HashMap<String,String>	GALFIND_ATTRIBUTE_MAP Map people attributes to LDAP
protected static HashSet<GraphField>	IMAP_MESSAGE_ATTRIBUTES
protected static Set<String>	ITEM_PROPERTIES Common item properties
protected static String	TEXT_CALENDAR
protected Map<String,String>	urlcompnameToIdMap
protected static String	USERS_ROOT
protected static HashMap<String,String>	wellKnownFolderMap

Fields inherited from class davmail.exchange.ExchangeSession

ADDRESSBOOK, alias, ARCHIVE, CALENDAR, CONTACTS, currentMailboxPath, DISTRIBUTION_LIST_ATTRIBUTES, DRAFTS, email, FREE_BUSY_INTERVAL, GMT_TIMEZONE, importanceToPriorityMap, INBOX, JUNK, lastRcptToRecipients, lastSentMessageId, LOGGER, LOWER_CASE_INBOX, MAILBOX_BASE, mailPath, MIXED_CASE_INBOX, ORG_CONTACT_ATTRIBUTES, POP_MESSAGE_ATTRIBUTES, priorityToImportanceMap, PUBLIC_ROOT, publicFolderUrl, rootPath, SENDMSG, SENT, serverVersion, SPECIAL, TASKS, TRASH, UID_MESSAGE_ATTRIBUTES, UNSENT, userName, vTimezone, YYYY_MM_DD_HH_MM_SS, YYYY_MM_DD_T_HHMMSS_Z

Constructor Summary

Constructors

Constructor and Description
GraphExchangeSession(HttpClientAdapter httpClient, O365Token token, String userName)

Method Summary

Modifier and Type	Method and Description
ExchangeSession.MultiCondition	and(ExchangeSession.Condition... conditions) And search filter.
protected void	appendSubFolders(List<ExchangeSession.Folder> folders, String parentFolderPath, GraphExchangeSession.FolderId parentFolderId, ExchangeSession.Condition condition, boolean recursive)
protected GraphExchangeSession.Contact	buildContact(String folderPath, String itemName, Map<String,String> properties, String etag, String noneMatch)
protected GraphExchangeSession.Contact	buildGalfindContact(org.codehaus.jettison.json.JSONObject response)
protected void	buildSessionInfo(URI uri)
void	close() Close session.
ExchangeSession.Condition	contains(String attributeName, String value) Contains condition.
protected static String	convertDateFromExchange(String exchangeDateValue) Lightweight conversion method to avoid full string to date and back conversions.
protected String	convertItemNameToEML(String itemName) convert vcf extension to EML.
protected String	convertItemNameToItemId(String itemName)
void	copyMessage(ExchangeSession.Message message, String targetFolder) Copy message to target folder
int	createFolder(String folderPath, String folderClass, Map<String,String> properties) Create Exchange folder with given folder class.
ExchangeSession.Message	createMessage(String folderPath, String messageName, HashMap<String,String> properties, javax.mail.internet.MimeMessage mimeMessage) Create a message in the specified folder.
void	deleteFolder(String folderPath) Delete Exchange folder.
void	deleteItem(String folderPath, String itemName) Delete event named itemName in folder
void	deleteMessage(ExchangeSession.Message message) Delete Exchange message.
ExchangeSession.Condition	exists(String attributeName) Exists condition.
String	formatSearchDate(Date date) Format date to exchange search format.
Map<String,ExchangeSession.Contact>	galFind(ExchangeSession.Condition condition, Set<String> returningAttributes, int sizeLimit) Search global address list
protected String	getCalendarEmail(String folderPath) Get email from current calendar
protected ExchangeSession.Condition	getCalendarItemCondition(ExchangeSession.Condition dateCondition)
protected javax.mail.internet.MimePart	getCalendarMimePart(javax.mail.internet.MimeMultipart multiPart)
ExchangeSession.ContactPhoto	getContactPhoto(ExchangeSession.Contact contact) Retrieve contact photo attached to contact
protected byte[]	getContent(ExchangeSession.Message message) Get raw MIME message content
List<ExchangeSession.Event>	getEventMessages(String folderPath) Search calendar messages in provided folder.
protected String	getFreeBusyData(String attendee, String start, String end, int interval) Get freebusy data string from Exchange.
protected byte[]	getICS(InputStream mimeInputStream) Load ICS content from MIME message input stream
ExchangeSession.Item	getItem(String folderPath, String itemName) Get item named eventName in folder
protected Set<String>	getItemProperties()
List<ExchangeSession.Folder>	getSubCalendarFolders(String folderName, boolean recursive) Search calendar folders under given folder.
protected GraphExchangeSession.FolderId	getSubFolderByName(GraphExchangeSession.FolderId currentFolderId, String folderName) Search subfolder by name, return null when no folders found
List<ExchangeSession.Folder>	getSubFolders(String folderPath, ExchangeSession.Condition condition, boolean recursive) Search folders under given folder matching filter.
ExchangeSession.Condition	gt(String attributeName, String value) Greater than condition.
ExchangeSession.Condition	gte(String attributeName, String value) Greater than or equals condition.
ExchangeSession.Condition	headerIsEqualTo(String headerName, String value) MIME header equals condition.
protected ExchangeSession.ItemResult	internalCreateOrUpdateEvent(String folderPath, String itemName, String contentClass, String icsBody, String etag, String noneMatch)
protected GraphExchangeSession.Folder	internalGetFolder(String folderPath)
protected boolean	isCalendarContentType(String contentType)
ExchangeSession.Condition	isEqualTo(String attributeName, int value) Equals condition.
ExchangeSession.Condition	isEqualTo(String attributeName, String value) Equals condition.
ExchangeSession.Condition	isFalse(String attributeName) Is false condition.
protected static boolean	isItemId(String itemName) Check if itemName is long and base64 encoded.
boolean	isMainCalendar(String folderPath) Test if folderPath is main calendar.
ExchangeSession.Condition	isNull(String attributeName) Is null condition.
boolean	isSharedFolder(String folderPath) Test if folderPath is inside user mailbox.
ExchangeSession.Condition	isTrue(String attributeName) Is true condition.
protected void	loadVtimezone()
ExchangeSession.Condition	lt(String attributeName, String value) Lower than condition.
ExchangeSession.Condition	lte(String attributeName, String value) Lower than or equals condition.
void	moveFolder(String folderPath, String targetFolderPath) Move folder to target name.
void	moveItem(String sourcePath, String targetPath) Move item from source path to target path.
void	moveMessage(ExchangeSession.Message message, String targetFolder) Move message to target folder
protected void	moveToTrash(ExchangeSession.Message message)
ExchangeSession.Condition	not(ExchangeSession.Condition condition) Not search filter.
ExchangeSession.MultiCondition	or(ExchangeSession.Condition... conditions) Or search filter.
void	processItem(String folderPath, String itemName) Mark event processed named eventName in folder
List<ExchangeSession.Contact>	searchContacts(String folderPath, Set<String> attributes, ExchangeSession.Condition condition, int maxCount) Search contacts in provided folder matching the search query.
List<ExchangeSession.Event>	searchEvents(String folderPath, Set<String> attributes, ExchangeSession.Condition condition) Search calendar events or messages in provided folder matching the search query.
ExchangeSession.MessageList	searchMessages(String folderName, Set<String> attributes, ExchangeSession.Condition condition) Search folder for messages matching conditions, with given attributes.
List<ExchangeSession.Event>	searchTasksOnly(String folderPath) Tasks folders are no longer supported, reroute to todos.
int	sendEvent(String icsBody) Build and send the MIME message for the provided ICS event.
void	sendMessage(byte[] byteArray)
void	sendMessage(javax.mail.internet.MimeMessage mimeMessage) Send Mime message.
ExchangeSession.Condition	startsWith(String attributeName, String value) Starts with condition.
int	updateFolder(String folderName, Map<String,String> properties) Update Exchange folder properties.
void	updateMessage(ExchangeSession.Message message, Map<String,String> properties) Update given properties on message.

Methods inherited from class davmail.exchange.ExchangeSession

clearVTimezone, convertBDayToZulu, convertClassFromExchange, convertContactProperties, convertFlagsToKeywords, convertFlagToKeyword, convertKeywordToFlag, convertPriorityFromExchange, convertPriorityToExchange, convertResentHeader, convertZuluDateToBday, copyMessages, createCalendarFolder, createContactFolder, createMessageFolder, createOrUpdateContact, createOrUpdateItem, decodeKeyword, encodeKeyword, getADPhoto, getAlias, getAliasFromLogin, getAllContacts, getAllEvents, getAllMessageUidAndSize, getAllRecipients, getEmail, getExchangeDateFormat, getExchangeZuluDateFormat, getExchangeZuluDateFormatMillisecond, getFolder, getFreebusy, getPastDelayCondition, getRangeCondition, getServerVersion, getSubFolders, getTimezoneId, getVcardBdayFormat, getVTimezone, getZuluDateFormat, isExpired, moveMessages, parseDate, purgeOldestFolderMessages, purgeOldestTrashAndSentMessages, refreshFolder, replaceIcal4Principal, searchEvents, searchEvents, searchEventsOnly, searchMessages, searchMessages, sendMessage

Methods inherited from class java.lang.Object

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

Field Detail

urlcompnameToIdMap

protected Map<String,String> urlcompnameToIdMap

wellKnownFolderMap

protected static HashMap<String,String> wellKnownFolderMap

IMAP_MESSAGE_ATTRIBUTES

protected static final HashSet<GraphField> IMAP_MESSAGE_ATTRIBUTES

CONTACT_ATTRIBUTES

protected static final HashSet<GraphField> CONTACT_ATTRIBUTES

EVENT_LIST_ATTRIBUTES

protected static final HashSet<GraphField> EVENT_LIST_ATTRIBUTES

EVENT_ATTRIBUTES to retrieve all fields including modified occurences, EVENT_LIST_ATTRIBUTES for search

EVENT_ATTRIBUTES

protected static final HashSet<GraphField> EVENT_ATTRIBUTES

FOLDER_PROPERTIES

protected static final HashSet<GraphField> FOLDER_PROPERTIES

Default folder properties list

USERS_ROOT

protected static final String USERS_ROOT

See Also:

Constant Field Values

ARCHIVE_ROOT

protected static final String ARCHIVE_ROOT

See Also:

Constant Field Values

ITEM_PROPERTIES

protected static final Set<String> ITEM_PROPERTIES

Common item properties

EVENT_REQUEST_PROPERTIES

protected static final HashSet<String> EVENT_REQUEST_PROPERTIES

CALENDAR_ITEM_REQUEST_PROPERTIES

protected static final HashSet<String> CALENDAR_ITEM_REQUEST_PROPERTIES

TEXT_CALENDAR

protected static final String TEXT_CALENDAR

See Also:

Constant Field Values

APPLICATION_ICS

protected static final String APPLICATION_ICS

See Also:

Constant Field Values

GALFIND_ATTRIBUTE_MAP

public static final HashMap<String,String> GALFIND_ATTRIBUTE_MAP

Map people attributes to LDAP

Constructor Detail

GraphExchangeSession

public GraphExchangeSession(HttpClientAdapter httpClient,
                            O365Token token,
                            String userName)
                     throws IOException

Throws:

IOException

Method Detail

close

public void close()

Description copied from class: ExchangeSession

Close session. Shutdown http client connection manager

Specified by:

close in class ExchangeSession

formatSearchDate

public String formatSearchDate(Date date)

Format date to exchange search format. TODO: review

Specified by:

formatSearchDate in class ExchangeSession

Parameters:

date - date object

Returns:

formatted search date

buildSessionInfo

protected void buildSessionInfo(URI uri)
                         throws IOException

Specified by:

buildSessionInfo in class ExchangeSession

Throws:

IOException

createMessage

public ExchangeSession.Message createMessage(String folderPath,
                                             String messageName,
                                             HashMap<String,String> properties,
                                             javax.mail.internet.MimeMessage mimeMessage)
                                      throws IOException

Description copied from class: ExchangeSession

Create a message in the specified folder. Will overwrite an existing message with the same subject in the same folder

Specified by:

createMessage in class ExchangeSession

Parameters:

folderPath - Exchange folder path

messageName - message name

properties - message properties (flags)

mimeMessage - MIME message

Throws:

IOException - when unable to create message

convertDateFromExchange

protected static String convertDateFromExchange(String exchangeDateValue)
                                         throws DavMailException

Lightweight conversion method to avoid full string to date and back conversions. Note: Duplicate from EWSEchangeSession, added nanosecond handling

Parameters:

exchangeDateValue - date returned from O365

Returns:

converted date

Throws:

DavMailException - on error

updateMessage

public void updateMessage(ExchangeSession.Message message,
                          Map<String,String> properties)
                   throws IOException

Description copied from class: ExchangeSession

Update given properties on message.

Specified by:

updateMessage in class ExchangeSession

Parameters:

message - Exchange message

properties - Webdav properties map

Throws:

IOException - on error

deleteMessage

public void deleteMessage(ExchangeSession.Message message)
                   throws IOException

Description copied from class: ExchangeSession

Delete Exchange message.

Specified by:

deleteMessage in class ExchangeSession

Parameters:

message - Exchange message

Throws:

IOException - on error

getContent

protected byte[] getContent(ExchangeSession.Message message)
                     throws IOException

Description copied from class: ExchangeSession

Get raw MIME message content

Specified by:

getContent in class ExchangeSession

Parameters:

message - Exchange message

Returns:

message body

Throws:

IOException - on error

searchMessages

public ExchangeSession.MessageList searchMessages(String folderName,
                                                  Set<String> attributes,
                                                  ExchangeSession.Condition condition)
                                           throws IOException

Description copied from class: ExchangeSession

Search folder for messages matching conditions, with given attributes.

Specified by:

searchMessages in class ExchangeSession

Parameters:

folderName - Exchange folder name

attributes - requested Webdav attributes

condition - search filter

Returns:

message list

Throws:

IOException - on error

and

public ExchangeSession.MultiCondition and(ExchangeSession.Condition... conditions)

Description copied from class: ExchangeSession

And search filter.

Specified by:

and in class ExchangeSession

Parameters:

conditions - search conditions

Returns:

condition

or

public ExchangeSession.MultiCondition or(ExchangeSession.Condition... conditions)

Description copied from class: ExchangeSession

Or search filter.

Specified by:

or in class ExchangeSession

Parameters:

conditions - search conditions

Returns:

condition

not

public ExchangeSession.Condition not(ExchangeSession.Condition condition)

Description copied from class: ExchangeSession

Not search filter.

Specified by:

not in class ExchangeSession

Parameters:

condition - search condition

Returns:

condition

isEqualTo

public ExchangeSession.Condition isEqualTo(String attributeName,
                                           String value)

Description copied from class: ExchangeSession

Equals condition.

Specified by:

isEqualTo in class ExchangeSession

Parameters:

attributeName - logical Exchange attribute name

value - attribute value

Returns:

condition

isEqualTo

public ExchangeSession.Condition isEqualTo(String attributeName,
                                           int value)

Description copied from class: ExchangeSession

Equals condition.

Specified by:

isEqualTo in class ExchangeSession

Parameters:

attributeName - logical Exchange attribute name

value - attribute value

Returns:

condition

headerIsEqualTo

public ExchangeSession.Condition headerIsEqualTo(String headerName,
                                                 String value)

Description copied from class: ExchangeSession

MIME header equals condition.

Specified by:

headerIsEqualTo in class ExchangeSession

Parameters:

headerName - MIME header name

value - attribute value

Returns:

condition

gte

public ExchangeSession.Condition gte(String attributeName,
                                     String value)

Description copied from class: ExchangeSession

Greater than or equals condition.

Specified by:

gte in class ExchangeSession

Parameters:

attributeName - logical Exchange attribute name

value - attribute value

Returns:

condition

gt

public ExchangeSession.Condition gt(String attributeName,
                                    String value)

Description copied from class: ExchangeSession

Greater than condition.

Specified by:

gt in class ExchangeSession

Parameters:

attributeName - logical Exchange attribute name

value - attribute value

Returns:

condition

lt

public ExchangeSession.Condition lt(String attributeName,
                                    String value)

Description copied from class: ExchangeSession

Lower than condition.

Specified by:

lt in class ExchangeSession

Parameters:

attributeName - logical Exchange attribute name

value - attribute value

Returns:

condition

lte

public ExchangeSession.Condition lte(String attributeName,
                                     String value)

Description copied from class: ExchangeSession

Lower than or equals condition.

Specified by:

lte in class ExchangeSession

Parameters:

attributeName - logical Exchange attribute name

value - attribute value

Returns:

condition

contains

public ExchangeSession.Condition contains(String attributeName,
                                          String value)

Description copied from class: ExchangeSession

Contains condition.

Specified by:

contains in class ExchangeSession

Parameters:

attributeName - logical Exchange attribute name

value - attribute value

Returns:

condition

startsWith

public ExchangeSession.Condition startsWith(String attributeName,
                                            String value)

Description copied from class: ExchangeSession

Starts with condition.

Specified by:

startsWith in class ExchangeSession

Parameters:

attributeName - logical Exchange attribute name

value - attribute value

Returns:

condition

isNull

public ExchangeSession.Condition isNull(String attributeName)

Description copied from class: ExchangeSession

Is null condition.

Specified by:

isNull in class ExchangeSession

Parameters:

attributeName - logical Exchange attribute name

Returns:

condition

exists

public ExchangeSession.Condition exists(String attributeName)

Description copied from class: ExchangeSession

Exists condition.

Specified by:

exists in class ExchangeSession

Parameters:

attributeName - logical Exchange attribute name

Returns:

condition

isTrue

public ExchangeSession.Condition isTrue(String attributeName)

Description copied from class: ExchangeSession

Is true condition.

Specified by:

isTrue in class ExchangeSession

Parameters:

attributeName - logical Exchange attribute name

Returns:

condition

isFalse

public ExchangeSession.Condition isFalse(String attributeName)

Description copied from class: ExchangeSession

Is false condition.

Specified by:

isFalse in class ExchangeSession

Parameters:

attributeName - logical Exchange attribute name

Returns:

condition

getSubCalendarFolders

public List<ExchangeSession.Folder> getSubCalendarFolders(String folderName,
                                                          boolean recursive)
                                                   throws IOException

Description copied from class: ExchangeSession

Search calendar folders under given folder.

Overrides:

getSubCalendarFolders in class ExchangeSession

Parameters:

folderName - Exchange folder name

recursive - deep search if true

Returns:

list of folders

Throws:

IOException - on error

getSubFolders

public List<ExchangeSession.Folder> getSubFolders(String folderPath,
                                                  ExchangeSession.Condition condition,
                                                  boolean recursive)
                                           throws IOException

Description copied from class: ExchangeSession

Search folders under given folder matching filter.

Specified by:

getSubFolders in class ExchangeSession

Parameters:

folderPath - Exchange folder name

condition - search filter

recursive - deep search if true

Returns:

list of folders

Throws:

IOException - on error

appendSubFolders

protected void appendSubFolders(List<ExchangeSession.Folder> folders,
                                String parentFolderPath,
                                GraphExchangeSession.FolderId parentFolderId,
                                ExchangeSession.Condition condition,
                                boolean recursive)
                         throws IOException

Throws:

IOException

sendMessage

public void sendMessage(javax.mail.internet.MimeMessage mimeMessage)
                 throws IOException,
                        javax.mail.MessagingException

Description copied from class: ExchangeSession

Send Mime message.

Specified by:

sendMessage in class ExchangeSession

Parameters:

mimeMessage - MIME message

Throws:

IOException - on error

javax.mail.MessagingException - on error

sendMessage

public void sendMessage(byte[] byteArray)
                 throws IOException

Throws:

IOException

internalGetFolder

protected GraphExchangeSession.Folder internalGetFolder(String folderPath)
                                                 throws IOException

Specified by:

internalGetFolder in class ExchangeSession

Throws:

IOException

getSubFolderByName

protected GraphExchangeSession.FolderId getSubFolderByName(GraphExchangeSession.FolderId currentFolderId,
                                                           String folderName)
                                                    throws IOException

Search subfolder by name, return null when no folders found

Parameters:

currentFolderId - parent folder id

folderName - child folder name

Returns:

child folder id if exists

Throws:

IOException - on error

createFolder

public int createFolder(String folderPath,
                        String folderClass,
                        Map<String,String> properties)
                 throws IOException

Description copied from class: ExchangeSession

Create Exchange folder with given folder class.

Specified by:

createFolder in class ExchangeSession

Parameters:

folderPath - logical folder name

folderClass - folder class

properties - folder properties

Returns:

status

Throws:

IOException - on error

updateFolder

public int updateFolder(String folderName,
                        Map<String,String> properties)
                 throws IOException

Description copied from class: ExchangeSession

Update Exchange folder properties.

Specified by:

updateFolder in class ExchangeSession

Parameters:

folderName - logical folder name

properties - folder properties

Returns:

status

Throws:

IOException - on error

deleteFolder

public void deleteFolder(String folderPath)
                  throws IOException

Description copied from class: ExchangeSession

Delete Exchange folder.

Specified by:

deleteFolder in class ExchangeSession

Parameters:

folderPath - logical folder name

Throws:

IOException - on error

copyMessage

public void copyMessage(ExchangeSession.Message message,
                        String targetFolder)
                 throws IOException

Description copied from class: ExchangeSession

Copy message to target folder

Specified by:

copyMessage in class ExchangeSession

Parameters:

message - Exchange message

targetFolder - target folder

Throws:

IOException - on error

moveMessage

public void moveMessage(ExchangeSession.Message message,
                        String targetFolder)
                 throws IOException

Description copied from class: ExchangeSession

Move message to target folder

Specified by:

moveMessage in class ExchangeSession

Parameters:

message - Exchange message

targetFolder - target folder

Throws:

IOException - on error

moveFolder

public void moveFolder(String folderPath,
                       String targetFolderPath)
                throws IOException

Description copied from class: ExchangeSession

Move folder to target name.

Specified by:

moveFolder in class ExchangeSession

Parameters:

folderPath - current folder name/path

targetFolderPath - target folder name/path

Throws:

IOException - on error

moveItem

public void moveItem(String sourcePath,
                     String targetPath)
              throws IOException

Description copied from class: ExchangeSession

Move item from source path to target path.

Specified by:

moveItem in class ExchangeSession

Parameters:

sourcePath - item source path

targetPath - item target path

Throws:

IOException - on error

moveToTrash

protected void moveToTrash(ExchangeSession.Message message)
                    throws IOException

Specified by:

moveToTrash in class ExchangeSession

Throws:

IOException

getItemProperties

protected Set<String> getItemProperties()

Specified by:

getItemProperties in class ExchangeSession

searchContacts

public List<ExchangeSession.Contact> searchContacts(String folderPath,
                                                    Set<String> attributes,
                                                    ExchangeSession.Condition condition,
                                                    int maxCount)
                                             throws IOException

Description copied from class: ExchangeSession

Search contacts in provided folder matching the search query.

Specified by:

searchContacts in class ExchangeSession

Parameters:

folderPath - Exchange folder path

attributes - requested attributes

condition - Exchange search query

maxCount - maximum item count

Returns:

list of contacts

Throws:

IOException - on error

getEventMessages

public List<ExchangeSession.Event> getEventMessages(String folderPath)
                                             throws IOException

Description copied from class: ExchangeSession

Search calendar messages in provided folder.

Specified by:

getEventMessages in class ExchangeSession

Parameters:

folderPath - Exchange folder path

Returns:

list of calendar messages as Event objects

Throws:

IOException - on error

getCalendarItemCondition

protected ExchangeSession.Condition getCalendarItemCondition(ExchangeSession.Condition dateCondition)

Specified by:

getCalendarItemCondition in class ExchangeSession

searchTasksOnly

public List<ExchangeSession.Event> searchTasksOnly(String folderPath)
                                            throws IOException

Tasks folders are no longer supported, reroute to todos.

Overrides:

searchTasksOnly in class ExchangeSession

Parameters:

folderPath - Exchange folder path

Returns:

todos as events

Throws:

IOException - on error

searchEvents

public List<ExchangeSession.Event> searchEvents(String folderPath,
                                                Set<String> attributes,
                                                ExchangeSession.Condition condition)
                                         throws IOException

Description copied from class: ExchangeSession

Search calendar events or messages in provided folder matching the search query.

Specified by:

searchEvents in class ExchangeSession

Parameters:

folderPath - Exchange folder path

attributes - requested attributes

condition - Exchange search query

Returns:

list of calendar messages as Event objects

Throws:

IOException - on error

isCalendarContentType

protected boolean isCalendarContentType(String contentType)

getCalendarMimePart

protected javax.mail.internet.MimePart getCalendarMimePart(javax.mail.internet.MimeMultipart multiPart)
                                                    throws IOException,
                                                           javax.mail.MessagingException

Throws:

IOException

javax.mail.MessagingException

getICS

protected byte[] getICS(InputStream mimeInputStream)
                 throws IOException,
                        javax.mail.MessagingException

Load ICS content from MIME message input stream

Parameters:

mimeInputStream - mime message input stream

Returns:

mime message ics attachment body

Throws:

IOException - on error

javax.mail.MessagingException - on error

getItem

public ExchangeSession.Item getItem(String folderPath,
                                    String itemName)
                             throws IOException

Description copied from class: ExchangeSession

Get item named eventName in folder

Specified by:

getItem in class ExchangeSession

Parameters:

folderPath - Exchange folder path

itemName - event name

Returns:

event object

Throws:

IOException - on error

convertItemNameToEML

protected String convertItemNameToEML(String itemName)

Description copied from class: ExchangeSession

convert vcf extension to EML.

Overrides:

convertItemNameToEML in class ExchangeSession

Parameters:

itemName - item name

Returns:

EML item name

convertItemNameToItemId

protected String convertItemNameToItemId(String itemName)

getContactPhoto

public ExchangeSession.ContactPhoto getContactPhoto(ExchangeSession.Contact contact)
                                             throws IOException

Description copied from class: ExchangeSession

Retrieve contact photo attached to contact

Specified by:

getContactPhoto in class ExchangeSession

Parameters:

contact - address book contact

Returns:

contact photo

Throws:

IOException - on error

deleteItem

public void deleteItem(String folderPath,
                       String itemName)
                throws IOException

Description copied from class: ExchangeSession

Delete event named itemName in folder

Specified by:

deleteItem in class ExchangeSession

Parameters:

folderPath - Exchange folder path

itemName - item name

Throws:

IOException - on error

processItem

public void processItem(String folderPath,
                        String itemName)
                 throws IOException

Description copied from class: ExchangeSession

Mark event processed named eventName in folder

Specified by:

processItem in class ExchangeSession

Parameters:

folderPath - Exchange folder path

itemName - item name

Throws:

IOException - on error

sendEvent

public int sendEvent(String icsBody)
              throws IOException

Description copied from class: ExchangeSession

Build and send the MIME message for the provided ICS event.

Specified by:

sendEvent in class ExchangeSession

Parameters:

icsBody - event in iCalendar format

Returns:

HTTP status

Throws:

IOException - on error

buildContact

protected GraphExchangeSession.Contact buildContact(String folderPath,
                                                    String itemName,
                                                    Map<String,String> properties,
                                                    String etag,
                                                    String noneMatch)
                                             throws IOException

Specified by:

buildContact in class ExchangeSession

Throws:

IOException

internalCreateOrUpdateEvent

protected ExchangeSession.ItemResult internalCreateOrUpdateEvent(String folderPath,
                                                                 String itemName,
                                                                 String contentClass,
                                                                 String icsBody,
                                                                 String etag,
                                                                 String noneMatch)
                                                          throws IOException

Specified by:

internalCreateOrUpdateEvent in class ExchangeSession

Throws:

IOException

isSharedFolder

public boolean isSharedFolder(String folderPath)

Description copied from class: ExchangeSession

Test if folderPath is inside user mailbox.

Specified by:

isSharedFolder in class ExchangeSession

Parameters:

folderPath - absolute folder path

Returns:

true if folderPath is a public or shared folder

isMainCalendar

public boolean isMainCalendar(String folderPath)
                       throws IOException

Description copied from class: ExchangeSession

Test if folderPath is main calendar.

Specified by:

isMainCalendar in class ExchangeSession

Parameters:

folderPath - absolute folder path

Returns:

true if folderPath is a public or shared folder

Throws:

IOException

getCalendarEmail

protected String getCalendarEmail(String folderPath)
                           throws IOException

Description copied from class: ExchangeSession

Get email from current calendar

Specified by:

getCalendarEmail in class ExchangeSession

Parameters:

folderPath - calendar folder path

Returns:

calendar mailbox

Throws:

IOException

buildGalfindContact

protected GraphExchangeSession.Contact buildGalfindContact(org.codehaus.jettison.json.JSONObject response)

galFind

public Map<String,ExchangeSession.Contact> galFind(ExchangeSession.Condition condition,
                                                   Set<String> returningAttributes,
                                                   int sizeLimit)
                                            throws IOException

Description copied from class: ExchangeSession

Search global address list

Specified by:

galFind in class ExchangeSession

Parameters:

condition - search filter

returningAttributes - returning attributes

sizeLimit - size limit

Returns:

matching contacts from gal

Throws:

IOException - on error

getFreeBusyData

protected String getFreeBusyData(String attendee,
                                 String start,
                                 String end,
                                 int interval)
                          throws IOException

Description copied from class: ExchangeSession

Get freebusy data string from Exchange.

Specified by:

getFreeBusyData in class ExchangeSession

Parameters:

attendee - attendee email address

start - start date in Exchange zulu format

end - end date in Exchange zulu format

interval - freebusy interval in minutes

Returns:

freebusy data or null

Throws:

IOException - on error

loadVtimezone

protected void loadVtimezone()

Specified by:

loadVtimezone in class ExchangeSession

isItemId

protected static boolean isItemId(String itemName)

Check if itemName is long and base64 encoded. User-generated item names are usually short

Parameters:

itemName - item name

Returns:

true if itemName is an EWS item id