org.mule.transport.file

Class FileMessageReceiver

java.lang.Object

org.mule.transport.AbstractTransportMessageHandler

org.mule.transport.AbstractMessageReceiver

org.mule.transport.AbstractPollingMessageReceiver

org.mule.transport.file.FileMessageReceiver

All Implemented Interfaces:

org.mule.api.lifecycle.Disposable, org.mule.api.lifecycle.Initialisable, org.mule.api.lifecycle.Lifecycle, org.mule.api.lifecycle.LifecycleStateEnabled, org.mule.api.lifecycle.Startable, org.mule.api.lifecycle.Stoppable, org.mule.api.source.MessageSource, org.mule.api.transport.Connectable, org.mule.api.transport.MessageReceiver

public class FileMessageReceiver
extends org.mule.transport.AbstractPollingMessageReceiver

FileMessageReceiver is a polling listener that reads files from a directory.

Field Summary

Fields

Modifier and Type	Field and Description
static String	COMPARATOR_CLASS_NAME_PROPERTY
static String	COMPARATOR_REVERSE_ORDER_PROPERTY
static String	MULE_TRANSPORT_FILE_SINGLEPOLLINSTANCE

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

defaultInboundTransformers, defaultResponseTransformers, flowConstruct, listener, receiverKey, replyToHandler

Fields inherited from class org.mule.transport.AbstractTransportMessageHandler

connected, connector, defaultMessageInfoMapping, endpoint, lifecycleManager, logger, muleMessageFactory, retryTemplate

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

PHASE_NAME

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.Disposable

PHASE_NAME

Constructor Summary

Constructors

Constructor and Description
FileMessageReceiver(org.mule.api.transport.Connector connector, org.mule.api.construct.FlowConstruct flowConstruct, org.mule.api.endpoint.InboundEndpoint endpoint, String readDir, String moveDir, String moveToPattern, long frequency)

Method Summary

Methods

Modifier and Type	Method and Description
protected boolean	attemptFileLock(File sourceFile) Try to acquire a lock on a file and release it immediately.
protected void	basicListFiles(File currentDirectory, List<File> discoveredFiles)
protected void	checkMustForceSync() If we will be autodeleting File objects, events must be processed synchronously to avoid a race
protected org.mule.transport.file.ReceiverFileInputStream	createReceiverFileInputStream(File sourceFile, File destinationFile)
protected org.mule.transport.file.ReceiverFileInputStream	createReceiverFileInputStream(File sourceFile, File destinationFile, InputStreamCloseListener closeListener)
protected void	doConnect()
protected void	doDisconnect()
protected void	doDispose()
protected void	doInitialise()
protected Comparator<File>	getComparator()
protected boolean	isAgedFile(File file, long fileAge) Indicates whether or not file is older than the specified age
void	poll()
protected boolean	pollOnPrimaryInstanceOnly()
void	processFile(File file)
protected void	rollbackFileMove(File sourceFile, String destinationFilePath) Exception tolerant roll back method

Methods inherited from class org.mule.transport.AbstractPollingMessageReceiver

createWork, disableNativeScheduling, doStart, doStop, getBatchSize, getFrequency, getTimeUnit, performPoll, schedule, setFrequency, setTimeUnit, unschedule

Methods inherited from class org.mule.transport.AbstractMessageReceiver

applyInboundTransformers, applyResponseTransformers, connectHandler, createExecutionTemplate, createLifecycleManager, createMuleEvent, doStartHandler, getConnectEventId, getConnectionDescription, getEndpoint, getEndpointURI, getFlowConstruct, getReceiverKey, getReplyToHandler, getWorkManager, handleUnacceptedFilter, initialise, processMessage, propagateRootMessageIdProperty, routeEvent, routeMessage, routeMessage, routeMessage, routeMessage, routeMessage, setEndpoint, setListener, setReceiverKey, shouldConsumeInEveryNode, toString, warnIfMuleClientSendUsed

Methods inherited from class org.mule.transport.AbstractTransportMessageHandler

activate, connect, createMuleMessage, createMuleMessage, createMuleMessage, createMuleMessageFactory, createNullMuleMessage, disconnect, dispose, disposeAndLogException, getConnectEventId, getConnector, getLifecycleState, initializeMessageFactory, initializeRetryPolicy, isConnected, isDoThreading, isStarted, isStarting, isStopped, isStopping, 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.transport.MessageReceiver

