Camel Components

LRA

Since Camel 2.21

The LRA module provides bindings of the Saga EIP with any MicroProfile compatible LRA Coordinator.

The configuration of the LRA Saga Service, including how to sign the callbacks that the LRA coordinator sends to the participant, is described in the Saga EIP page.

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

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

Spring Boot Auto-Configuration

When using lra with Spring Boot make sure to use the following Maven dependency to have support for auto configuration:

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

The component supports 7 options, which are listed below.

Name	Description	Default	Type
camel.lra.allowed-coordinator-urls	Comma-separated URLs, including the context path, of further LRA coordinators whose LRAs may be joined, completed or compensated. By default, only an LRA hosted by the configured coordinator is accepted. Use it when participants reach the same coordinator under different URLs, for example with different host names.		String
camel.lra.callback-secret	Secret used to sign the participant callback URLs that are enlisted with the LRA coordinator, and to verify them when the coordinator calls back. When set, a compensation or completion callback with a missing or invalid signature is rejected with HTTP 403. All the instances of a participant must use the same secret.		String
camel.lra.coordinator-context-path	The context path of the LRA coordinator service.		String
camel.lra.coordinator-url	The base URL of the LRA coordinator service (e.g. http://lra-host:8080).		String
camel.lra.enabled	Global option to enable/disable component auto-configuration, default is true.	true	Boolean
camel.lra.local-participant-context-path	The context path of the local participant callback services.		String
camel.lra.local-participant-url	The local URL where the coordinator should send callbacks to (e.g. http://my-host-name:8080).		String

Name

Description

Default

Type

camel.lra.allowed-coordinator-urls

Comma-separated URLs, including the context path, of further LRA coordinators whose LRAs may be joined, completed or compensated. By default, only an LRA hosted by the configured coordinator is accepted. Use it when participants reach the same coordinator under different URLs, for example with different host names.

String

camel.lra.callback-secret

Secret used to sign the participant callback URLs that are enlisted with the LRA coordinator, and to verify them when the coordinator calls back. When set, a compensation or completion callback with a missing or invalid signature is rejected with HTTP 403. All the instances of a participant must use the same secret.

String

camel.lra.coordinator-context-path

The context path of the LRA coordinator service.

String

camel.lra.coordinator-url

The base URL of the LRA coordinator service (e.g. http://lra-host:8080).

String

camel.lra.enabled

Global option to enable/disable component auto-configuration, default is true.

true

Boolean

camel.lra.local-participant-context-path

The context path of the local participant callback services.

String

camel.lra.local-participant-url

The local URL where the coordinator should send callbacks to (e.g. http://my-host-name:8080).

String