Chapter 40. Azure Storage Queue Service Component
Available as of Camel version 2.19
The Azure Queue component supports storing and retrieving the messages to/from Azure Storage Queue service.
Prerequisites
You must have a valid Windows Azure Storage account. More information is available at Azure Documentation Portal.
40.1. URI Format
azure-queue://accountName/queueName[?options]
The queue will be created if it does not already exist.
You can append query options to the URI in the following format: ?options=value&option2=value&…
For example, to get a message content from the queue messageQueue in the camelazure storage account, use the following snippet:
from("azure-queue:camelazure/messageQueue").
to("file://queuedirectory");40.2. URI Options
The Azure Storage Queue Service component has no options.
The Azure Storage Queue Service endpoint is configured using URI syntax:
azure-queue:containerAndQueueUri
with the following path and query parameters:
40.2.1. Path Parameters (1 parameter)
| Name | Description | Default | Type |
|---|---|---|---|
| containerAndQueueUri | Required: Container Queue compact URI. | String |
40.2.2. Query Parameters (10 parameters)
| Name | Description | Default | Type |
|---|---|---|---|
| azureQueueClient (common) | The queue service client. | CloudQueue | |
| credentials (common) | Set the storage credentials, required in most cases | StorageCredentials | |
| bridgeErrorHandler (consumer) |
Allows for bridging the consumer to the Camel routing Error Handler. This means any exceptions that occurred (for example, while the consumer was trying to pick up incoming messages) will now be processed as a message and handled by the routing Error Handler. By default, the consumer will use the | false | boolean |
| exceptionHandler (consumer) |
To let the consumer use a custom | ExceptionHandler | |
| exchangePattern (consumer) | Sets the exchange pattern when the consumer creates an exchange. | ExchangePattern | |
| messageTimeToLive (producer) | Message Time To Live in seconds. | int | |
| messageVisibilityDelay (producer) | Message Visibility Delay in seconds. | int | |
| operation (producer) | Queue service operation hint to the producer. | listQueues | QueueServiceOperations |
| queuePrefix (producer) | Set a prefix which can be used for listing the queues. | String | |
| synchronous (advanced) | Sets whether synchronous processing should be strictly used, or Camel is allowed to use asynchronous processing (if supported). | false | boolean |
Required Azure Storage Queue Service component options
You must provide the containerAndQueue URI and the credentials.
40.3. Usage
40.3.1. Azure Queue Service operations
| Operation | Description |
|---|---|
|
| List the queues. |
|
| Create the queue. |
|
| Delete the queue. |
|
| Add a message to the queue. |
|
| Retrieve a message from the queue. |
|
| View the message inside the queue, for example, to determine whether the message arrived at the correct queue. |
|
| Update the message in the queue. |
|
| Delete the message in the queue. |
40.3.2. Azure Queue Client configuration
If your Camel Application is running behind a firewall or if you need to have more control over the Azure Queue Client configuration, you can create your own instance:
StorageCredentials credentials = new StorageCredentialsAccountAndKey("camelazure", "thekey");
CloudQueue client = new CloudQueue("camelazure", credentials);
registry.bind("azureQueueClient", client);
and refer to it in your Camel azure-queue component configuration:
from("azure-queue:camelazure/messageQueue?azureQueueClient=#client")
.to("mock:result");40.4. Dependencies
Maven users must add the following dependency to their pom.xml.
pom.xml
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-azure</artifactId>
<version>${camel-version}</version>
</dependency>
where ${camel-version} must be replaced by the actual version of Camel (2.19.0 or higher).
40.5. See Also
- Configuring Camel
- Component
- Endpoint
- Getting Started
- Azure Component