createMuleMessage, createMuleMessage

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

connect, disconnect, isConnected, validateConnection

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.lifecycle.Disposable

dispose

Field Detail

COMPARATOR_CLASS_NAME_PROPERTY

public static final String COMPARATOR_CLASS_NAME_PROPERTY

See Also:

Constant Field Values

COMPARATOR_REVERSE_ORDER_PROPERTY

public static final String COMPARATOR_REVERSE_ORDER_PROPERTY

See Also:

Constant Field Values

MULE_TRANSPORT_FILE_SINGLEPOLLINSTANCE

public static final String MULE_TRANSPORT_FILE_SINGLEPOLLINSTANCE

See Also:

Constant Field Values

Constructor Detail

FileMessageReceiver

public FileMessageReceiver(org.mule.api.transport.Connector connector,
                   org.mule.api.construct.FlowConstruct flowConstruct,
                   org.mule.api.endpoint.InboundEndpoint endpoint,
                   String readDir,
                   String moveDir,
                   String moveToPattern,
                   long frequency)
                    throws org.mule.api.lifecycle.CreateException

Throws:

org.mule.api.lifecycle.CreateException

Method Detail

checkMustForceSync

protected void checkMustForceSync()
                           throws org.mule.api.lifecycle.CreateException

If we will be autodeleting File objects, events must be processed synchronously to avoid a race

Throws:

org.mule.api.lifecycle.CreateException

doInitialise

protected void doInitialise()
                     throws org.mule.api.lifecycle.InitialisationException

Overrides:

doInitialise in class org.mule.transport.AbstractTransportMessageHandler

Throws:

org.mule.api.lifecycle.InitialisationException

doConnect

protected void doConnect()
                  throws Exception

Overrides:

doConnect in class org.mule.transport.AbstractTransportMessageHandler

Throws:

Exception

doDisconnect

protected void doDisconnect()
                     throws Exception

Overrides:

doDisconnect in class org.mule.transport.AbstractTransportMessageHandler

Throws:

Exception

doDispose

protected void doDispose()

Overrides:

doDispose in class org.mule.transport.AbstractMessageReceiver

poll

public void poll()

Specified by:

poll in class org.mule.transport.AbstractPollingMessageReceiver

pollOnPrimaryInstanceOnly

protected boolean pollOnPrimaryInstanceOnly()

Overrides:

pollOnPrimaryInstanceOnly in class org.mule.transport.AbstractPollingMessageReceiver

processFile

public void processFile(File file)
                 throws org.mule.api.MuleException

Throws:

org.mule.api.MuleException

isAgedFile

protected boolean isAgedFile(File file,
                 long fileAge)

Indicates whether or not file is older than the specified age

Parameters:

file - file to check

fileAge - target file age in milliseconds

Returns:

true if the file is older than the fileAge, false otherwise

createReceiverFileInputStream

protected org.mule.transport.file.ReceiverFileInputStream createReceiverFileInputStream(File sourceFile,
                                                                            File destinationFile)
                                                                                 throws FileNotFoundException

Throws:

FileNotFoundException

createReceiverFileInputStream

protected org.mule.transport.file.ReceiverFileInputStream createReceiverFileInputStream(File sourceFile,
                                                                            File destinationFile,
                                                                            InputStreamCloseListener closeListener)
                                                                                 throws FileNotFoundException

Throws:

FileNotFoundException

attemptFileLock

protected boolean attemptFileLock(File sourceFile)
                           throws org.mule.api.MuleException

Try to acquire a lock on a file and release it immediately. Usually used as a quick check to see if another process is still holding onto the file, e.g. a large file (more than 100MB) is still being written to.

Parameters:

sourceFile - file to check

Returns:

true if the file can be locked

Throws:

org.mule.api.MuleException

basicListFiles

protected void basicListFiles(File currentDirectory,
                  List<File> discoveredFiles)

rollbackFileMove

protected void rollbackFileMove(File sourceFile,
                    String destinationFilePath)
                         throws IOException

Exception tolerant roll back method

Throws:

Throwable

IOException

getComparator

protected Comparator<File> getComparator()
                                  throws Exception

Throws:

Exception