org.apache.camel.component

Class ResourceEndpoint

java.lang.Object

org.apache.camel.support.service.ServiceSupport

org.apache.camel.support.DefaultEndpoint

org.apache.camel.support.ScheduledPollEndpoint

org.apache.camel.support.DefaultPollingEndpoint

org.apache.camel.support.ProcessorEndpoint

org.apache.camel.component.ResourceEndpoint

All Implemented Interfaces:

org.apache.camel.api.management.mbean.ManagedResourceEndpointMBean, org.apache.camel.CamelContextAware, org.apache.camel.Endpoint, org.apache.camel.IsSingleton, org.apache.camel.Service, org.apache.camel.ShutdownableService, org.apache.camel.spi.HasId, org.apache.camel.StatefulService, org.apache.camel.SuspendableService

@ManagedResource(description="Managed ResourceEndpoint")
public abstract class ResourceEndpoint
extends ProcessorEndpoint
implements org.apache.camel.api.management.mbean.ManagedResourceEndpointMBean

A useful base class for endpoints which depend on a resource such as things like Velocity or XQuery based components.

Field Summary

Fields

Modifier and Type	Field and Description
protected org.slf4j.Logger	log

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

FAILED, INITIALIZED, lock, NEW, SHUTDOWN, SHUTTINGDOWN, STARTED, STARTING, status, STOPPED, STOPPING, SUSPENDED, SUSPENDING

Constructor Summary

Constructors

Constructor and Description
ResourceEndpoint()
ResourceEndpoint(String endpointUri, org.apache.camel.Component component, String resourceUri)

Method Summary

Modifier and Type	Method and Description
void	clearContentCache()
String	getCamelId()
String	getCamelManagementName()
InputStream	getResourceAsInputStream() Gets the resource as an input stream considering the cache flag as well.
protected InputStream	getResourceAsInputStreamWithoutCache()
String	getResourceUri()
String	getState()
boolean	isContentCache()
boolean	isContentCacheCleared()
protected InputStream	loadResource(String uri) Loads the given resource.
void	setContentCache(boolean contentCache) Sets whether to use resource content cache or not.
void	setResourceUri(String resourceUri) Path to the resource.

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

createPollingConsumer, createProcessor, createProducer, getProcessor, isSingleton, onExchange, setProcessor

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

createConsumer

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

configurePollingConsumer, configureProperties, configureScheduledPollConsumerProperties, doStart, doStop, getBackoffErrorThreshold, getBackoffIdleThreshold, getBackoffMultiplier, getDelay, getInitialDelay, getPollStrategy, getRunLoggingLevel, getScheduledExecutorService, getScheduler, getSchedulerProperties, getTimeUnit, initConsumerProperties, isGreedy, isSendEmptyMessageWhenIdle, isStartScheduler, isUseFixedDelay, setBackoffErrorThreshold, setBackoffIdleThreshold, setBackoffMultiplier, setDelay, setGreedy, setInitialDelay, setPollStrategy, setRunLoggingLevel, setScheduledExecutorService, setScheduler, setScheduler, setSchedulerProperties, setSendEmptyMessageWhenIdle, setStartScheduler, setTimeUnit, setUseFixedDelay

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

configureConsumer, createAsyncProducer, createEndpointUri, createExchange, createExchange, equals, getCamelContext, getComponent, getConsumerProperties, getEndpointKey, getEndpointUri, getExceptionHandler, getExchangePattern, getId, getPollingConsumerBlockTimeout, getPollingConsumerQueueSize, hashCode, isBridgeErrorHandler, isLenientProperties, isPollingConsumerBlockWhenFull, isSynchronous, setBridgeErrorHandler, setCamelContext, setConsumerProperties, setEndpointUri, setEndpointUriIfNotSpecified, setExceptionHandler, setExchangePattern, setPollingConsumerBlockTimeout, setPollingConsumerBlockWhenFull, setPollingConsumerQueueSize, setProperties, setSynchronous, toString

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

doInit, doResume, doShutdown, doSuspend, getStatus, init, isInit, isNew, isRunAllowed, isShutdown, isStarted, isStarting, isStartingOrStarted, isStopped, isStopping, isStoppingOrStopped, isSuspended, isSuspending, isSuspendingOrSuspended, resume, shutdown, start, stop, suspend

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.camel.Service

init, start, stop

Methods inherited from interface org.apache.camel.CamelContextAware

trySetCamelContext

Field Detail

log

protected final org.slf4j.Logger log

Constructor Detail

ResourceEndpoint

public ResourceEndpoint()

ResourceEndpoint

public ResourceEndpoint(String endpointUri,
                        org.apache.camel.Component component,
                        String resourceUri)

Method Detail

getResourceAsInputStream

public InputStream getResourceAsInputStream()
                                     throws IOException

Gets the resource as an input stream considering the cache flag as well.

If cache is enabled then the resource content is cached in an internal buffer and this content is returned to avoid loading the resource over and over again.

Returns:

the input stream

Throws:

IOException - is thrown if error loading the content of the resource to the local cache buffer

getResourceAsInputStreamWithoutCache

protected InputStream getResourceAsInputStreamWithoutCache()
                                                    throws IOException

Throws:

IOException

loadResource

protected InputStream loadResource(String uri)
                            throws IOException

Loads the given resource.

Parameters:

uri - uri of the resource.

Returns:

the loaded resource

Throws:

IOException - is thrown if resource is not found or cannot be loaded

isContentCache

@ManagedAttribute(description="Whether the resource is cached")
public boolean isContentCache()

Specified by:

isContentCache in interface org.apache.camel.api.management.mbean.ManagedResourceEndpointMBean

clearContentCache

@ManagedOperation(description="Clears the cached resource, forcing to re-load the resource on next request")
public void clearContentCache()

Specified by:

clearContentCache in interface org.apache.camel.api.management.mbean.ManagedResourceEndpointMBean

isContentCacheCleared

public boolean isContentCacheCleared()

getCamelId

@ManagedAttribute(description="Camel context ID")
public String getCamelId()

Specified by:

getCamelId in interface org.apache.camel.api.management.mbean.ManagedResourceEndpointMBean

getCamelManagementName

@ManagedAttribute(description="Camel ManagementName")
public String getCamelManagementName()

Specified by:

getCamelManagementName in interface org.apache.camel.api.management.mbean.ManagedResourceEndpointMBean

getState

@ManagedAttribute(description="Endpoint service state")
public String getState()

Specified by:

getState in interface org.apache.camel.api.management.mbean.ManagedResourceEndpointMBean

setContentCache

public void setContentCache(boolean contentCache)

Sets whether to use resource content cache or not.

Specified by:

setContentCache in interface org.apache.camel.api.management.mbean.ManagedResourceEndpointMBean

getResourceUri

public String getResourceUri()

setResourceUri

public void setResourceUri(String resourceUri)

Path to the resource.

You can prefix with: classpath, file, http, ref, or bean. classpath, file and http loads the resource using these protocols (classpath is default). ref will lookup the resource in the registry. bean will call a method on a bean to be used as the resource. For bean you can specify the method name after dot, eg bean:myBean.myMethod

Parameters:

resourceUri - the resource path