org.apache.camel.impl
Class DefaultConsumerTemplate

java.lang.Object
  org.apache.camel.impl.ServiceSupport
      org.apache.camel.impl.DefaultConsumerTemplate

All Implemented Interfaces:

ConsumerTemplate, Service, ShutdownableService

public class DefaultConsumerTemplate
extends ServiceSupport
implements ConsumerTemplate

Template (named like Spring's TransactionTemplate & JmsTemplate et al) for working with Camel and consuming Message instances in an Exchange from an Endpoint.

Version:

$Revision: 941182 $

Constructor Summary

DefaultConsumerTemplate(CamelContext context)

Method Summary

protected void	doStart()
protected void	doStop()
protected Object	extractResultBody(Exchange result) Extracts the body from the given result.
CamelContext	getCamelContext()
int	getCurrentCacheSize() Gets an approximated size of the current cached resources in the backing cache pools.
int	getMaximumCacheSize() Gets the maximum cache size used.
Exchange	receive(Endpoint endpoint) Receives from the endpoint, waiting until there is a response
Exchange	receive(Endpoint endpoint, long timeout) Receives from the endpoint, waiting until there is a response or the timeout occurs
Exchange	receive(String endpointUri) Receives from the endpoint, waiting until there is a response
Exchange	receive(String endpointUri, long timeout) Receives from the endpoint, waiting until there is a response or the timeout occurs
Object	receiveBody(Endpoint endpoint) Receives from the endpoint, waiting until there is a response
<T> T	receiveBody(Endpoint endpoint, Class<T> type) Receives from the endpoint, waiting until there is a response
Object	receiveBody(Endpoint endpoint, long timeout) Receives from the endpoint, waiting until there is a response or the timeout occurs
<T> T	receiveBody(Endpoint endpoint, long timeout, Class<T> type) Receives from the endpoint, waiting until there is a response or the timeout occurs
Object	receiveBody(String endpointUri) Receives from the endpoint, waiting until there is a response
<T> T	receiveBody(String endpointUri, Class<T> type) Receives from the endpoint, waiting until there is a response
Object	receiveBody(String endpointUri, long timeout) Receives from the endpoint, waiting until there is a response or the timeout occurs
<T> T	receiveBody(String endpointUri, long timeout, Class<T> type) Receives from the endpoint, waiting until there is a response or the timeout occurs
Object	receiveBodyNoWait(Endpoint endpoint) Receives from the endpoint, not waiting for a response if non exists.
<T> T	receiveBodyNoWait(Endpoint endpoint, Class<T> type) Receives from the endpoint, not waiting for a response if non exists.
Object	receiveBodyNoWait(String endpointUri) Receives from the endpoint, not waiting for a response if non exists.
<T> T	receiveBodyNoWait(String endpointUri, Class<T> type) Receives from the endpoint, not waiting for a response if non exists.
Exchange	receiveNoWait(Endpoint endpoint) Receives from the endpoint, not waiting for a response if non exists.
Exchange	receiveNoWait(String endpointUri) Receives from the endpoint, not waiting for a response if non exists.
protected Endpoint	resolveMandatoryEndpoint(String endpointUri)
void	setMaximumCacheSize(int maximumCacheSize) Sets a custom maximum cache size.

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

addChildService, doShutdown, getStatus, getVersion, isRunAllowed, isStarted, isStarting, isStopped, isStopping, removeChildService, shutdown, start, stop

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.camel.Service

start, stop

Constructor Detail

DefaultConsumerTemplate

public DefaultConsumerTemplate(CamelContext context)

Method Detail

getMaximumCacheSize

public int getMaximumCacheSize()

Description copied from interface: ConsumerTemplate

Gets the maximum cache size used.

Specified by:

getMaximumCacheSize in interface ConsumerTemplate

Returns:

the maximum cache size

setMaximumCacheSize

public void setMaximumCacheSize(int maximumCacheSize)

Description copied from interface: ConsumerTemplate

Sets a custom maximum cache size.

Specified by:

setMaximumCacheSize in interface ConsumerTemplate

Parameters:

maximumCacheSize - the custom maximum cache size

getCurrentCacheSize

public int getCurrentCacheSize()

Description copied from interface: ConsumerTemplate

Gets an approximated size of the current cached resources in the backing cache pools.

Specified by:

getCurrentCacheSize in interface ConsumerTemplate

Returns:

the size of current cached resources

getCamelContext

public CamelContext getCamelContext()

receive

public Exchange receive(String endpointUri)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, waiting until there is a response

Specified by:

receive in interface ConsumerTemplate

Parameters:

endpointUri - the endpoint to receive from

Returns:

the returned exchange

receive

public Exchange receive(Endpoint endpoint)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, waiting until there is a response

Specified by:

receive in interface ConsumerTemplate

Parameters:

endpoint - the endpoint to receive from

Returns:

the returned exchange

receive

public Exchange receive(String endpointUri,
                        long timeout)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, waiting until there is a response or the timeout occurs

Specified by:

receive in interface ConsumerTemplate

Parameters:

endpointUri - the endpoint to receive from

timeout - timeout in millis to wait for a response

Returns:

the returned exchange, or null if no response

receive

public Exchange receive(Endpoint endpoint,
                        long timeout)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, waiting until there is a response or the timeout occurs

Specified by:

receive in interface ConsumerTemplate

Parameters:

endpoint - the endpoint to receive from

timeout - timeout in millis to wait for a response

Returns:

the returned exchange, or null if no response

receiveNoWait

public Exchange receiveNoWait(String endpointUri)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, not waiting for a response if non exists.

Specified by:

receiveNoWait in interface ConsumerTemplate

Parameters:

endpointUri - the endpoint to receive from

Returns:

the returned exchange, or null if no response

receiveNoWait

public Exchange receiveNoWait(Endpoint endpoint)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, not waiting for a response if non exists.

Specified by:

receiveNoWait in interface ConsumerTemplate

Parameters:

endpoint - the endpoint to receive from

Returns:

the returned exchange, or null if no response

receiveBody

public Object receiveBody(String endpointUri)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, waiting until there is a response

Specified by:

receiveBody in interface ConsumerTemplate

Parameters:

endpointUri - the endpoint to receive from

Returns:

the returned response body

receiveBody

public Object receiveBody(Endpoint endpoint)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, waiting until there is a response

Specified by:

receiveBody in interface ConsumerTemplate

Parameters:

endpoint - the endpoint to receive from

Returns:

the returned response body

receiveBody

public Object receiveBody(String endpointUri,
                          long timeout)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, waiting until there is a response or the timeout occurs

Specified by:

receiveBody in interface ConsumerTemplate

Parameters:

endpointUri - the endpoint to receive from

timeout - timeout in millis to wait for a response

Returns:

the returned response body, or null if no response

receiveBody

public Object receiveBody(Endpoint endpoint,
                          long timeout)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, waiting until there is a response or the timeout occurs

Specified by:

receiveBody in interface ConsumerTemplate

Parameters:

endpoint - the endpoint to receive from

timeout - timeout in millis to wait for a response

Returns:

the returned response body, or null if no response

receiveBodyNoWait

public Object receiveBodyNoWait(String endpointUri)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, not waiting for a response if non exists.

Specified by:

receiveBodyNoWait in interface ConsumerTemplate

Parameters:

endpointUri - the endpoint to receive from

Returns:

the returned response body, or null if no response

receiveBodyNoWait

public Object receiveBodyNoWait(Endpoint endpoint)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, not waiting for a response if non exists.

Specified by:

receiveBodyNoWait in interface ConsumerTemplate

Parameters:

endpoint - the endpoint to receive from

Returns:

the returned response body, or null if no response

receiveBody

public <T> T receiveBody(String endpointUri,
                         Class<T> type)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, waiting until there is a response

Specified by:

receiveBody in interface ConsumerTemplate

Parameters:

endpointUri - the endpoint to receive from

type - the expected response type

Returns:

the returned response body

receiveBody

public <T> T receiveBody(Endpoint endpoint,
                         Class<T> type)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, waiting until there is a response

Specified by:

receiveBody in interface ConsumerTemplate

Parameters:

endpoint - the endpoint to receive from

type - the expected response type

Returns:

the returned response body

receiveBody

public <T> T receiveBody(String endpointUri,
                         long timeout,
                         Class<T> type)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, waiting until there is a response or the timeout occurs

Specified by:

receiveBody in interface ConsumerTemplate

Parameters:

endpointUri - the endpoint to receive from

timeout - timeout in millis to wait for a response

type - the expected response type

Returns:

the returned response body, or null if no response

receiveBody

public <T> T receiveBody(Endpoint endpoint,
                         long timeout,
                         Class<T> type)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, waiting until there is a response or the timeout occurs

Specified by:

receiveBody in interface ConsumerTemplate

Parameters:

endpoint - the endpoint to receive from

timeout - timeout in millis to wait for a response

type - the expected response type

Returns:

the returned response body, or null if no response

receiveBodyNoWait

public <T> T receiveBodyNoWait(String endpointUri,
                               Class<T> type)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, not waiting for a response if non exists.

Specified by:

receiveBodyNoWait in interface ConsumerTemplate

Parameters:

endpointUri - the endpoint to receive from

type - the expected response type

Returns:

the returned response body, or null if no response

receiveBodyNoWait

public <T> T receiveBodyNoWait(Endpoint endpoint,
                               Class<T> type)

Description copied from interface: ConsumerTemplate

Receives from the endpoint, not waiting for a response if non exists.

Specified by:

receiveBodyNoWait in interface ConsumerTemplate

Parameters:

endpoint - the endpoint to receive from

type - the expected response type

Returns:

the returned response body, or null if no response

resolveMandatoryEndpoint

protected Endpoint resolveMandatoryEndpoint(String endpointUri)

extractResultBody

protected Object extractResultBody(Exchange result)

Extracts the body from the given result.

If the exchange pattern is provided it will try to honor it and retrieve the body from either IN or OUT according to the pattern.

Parameters:

result - the result

Returns:

the result, can be null.

doStart

protected void doStart()
                throws Exception

Specified by:

doStart in class ServiceSupport

Throws:

Exception

doStop

protected void doStop()
               throws Exception

Specified by:

doStop in class ServiceSupport

Throws:

Exception