net.bluemind.backend.mail.replica.service.internal

Class ImapMailboxRecordsService

java.lang.Object

net.bluemind.backend.mail.replica.service.internal.BaseMailboxRecordsService

net.bluemind.backend.mail.replica.service.internal.ImapMailboxRecordsService

All Implemented Interfaces:

IMailboxItems, IInternalMailboxItems, IChangelogSupport, ICountingSupport, ICrudByIdSupport<MailboxItem>, ISortingSupport

public class ImapMailboxRecordsService
extends BaseMailboxRecordsService
implements IInternalMailboxItems

Nested Class Summary

Nested classes/interfaces inherited from interface net.bluemind.backend.mail.replica.api.IInternalMailboxItems

IInternalMailboxItems.ImapClient, IInternalMailboxItems.ImapCommandRunner

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.Integer	DEFAULT_TIMEOUT

Fields inherited from class net.bluemind.backend.mail.replica.service.internal.BaseMailboxRecordsService

container, context, mailboxUniqueId, optRecordsLocation, rbac, recordStore, replicaStore, storeService

Constructor Summary

Constructors

Constructor and Description
ImapMailboxRecordsService(javax.sql.DataSource ds, Container cont, BmContext context, java.lang.String mailboxUniqueId, MailboxRecordStore recordStore, ContainerStoreService<MailboxRecord> storeService)

Method Summary

