Package 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	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 class	GraphExchangeSession.FolderId
protected class	GraphExchangeSession.GraphIterator
protected static class	GraphExchangeSession.HeaderCondition
protected static class	GraphExchangeSession.IsNullCondition
protected class	GraphExchangeSession.Message
protected static class	GraphExchangeSession.MessageList	Extend message list to support delta sync
static enum	GraphExchangeSession.WellKnownFolderName

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

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

Field Summary

Fields

Modifier and Type	Field	Description
protected static final String	APPLICATION_ICS
protected static final String	ARCHIVE_ROOT
protected static final HashSet<String>	CALENDAR_ITEM_REQUEST_PROPERTIES
protected static final HashSet<GraphField>	CONTACT_ATTRIBUTES
protected static final HashSet<GraphField>	EVENT_ATTRIBUTES
protected static final HashSet<GraphField>	EVENT_LIST_ATTRIBUTES	EVENT_ATTRIBUTES to retrieve all fields including modified occurrences, EVENT_LIST_ATTRIBUTES for search
protected static final HashSet<String>	EVENT_REQUEST_PROPERTIES
protected static final HashSet<GraphField>	FOLDER_PROPERTIES	Default folder properties list
protected Map<String,GraphExchangeSession.FolderId>	folderIdCache
static final HashMap<String,String>	GALFIND_ATTRIBUTE_MAP	Map people attributes to LDAP
protected static final HashSet<GraphField>	IMAP_MESSAGE_ATTRIBUTES
protected static final HashSet<GraphField>	IMAP_MESSAGE_DELTA_ATTRIBUTES
protected static final Set<String>	ITEM_PROPERTIES	Common item properties, not used over Graph
protected static final int	PAGE_SIZE
protected static final String	TEXT_CALENDAR
protected Map<String,String>	urlcompnameToIdMap
protected static final 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, FORWARD, FORWARDED_ICON, FREE_BUSY_INTERVAL, GMT_TIMEZONE, importanceToPriorityMap, INBOX, JUNK, lastRcptToRecipients, lastSentMessageId, LOGGER, LOWER_CASE_INBOX, MAILBOX_BASE, mailPath, MIXED_CASE_INBOX, POP_MESSAGE_ATTRIBUTES, priorityToImportanceMap, PUBLIC_ROOT, publicFolderUrl, REPLIED_ICON, REPLYTOALL, REPLYTOSENDER, 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	Description
GraphExchangeSession(HttpClientAdapter httpClient, O365Token token, String userName)

Method Summary

