Class RabbitMQComponent
- java.lang.Object
-
- org.apache.camel.support.service.BaseService
-
- org.apache.camel.support.service.ServiceSupport
-
- org.apache.camel.support.DefaultComponent
-
- org.apache.camel.component.rabbitmq.RabbitMQComponent
-
- All Implemented Interfaces:
AutoCloseable,org.apache.camel.CamelContextAware,org.apache.camel.Component,org.apache.camel.Service,org.apache.camel.ShutdownableService,org.apache.camel.StatefulService,org.apache.camel.SuspendableService
@Component("rabbitmq") public class RabbitMQComponent extends org.apache.camel.support.DefaultComponent
-
-
Field Summary
Fields Modifier and Type Field Description static StringARG_PREFIXstatic StringBINDING_ARG_PREFIXstatic StringDLQ_ARG_PREFIXstatic StringDLQ_BINDING_PREFIXstatic StringEXCHANGE_ARG_PREFIXstatic StringQUEUE_ARG_PREFIX
-
Constructor Summary
Constructors Constructor Description RabbitMQComponent()RabbitMQComponent(org.apache.camel.CamelContext context)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected RabbitMQEndpointcreateEndpoint(String uri, String remaining, Map<String,Object> params)Map<String,Object>getAdditionalHeaders()Map<String,Object>getAdditionalProperties()StringgetAddresses()Map<String,Object>getArgs()BooleangetAutomaticRecoveryEnabled()intgetChannelPoolMaxSize()Get maximum number of opened channel in poollonggetChannelPoolMaxWait()Map<String,Object>getClientProperties()com.rabbitmq.client.ConnectionFactorygetConnectionFactory()com.rabbitmq.client.ExceptionHandlergetConnectionFactoryExceptionHandler()intgetConnectionTimeout()StringgetDeadLetterExchange()StringgetDeadLetterExchangeType()StringgetDeadLetterQueue()StringgetDeadLetterRoutingKey()StringgetHostname()IntegergetNetworkRecoveryInterval()StringgetPassword()intgetPortNumber()intgetPrefetchCount()intgetPrefetchSize()longgetPublisherAcknowledgementsTimeout()The amount of time in milliseconds to wait for a basic.ack response from RabbitMQ serverintgetRequestedChannelMax()intgetRequestedFrameMax()intgetRequestedHeartbeat()longgetRequestTimeout()longgetRequestTimeoutCheckerInterval()StringgetSslProtocol()intgetThreadPoolSize()BooleangetTopologyRecoveryEnabled()TrustManagergetTrustManager()StringgetUsername()StringgetVhost()booleanisAllowNullHeaders()Allow pass null values to headerbooleanisAutoAck()booleanisAutoDelete()booleanisAutoDetectConnectionFactory()booleanisDeclare()booleanisDurable()booleanisExclusive()booleanisExclusiveConsumer()booleanisGuaranteedDeliveries()When true, an exception will be thrown when the message cannot be delivered (basic.return) and the message is marked as mandatory.booleanisImmediate()booleanisMandatory()booleanisPassive()booleanisPrefetchEnabled()booleanisPrefetchGlobal()booleanisPublisherAcknowledgements()When true, the message will be published with publisher acknowledgements turned onbooleanisRecoverFromDeclareException()booleanisSkipExchangeDeclare()booleanisSkipQueueBind()If true the queue will not be bound to the exchange after declaring itbooleanisSkipQueueDeclare()booleanisTransferException()voidsetAdditionalHeaders(Map<String,Object> additionalHeaders)Map of additional headers.voidsetAdditionalProperties(Map<String,Object> additionalProperties)Map of additional properties.voidsetAddresses(String addresses)If this option is set, camel-rabbitmq will try to create connection based on the setting of option addresses.voidsetAllowNullHeaders(boolean allowNullHeaders)voidsetArgs(Map<String,Object> args)Specify arguments for configuring the different RabbitMQ concepts, a different prefix is required for each: Exchange: arg.exchange. Queue: arg.queue. Binding: arg.binding. DLQ: arg.dlq.queue. DLQ Binding: arg.dlq.binding. For example to declare a queue with message ttl argument: http://localhost:5672/exchange/queue?args=arg.queue.x-message-ttl=60000voidsetAutoAck(boolean autoAck)If messages should be auto acknowledgedvoidsetAutoDelete(boolean autoDelete)If it is true, the exchange will be deleted when it is no longer in usevoidsetAutoDetectConnectionFactory(boolean autoDetectConnectionFactory)Whether to auto-detect looking up RabbitMQ connection factory from the registry.voidsetAutomaticRecoveryEnabled(Boolean automaticRecoveryEnabled)Enables connection automatic recovery (uses connection implementation that performs automatic recovery when connection shutdown is not initiated by the application)voidsetChannelPoolMaxSize(int channelPoolMaxSize)voidsetChannelPoolMaxWait(long channelPoolMaxWait)Set the maximum number of milliseconds to wait for a channel from the poolvoidsetClientProperties(Map<String,Object> clientProperties)Connection client properties (client info used in negotiating with the server)voidsetConnectionFactory(com.rabbitmq.client.ConnectionFactory connectionFactory)To use a custom RabbitMQ connection factory.voidsetConnectionFactoryExceptionHandler(com.rabbitmq.client.ExceptionHandler connectionFactoryExceptionHandler)Custom rabbitmq ExceptionHandler for ConnectionFactoryvoidsetConnectionTimeout(int connectionTimeout)Connection timeoutvoidsetDeadLetterExchange(String deadLetterExchange)The name of the dead letter exchangevoidsetDeadLetterExchangeType(String deadLetterExchangeType)The type of the dead letter exchangevoidsetDeadLetterQueue(String deadLetterQueue)The name of the dead letter queuevoidsetDeadLetterRoutingKey(String deadLetterRoutingKey)The routing key for the dead letter exchangevoidsetDeclare(boolean declare)If the option is true, camel declare the exchange and queue name and bind them together.voidsetDurable(boolean durable)If we are declaring a durable exchange (the exchange will survive a server restart)voidsetExclusive(boolean exclusive)Exclusive queues may only be accessed by the current connection, and are deleted when that connection closes.voidsetExclusiveConsumer(boolean exclusiveConsumer)Request exclusive access to the queue (meaning only this consumer can access the queue).voidsetGuaranteedDeliveries(boolean guaranteedDeliveries)voidsetHostname(String hostname)The hostname of the running RabbitMQ instance or cluster.voidsetImmediate(boolean immediate)This flag tells the server how to react if the message cannot be routed to a queue consumer immediately.voidsetMandatory(boolean mandatory)This flag tells the server how to react if the message cannot be routed to a queue.voidsetNetworkRecoveryInterval(Integer networkRecoveryInterval)Network recovery interval in milliseconds (interval used when recovering from network failure)voidsetPassive(boolean passive)Passive queues depend on the queue already to be available at RabbitMQ.voidsetPassword(String password)Password for authenticated accessvoidsetPortNumber(int portNumber)Port number for the host with the running rabbitmq instance or cluster.voidsetPrefetchCount(int prefetchCount)The maximum number of messages that the server will deliver, 0 if unlimited.voidsetPrefetchEnabled(boolean prefetchEnabled)Enables the quality of service on the RabbitMQConsumer side.voidsetPrefetchGlobal(boolean prefetchGlobal)If the settings should be applied to the entire channel rather than each consumer You need to specify the option of prefetchSize, prefetchCount, prefetchGlobal at the same timevoidsetPrefetchSize(int prefetchSize)The maximum amount of content (measured in octets) that the server will deliver, 0 if unlimited.voidsetPublisherAcknowledgements(boolean publisherAcknowledgements)voidsetPublisherAcknowledgementsTimeout(long publisherAcknowledgementsTimeout)voidsetRecoverFromDeclareException(boolean recoverFromDeclareException)Decides whether an exception during declaration of exchanges or queues is recoverable or not.voidsetRequestedChannelMax(int requestedChannelMax)Connection requested channel max (max number of channels offered)voidsetRequestedFrameMax(int requestedFrameMax)Connection requested frame max (max size of frame offered)voidsetRequestedHeartbeat(int requestedHeartbeat)Connection requested heartbeat (heart-beat in seconds offered)voidsetRequestTimeout(long requestTimeout)Set timeout for waiting for a reply when using the InOut Exchange Pattern (in milliseconds)voidsetRequestTimeoutCheckerInterval(long requestTimeoutCheckerInterval)Set requestTimeoutCheckerInterval for inOut exchangevoidsetSkipExchangeDeclare(boolean skipExchangeDeclare)This can be used if we need to declare the queue but not the exchangevoidsetSkipQueueBind(boolean skipQueueBind)voidsetSkipQueueDeclare(boolean skipQueueDeclare)If true the producer will not declare and bind a queue.voidsetSslProtocol(String sslProtocol)Enables SSL on connection, accepted value are `true`, `TLS` and 'SSLv3`voidsetThreadPoolSize(int threadPoolSize)The consumer uses a Thread Pool Executor with a fixed number of threads.voidsetTopologyRecoveryEnabled(Boolean topologyRecoveryEnabled)Enables connection topology recovery (should topology recovery be performed?)voidsetTransferException(boolean transferException)When true and an inOut Exchange failed on the consumer side send the caused Exception back in the responsevoidsetTrustManager(TrustManager trustManager)Configure SSL trust manager, SSL should be enabled for this option to be effectivevoidsetUsername(String username)Username in case of authenticated accessvoidsetVhost(String vhost)The vhost for the channel-
Methods inherited from class org.apache.camel.support.DefaultComponent
afterConfiguration, createEndpoint, createEndpoint, doBuild, doInit, doStart, doStop, getAndRemoveOrResolveReferenceParameter, getAndRemoveOrResolveReferenceParameter, getAndRemoveParameter, getAndRemoveParameter, getCamelContext, getComponentPropertyConfigurer, getDefaultName, getEndpointPropertyConfigurer, getExtension, getSupportedExtensions, ifStartsWithReturnRemainder, isAutowiredEnabled, isBridgeErrorHandler, isLazyStartProducer, registerExtension, registerExtension, resolveAndRemoveReferenceListParameter, resolveAndRemoveReferenceListParameter, resolveAndRemoveReferenceParameter, resolveAndRemoveReferenceParameter, resolveRawParameterValues, setAutowiredEnabled, setBridgeErrorHandler, setCamelContext, setLazyStartProducer, setProperties, setProperties, setProperties, useIntrospectionOnEndpoint, useRawUri, validateParameters, validateURI
-
Methods inherited from class org.apache.camel.support.service.BaseService
build, doFail, doLifecycleChange, doResume, doShutdown, doSuspend, fail, getStatus, init, isBuild, 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, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
-
-
-
Field Detail
-
ARG_PREFIX
public static final String ARG_PREFIX
- See Also:
- Constant Field Values
-
EXCHANGE_ARG_PREFIX
public static final String EXCHANGE_ARG_PREFIX
- See Also:
- Constant Field Values
-
QUEUE_ARG_PREFIX
public static final String QUEUE_ARG_PREFIX
- See Also:
- Constant Field Values
-
DLQ_ARG_PREFIX
public static final String DLQ_ARG_PREFIX
- See Also:
- Constant Field Values
-
DLQ_BINDING_PREFIX
public static final String DLQ_BINDING_PREFIX
- See Also:
- Constant Field Values
-
BINDING_ARG_PREFIX
public static final String BINDING_ARG_PREFIX
- See Also:
- Constant Field Values
-
-
Method Detail
-
createEndpoint
protected RabbitMQEndpoint createEndpoint(String uri, String remaining, Map<String,Object> params) throws Exception
- Specified by:
createEndpointin classorg.apache.camel.support.DefaultComponent- Throws:
Exception
-
getHostname
public String getHostname()
-
setHostname
public void setHostname(String hostname)
The hostname of the running RabbitMQ instance or cluster.
-
getPortNumber
public int getPortNumber()
-
setPortNumber
public void setPortNumber(int portNumber)
Port number for the host with the running rabbitmq instance or cluster.
-
getUsername
public String getUsername()
-
setUsername
public void setUsername(String username)
Username in case of authenticated access
-
getPassword
public String getPassword()
-
setPassword
public void setPassword(String password)
Password for authenticated access
-
getVhost
public String getVhost()
-
setVhost
public void setVhost(String vhost)
The vhost for the channel
-
setAddresses
public void setAddresses(String addresses)
If this option is set, camel-rabbitmq will try to create connection based on the setting of option addresses. The addresses value is a string which looks like "server1:12345, server2:12345"
-
getAddresses
public String getAddresses()
-
getConnectionFactory
public com.rabbitmq.client.ConnectionFactory getConnectionFactory()
-
setConnectionFactory
public void setConnectionFactory(com.rabbitmq.client.ConnectionFactory connectionFactory)
To use a custom RabbitMQ connection factory. When this option is set, all connection options (connectionTimeout, requestedChannelMax...) set on URI are not used
-
getThreadPoolSize
public int getThreadPoolSize()
-
setThreadPoolSize
public void setThreadPoolSize(int threadPoolSize)
The consumer uses a Thread Pool Executor with a fixed number of threads. This setting allows you to set that number of threads.
-
isAutoDetectConnectionFactory
public boolean isAutoDetectConnectionFactory()
-
setAutoDetectConnectionFactory
public void setAutoDetectConnectionFactory(boolean autoDetectConnectionFactory)
Whether to auto-detect looking up RabbitMQ connection factory from the registry. When enabled and a single instance of the connection factory is found then it will be used. An explicit connection factory can be configured on the component or endpoint level which takes precedence.
-
getConnectionTimeout
public int getConnectionTimeout()
-
setConnectionTimeout
public void setConnectionTimeout(int connectionTimeout)
Connection timeout
-
getRequestedChannelMax
public int getRequestedChannelMax()
-
setRequestedChannelMax
public void setRequestedChannelMax(int requestedChannelMax)
Connection requested channel max (max number of channels offered)
-
getRequestedFrameMax
public int getRequestedFrameMax()
-
setRequestedFrameMax
public void setRequestedFrameMax(int requestedFrameMax)
Connection requested frame max (max size of frame offered)
-
getRequestedHeartbeat
public int getRequestedHeartbeat()
-
setRequestedHeartbeat
public void setRequestedHeartbeat(int requestedHeartbeat)
Connection requested heartbeat (heart-beat in seconds offered)
-
getAutomaticRecoveryEnabled
public Boolean getAutomaticRecoveryEnabled()
-
setAutomaticRecoveryEnabled
public void setAutomaticRecoveryEnabled(Boolean automaticRecoveryEnabled)
Enables connection automatic recovery (uses connection implementation that performs automatic recovery when connection shutdown is not initiated by the application)
-
getNetworkRecoveryInterval
public Integer getNetworkRecoveryInterval()
-
setNetworkRecoveryInterval
public void setNetworkRecoveryInterval(Integer networkRecoveryInterval)
Network recovery interval in milliseconds (interval used when recovering from network failure)
-
getTopologyRecoveryEnabled
public Boolean getTopologyRecoveryEnabled()
-
setTopologyRecoveryEnabled
public void setTopologyRecoveryEnabled(Boolean topologyRecoveryEnabled)
Enables connection topology recovery (should topology recovery be performed?)
-
isPrefetchEnabled
public boolean isPrefetchEnabled()
-
setPrefetchEnabled
public void setPrefetchEnabled(boolean prefetchEnabled)
Enables the quality of service on the RabbitMQConsumer side. You need to specify the option of prefetchSize, prefetchCount, prefetchGlobal at the same time
-
setPrefetchSize
public void setPrefetchSize(int prefetchSize)
The maximum amount of content (measured in octets) that the server will deliver, 0 if unlimited. You need to specify the option of prefetchSize, prefetchCount, prefetchGlobal at the same time
-
getPrefetchSize
public int getPrefetchSize()
-
setPrefetchCount
public void setPrefetchCount(int prefetchCount)
The maximum number of messages that the server will deliver, 0 if unlimited. You need to specify the option of prefetchSize, prefetchCount, prefetchGlobal at the same time
-
getPrefetchCount
public int getPrefetchCount()
-
setPrefetchGlobal
public void setPrefetchGlobal(boolean prefetchGlobal)
If the settings should be applied to the entire channel rather than each consumer You need to specify the option of prefetchSize, prefetchCount, prefetchGlobal at the same time
-
isPrefetchGlobal
public boolean isPrefetchGlobal()
-
getChannelPoolMaxSize
public int getChannelPoolMaxSize()
Get maximum number of opened channel in pool
-
setChannelPoolMaxSize
public void setChannelPoolMaxSize(int channelPoolMaxSize)
-
getChannelPoolMaxWait
public long getChannelPoolMaxWait()
-
setChannelPoolMaxWait
public void setChannelPoolMaxWait(long channelPoolMaxWait)
Set the maximum number of milliseconds to wait for a channel from the pool
-
setRequestTimeout
public void setRequestTimeout(long requestTimeout)
Set timeout for waiting for a reply when using the InOut Exchange Pattern (in milliseconds)
-
getRequestTimeout
public long getRequestTimeout()
-
setRequestTimeoutCheckerInterval
public void setRequestTimeoutCheckerInterval(long requestTimeoutCheckerInterval)
Set requestTimeoutCheckerInterval for inOut exchange
-
getRequestTimeoutCheckerInterval
public long getRequestTimeoutCheckerInterval()
-
setTransferException
public void setTransferException(boolean transferException)
When true and an inOut Exchange failed on the consumer side send the caused Exception back in the response
-
isTransferException
public boolean isTransferException()
-
isPublisherAcknowledgements
public boolean isPublisherAcknowledgements()
When true, the message will be published with publisher acknowledgements turned on
-
setPublisherAcknowledgements
public void setPublisherAcknowledgements(boolean publisherAcknowledgements)
-
getPublisherAcknowledgementsTimeout
public long getPublisherAcknowledgementsTimeout()
The amount of time in milliseconds to wait for a basic.ack response from RabbitMQ server
-
setPublisherAcknowledgementsTimeout
public void setPublisherAcknowledgementsTimeout(long publisherAcknowledgementsTimeout)
-
isGuaranteedDeliveries
public boolean isGuaranteedDeliveries()
When true, an exception will be thrown when the message cannot be delivered (basic.return) and the message is marked as mandatory. PublisherAcknowledgement will also be activated in this case. See also publisher acknowledgements - When will messages be confirmed.
-
setGuaranteedDeliveries
public void setGuaranteedDeliveries(boolean guaranteedDeliveries)
-
isMandatory
public boolean isMandatory()
-
setMandatory
public void setMandatory(boolean mandatory)
This flag tells the server how to react if the message cannot be routed to a queue. If this flag is set, the server will return an unroutable message with a Return method. If this flag is zero, the server silently drops the message. If the header is present rabbitmq.MANDATORY it will override this option.
-
isImmediate
public boolean isImmediate()
-
setImmediate
public void setImmediate(boolean immediate)
This flag tells the server how to react if the message cannot be routed to a queue consumer immediately. If this flag is set, the server will return an undeliverable message with a Return method. If this flag is zero, the server will queue the message, but with no guarantee that it will ever be consumed. If the header is present rabbitmq.IMMEDIATE it will override this option.
-
setArgs
public void setArgs(Map<String,Object> args)
Specify arguments for configuring the different RabbitMQ concepts, a different prefix is required for each:- Exchange: arg.exchange.
- Queue: arg.queue.
- Binding: arg.binding.
- DLQ: arg.dlq.queue.
- DLQ Binding: arg.dlq.binding.
-
setClientProperties
public void setClientProperties(Map<String,Object> clientProperties)
Connection client properties (client info used in negotiating with the server)
-
getSslProtocol
public String getSslProtocol()
-
setSslProtocol
public void setSslProtocol(String sslProtocol)
Enables SSL on connection, accepted value are `true`, `TLS` and 'SSLv3`
-
getTrustManager
public TrustManager getTrustManager()
-
setTrustManager
public void setTrustManager(TrustManager trustManager)
Configure SSL trust manager, SSL should be enabled for this option to be effective
-
isAutoAck
public boolean isAutoAck()
-
setAutoAck
public void setAutoAck(boolean autoAck)
If messages should be auto acknowledged
-
isAutoDelete
public boolean isAutoDelete()
-
setAutoDelete
public void setAutoDelete(boolean autoDelete)
If it is true, the exchange will be deleted when it is no longer in use
-
isDurable
public boolean isDurable()
-
setDurable
public void setDurable(boolean durable)
If we are declaring a durable exchange (the exchange will survive a server restart)
-
isExclusive
public boolean isExclusive()
-
setExclusive
public void setExclusive(boolean exclusive)
Exclusive queues may only be accessed by the current connection, and are deleted when that connection closes.
-
isExclusiveConsumer
public boolean isExclusiveConsumer()
-
setExclusiveConsumer
public void setExclusiveConsumer(boolean exclusiveConsumer)
Request exclusive access to the queue (meaning only this consumer can access the queue). This is useful when you want a long-lived shared queue to be temporarily accessible by just one consumer.
-
isPassive
public boolean isPassive()
-
setPassive
public void setPassive(boolean passive)
Passive queues depend on the queue already to be available at RabbitMQ.
-
setSkipQueueDeclare
public void setSkipQueueDeclare(boolean skipQueueDeclare)
If true the producer will not declare and bind a queue. This can be used for directing messages via an existing routing key.
-
isSkipQueueDeclare
public boolean isSkipQueueDeclare()
-
isSkipQueueBind
public boolean isSkipQueueBind()
If true the queue will not be bound to the exchange after declaring it
-
setSkipQueueBind
public void setSkipQueueBind(boolean skipQueueBind)
-
setSkipExchangeDeclare
public void setSkipExchangeDeclare(boolean skipExchangeDeclare)
This can be used if we need to declare the queue but not the exchange
-
isSkipExchangeDeclare
public boolean isSkipExchangeDeclare()
-
isDeclare
public boolean isDeclare()
-
setDeclare
public void setDeclare(boolean declare)
If the option is true, camel declare the exchange and queue name and bind them together. If the option is false, camel won't declare the exchange and queue name on the server.
-
getDeadLetterExchange
public String getDeadLetterExchange()
-
setDeadLetterExchange
public void setDeadLetterExchange(String deadLetterExchange)
The name of the dead letter exchange
-
getDeadLetterQueue
public String getDeadLetterQueue()
-
setDeadLetterQueue
public void setDeadLetterQueue(String deadLetterQueue)
The name of the dead letter queue
-
getDeadLetterRoutingKey
public String getDeadLetterRoutingKey()
-
setDeadLetterRoutingKey
public void setDeadLetterRoutingKey(String deadLetterRoutingKey)
The routing key for the dead letter exchange
-
getDeadLetterExchangeType
public String getDeadLetterExchangeType()
-
setDeadLetterExchangeType
public void setDeadLetterExchangeType(String deadLetterExchangeType)
The type of the dead letter exchange
-
isAllowNullHeaders
public boolean isAllowNullHeaders()
Allow pass null values to header
-
setAllowNullHeaders
public void setAllowNullHeaders(boolean allowNullHeaders)
-
setAdditionalHeaders
public void setAdditionalHeaders(Map<String,Object> additionalHeaders)
Map of additional headers. These headers will be set only when the 'allowCustomHeaders' is set to true
-
setAdditionalProperties
public void setAdditionalProperties(Map<String,Object> additionalProperties)
Map of additional properties. These are standard RabbitMQ properties as defined inAMQP.BasicPropertiesThe map keys should be fromRabbitMQConstants. Any other keys will be ignored. When the message already contains these headers they will be given precedence over these properties.
-
getConnectionFactoryExceptionHandler
public com.rabbitmq.client.ExceptionHandler getConnectionFactoryExceptionHandler()
-
setConnectionFactoryExceptionHandler
public void setConnectionFactoryExceptionHandler(com.rabbitmq.client.ExceptionHandler connectionFactoryExceptionHandler)
Custom rabbitmq ExceptionHandler for ConnectionFactory
-
isRecoverFromDeclareException
public boolean isRecoverFromDeclareException()
-
setRecoverFromDeclareException
public void setRecoverFromDeclareException(boolean recoverFromDeclareException)
Decides whether an exception during declaration of exchanges or queues is recoverable or not. If the option is false, camel will throw an exception when starting the consumer, which will interrupt application startup (e.g. in the case when the exchange / queue is already declared in RabbitMQ and has incompatible configuration). If set to true, the consumer will try to reconnect periodically.
-
-