org.mule.transport.email
Class RetrieveMessageReceiver

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

All Implemented Interfaces:

EventListener, MessageCountListener, org.mule.api.lifecycle.Disposable, org.mule.api.lifecycle.Initialisable, org.mule.api.lifecycle.Lifecycle, org.mule.api.lifecycle.Startable, org.mule.api.lifecycle.Stoppable, org.mule.api.transport.Connectable, org.mule.api.transport.MessageReceiver

public class RetrieveMessageReceiver
extends org.mule.transport.AbstractPollingMessageReceiver
implements MessageCountListener, org.mule.api.lifecycle.Startable, org.mule.api.lifecycle.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

connected, connecting, connectionStrategy, connector, disposing, endpoint, logger, receiverKey, responseEndpoint, service, stopped

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(org.mule.api.transport.Connector connector, org.mule.api.service.Service service, org.mule.api.endpoint.Endpoint 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 org.mule.api.MuleMessage	handleUnacceptedFilter(org.mule.api.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

connect, disconnect, dispose, doInitialise, getConnectEventId, getConnectionDescription, getConnector, getEndpoint, getEndpointURI, getListener, getReceiverKey, getService, getWorkManager, handleException, initialise, isConnected, routeMessage, routeMessage, routeMessage, routeMessage, routeMessage, routeMessage, setConnector, setEndpoint, setExceptionDetails, setListener, setReceiverKey, setService, setWorkManager, start, stop, toString

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

Constructor Detail

RetrieveMessageReceiver

public RetrieveMessageReceiver(org.mule.api.transport.Connector connector,
                               org.mule.api.service.Service service,
                               org.mule.api.endpoint.Endpoint endpoint,
                               long checkFrequency,
                               boolean backupEnabled,
                               String backupFolder)
                        throws org.mule.api.lifecycle.CreateException

Throws:

org.mule.api.lifecycle.CreateException

Method Detail

doConnect

protected void doConnect()
                  throws Exception

Specified by:

doConnect in class org.mule.transport.AbstractMessageReceiver

Throws:

Exception

doDisconnect

protected void doDisconnect()
                     throws Exception

Specified by:

doDisconnect in class org.mule.transport.AbstractMessageReceiver

Throws:

Exception

doStop

protected void doStop()

Overrides:

doStop in class org.mule.transport.AbstractPollingMessageReceiver

doStart

protected void doStart()
                throws org.mule.api.MuleException

Overrides:

doStart in class org.mule.transport.AbstractPollingMessageReceiver

Throws:

org.mule.api.MuleException

messagesAdded

public void messagesAdded(MessageCountEvent event)

Specified by:

messagesAdded in interface MessageCountListener

handleUnacceptedFilter

protected org.mule.api.MuleMessage handleUnacceptedFilter(org.mule.api.MuleMessage message)

Overrides:

handleUnacceptedFilter in class org.mule.transport.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 org.mule.transport.AbstractPollingMessageReceiver

doDispose

protected void doDispose()

Specified by:

doDispose in class org.mule.transport.AbstractMessageReceiver