/* * 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; } }