Modifier and Type	Method and Description
Ack	addFlag(FlagUpdate flagUpdate) Add one flag to multiple MailboxItem.
ImapItemIdentifier	create(MailboxItem value)
ImapAck	createById(long id, MailboxItem value)
void	deleteById(long id)
Ack	deleteFlag(FlagUpdate flagUpdate) Delete one flag to multiple MailboxItem.
void	expunge() Mark deleted items as ready for removal.
Stream	fetch(long imapUid, java.lang.String address, java.lang.String encoding, java.lang.String mime, java.lang.String charset, java.lang.String filename) Fetch a single part from an email mime tree.
Stream	fetchComplete(long imapUid)
ItemValue<MailboxItem>	getCompleteById(long id)
ItemValue<MailboxItem>	getForUpdate(long id) Decompose EML in temporary parts, useful to update drafts
IInternalMailboxItems.ImapCommandRunner	imapExecutor()
java.lang.String	imapFolder()
java.util.List<ItemIdentifier>	multiCreate(java.util.List<MailboxItem> items)
java.util.List<ItemValue<MailboxItem>>	multipleById(java.util.List<java.lang.Long> ids)
void	multipleDeleteById(java.util.List<java.lang.Long> ids)
java.util.List<java.lang.Long>	recentItems(java.util.Date d) Get the list of ItemValue.internalId for MailboxItem delivered or updated after or at the given date.
void	removePart(java.lang.String partId) Remove a part uploaded through IMailboxItems.uploadPart(Stream)
void	resync() Removes extra records (missing on imap server)
ItemIdentifier	unexpunge(long itemId) Re-injects a deleted item into the current folder
java.util.List<java.lang.Long>	unreadItems() Get the list of unread items, applying the per-user overlay when dealing with a shared folder.
ImapAck	updateById(long id, MailboxItem mail)
java.lang.String	uploadPart(Stream part) Upload an email part (eg.

Methods inherited from class net.bluemind.backend.mail.replica.service.internal.BaseMailboxRecordsService

adapt, allIds, changeset, changesetById, checkExistOnBackend, containerChangelog, count, fetchCompleteOIO, filteredChangesetById, getVersion, itemChangelog, sortedIds

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.bluemind.backend.mail.api.IMailboxItems

sortedIds

Methods inherited from interface net.bluemind.core.container.api.IChangelogSupport

allIds, changeset, changesetById, containerChangelog, filteredChangesetById, getVersion, itemChangelog

Methods inherited from interface net.bluemind.core.container.api.ICountingSupport

count

Field Detail

DEFAULT_TIMEOUT

public static final java.lang.Integer DEFAULT_TIMEOUT

Constructor Detail

ImapMailboxRecordsService

public ImapMailboxRecordsService(javax.sql.DataSource ds,
                                 Container cont,
                                 BmContext context,
                                 java.lang.String mailboxUniqueId,
                                 MailboxRecordStore recordStore,
                                 ContainerStoreService<MailboxRecord> storeService)

Method Detail

imapFolder

public java.lang.String imapFolder()

Specified by:

imapFolder in interface IInternalMailboxItems

imapExecutor

public IInternalMailboxItems.ImapCommandRunner imapExecutor()

Specified by:

imapExecutor in interface IInternalMailboxItems

getCompleteById

public ItemValue<MailboxItem> getCompleteById(long id)

Specified by:

getCompleteById in interface IMailboxItems

Specified by:

getCompleteById in interface ICrudByIdSupport<MailboxItem>

deleteById

public void deleteById(long id)

Specified by:

deleteById in interface IMailboxItems

Specified by:

deleteById in interface ICrudByIdSupport<MailboxItem>

expunge

public void expunge()

Description copied from interface: IMailboxItems

Mark deleted items as ready for removal. Physical will removal will occur later (cyr_expire & co)

Specified by:

expunge in interface IMailboxItems

resync

public void resync()

Description copied from interface: IMailboxItems

Removes extra records (missing on imap server)

Specified by:

resync in interface IMailboxItems

updateById

public ImapAck updateById(long id,
                          MailboxItem mail)

Specified by:

updateById in interface IMailboxItems

Specified by:

updateById in interface ICrudByIdSupport<MailboxItem>

create

public ImapItemIdentifier create(MailboxItem value)

Specified by:

create in interface IMailboxItems

createById

public ImapAck createById(long id,
                          MailboxItem value)

Specified by:

createById in interface IMailboxItems

Specified by:

createById in interface ICrudByIdSupport<MailboxItem>

multiCreate

public java.util.List<ItemIdentifier> multiCreate(java.util.List<MailboxItem> items)

Specified by:

multiCreate in interface IInternalMailboxItems

multipleById

public java.util.List<ItemValue<MailboxItem>> multipleById(java.util.List<java.lang.Long> ids)

Specified by:

multipleById in interface IMailboxItems

unexpunge

public ItemIdentifier unexpunge(long itemId)

Description copied from interface: IMailboxItems

Re-injects a deleted item into the current folder

Specified by:

unexpunge in interface IMailboxItems

Parameters:

itemId - the item id of a deleted or deleted+expunged message

Returns:

fetchComplete

public Stream fetchComplete(long imapUid)

Specified by:

fetchComplete in interface IMailboxItems

Overrides:

fetchComplete in class BaseMailboxRecordsService

Returns:

fetch

public Stream fetch(long imapUid,
                    java.lang.String address,
                    java.lang.String encoding,
                    java.lang.String mime,
                    java.lang.String charset,
                    java.lang.String filename)

Description copied from interface: IMailboxItems

Fetch a single part from an email mime tree. The address, encoding & charset are specified in the MessageBody.Part objects from MessageBody.structure.

Specified by:

fetch in interface IMailboxItems

encoding - set null to fetch pristine part

mime - override the mime type of the response

charset - override the charset of the response

filename - set a part name (useful for download purpose)

Returns:

a stream of the (optionally) decoded part

uploadPart

public java.lang.String uploadPart(Stream part)

Description copied from interface: IMailboxItems

Upload an email part (eg. attachment, html body). The returned address can be used as MessageBody.Part.address when creating or updating a MailboxItem. The uploaded parts need to be cleaned-up explicitly with IMailboxItems.removePart(String)

Specified by:

uploadPart in interface IMailboxItems

Parameters:

part - a re-usable email part.

Returns:

an address usable as MessageBody.Part.address

removePart

public void removePart(java.lang.String partId)

Description copied from interface: IMailboxItems

Remove a part uploaded through IMailboxItems.uploadPart(Stream)

Specified by:

removePart in interface IMailboxItems

Parameters:

partId - an address returned by a previous uploadPart call

unreadItems

public java.util.List<java.lang.Long> unreadItems()

Description copied from interface: IMailboxItems

Get the list of unread items, applying the per-user overlay when dealing with a shared folder.

Specified by:

unreadItems in interface IMailboxItems

Returns:

the list of ItemValue.internalId

recentItems

public java.util.List<java.lang.Long> recentItems(java.util.Date d)

Description copied from interface: IMailboxItems

Get the list of ItemValue.internalId for MailboxItem delivered or updated after or at the given date.

Specified by:

recentItems in interface IMailboxItems

Returns:

multipleDeleteById

public void multipleDeleteById(java.util.List<java.lang.Long> ids)

Specified by:

multipleDeleteById in interface ICrudByIdSupport<MailboxItem>

addFlag

public Ack addFlag(FlagUpdate flagUpdate)

Description copied from interface: IMailboxItems

Add one flag to multiple MailboxItem.

Specified by:

addFlag in interface IMailboxItems

Returns:

the new container version

deleteFlag

public Ack deleteFlag(FlagUpdate flagUpdate)

Description copied from interface: IMailboxItems

Delete one flag to multiple MailboxItem.

Specified by:

deleteFlag in interface IMailboxItems

Returns:

the new container version

getForUpdate

public ItemValue<MailboxItem> getForUpdate(long id)

Description copied from interface: IMailboxItems

Decompose EML in temporary parts, useful to update drafts

Specified by:

getForUpdate in interface IMailboxItems

Returns:

message structure with temporary addresses