Since we're on a major migration process of this website, some component documents here are out of sync right now. In the meantime you may want to look at the early version of the new website
https://camel.apache.org/staging/
We would very much like to receive any feedback on the new site, please join the discussion on the Camel user mailing list.

Ehcache Component

Available as of Camel 2.18.x

The ehcache component enables you to perform caching operations using Ehcache 3 as the Cache Implementation.

This component supports producer and event based consumer endpoints.

The Cache consumer is an event based consumer and can be used to listen and respond to specific cache activities. 

Maven users will need to add the following dependency to their pom.xml for this component:

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-ehcache</artifactId>
    <version>x.x.x</version>
    <!-- use the same version as your Camel core version -->
</dependency>

URI format

ehcache://cacheName[?options]

You can append query options to the URI in the following format, ?option=value&option=#beanRef&...

Component Options

Name

Default Value

Type

Description

Since
configuration

null

EhcacheConfiguration

The global component configuration

camel 2.20.x
cacheConfigurationnullCacheConfigurationThe default cache configuration to be used to create caches if configUri is not setcamel 2.20.x
cacheConfigurationUrinullStringURI pointing to the Ehcache XML configuration file's locationcamel 2.20.x
cacheManagernullCacheManagerThe cache manager, if set configuration and configurationUri are discarded camel 2.19.1

Endpoint Options

Name

Default Value

Description

configUri

null

URI pointing to the Ehcache XML configuration file's location (deprecated in camel 2.20.x)

configurationUrinullURI pointing to the Ehcache XML configuration file's location
configuration

null

The default cache configuration to be used to create caches if configUri is not set

cacheManagernullThe cache manager, if set configuration and configurationUri are discarded

createCacheIfNotExist

true

Configure if a cache need to be created if it does exist or can't be pre-configured.

action

null

To configure the default cache action. If an action is set in the message header, then the operation from the header takes precedence.

key

null

To configure the default action key. If a key is set in the message header, then the key from the header takes precedence.

keyType

java.lang.Object

The cache key type, default Object.class

valueType

java.lang.Object

The cache value type, default Object.class

eventOrdering

ORDERED

Set the the delivery mode (ordered, unordered), consumer only

eventFiring

ASYNCHRONOUS

Set the the delivery mode (synchronous, asynchronous), consumer only

eventTypes

EVICTED,EXPIRED,REMOVED,CREATED,UPDATED

Set the type of events to listen for, consumer only

Message Headers Camel 

 

Header

Type

Description

CamelEhcacheAction

String

The operation to be perfomed on the cache, valid options are:

  • CLEAR
  • PUT
  • PUT_ALL
  • PUT_IF_ABSENT
  • GET
  • GET_ALL
  • REMOVE
  • REMOVE_ALL
  • REPLACE

CamelEhcacheActionHasResult

Boolean

Set to true if the action has a result

CamelEhcacheActionSucceeded

Boolean

Set to true if the actionsuccedded

CamelEhcacheKeyObjectThe cache key used for an action
CamelEhcacheKeysSet<Object>A list of keys, used in
  • PUT_ALL
  • GET_ALL
  • REMOVE_ALL
CamelEhcacheValueObjectThe value to put in the cache or the result of an operation
CamelEhcacheOldValueObjectThe old value associated to a key for actions like PUT_IF_ABSENT or the Object used for comparison for actions like REPLACE
CamelEhcacheEventTypeEventTypeThe type of event received

Ehcache based idempotent repository example:

 

CacheManager manager = CacheManagerBuilder.newCacheManager(new XmlConfiguration("ehcache.xml"));
EhcacheIdempotentRepository repo = new EhcacheIdempotentRepository(manager, "idempotent-cache");
 
from("direct:in")
    .idempotentConsumer(header("messageId"), idempotentRepo)
    .to("mock:out");

 

Ehcache based aggregation repository example:

 

public class EhcacheAggregationRepositoryRoutesTest extends CamelTestSupport {
    private static final String ENDPOINT_MOCK = "mock:result";
    private static final String ENDPOINT_DIRECT = "direct:one";
    private static final int[] VALUES = generateRandomArrayOfInt(10, 0, 30);
    private static final int SUM = IntStream.of(VALUES).reduce(0, (a, b) -> a + b);
    private static final String CORRELATOR = "CORRELATOR";

    @EndpointInject(uri = ENDPOINT_MOCK)
    private MockEndpoint mock;

    @Produce(uri = ENDPOINT_DIRECT)
    private ProducerTemplate producer;

    @Test
    public void checkAggregationFromOneRoute() throws Exception {
        mock.expectedMessageCount(VALUES.length);
        mock.expectedBodiesReceived(SUM);

        IntStream.of(VALUES).forEach(
            i -> producer.sendBodyAndHeader(i, CORRELATOR, CORRELATOR)
        );

        mock.assertIsSatisfied();
    }

    private Exchange aggregate(Exchange oldExchange, Exchange newExchange) {
        if (oldExchange == null) {
            return newExchange;
        } else {
            Integer n = newExchange.getIn().getBody(Integer.class);
            Integer o = oldExchange.getIn().getBody(Integer.class);
            Integer v = (o == null ? 0 : o) + (n == null ? 0 : n);

            oldExchange.getIn().setBody(v, Integer.class);

            return oldExchange;
        }
    }

    @Override
    protected RoutesBuilder createRouteBuilder() throws Exception {
        return new RouteBuilder() {
            @Override
            public void configure() throws Exception {
                from(ENDPOINT_DIRECT)
                    .routeId("AggregatingRouteOne")
                    .aggregate(header(CORRELATOR))
                    .aggregationRepository(createAggregateRepository())
                    .aggregationStrategy(EhcacheAggregationRepositoryRoutesTest.this::aggregate)
                    .completionSize(VALUES.length)
                        .to("log:org.apache.camel.component.ehcache.processor.aggregate.level=INFO&showAll=true&mulltiline=true")
                        .to(ENDPOINT_MOCK);
            }
        };
    }

    protected EhcacheAggregationRepository createAggregateRepository() throws Exception {
        CacheManager cacheManager = CacheManagerBuilder.newCacheManager(new XmlConfiguration("ehcache.xml"));
        cacheManager.init();

        EhcacheAggregationRepository repository = new EhcacheAggregationRepository();
        repository.setCacheManager(cacheManager);
        repository.setCacheName("aggregate");

        return repository;
    }
}

© 2004-2015 The Apache Software Foundation.
Apache Camel, Camel, Apache, the Apache feather logo, and the Apache Camel project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
Graphic Design By Hiram