org.apache.camel.component.file.strategy

Class GenericFileProcessStrategySupport<T>

java.lang.Object

org.apache.camel.support.ServiceSupport

org.apache.camel.component.file.strategy.GenericFileProcessStrategySupport<T>

All Implemented Interfaces:

CamelContextAware, GenericFileProcessStrategy<T>, Service, ShutdownableService, StatefulService, SuspendableService

Direct Known Subclasses:

GenericFileDeleteProcessStrategy, GenericFileNoOpProcessStrategy, GenericFileRenameProcessStrategy

public abstract class GenericFileProcessStrategySupport<T>
extends ServiceSupport
implements GenericFileProcessStrategy<T>, CamelContextAware

Base class for implementations of GenericFileProcessStrategy.

Field Summary

Fields

Modifier and Type	Field and Description
protected CamelContext	camelContext
protected GenericFileExclusiveReadLockStrategy<T>	exclusiveReadLockStrategy
protected org.slf4j.Logger	log

Fields inherited from class org.apache.camel.support.ServiceSupport

shutdown, shuttingdown, started, starting, stopped, stopping, suspended, suspending

Constructor Summary

Constructors

Constructor and Description
GenericFileProcessStrategySupport()

Method Summary

Modifier and Type	Method and Description
void	abort(GenericFileOperations<T> operations, GenericFileEndpoint<T> endpoint, Exchange exchange, GenericFile<T> file) Called when a begin is aborted, for example to release any resources which may have been acquired during the GenericFileProcessStrategy.begin(GenericFileOperations, GenericFileEndpoint, org.apache.camel.Exchange, GenericFile) operation.
boolean	begin(GenericFileOperations<T> operations, GenericFileEndpoint<T> endpoint, Exchange exchange, GenericFile<T> file) Called when work is about to begin on this file.
void	commit(GenericFileOperations<T> operations, GenericFileEndpoint<T> endpoint, Exchange exchange, GenericFile<T> file) Releases any file locks and possibly deletes or moves the file after successful processing
protected void	deleteLocalWorkFile(Exchange exchange)
protected void	doShutdown() Implementations override this method to perform customized shutdown.
protected void	doStart() Implementations override this method to support customized start/stop.
protected void	doStop() Implementations override this method to support customized start/stop.
CamelContext	getCamelContext() Get the CamelContext
GenericFileExclusiveReadLockStrategy<T>	getExclusiveReadLockStrategy()
void	prepareOnStartup(GenericFileOperations<T> operations, GenericFileEndpoint<T> endpoint) Allows custom logic to be run on first poll preparing the strategy, such as removing old lock files etc.
protected GenericFile<T>	renameFile(GenericFileOperations<T> operations, GenericFile<T> from, GenericFile<T> to)
void	rollback(GenericFileOperations<T> operations, GenericFileEndpoint<T> endpoint, Exchange exchange, GenericFile<T> file) Releases any file locks and possibly deletes or moves the file after unsuccessful processing
void	setCamelContext(CamelContext camelContext) Injects the CamelContext
void	setExclusiveReadLockStrategy(GenericFileExclusiveReadLockStrategy<T> exclusiveReadLockStrategy)

Methods inherited from class org.apache.camel.support.ServiceSupport

doResume, doSuspend, getStatus, getVersion, isRunAllowed, isStarted, isStarting, isStopped, isStopping, isStoppingOrStopped, isSuspended, isSuspending, isSuspendingOrSuspended, resume, shutdown, start, stop, suspend

Methods inherited from class java.lang.Object

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

Field Detail

log

protected final org.slf4j.Logger log

exclusiveReadLockStrategy

protected GenericFileExclusiveReadLockStrategy<T> exclusiveReadLockStrategy

camelContext

protected CamelContext camelContext

Constructor Detail

GenericFileProcessStrategySupport

public GenericFileProcessStrategySupport()

Method Detail

getCamelContext

public CamelContext getCamelContext()

Description copied from interface: CamelContextAware

Get the CamelContext

Specified by:

getCamelContext in interface CamelContextAware

Returns:

camelContext the Camel context

setCamelContext

public void setCamelContext(CamelContext camelContext)

Description copied from interface: CamelContextAware

Injects the CamelContext

Specified by:

setCamelContext in interface CamelContextAware

Parameters:

camelContext - the Camel context

prepareOnStartup

public void prepareOnStartup(GenericFileOperations<T> operations,
                             GenericFileEndpoint<T> endpoint)
                      throws Exception

