Coverage Report - org.mule.transport.email.RetrieveMessageReceiver
 
Classes in this File Line Coverage Branch Coverage Complexity
RetrieveMessageReceiver
58%
70/120
37%
19/52
3.429
 
 1  
 /*
 2  
  * $Id: RetrieveMessageReceiver.java 11343 2008-03-13 10:58:26Z tcarlson $
 3  
  * --------------------------------------------------------------------------------------
 4  
  * Copyright (c) MuleSource, Inc.  All rights reserved.  http://www.mulesource.com
 5  
  *
 6  
  * The software in this package is published under the terms of the CPAL v1.0
 7  
  * license, a copy of which has been included with this distribution in the
 8  
  * LICENSE.txt file.
 9  
  */
 10  
 
 11  
 package org.mule.transport.email;
 12  
 
 13  
 import org.mule.DefaultMuleMessage;
 14  
 import org.mule.MuleServer;
 15  
 import org.mule.api.MuleException;
 16  
 import org.mule.api.MuleMessage;
 17  
 import org.mule.api.endpoint.InboundEndpoint;
 18  
 import org.mule.api.lifecycle.CreateException;
 19  
 import org.mule.api.lifecycle.Startable;
 20  
 import org.mule.api.lifecycle.Stoppable;
 21  
 import org.mule.api.routing.RoutingException;
 22  
 import org.mule.api.service.Service;
 23  
 import org.mule.api.transport.Connector;
 24  
 import org.mule.api.transport.ReceiveException;
 25  
 import org.mule.transport.AbstractPollingMessageReceiver;
 26  
 import org.mule.transport.email.i18n.EmailMessages;
 27  
 import org.mule.util.FileUtils;
 28  
 import org.mule.util.StringUtils;
 29  
 import org.mule.util.UUID;
 30  
 
 31  
 import java.io.File;
 32  
 import java.io.FileOutputStream;
 33  
 import java.io.IOException;
 34  
 
 35  
 import javax.mail.Address;
 36  
 import javax.mail.Flags;
 37  
 import javax.mail.Folder;
 38  
 import javax.mail.Message;
 39  
 import javax.mail.MessagingException;
 40  
 import javax.mail.Store;
 41  
 import javax.mail.event.MessageCountEvent;
 42  
 import javax.mail.event.MessageCountListener;
 43  
 import javax.mail.internet.InternetAddress;
 44  
 import javax.mail.internet.MimeMessage;
 45  
 
 46  
 /**
 47  
  * Poll a mailbox for messages, remove the messages and route them as events into Mule.
 48  
  * <p/>
 49  
  * This contains a reference to a mail folder (and also the endpoint and connector, via superclasses)
 50  
  */
 51  
 
 52  
 public class RetrieveMessageReceiver extends AbstractPollingMessageReceiver
 53  
         implements MessageCountListener, Startable, Stoppable
 54  
 {
 55  42
     private Folder folder = null;
 56  
     private boolean backupEnabled;
 57  42
     private String backupFolder = null;
 58  
 
 59  
     public RetrieveMessageReceiver(Connector connector,
 60  
                                         Service service,
 61  
                                         InboundEndpoint endpoint,
 62  
                                         long checkFrequency,
 63  
                                         boolean backupEnabled,
 64  
                                         String backupFolder)
 65  
                  throws CreateException
 66  
     {
 67  42
         super(connector, service, endpoint);
 68  42
              this.backupFolder = backupFolder;
 69  42
              this.backupEnabled = backupEnabled;
 70  42
              this.setFrequency(checkFrequency);
 71  42
          }
 72  
 
 73  
     private AbstractRetrieveMailConnector castConnector()
 74  
     {
 75  120
         return (AbstractRetrieveMailConnector) getConnector();
 76  
     }
 77  
 
 78  
     protected void doConnect() throws Exception
 79  
     {
 80  30
         SessionDetails session = castConnector().getSessionDetails(endpoint);
 81  
 
 82  30
         Store store = session.newStore();
 83  30
         store.connect();
 84  30
         folder = store.getFolder(castConnector().getMailboxFolder());
 85  
 
 86  
         // set default value if empty/null
 87  30
         if (StringUtils.isEmpty(backupFolder))
 88  
         {
 89  30
             this.backupFolder =
 90  
                     MuleServer.getMuleContext().getConfiguration().getWorkingDirectory() + "/mail/" + folder.getName();
 91  
         }
 92  
 
 93  30
         if (backupFolder != null && !this.backupFolder.endsWith(File.separator))
 94  
         {
 95  30
             this.backupFolder += File.separator;
 96  
         }
 97  30
     }
 98  
 
 99  
     protected void doDisconnect() throws Exception
 100  
     {
 101  
         // nothing to do here
 102  30
     }
 103  
 
 104  
     protected void doStop()
 105  
     {
 106  30
         if (folder != null)
 107  
         {
 108  30
             folder.removeMessageCountListener(this);
 109  
         }
 110  30
     }
 111  
 
 112  
     protected void doStart() throws MuleException
 113  
     {
 114  30
         super.doStart();
 115  30
         folder.addMessageCountListener(this);
 116  30
     }
 117  
 
 118  
     public void messagesAdded(MessageCountEvent event)
 119  
     {
 120  30
         Message messages[] = event.getMessages();
 121  30
         if (messages != null)
 122  
         {
 123  30
             MuleMessage message = null;
 124  60
             for (int i = 0; i < messages.length; i++)
 125  
             {
 126  
                 try
 127  
                 {
 128  30
                     if (!messages[i].getFlags().contains(Flags.Flag.DELETED))
 129  
                     {
 130  30
                         MimeMessage mimeMessage = new MimeMessage((MimeMessage) messages[i]);
 131  30
                         storeMessage(mimeMessage);
 132  30
                         message = new DefaultMuleMessage(castConnector().getMessageAdapter(mimeMessage));
 133  
 
 134  30
                         if (castConnector().isDeleteReadMessages())
 135  
                         {
 136  
                             // Mark as deleted
 137  30
                             messages[i].setFlag(Flags.Flag.DELETED, true);
 138  
                         }
 139  
                         else
 140  
                         {
 141  0
                             messages[i].setFlag(Flags.Flag.SEEN, true);
 142  
                         }
 143  30
                         routeMessage(message, endpoint.isSynchronous());
 144  
                     }
 145  
                 }
 146  0
                 catch (MuleException e)
 147  
                 {
 148  0
                     handleException(e);
 149  
                 }
 150  0
                 catch (Exception e)
 151  
                 {
 152  
                     Exception forwarded;
 153  
 
 154  0
                     if (message != null)
 155  
                     {
 156  0
                         forwarded = new RoutingException(EmailMessages.routingError(), message, endpoint, e);
 157  
                     }
 158  
                     else
 159  
                     {
 160  0
                         forwarded = new ReceiveException(endpoint, -1, e);
 161  
                     }
 162  
 
 163  0
                     handleException(forwarded);
 164  30
                 }
 165  
             }
 166  
         }
 167  30
     }
 168  
 
 169  
     // @Override
 170  
     protected MuleMessage handleUnacceptedFilter(MuleMessage message)
 171  
     {
 172  0
         super.handleUnacceptedFilter(message);
 173  0
         if (message.getPayload() instanceof Message)
 174  
         {
 175  0
             Message msg = (Message) message.getPayload();
 176  
             try
 177  
             {
 178  0
                 msg.setFlag(Flags.Flag.DELETED, endpoint.isDeleteUnacceptedMessages());
 179  
             }
 180  0
             catch (MessagingException e)
 181  
             {
 182  0
                 logger.error("failed to set message deleted: " + e.getMessage(), e);
 183  0
             }
 184  
         }
 185  0
         return message;
 186  
     }
 187  
 
 188  
     public void messagesRemoved(MessageCountEvent event)
 189  
     {
 190  0
         if (logger.isDebugEnabled())
 191  
         {
 192  0
             Message messages[] = event.getMessages();
 193  0
             for (int i = 0; i < messages.length; i++)
 194  
             {
 195  
                 try
 196  
                 {
 197  0
                     logger.debug("Message removed: " + messages[i].getSubject());
 198  
                 }
 199  0
                 catch (MessagingException ignore)
 200  
                 {
 201  0
                     logger.debug("ignoring exception: " + ignore.getMessage());
 202  0
                 }
 203  
             }
 204  
         }
 205  0
     }
 206  
 
 207  
     /** @return the current Mail folder */
 208  
     public Folder getFolder()
 209  
     {
 210  0
         return folder;
 211  
     }
 212  
 
 213  
     /** @param folder  */
 214  
     public synchronized void setFolder(Folder folder)
 215  
     {
 216  0
         if (folder == null)
 217  
         {
 218  0
             throw new IllegalArgumentException("Mail folder cannot be null");
 219  
         }
 220  0
         this.folder = folder;
 221  0
         synchronized (this.folder)
 222  
         {
 223  0
             if (!this.folder.isOpen())
 224  
             {
 225  
                 try
 226  
                 {
 227  0
                     this.folder.open(Folder.READ_WRITE);
 228  
                 }
 229  0
                 catch (MessagingException e)
 230  
                 {
 231  0
                     logger.warn("Failed to open folder: " + folder.getFullName(), e);
 232  0
                 }
 233  
             }
 234  0
         }
 235  0
     }
 236  
 
 237  
     /**
 238  
      * Helper method for testing which stores a copy of the message locally as the
 239  
      * POP3 <p/> message will be deleted from the server
 240  
      *
 241  
      * @param msg the message to store
 242  
      * @throws IOException        If a failure happens writing the message
 243  
      * @throws MessagingException If a failure happens reading the message
 244  
      */
 245  
     protected void storeMessage(Message msg) throws IOException, MessagingException
 246  
     {
 247  30
         if (backupEnabled)
 248  
         {
 249  2
             String filename = msg.getFileName();
 250  2
             if (filename == null)
 251  
             {
 252  2
                 Address[] from = msg.getFrom();
 253  2
                 if (from != null && from.length > 0)
 254  
                 {
 255  0
                     filename = from[0] instanceof InternetAddress
 256  
                             ? ((InternetAddress) from[0]).getAddress()
 257  
                             : from[0].toString();
 258  
                 }
 259  
                 else
 260  
                 {
 261  2
                     filename = "(no from address)";
 262  
                 }
 263  2
                 filename += "[" + UUID.getUUID() + "]";
 264  
             }
 265  2
             filename = FileUtils.prepareWinFilename(filename);
 266  2
             filename = backupFolder + filename + ".msg";
 267  2
             if (logger.isDebugEnabled())
 268  
             {
 269  0
                 logger.debug("Writing message to: " + filename);
 270  
             }
 271  2
             File f = FileUtils.createFile(filename);
 272  2
             FileOutputStream fos = new FileOutputStream(f);
 273  2
             msg.writeTo(fos);
 274  
         }
 275  30
     }
 276  
 
 277  
     public synchronized void poll()
 278  
     {
 279  
         try
 280  
         {
 281  
             try
 282  
             {
 283  30
                 if (!folder.isOpen())
 284  
                 {
 285  30
                     folder.open(Folder.READ_WRITE);
 286  
                 }
 287  
             }
 288  0
             catch (Exception e)
 289  
             {
 290  0
                 if (logger.isDebugEnabled())
 291  
                 {
 292  0
                     logger.debug("ignoring exception: " + e.getMessage());
 293  
                 }
 294  30
             }
 295  
 
 296  30
             int count = folder.getMessageCount();
 297  30
             if (count > 0)
 298  
             {
 299  30
                 Message[] messages = folder.getMessages();
 300  30
                 MessageCountEvent event = new MessageCountEvent(folder, MessageCountEvent.ADDED, true,
 301  
                         messages);
 302  30
                 messagesAdded(event);
 303  30
             }
 304  0
             else if (count == -1)
 305  
             {
 306  0
                 throw new MessagingException("Cannot monitor folder: " + folder.getFullName()
 307  
                         + " as folder is closed");
 308  
             }
 309  
         }
 310  0
         catch (MessagingException e)
 311  
         {
 312  0
             handleException(e);
 313  
         }
 314  
         finally
 315  
         {
 316  0
             try
 317  
             {
 318  30
                 folder.close(true); // close and expunge deleted messages
 319  
             }
 320  2
             catch (Exception e)
 321  
             {
 322  2
                 logger.error("Failed to close pop3  inbox: " + e.getMessage());
 323  28
             }
 324  2
         }
 325  30
     }
 326  
 
 327  
     protected void doDispose()
 328  
     {
 329  72
         if (null != folder)
 330  
         {
 331  48
             folder.removeMessageCountListener(this);
 332  48
             if (folder.isOpen())
 333  
             {
 334  
                 try
 335  
                 {
 336  
 
 337  0
                     folder.close(true);
 338  
                 }
 339  0
                 catch (Exception e)
 340  
                 {
 341  0
                     logger.debug("ignoring exception: " + e.getMessage(), e);
 342  0
                 }
 343  
             }
 344  
         }
 345  72
     }
 346  
 
 347  
 }