Modifier and Type	Method	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)
protected void	checkToken()
void	close()	Close session.
ExchangeSession.Condition	contains(String attributeName, String value)	Contains condition.
protected String	convertClassToExchange(String eventClass)	Convert iCalendar CLASS value to Graph sensitivity value.
protected static String	convertDateFromExchange(String exchangeDateValue)	Lightweight conversion method to avoid full string to date and back conversions.
protected static String	convertHtmlToText(String htmlText)
protected String	convertItemNameToEML(String itemName)	convert vcf extension to EML.
protected String	convertItemNameToItemId(String itemName)
protected static String	convertShowAs(String status, String busyStatus)	Convert iCalendar STATUS and X-MICROSOFT-CDO-BUSYSTATUS to Graph showAs.
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.
protected GraphExchangeSession.GraphIterator	executeSearchRequest(GraphRequestBuilder httpRequestBuilder)
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
List<ExchangeSession.Contact>	getAllContacts(String folderPath, boolean includeDistList)	Search contacts in provided folder.
List<ExchangeSession.Contact>	getAllDistributionLists(String folderPath)
List<ExchangeSession.Event>	getAllEvents(String folderPath)	Search calendar events in provided folder.
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
protected String	getDeltaLink(GraphExchangeSession.FolderId folderId)	Get deltaLink on folder for delta synchronization.
protected org.codehaus.jettison.json.JSONObject	getDistListIfExists(GraphExchangeSession.FolderId folderId, String itemName)
protected org.codehaus.jettison.json.JSONObject	getEventByIdIfExists(GraphExchangeSession.FolderId folderId, String itemId)
protected org.codehaus.jettison.json.JSONObject	getEventIfExists(GraphExchangeSession.FolderId folderId, String itemName)
List<ExchangeSession.Event>	getEventMessages(String folderPath)	Override getEventMessages: inbox processing is deprecated, O365 auto scheduling is always enabled, return empty list.
protected GraphExchangeSession.FolderId	getFolderId(String folderPath)	Compute folderId from folderName
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()
protected GraphExchangeSession.Message	getMessage(GraphExchangeSession.FolderId folderId, String messageId)
protected String	getMessageHeader(javax.mail.internet.MimeMessage mimeMessage, String headerName)	Get message header value from MIME message.
List<ExchangeSession.Folder>	getSubCalendarFolders(String folderName, boolean recursive)	Search calendar folders under given folder.
List<ExchangeSession.Folder>	getSubContactFolders(String folderPath, boolean recursive)	Get contact sub folders.
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.
boolean	isExpired()	Override isExpired check with a lightweight Graph request.
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.
boolean	isMainContactFolder(String folderPath)
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
boolean	refreshFolder(ExchangeSession.Folder currentFolder)	Check folder ctag and reload messages as needed.
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, boolean fullEvent, ExchangeSession.Condition condition)	Graph implementation of event search, does not rely on provided attribute list.
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.
boolean	supportsPeopleSearch()	Check if the backend supports native people/directory search (e.g.
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.
protected void	updateMessageList(GraphExchangeSession.FolderId folderId, GraphExchangeSession.MessageList messageList)	Leverage delta sync to only load modified messages

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, getAllMessageUidAndSize, getAllRecipients, getContactPhoneField, getEmail, getExchangeDateFormat, getExchangeZuluDateFormat, getExchangeZuluDateFormatMillisecond, getFolder, getFreebusy, getPastDelayCondition, getRangeCondition, getServerVersion, getSubfolderPath, getSubFolders, getTimezoneId, getVcardBdayFormat, getVTimezone, getZuluDateFormat, moveMessages, parseDate, purgeOldestFolderMessages, purgeOldestTrashAndSentMessages, 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 Details

PAGE_SIZE

protected static final int PAGE_SIZE

See Also:

• Constant Field Values

urlcompnameToIdMap

protected Map<String,String> urlcompnameToIdMap

wellKnownFolderMap

protected static HashMap<String,String> wellKnownFolderMap

IMAP_MESSAGE_ATTRIBUTES

protected static final HashSet<GraphField> IMAP_MESSAGE_ATTRIBUTES

IMAP_MESSAGE_DELTA_ATTRIBUTES

protected static final HashSet<GraphField> IMAP_MESSAGE_DELTA_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 occurrences, 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

folderIdCache

protected Map<String,GraphExchangeSession.FolderId> folderIdCache

ITEM_PROPERTIES

protected static final Set<String> ITEM_PROPERTIES

Common item properties, not used over Graph

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 Details

GraphExchangeSession

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

Throws:

IOException

Method Details

isExpired

public boolean isExpired()
                  throws IOException

Override isExpired check with a lightweight Graph request. The session is expired if the http client is closed or the token check fails, network level errors are rethrown to avoid reauthentication.

Overrides:

isExpired in class ExchangeSession

Returns:

true if the session expired

Throws:

IOException - on network error

checkToken

protected void checkToken()
                   throws IOException

Throws:

IOException

convertShowAs

protected static String convertShowAs(String status,
 String busyStatus)

Convert iCalendar STATUS and X-MICROSOFT-CDO-BUSYSTATUS to Graph showAs. Graph showAs values: free, tentative, busy, oof, workingElsewhere, unknown (case sensitive).

Parameters:

status - iCalendar STATUS value, may be null

busyStatus - X-MICROSOFT-CDO-BUSYSTATUS value, may be null

Returns:

Graph showAs value or null if no usable value is provided

convertHtmlToText

protected static String convertHtmlToText(String htmlText)

convertClassToExchange

protected String convertClassToExchange(String eventClass)

Convert iCalendar CLASS value to Graph sensitivity value.

Parameters:

eventClass - iCalendar CLASS (PUBLIC, PRIVATE, CONFIDENTIAL)

Returns:

Graph sensitivity value (normal, private, confidential)

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

getMessageHeader

protected String getMessageHeader(javax.mail.internet.MimeMessage mimeMessage,
 String headerName)

Get message header value from MIME message. Warn on error, do not throw exception.

Parameters:

mimeMessage - MIME message

headerName - header name

Returns:

header value

getMessage

protected GraphExchangeSession.Message getMessage(GraphExchangeSession.FolderId folderId,
 String messageId)
                                           throws IOException

Throws:

IOException

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 See datetimetimezone

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

getSubContactFolders

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

Description copied from class: ExchangeSession

Get contact sub folders.

Overrides:

getSubContactFolders in class ExchangeSession

Parameters:

folderPath - 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

refreshFolder

public boolean refreshFolder(ExchangeSession.Folder currentFolder)
                      throws IOException

Description copied from class: ExchangeSession

Check folder ctag and reload messages as needed.

Overrides:

refreshFolder in class ExchangeSession

Parameters:

currentFolder - current folder

Returns:

true if folder changed

Throws:

IOException - on error

internalGetFolder

protected GraphExchangeSession.Folder internalGetFolder(String folderPath)
                                                 throws IOException

Specified by:

internalGetFolder in class ExchangeSession

Throws:

IOException

getFolderId

protected GraphExchangeSession.FolderId getFolderId(String folderPath)
                                             throws IOException

Compute folderId from folderName

Parameters:

folderPath - folder name (path)

Returns:

folder id

Throws:

IOException

getDeltaLink

protected String getDeltaLink(GraphExchangeSession.FolderId folderId)
                       throws IOException

Get deltaLink on folder for delta synchronization.

Parameters:

folderId - folder id

Returns:

delta link

Throws:

IOException - on error

updateMessageList

protected void updateMessageList(GraphExchangeSession.FolderId folderId,
 GraphExchangeSession.MessageList messageList)
                          throws IOException

Leverage delta sync to only load modified messages

Parameters:

messageList - current messages

Throws:

IOException - on error

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

getAllContacts

public List<ExchangeSession.Contact> getAllContacts(String folderPath,
 boolean includeDistList)
                                             throws IOException

Description copied from class: ExchangeSession

Search contacts in provided folder.

Overrides:

getAllContacts in class ExchangeSession

Parameters:

folderPath - Exchange folder path

includeDistList - include distribution lists

Returns:

list of contacts

Throws:

IOException - on error

getAllDistributionLists

public List<ExchangeSession.Contact> getAllDistributionLists(String folderPath)
                                                      throws IOException

Throws:

IOException

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

getAllEvents

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

Search calendar events in provided folder.

Overrides:

getAllEvents in class ExchangeSession

Parameters:

folderPath - Exchange folder path

Returns:

list of calendar events

Throws:

IOException - on error

getEventMessages

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

Override getEventMessages: inbox processing is deprecated, O365 auto scheduling is always enabled, return empty list.

Specified by:

getEventMessages in class ExchangeSession

Parameters:

folderPath - Exchange folder path

Returns:

empty list, O365 handles inbox scheduling automatically

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

searchEvents

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

Graph implementation of event search, does not rely on provided attribute list. Based on fullEvent flag, will just list minimal information or return full event content

Parameters:

folderPath - folder path

fullEvent - retrieve full events body

condition - search condition

Returns:

event list

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)

