/*
* Copyright (C) 2005-2010 Alfresco Software Limited.
*
* This file is part of Alfresco
*
* Alfresco is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Alfresco is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with Alfresco. If not, see .
*/
package org.alfresco.repo.imap;
import java.util.ArrayList;
import java.util.Collection;
import java.util.List;
import org.alfresco.repo.imap.exception.AlfrescoImapFolderException;
import org.alfresco.service.transaction.TransactionService;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import com.icegreen.greenmail.imap.AuthorizationException;
import com.icegreen.greenmail.imap.ImapHostManager;
import com.icegreen.greenmail.store.FolderException;
import com.icegreen.greenmail.store.MailFolder;
import com.icegreen.greenmail.user.GreenMailUser;
/**
* @author Mike Shavnev
*/
public class AlfrescoImapHostManager implements ImapHostManager
{
private ImapService imapService;
private TransactionService transactionService;
private static Log logger = LogFactory.getLog(AlfrescoImapHostManager.class);
/**
* Returns the hierarchy delimiter for mailboxes on this host.
*
* @return The hierarchy delimiter character.
*/
public char getHierarchyDelimiter()
{
return AlfrescoImapConst.HIERARCHY_DELIMITER;
}
/**
* Returns an collection of mailboxes. Method searches mailboxes under mount points defined for a specific user.
* Mount points include user's IMAP Virtualised Views and Email Archive Views. This method serves LIST command
* of the IMAP protocol.
*
* @param user User making the request
* @param mailboxPattern String name of a mailbox possible including a wildcard.
* @return Collection of mailboxes matching the pattern.
* @throws com.icegreen.greenmail.store.FolderException
*/
public Collection listMailboxes(GreenMailUser user, String mailboxPattern) throws FolderException
{
try
{
return new ArrayList(
imapService.listMailboxes(
new AlfrescoImapUser(
user.getEmail(),
user.getLogin(),
user.getPassword()),
mailboxPattern));
}
catch (Throwable e)
{
logger.debug(e.getMessage(), e);
throw new FolderException(e.getMessage());
}
}
/**
* Returns an collection of subscribed mailboxes. To appear in search result mailboxes should have
* {http://www.alfresco.org/model/imap/1.0}subscribed property specified for user. Method searches
* subscribed mailboxes under mount points defined for a specific user. Mount points include user's
* IMAP Virtualised Views and Email Archive Views. This method serves LSUB command of the IMAP protocol.
*
* @param user User making the request
* @param mailboxPattern String name of a mailbox possible including a wildcard.
* @return Collection of mailboxes matching the pattern.
* @throws com.icegreen.greenmail.store.FolderException
*/
public Collection listSubscribedMailboxes(GreenMailUser user, String mailboxPattern) throws FolderException
{
try
{
return new ArrayList(
imapService.listSubscribedMailboxes(
new AlfrescoImapUser(
user.getEmail(),
user.getLogin(),
user.getPassword()),
mailboxPattern));
}
catch (Throwable e)
{
logger.debug(e.getMessage(), e);
throw new FolderException(e.getMessage());
}
}
/**
* Renames an existing mailbox. The specified mailbox must already exist, the requested name must not exist
* already but must be able to be created and the user must have rights to delete the existing mailbox and
* create a mailbox with the new name. Any inferior hierarchical names must also be renamed. If INBOX is renamed,
* the contents of INBOX are transferred to a new mailbox with the new name, but INBOX is not deleted.
* If INBOX has inferior mailbox these are not renamed. This method serves RENAME command of the IMAP
* protocol. Method searches mailbox under mount points defined for a specific user. Mount points
* include user's IMAP Virtualised Views and Email Archive Views.
*
* @param user User making the request.
* @param oldMailboxName String name of the existing folder
* @param newMailboxName String target new name
* @throws com.icegreen.greenmail.store.FolderException if an existing folder with the new name.
* @throws AlfrescoImapFolderException if user does not have rights to create the new mailbox.
*/
public void renameMailbox(GreenMailUser user, String oldMailboxName, String newMailboxName) throws FolderException, AuthorizationException
{
try
{
imapService.renameMailbox(new AlfrescoImapUser(user.getEmail(), user.getLogin(), user.getPassword()), oldMailboxName, newMailboxName);
}
catch (Throwable e)
{
logger.debug(e.getMessage(), e);
throw new FolderException(e.getMessage());
}
}
/**
* Returns a reference to a newly created mailbox. The request should specify a mailbox that does not
* already exist on this server, that could exist on this server and that the user has rights to create.
* This method serves CREATE command of the IMAP protocol.
*
* @param user User making the request.
* @param mailboxName String name of the target
* @return an Mailbox reference.
* @throws com.icegreen.greenmail.store.FolderException if mailbox already exists
* @throws AlfrescoImapFolderException if user does not have rights to create the new mailbox.
*/
public MailFolder createMailbox(GreenMailUser user, String mailboxName) throws AuthorizationException, FolderException
{
try
{
return imapService.createMailbox(new AlfrescoImapUser(user.getEmail(), user.getLogin(), user.getPassword()), mailboxName);
}
catch (Throwable e)
{
logger.debug(e.getMessage(), e);
throw new FolderException(e.getMessage());
}
}
/**
* Deletes an existing MailBox. Specified mailbox must already exist on this server, and the user
* must have rights to delete it. This method serves DELETE command of the IMAP protocol.
*
* @param user User making the request.
* @param mailboxName String name of the target
* @throws com.icegreen.greenmail.store.FolderException if mailbox has a non-selectable store with children
*/
public void deleteMailbox(GreenMailUser user, String mailboxName) throws FolderException, AuthorizationException
{
try
{
imapService.deleteMailbox(new AlfrescoImapUser(user.getEmail(), user.getLogin(), user.getPassword()), mailboxName);
}
catch (Throwable e)
{
logger.debug(e.getMessage(), e);
throw new FolderException(e.getMessage());
}
}
/**
* Returns a reference to an existing Mailbox. The requested mailbox must already exists on this server and the
* requesting user must have at least lookup rights. It is also can be used by to obtain hierarchy delimiter
* by the LIST command: C: 2 list "" "" S: * LIST () "." "" S: 2 OK LIST completed.
*
* Method searches mailbox under mount points defined for a specific user. Mount points include user's IMAP
* Virtualised Views and Email Archive Views.
*
* @param user User making the request.
* @param mailboxName String name of the target.
* @return an Mailbox reference.
*/
public MailFolder getFolder(GreenMailUser user, String mailboxName)
{
return imapService.getFolder(new AlfrescoImapUser(user.getEmail(), user.getLogin(), user.getPassword()), mailboxName);
}
/**
* Simply calls {@link #getFolder(GreenMailUser, String)}. Added to implement {@link ImapHostManager}.
*/
public MailFolder getFolder(final GreenMailUser user, final String mailboxName, boolean mustExist) throws FolderException
{
try
{
return getFolder(new AlfrescoImapUser(user.getEmail(), user.getLogin(), user.getPassword()), mailboxName);
}
catch (Throwable e)
{
logger.debug(e.getMessage(), e);
throw new FolderException(e.getMessage());
}
}
/**
* Returns a reference to the user's INBOX.
*
* @param user The user making the request.
* @return The user's Inbox.
*/
public MailFolder getInbox(GreenMailUser user) throws FolderException
{
try
{
return getFolder(new AlfrescoImapUser(user.getEmail(), user.getLogin(), user.getPassword()), AlfrescoImapConst.INBOX_NAME);
}
catch (Throwable e)
{
logger.debug(e.getMessage(), e);
throw new FolderException(e.getMessage());
}
}
/**
* Not supported. May be used by GreenMailUser.create() method. Added to implement {@link ImapHostManager}.
*/
public void createPrivateMailAccount(GreenMailUser user) throws FolderException
{
throw new UnsupportedOperationException();
}
/**
* Subscribes a user to a mailbox. The mailbox must exist locally and the user must have rights to modify it.
*
* This method serves SUBSCRIBE command of the IMAP protocol.
*
* @param user User making the request
* @param mailbox String representation of a mailbox name.
*/
public void subscribe(GreenMailUser user, String mailbox) throws FolderException
{
try
{
imapService.subscribe(new AlfrescoImapUser(user.getEmail(), user.getLogin(), user.getPassword()), mailbox);
}
catch (Throwable e)
{
logger.debug(e.getMessage(), e);
throw new FolderException(e.getMessage());
}
}
/**
* Unsubscribes from a given mailbox. This method serves UNSUBSCRIBE command of the IMAP protocol.
*
* @param user User making the request
* @param mailbox String representation of a mailbox name.
*/
public void unsubscribe(GreenMailUser user, String mailbox) throws FolderException
{
try
{
imapService.unsubscribe(new AlfrescoImapUser(user.getEmail(), user.getLogin(), user.getPassword()), mailbox);
}
catch (Throwable e)
{
logger.debug(e.getMessage(), e);
throw new FolderException(e.getMessage());
}
}
/**
* Not supported. Used by GreenMail class.
*/
public List> getAllMessages()
{
throw new UnsupportedOperationException();
}
// ----------------------Getters and Setters----------------------------
public ImapService getImapService()
{
return imapService;
}
public void setImapService(ImapService imapService)
{
this.imapService = imapService;
}
public TransactionService getTransactionService()
{
return transactionService;
}
public void setTransactionService(TransactionService transactionService)
{
this.transactionService = transactionService;
}
}