Description copied from interface: GenericFileProcessStrategy

Allows custom logic to be run on first poll preparing the strategy, such as removing old lock files etc.

Specified by:

prepareOnStartup in interface GenericFileProcessStrategy<T>

Parameters:

operations - file operations

endpoint - the endpoint

Throws:

Exception - can be thrown in case of errors which causes poll to fail

begin

public boolean begin(GenericFileOperations<T> operations,
                     GenericFileEndpoint<T> endpoint,
                     Exchange exchange,
                     GenericFile<T> file)
              throws Exception

Description copied from interface: GenericFileProcessStrategy

Called when work is about to begin on this file. This method may attempt to acquire some file lock before returning true; returning false if the file lock could not be obtained so that the file should be ignored.

Specified by:

begin in interface GenericFileProcessStrategy<T>

Parameters:

operations - file operations

endpoint - the endpoint

exchange - the exchange

file - the file

Returns:

true if the file can be processed (such as if a file lock could be obtained)

Throws:

Exception - can be thrown in case of errors

abort

public void abort(GenericFileOperations<T> operations,
                  GenericFileEndpoint<T> endpoint,
                  Exchange exchange,
                  GenericFile<T> file)
           throws Exception

Description copied from interface: GenericFileProcessStrategy

Called when a begin is aborted, for example to release any resources which may have been acquired during the GenericFileProcessStrategy.begin(GenericFileOperations, GenericFileEndpoint, org.apache.camel.Exchange, GenericFile) operation.

Specified by:

abort in interface GenericFileProcessStrategy<T>

Parameters:

operations - file operations

endpoint - the endpoint

exchange - the exchange

file - the file

Throws:

Exception - can be thrown in case of errors

commit

public void commit(GenericFileOperations<T> operations,
                   GenericFileEndpoint<T> endpoint,
                   Exchange exchange,
                   GenericFile<T> file)
            throws Exception

Description copied from interface: GenericFileProcessStrategy

Releases any file locks and possibly deletes or moves the file after successful processing

Specified by:

commit in interface GenericFileProcessStrategy<T>

Parameters:

operations - file operations

endpoint - the endpoint

exchange - the exchange

file - the file

Throws:

Exception - can be thrown in case of errors

rollback

public void rollback(GenericFileOperations<T> operations,
                     GenericFileEndpoint<T> endpoint,
                     Exchange exchange,
                     GenericFile<T> file)
              throws Exception

Description copied from interface: GenericFileProcessStrategy

Releases any file locks and possibly deletes or moves the file after unsuccessful processing

Specified by:

rollback in interface GenericFileProcessStrategy<T>

Parameters:

operations - file operations

endpoint - the endpoint

exchange - the exchange

file - the file

Throws:

Exception - can be thrown in case of errors

getExclusiveReadLockStrategy

public GenericFileExclusiveReadLockStrategy<T> getExclusiveReadLockStrategy()

setExclusiveReadLockStrategy

public void setExclusiveReadLockStrategy(GenericFileExclusiveReadLockStrategy<T> exclusiveReadLockStrategy)

renameFile

protected GenericFile<T> renameFile(GenericFileOperations<T> operations,
                                    GenericFile<T> from,
                                    GenericFile<T> to)
                             throws IOException

Throws:

IOException

deleteLocalWorkFile

protected void deleteLocalWorkFile(Exchange exchange)

doStart

protected void doStart()
                throws Exception

Description copied from class: ServiceSupport

Implementations override this method to support customized start/stop.

Important: See ServiceSupport.doStop() for more details.

Specified by:

doStart in class ServiceSupport

Throws:

Exception

See Also:

ServiceSupport.doStop()

doStop

protected void doStop()
               throws Exception

Description copied from class: ServiceSupport

Implementations override this method to support customized start/stop.

Important: Camel will invoke this ServiceSupport.doStop() method when the service is being stopped. This method will also be invoked if the service is still in uninitialized state (eg has not been started). The method is always called to allow the service to do custom logic when the service is being stopped, such as when CamelContext is shutting down.

Specified by:

doStop in class ServiceSupport

Throws:

Exception

See Also:

ServiceSupport.doStart()

doShutdown

protected void doShutdown()
                   throws Exception

Description copied from class: ServiceSupport

Implementations override this method to perform customized shutdown.

Overrides:

doShutdown in class ServiceSupport

Throws:

Exception