Package org.apache.camel.model
Class PollEnrichDefinition
- java.lang.Object
-
- org.apache.camel.model.OptionalIdentifiedDefinition<Type>
-
- org.apache.camel.model.ProcessorDefinition<ExpressionNode>
-
- org.apache.camel.model.ExpressionNode
-
- org.apache.camel.model.PollEnrichDefinition
-
- All Implemented Interfaces:
org.apache.camel.CamelContextAware
,org.apache.camel.LineNumberAware
,AggregationStrategyAwareDefinition<PollEnrichDefinition>
,Block
,HasExpressionType
,org.apache.camel.NamedNode
,org.apache.camel.spi.HasId
,org.apache.camel.spi.IdAware
@Metadata(label="eip,transformation") public class PollEnrichDefinition extends ExpressionNode implements AggregationStrategyAwareDefinition<PollEnrichDefinition>
Enriches messages with data polled from a secondary resource- See Also:
Enricher
-
-
Field Summary
-
Fields inherited from class org.apache.camel.model.ProcessorDefinition
disabled, inheritErrorHandler
-
-
Constructor Summary
Constructors Constructor Description PollEnrichDefinition()
PollEnrichDefinition(org.apache.camel.AggregationStrategy aggregationStrategy, long timeout)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description PollEnrichDefinition
aggregateOnException(boolean aggregateOnException)
If this option is false then the aggregate method is not used if there was an exception thrown while trying to retrieve the data to enrich from the resource.PollEnrichDefinition
aggregationStrategy(String aggregationStrategy)
Refers to an AggregationStrategy to be used to merge the reply from the external service, into a single outgoing message.PollEnrichDefinition
aggregationStrategy(org.apache.camel.AggregationStrategy aggregationStrategy)
Sets the AggregationStrategy to be used to merge the reply from the external service, into a single outgoing message.PollEnrichDefinition
aggregationStrategyMethodAllowNull(boolean aggregationStrategyMethodAllowNull)
If this option is false then the aggregate method is not used if there was no data to enrich.PollEnrichDefinition
aggregationStrategyMethodName(String aggregationStrategyMethodName)
This option can be used to explicit declare the method name to use, when using POJOs as the AggregationStrategy.PollEnrichDefinition
cacheSize(int cacheSize)
Sets the maximum size used by theConsumerCache
which is used to cache and reuse consumers when uris are reused.PollEnrichDefinition
cacheSize(String cacheSize)
Sets the maximum size used by theConsumerCache
which is used to cache and reuse consumers when uris are reused.String
getAggregateOnException()
String
getAggregationStrategy()
org.apache.camel.AggregationStrategy
getAggregationStrategyBean()
Gets the aggregation strategyString
getAggregationStrategyMethodAllowNull()
If this option is false then the aggregate method is not used for the very first aggregation.String
getAggregationStrategyMethodName()
This option can be used to explicit declare the method name to use, when using beans as the AggregationStrategy.String
getAggregationStrategyRef()
Gets a reference id to lookup the aggregation strategy from the registryString
getCacheSize()
String
getIgnoreInvalidEndpoint()
String
getLabel()
Returns a label to describe this node such as the expression if some kind of expression nodeString
getShortName()
String
getTimeout()
PollEnrichDefinition
ignoreInvalidEndpoint()
Ignore the invalidate endpoint exception when try to create a producer with that endpointvoid
setAggregateOnException(String aggregateOnException)
void
setAggregationStrategy(String aggregationStrategy)
void
setAggregationStrategy(org.apache.camel.AggregationStrategy aggregationStrategy)
void
setAggregationStrategyMethodAllowNull(String aggregationStrategyMethodAllowNull)
void
setAggregationStrategyMethodName(String aggregationStrategyMethodName)
void
setCacheSize(String cacheSize)
void
setExpression(ExpressionDefinition expression)
Expression that computes the endpoint uri to use as the resource endpoint to enrich fromvoid
setIgnoreInvalidEndpoint(String ignoreInvalidEndpoint)
void
setTimeout(String timeout)
PollEnrichDefinition
timeout(long timeout)
Timeout in millis when polling from the external service.PollEnrichDefinition
timeout(String timeout)
Timeout in millis when polling from the external service.String
toString()
-
Methods inherited from class org.apache.camel.model.ExpressionNode
configureChild, getExpression, getExpressionType, getOutputs, id, preCreateProcessor, setExpression, setExpressionType
-
Methods inherited from class org.apache.camel.model.ProcessorDefinition
addInterceptStrategy, addOutput, aggregate, aggregate, aggregate, aggregate, bean, bean, bean, bean, bean, bean, bean, bean, bean, bean, bean, choice, circuitBreaker, claimCheck, claimCheck, claimCheck, claimCheck, clearOutput, convertBodyTo, convertBodyTo, convertBodyTo, delay, delay, delay, disabled, disabled, disabled, doTry, dynamicRouter, dynamicRouter, end, endChoice, endCircuitBreaker, endDoCatch, endDoTry, endParent, enrich, enrich, enrich, enrich, enrich, enrich, enrich, enrich, enrich, enrichWith, enrichWith, enrichWith, enrichWith, enrichWith, enrichWith, filter, filter, filter, filter, getDisabled, getIndex, getInterceptStrategies, getParent, getRouteConfiguration, idempotentConsumer, idempotentConsumer, idempotentConsumer, inheritErrorHandler, inOnly, inOnly, inOnly, inOnly, inOnly, inOut, inOut, inOut, inOut, inOut, isAbstract, isInheritErrorHandler, isTopLevelOnly, isWrappingEntireOutput, kamelet, loadBalance, loadBalance, log, log, log, log, log, log, loop, loop, loop, loopDoWhile, loopDoWhile, markRollbackOnly, markRollbackOnlyLast, marshal, marshal, marshal, marshal, multicast, multicast, multicast, nodePrefixId, onCompletion, onException, onException, pausable, pausable, pausable, pausable, pipeline, pipeline, pipeline, pipeline, policy, policy, pollEnrich, pollEnrich, pollEnrich, pollEnrich, pollEnrich, pollEnrich, pollEnrich, pollEnrich, pollEnrich, pollEnrich, pollEnrich, pollEnrich, pollEnrich, pollEnrich, pollEnrich, pollEnrich, pollEnrich, pollEnrichWith, pollEnrichWith, pollEnrichWith, pollEnrichWith, pollEnrichWith, pollEnrichWith, process, process, process, recipientList, recipientList, recipientList, recipientList, removeHeader, removeHeaders, removeHeaders, removeProperties, removeProperties, removeProperty, resequence, resequence, resumable, resumable, resumable, rollback, rollback, routeDescription, routeGroup, routeId, routingSlip, routingSlip, routingSlip, saga, sample, sample, sample, sample, sample, script, script, serviceCall, serviceCall, serviceCall, setBody, setBody, setBody, setDisabled, setExchangePattern, setExchangePattern, setHeader, setHeader, setHeader, setInheritErrorHandler, setParent, setProperty, setProperty, setProperty, setRouteConfiguration, sort, sort, sort, split, split, split, split, startupOrder, step, step, stop, threads, threads, threads, threads, throttle, throttle, throttle, throttle, throttle, throwException, throwException, to, to, to, to, to, to, to, to, to, to, to, to, to, to, toD, toD, toD, toD, toD, toD, toD, toF, transacted, transacted, transform, transform, unmarshal, unmarshal, unmarshal, unmarshal, unmarshal, unmarshal, unmarshal, validate, validate, validate, wireTap, wireTap, wireTap
-
Methods inherited from class org.apache.camel.model.OptionalIdentifiedDefinition
description, description, getCamelContext, getCustomId, getDescription, getDescriptionText, getId, getLineNumber, getLocation, hasCustomIdAssigned, idOrCreate, setCamelContext, setCustomId, setDescription, setGeneratedId, setId, setLineNumber, setLocation
-
-
-
-
Method Detail
-
getShortName
public String getShortName()
- Specified by:
getShortName
in interfaceorg.apache.camel.NamedNode
-
getLabel
public String getLabel()
Description copied from class:ProcessorDefinition
Returns a label to describe this node such as the expression if some kind of expression node- Specified by:
getLabel
in interfaceorg.apache.camel.NamedNode
- Overrides:
getLabel
in classExpressionNode
-
timeout
public PollEnrichDefinition timeout(long timeout)
Timeout in millis when polling from the external service. The timeout has influence about the poll enrich behavior. It basically operations in three different modes:- negative value - Waits until a message is available and then returns it. Warning that this method could block indefinitely if no messages are available.
- 0 - Attempts to receive a message exchange immediately without waiting and returning null if a message exchange is not available yet.
- positive value - Attempts to receive a message exchange, waiting up to the given timeout to expire if a message is not yet available. Returns null if timed out
-
timeout
public PollEnrichDefinition timeout(String timeout)
Timeout in millis when polling from the external service. The timeout has influence about the poll enrich behavior. It basically operations in three different modes:- negative value - Waits until a message is available and then returns it. Warning that this method could block indefinitely if no messages are available.
- 0 - Attempts to receive a message exchange immediately without waiting and returning null if a message exchange is not available yet.
- positive value - Attempts to receive a message exchange, waiting up to the given timeout to expire if a message is not yet available. Returns null if timed out
-
aggregationStrategy
public PollEnrichDefinition aggregationStrategy(org.apache.camel.AggregationStrategy aggregationStrategy)
Sets the AggregationStrategy to be used to merge the reply from the external service, into a single outgoing message. By default Camel will use the reply from the external service as outgoing message.- Specified by:
aggregationStrategy
in interfaceAggregationStrategyAwareDefinition<PollEnrichDefinition>
- Parameters:
aggregationStrategy
- the aggregation strategy- Returns:
- the builder
-
aggregationStrategy
public PollEnrichDefinition aggregationStrategy(String aggregationStrategy)
Refers to an AggregationStrategy to be used to merge the reply from the external service, into a single outgoing message. By default Camel will use the reply from the external service as outgoing message.- Specified by:
aggregationStrategy
in interfaceAggregationStrategyAwareDefinition<PollEnrichDefinition>
- Parameters:
aggregationStrategy
- the aggregation strategy- Returns:
- the builder
-
aggregationStrategyMethodName
public PollEnrichDefinition aggregationStrategyMethodName(String aggregationStrategyMethodName)
This option can be used to explicit declare the method name to use, when using POJOs as the AggregationStrategy.
-
aggregationStrategyMethodAllowNull
public PollEnrichDefinition aggregationStrategyMethodAllowNull(boolean aggregationStrategyMethodAllowNull)
If this option is false then the aggregate method is not used if there was no data to enrich. If this option is true then null values is used as the oldExchange (when no data to enrich), when using POJOs as the AggregationStrategy.
-
aggregateOnException
public PollEnrichDefinition aggregateOnException(boolean aggregateOnException)
If this option is false then the aggregate method is not used if there was an exception thrown while trying to retrieve the data to enrich from the resource. Setting this option to true allows end users to control what to do if there was an exception in the aggregate method. For example to suppress the exception or set a custom message body etc.
-
cacheSize
public PollEnrichDefinition cacheSize(int cacheSize)
Sets the maximum size used by theConsumerCache
which is used to cache and reuse consumers when uris are reused. Beware that when using dynamic endpoints then it affects how well the cache can be utilized. If each dynamic endpoint is unique then its best to turn of caching by setting this to -1, which allows Camel to not cache both the producers and endpoints; they are regarded as prototype scoped and will be stopped and discarded after use. This reduces memory usage as otherwise producers/endpoints are stored in memory in the caches. However if there are a high degree of dynamic endpoints that have been used before, then it can benefit to use the cache to reuse both producers and endpoints and therefore the cache size can be set accordingly or rely on the default size (1000). If there is a mix of unique and used before dynamic endpoints, then setting a reasonable cache size can help reduce memory usage to avoid storing too many non frequent used producers.- Parameters:
cacheSize
- the cache size, use 0 for default cache size, or -1 to turn cache off.- Returns:
- the builder
-
cacheSize
public PollEnrichDefinition cacheSize(String cacheSize)
Sets the maximum size used by theConsumerCache
which is used to cache and reuse consumers when uris are reused. Beware that when using dynamic endpoints then it affects how well the cache can be utilized. If each dynamic endpoint is unique then its best to turn of caching by setting this to -1, which allows Camel to not cache both the producers and endpoints; they are regarded as prototype scoped and will be stopped and discarded after use. This reduces memory usage as otherwise producers/endpoints are stored in memory in the caches. However if there are a high degree of dynamic endpoints that have been used before, then it can benefit to use the cache to reuse both producers and endpoints and therefore the cache size can be set accordingly or rely on the default size (1000). If there is a mix of unique and used before dynamic endpoints, then setting a reasonable cache size can help reduce memory usage to avoid storing too many non frequent used producers.- Parameters:
cacheSize
- the cache size, use 0 for default cache size, or -1 to turn cache off.- Returns:
- the builder
-
ignoreInvalidEndpoint
public PollEnrichDefinition ignoreInvalidEndpoint()
Ignore the invalidate endpoint exception when try to create a producer with that endpoint- Returns:
- the builder
-
setExpression
public void setExpression(ExpressionDefinition expression)
Expression that computes the endpoint uri to use as the resource endpoint to enrich from- Overrides:
setExpression
in classExpressionNode
-
getAggregationStrategyBean
public org.apache.camel.AggregationStrategy getAggregationStrategyBean()
Description copied from interface:AggregationStrategyAwareDefinition
Gets the aggregation strategy- Specified by:
getAggregationStrategyBean
in interfaceAggregationStrategyAwareDefinition<PollEnrichDefinition>
-
getAggregationStrategyRef
public String getAggregationStrategyRef()
Description copied from interface:AggregationStrategyAwareDefinition
Gets a reference id to lookup the aggregation strategy from the registry- Specified by:
getAggregationStrategyRef
in interfaceAggregationStrategyAwareDefinition<PollEnrichDefinition>
-
getTimeout
public String getTimeout()
-
setTimeout
public void setTimeout(String timeout)
-
getAggregationStrategy
public String getAggregationStrategy()
-
setAggregationStrategy
public void setAggregationStrategy(String aggregationStrategy)
-
setAggregationStrategy
public void setAggregationStrategy(org.apache.camel.AggregationStrategy aggregationStrategy)
-
getAggregationStrategyMethodName
public String getAggregationStrategyMethodName()
Description copied from interface:AggregationStrategyAwareDefinition
This option can be used to explicit declare the method name to use, when using beans as the AggregationStrategy.- Specified by:
getAggregationStrategyMethodName
in interfaceAggregationStrategyAwareDefinition<PollEnrichDefinition>
-
setAggregationStrategyMethodName
public void setAggregationStrategyMethodName(String aggregationStrategyMethodName)
-
getAggregationStrategyMethodAllowNull
public String getAggregationStrategyMethodAllowNull()
Description copied from interface:AggregationStrategyAwareDefinition
If this option is false then the aggregate method is not used for the very first aggregation. If this option is true then null values is used as the oldExchange (at the very first aggregation), when using beans as the AggregationStrategy.- Specified by:
getAggregationStrategyMethodAllowNull
in interfaceAggregationStrategyAwareDefinition<PollEnrichDefinition>
-
setAggregationStrategyMethodAllowNull
public void setAggregationStrategyMethodAllowNull(String aggregationStrategyMethodAllowNull)
-
getAggregateOnException
public String getAggregateOnException()
-
setAggregateOnException
public void setAggregateOnException(String aggregateOnException)
-
getCacheSize
public String getCacheSize()
-
setCacheSize
public void setCacheSize(String cacheSize)
-
getIgnoreInvalidEndpoint
public String getIgnoreInvalidEndpoint()
-
setIgnoreInvalidEndpoint
public void setIgnoreInvalidEndpoint(String ignoreInvalidEndpoint)
-
-