Questo contenuto non è disponibile nella lingua selezionata.
10.6. Attributes of a Listener
The “base” <listener> possesses the following attributes. These attribute definitions are inherited by all <listener> extensions. As such, they can be set for all of the listeners and gateways supported by the JBoss Enterprise SOA Platform, such as InVM.
| Name | Description | Type | Required |
|---|---|---|---|
| name | The name of the listener. This attribute is required primarily for logging purposes. | xsd:string | true |
| busrefid | Reference to the busid of the <bus> through which the listener instance receives messages. | xsd:string | true |
| maxThreads | The maximum number of concurrent message processing threads that the listener can have active. | xsd:int | True |
| is-gateway | Whether or not the listener instance is a “Gateway” or “Message Aware” Listener.
A message bus defines the details of a specific message channel or transport.
| xsd:boolean | true |
Listeners can define a set of zero or more <property> elements (just like the <provider> and <bus> elements/types). These are used to define listener specific properties.
Note
For each gateway listener defined in a service, an ESB-aware (or “native”) listener must also be defined. This is because gateway listeners do not define bidirectional endpoints but, rather, “start points” into the ESB. You cannot send a message to a gateway from within the ESB. Also, note that, since a gateway is not an endpoint, it does not have an Endpoint Reference (EPR) persisted in the registry.
Here is an example of a <listener> referencing a <bus>:
<?xml version = "1.0" encoding = "UTF-8"?>
<jbossesb xmlns="http://anonsvn.jboss.org/repos/labs/labs/jbossesb/trunk/product/etc/schemas/xml/jbossesb-1.3.0.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://anonsvn.jboss.org/repos/labs/labs/jbossesb/trunk/product/etc/schemas/xml/jbossesb-1.3.0.xsd http://anonsvn.jboss.org/repos/labs/labs/jbossesb/trunk/product/etc/schemas/xml/jbossesb-1.3.0.xsd"
parameterReloadSecs="5">
<providers>
<jms-provider name="JBossMQ" connection-factory="ConnectionFactory">
<jms-bus busid="Reconciliation">
<jms-message-filter
dest-type="QUEUE"
dest-name="queue/B"
/>
</jms-bus>
<!-- busid --> <jms-bus busid="ReconciliationEsb">
<jms-message-filter
dest-type="QUEUE"
dest-name="queue/C"
</jms-bus>
</jms-provider>
</providers>
<services>
<service category="Bank" name="Reconciliation"
description="Bank Reconciliation Service">
<listeners>
<!-- busidref --> <jms-listener name="Bank-Listener"
busidref="Reconciliation"
is-gateway="true"/>
<jms-listener name="Bank-Esb"
busidref="ReconciliationEsb"/>
</listeners>
<actions>
....
</actions>
</service>
</services>
</jbossesb>