Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Axis2 properties allow you to configure the web services engine in the ESB, such as specifying how to cache JMS objects, setting the minimum and maximum threads for consuming messages, and forcing outgoing HTTP/S messages to use HTTP 1.0. You can access some of these properties through the Property mediator with the scope set to axis2 or axis2-client as shown below.

CacheLevel

Name

CacheLevel

Possible Values

none, connection, session, consumer, producer, auto

 


Default Behavior

 


Scope

 


Description

This property determines which JMS objects should be cached. JMS objects are cached so that they can be reused in the subsequent invocations. Each caching level can be described as follows:

none: No JMS object will be cached.
connection: JMS connection objects will be cached.
session: JMS connection and session objects will be cached.
consumer: JMS connection, session and consumer objects will be cached.
producer: JMS connection, session and producer objects will be cached.

auto: An appropriate caching level will be used depending on the transaction strategy.

Example

Code Block
languagexml
<parameter name="transport.jms.CacheLevel">consumer</parameter>

Anchor
Concurrent
Concurrent
ConcurrentConsumers

Name

ConcurrentConsumers

Possible Values

integer

 


Default Behavior

 


Scope

 


Description

The minimum number of threads for message consuming. The value specified for this property is the initial number of threads started. As the number of messages to be consumed increases, number of threads are also increased to match the load until the total number of threads equals the value specified for the transport.jms.MaxConcurrentConsumers property.

Example

Code Block
languagexml
<parameter name="transport.jms.ConcurrentConsumers"locked="false">50</parameter>

Anchor
HTTP_ETAG
HTTP_ETAG
HTTP_ETAG

Name HTTP_ETAG
Possible Values true/false
Default Behaviour
 

Scope axis2
Description

This property determines whether the HTTP Etag should be enabled for the request or not.

Info

HTTP Etag is a mechanism provided by HTTP for Web cache validation.

Example
Code Block
languagexml
<property name="HTTP_ETAG" scope="axis2" type="BOOLEAN" value="true"/>

Anchor
JMS_Coorelation_ID
JMS_Coorelation_ID
JMS_COORELATION_ID

Name

JMS_COORELATION_ID

Possible Values

String

Default Behavior

 

 



Scope

axis2

Description

The JMS coorelation ID is used to match responses with specific requests. This property can be used to set the JMS coorrelation ID as a dynamic or a hard coded value in a request. As a result, responses with the matching JMS correlation IDs will be matched with the request.

Example

Code Block
languagexml
<property name="JMS_COORELATION_ID" action="set" scope="axis2" expression="$header/wsa:MessageID" xmlns:sam="http://sample.esb.org/>
Excerpt
hiddentrue

This description was added to answer the FAQ How can we add JMS Coorelation IDS to the messages in the request Queue and how does it work?

MaxConcurrentConsumers

Name

MaxConcurrentConsumers

Possible Values

integer
 


Default Behavior

 


Scope

 


Description

The maximum number of threads that can be added for message consuming. See ConcurrentConsumers.

Example

Code Block
languagexml
<parameter name="transport.jms.MaxConcurrentConsumers"locked="false">50</parameter>

MercurySequenceKey

Name

MercurySequenceKey

Possible Values

integer

Default Behavior

 


Scope

 


Description

Can be an identifier specifying a Mercury internal sequence key.

Example

 


MercuryLastMessage

Name

MercuryLastMessage

Possible Values

true/false

Default Behavior

 


Scope

 


Description

When set to "true", it will make this the last message and terminate the sequence.

Example

 


FORCE_HTTP_1.0

Name

FORCE_HTTP_1.0

Possible Values

true/false

Default Behavior

 


Scope

axis2-client

Description

Forces outgoing http/s messages to use HTTP 1.0 (instead of the default 1.1).

Example