jms7.html

j2eePDF格式的电子书

    <td><a name="wp88978"> </a><div class="pCellBody">
Specifies the coded name of a message destination reference. The name is a JNDI name relative to the <code class="cCode">java:comp/env</code> context, such as <code class="cCode">jms/NewHireTopic</code>.
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp88651"> </a><div class="pCellBody">
<code class="cCode">&lt;message-destination-type&gt;</code>
</div>
</td>
    <td><a name="wp89021"> </a><div class="pCellBody">
Specifies the type of the destination. The type is specified by the Java interface expected to be implemented by the destination. For JMS destinations, the allowed interfaces are <code class="cCode">javax.jms.Topic</code> and <code class="cCode">javax.jms.Queu</code>e.
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp88958"> </a><div class="pCellBody">
<code class="cCode">&lt;message-destination-usage&gt;</code>
</div>
</td>
    <td><a name="wp89050"> </a><div class="pCellBody">
Specifies the use of the message destination indicated by the reference. Must be one of the following: <code class="cCode">Consumes</code>, <code class="cCode">Produces</code>, or <code class="cCode">ConsumesProduces</code>.
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp88954"> </a><div class="pCellBody">
<code class="cCode">&lt;message-destination-link&gt;</code>
</div>
</td>
    <td><a name="wp89035"> </a><div class="pCellBody">
Links a message destination reference or message-driven bean to a message destination. For example, if the <code class="cCode">&lt;message-destination&gt;</code> element has the <code class="cCode">&lt;message-destination-name&gt;</code> value <code class="cCode">PhysicalTopic</code>, specify <code class="cCode">PhysicalTopic</code> as the value of the <code class="cCode">&lt;message-destination-link&gt;</code> element.
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp88950"> </a><div class="pCellBody">
<code class="cCode">&lt;message-destination&gt;</code>
</div>
</td>
    <td><a name="wp89067"> </a><div class="pCellBody">
Specifies a message destination. The logical destination described by this element is mapped to a physical destination by the Deployer. Contains a <code class="cCode">&lt;message-destination-name&gt;</code> element. In the J2EE Application Server, the name you specify here is the name of the destination you created with the <code class="cCode">asadmin create-jmsdest</code> command.
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp88946"> </a><div class="pCellBody">
<code class="cCode">&lt;message-destination-name&gt;</code>
</div>
</td>
    <td><a name="wp89094"> </a><div class="pCellBody">
Specifies a name for a message destination.
</div>
</td>
</tr>
</table>
</div>
<p class="pBody">
</p>
<a name="wp89133"> </a><h4 class="pHeading3">
Deployment Descriptor Elements for Message-Driven Beans
</h4>
<a name="wp89459"> </a><p class="pBody">
The deployment descriptor for a message-driven bean is similar to the deployment descriptor for a session or entity bean in many respects. It includes the messaging-specific elements listed in <a  href="JMS7.html#wp89139">Table 29-4</a>. The XML Schema files used by the J2EE Application Server are in the directory <code class="cCode">&lt;</code><code class="cVariable">J2EE_HOME</code><code class="cCode">&gt;/lib/schemas/</code>.</p><div align="left">
<table border="1" summary="Deployment Descriptor Elements for Message-Driven Beans" id="wp89139">
  <caption><a name="wp89139"> </a><div class="pTableTitle">
Table 29-4   Deployment Descriptor Elements for Message-Driven Beans
</div>
</caption>
  <tr align="center">    <th><a name="wp89143"> </a><div class="pCellHeading">
Element Name
</div>
</th>
    <th><a name="wp89145"> </a><div class="pCellHeading">
Description
</div>
</th>
</tr>
  <tr align="left">    <td><a name="wp89147"> </a><div class="pCellBody">
<code class="cCode">&lt;message-driven&gt;</code>
</div>
</td>
    <td><a name="wp89149"> </a><div class="pCellBody">
Declares a message-driven bean within an <code class="cCode">&lt;enterprise-beans&gt;</code> element.
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp89151"> </a><div class="pCellBody">
<code class="cCode">&lt;messaging-type&gt;</code>
</div>
</td>
    <td><a name="wp89239"> </a><div class="pCellBody">
