org.mule.transport.email
Class RetrieveMessageReceiver

java.lang.Object
  org.mule.transport.AbstractConnectable
      org.mule.transport.AbstractMessageReceiver
          org.mule.transport.AbstractPollingMessageReceiver
              org.mule.transport.email.RetrieveMessageReceiver

All Implemented Interfaces:

ExceptionListener, EventListener, MessageCountListener, Disposable, Initialisable, Startable, Stoppable, Connectable, MessageReceiver

public class RetrieveMessageReceiver
extends AbstractPollingMessageReceiver
implements MessageCountListener, Startable, Stoppable

Poll a mailbox for messages, remove the messages and route them as events into Mule.

This contains a reference to a mail folder (and also the endpoint and connector, via superclasses)

Field Summary

Fields inherited from class org.mule.transport.AbstractPollingMessageReceiver

DEFAULT_POLL_FREQUENCY, DEFAULT_POLL_TIMEUNIT, DEFAULT_STARTUP_DELAY, schedules

Fields inherited from class org.mule.transport.AbstractMessageReceiver

receiverKey, responseEndpoint, service

Fields inherited from class org.mule.transport.AbstractConnectable

connected, connector, disposed, endpoint, logger, retryTemplate, started, startOnConnect

Fields inherited from interface org.mule.api.lifecycle.Startable

PHASE_NAME

Fields inherited from interface org.mule.api.lifecycle.Stoppable

PHASE_NAME

Fields inherited from interface org.mule.api.lifecycle.Initialisable

PHASE_NAME

Fields inherited from interface org.mule.api.lifecycle.Disposable

PHASE_NAME

Constructor Summary

RetrieveMessageReceiver(Connector connector, Service service, InboundEndpoint endpoint, long checkFrequency, boolean backupEnabled, String backupFolder)

Method Summary

protected void	doConnect()
protected void	doDisconnect()
protected void	doDispose()
protected void	doStart()
protected void	doStop()
Folder	getFolder()
protected MuleMessage	handleUnacceptedFilter(MuleMessage message)
void	messagesAdded(MessageCountEvent event)
void	messagesRemoved(MessageCountEvent event)
void	poll()
void	setFolder(Folder folder)
protected void	storeMessage(Message msg) Helper method for testing which stores a copy of the message locally as the POP3 message will be deleted from the server

Methods inherited from class org.mule.transport.AbstractPollingMessageReceiver

createWork, getFrequency, getTimeUnit, schedule, setFrequency, setTimeUnit, unschedule

Methods inherited from class org.mule.transport.AbstractMessageReceiver

dispose, getConnectEventId, getConnectionDescription, getEndpoint, getEndpointURI, getListener, getReceiverKey, getService, getWorkManager, initialise, routeMessage, routeMessage, routeMessage, routeMessage, routeMessage, routeMessage, setEndpoint, setExceptionDetails, setListener, setReceiverKey, setService, toString

Methods inherited from class org.mule.transport.AbstractConnectable

activate, connect, disconnect, disposeAndLogException, doInitialise, exceptionThrown, getConnectEventId, getConnector, handleException, isConnected, isDoThreading, isStarted, passivate, setEndpoint, start, stop, validate, validateConnection

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.mule.api.lifecycle.Startable

start

Methods inherited from interface org.mule.api.lifecycle.Stoppable

stop

Methods inherited from interface org.mule.api.transport.Connectable

connect, disconnect, isConnected, validateConnection

Constructor Detail

RetrieveMessageReceiver

public RetrieveMessageReceiver(Connector connector,
                               Service service,
                               InboundEndpoint endpoint,
                               long checkFrequency,
                               boolean backupEnabled,
                               String backupFolder)
                        throws CreateException

Throws:

CreateException

Method Detail

doConnect

protected void doConnect()
                  throws Exception

Overrides:

doConnect in class AbstractConnectable

Throws:

Exception

doDisconnect

protected void doDisconnect()
                     throws Exception

Overrides:

doDisconnect in class AbstractConnectable

Throws:

Exception

doStop

protected void doStop()

Overrides:

doStop in class AbstractPollingMessageReceiver

doStart

protected void doStart()
                throws MuleException

Overrides:

doStart in class AbstractPollingMessageReceiver

Throws:

MuleException

messagesAdded

public void messagesAdded(MessageCountEvent event)

Specified by:

messagesAdded in interface MessageCountListener

handleUnacceptedFilter

protected MuleMessage handleUnacceptedFilter(MuleMessage message)

Overrides:

handleUnacceptedFilter in class AbstractMessageReceiver

messagesRemoved

public void messagesRemoved(MessageCountEvent event)

Specified by:

messagesRemoved in interface MessageCountListener

getFolder

public Folder getFolder()

Returns:

the current Mail folder

setFolder

public void setFolder(Folder folder)

Parameters:

folder -

storeMessage

protected void storeMessage(Message msg)
                     throws IOException,
                            MessagingException

Helper method for testing which stores a copy of the message locally as the POP3

message will be deleted from the server

Parameters:

msg - the message to store

Throws:

IOException - If a failure happens writing the message

MessagingException - If a failure happens reading the message

poll

public void poll()

Specified by:

poll in class AbstractPollingMessageReceiver

doDispose

protected void doDispose()

Overrides:

doDispose in class AbstractConnectable