getEventIfExists

protected org.codehaus.jettison.json.JSONObject getEventIfExists(GraphExchangeSession.FolderId folderId,
 String itemName)
                                                          throws IOException

Throws:

IOException

getEventByIdIfExists

protected org.codehaus.jettison.json.JSONObject getEventByIdIfExists(GraphExchangeSession.FolderId folderId,
 String itemId)
                                                              throws IOException

Throws:

IOException

getDistListIfExists

protected org.codehaus.jettison.json.JSONObject getDistListIfExists(GraphExchangeSession.FolderId folderId,
 String itemName)
                                                             throws IOException

Throws:

IOException

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

isMainContactFolder

public boolean isMainContactFolder(String folderPath)
                            throws IOException

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)

supportsPeopleSearch

public boolean supportsPeopleSearch()

Description copied from class: ExchangeSession

Check if the backend supports native people/directory search (e.g. Graph People API). When true, the LDAP layer can issue a single broad search instead of iterating A-to-Z.

Overrides:

supportsPeopleSearch in class ExchangeSession

Returns:

true if backend supports native people search

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

executeSearchRequest

protected GraphExchangeSession.GraphIterator executeSearchRequest(GraphRequestBuilder httpRequestBuilder)
                                                           throws IOException

Throws:

IOException

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