Specifies the message listener interface of the message-driven bean. If the <code class="cCode">&lt;messaging-type&gt;</code> element is not specified, it is assumed to be <code class="cCode">javax.jms.MessageListener</code>.
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp89155"> </a><div class="pCellBody">
<code class="cCode">&lt;message-destination-type&gt;</code>
</div>
</td>
    <td><a name="wp89157"> </a><div class="pCellBody">
Specifies the type of the destination. The type is specified by the Java interface expected to be implemented by the destination, such as <code class="cCode">javax.jms.Topic</code>.
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp89159"> </a><div class="pCellBody">
<code class="cCode">&lt;message-destination-link&gt;</code>
</div>
</td>
    <td><a name="wp89161"> </a><div class="pCellBody">
Links a message destination reference or message-driven bean to a message destination.
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp89163"> </a><div class="pCellBody">
<code class="cCode">&lt;activation-config&gt;</code>
</div>
</td>
    <td><a name="wp89326"> </a><div class="pCellBody">
Defines information about the expected configuration properties of the message-driven bean in its operational environment. This may include information about message acknowledgement, message selector, expected destination type, and so on. For details, see <a  href="JMS7.html#wp89449">Specifying Activation Configuration Properties for Message-Driven Beans</a>. Contains a set of <code class="cCode">&lt;activation-config-property&gt;</code> elements.
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp89167"> </a><div class="pCellBody">
<code class="cCode">&lt;activation-config-property&gt;</code>
</div>
</td>
    <td><a name="wp89348"> </a><div class="pCellBody">
Contains an <code class="cCode">&lt;activation-config-property-name&gt;</code> and <code class="cCode">&lt;activation-config-property-value&gt;</code> pair for a message-driven bean.
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp89171"> </a><div class="pCellBody">
<code class="cCode">&lt;activation-config-property-name&gt;</code>
</div>
</td>
    <td><a name="wp89365"> </a><div class="pCellBody">
Contains the name for an activation configuration property of a message-driven bean.
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp89175"> </a><div class="pCellBody">
<code class="cCode">&lt;activation-config-property-value&gt;</code>
</div>
</td>
    <td><a name="wp89371"> </a><div class="pCellBody">
Contains the value for an activation configuration property of a message-driven bean.
</div>
</td>
</tr>
</table>
</div>
<p class="pBody">
</p>
<a name="wp89136"> </a><h4 class="pHeading3">
Deployment Descriptor Elements Specified at Runtime
</h4>
<a name="wp89463"> </a><p class="pBody">
The runtime deployment descriptors for an application specify the runtime linkages between the connection factories and destinations specified in source code and the actual resources in the JNDI namespace. Runtime deployment descriptors vary from one application server to another. This section describes the elements used in the J2EE Application Server runtime deployment descriptors, which are named <code class="cCode">sun-application.xml</code>, <code class="cCode">sun-application-client.xml</code>, <code class="cCode">sun-ejb-jar.xml</code>, and so on. The Document Type Definitions (DTDs) for these deployment descriptors are in the directory <code class="cCode">&lt;</code><code class="cVariable">J2EE_HOME</code><code class="cCode">&gt;/lib/dtds/</code>.
</p>
<a name="wp89549"> </a><p class="pBody">
<a  href="JMS7.html#wp89473">Table 29-5</a> lists these elements.</p><div align="left">
<table border="1" summary="Runtime Deployment Descriptor Elements" id="wp89473">
  <caption><a name="wp89473"> </a><div class="pTableTitle">
Table 29-5   Runtime Deployment Descriptor Elements
</div>
</caption>
  <tr align="center">    <th><a name="wp89477"> </a><div class="pCellHeading">
Element Name
</div>
</th>
    <th><a name="wp89479"> </a><div class="pCellHeading">
Description
</div>
</th>
</tr>
  <tr align="left">    <td><a name="wp89481"> </a><div class="pCellBody">
<code class="cCode">&lt;mdb-connection-factory&gt;</code>
</div>
</td>
    <td><a name="wp89697"> </a><div class="pCellBody">
Specifies the connection factory associated with the message-driven bean.
</div>