| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" |
| "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| <!-- |
| |
| Licensed to the Apache Software Foundation (ASF) under one |
| or more contributor license agreements. See the NOTICE file |
| distributed with this work for additional information |
| regarding copyright ownership. The ASF licenses this file |
| to you under the Apache License, Version 2.0 (the |
| "License"); you may not use this file except in compliance |
| with the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, |
| software distributed under the License is distributed on an |
| "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| KIND, either express or implied. See the License for the |
| specific language governing permissions and limitations |
| under the License. |
| |
| --> |
| <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr"> |
| <head> |
| <title>web.xml Visual Editor: Message Destination References</title> |
| <link rel="stylesheet" href="ide.css" title="Oracle BLAFDoc" type="text/css"/> |
| </head> |
| |
| <body> |
| <p><a id="dd_multiview_references_messageDestRefsNode" name="dd_multiview_references_messageDestRefsNode"></a></p> |
| <div id="NBCSH3853"><!-- infolevel="all" infotype="General" --><a id="sthref521" name="sthref521"></a> |
| <h1>web.xml Visual Editor: Message Destination References</h1> |
| <a name="BEGIN" id="BEGIN"></a> |
| <p>Use the Message Destination References section to add, remove, and view the web application's message destination references. |
| <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"> |
| <param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1114"> |
| <param name="text" value="<html><u>How?</u></html>"> |
| <param name="textFontSize" value="medium"> |
| <param name="textColor" value="blue"> |
| </object> |
| </p> |
| <p>The J2EE specification lets J2EE components refer to message destination objects by using logical names called message destination references. A message destination reference points to a message destination that can be defined in an EJB module, application client module, or web module.</p> |
| <p>To declare a message destination reference, you must register it in the <code dir="ltr">web.xml</code> file. When you do this, you provide information needed by the server to use the resource reference.</p> |
| <p>In the Visual Editor, click <b>References</b> at the top of the editor to open the References section, then click the Message Destination References header to open the Message Destination References section. |
| <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"> |
| <param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1114"> |
| <param name="text" value="<html><u>How?</u></html>"> |
| <param name="textFontSize" value="medium"> |
| <param name="textColor" value="blue"> |
| </object> |
| </p> |
| <p>Click <b>Add</b> to define a message destination reference element with the following properties:</p> |
| |
| <table summary="User interface elements and descriptions" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> |
| <col width="24%" /> |
| <col width="*" /> |
| <thead> |
| <tr align="left" valign="top"> |
| <th align="left" valign="bottom" id="r1c1-t18">Element</th> |
| <th align="left" valign="bottom" id="r1c2-t18">Description</th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr align="left" valign="top"> |
| <td align="left" id="r2c1-t18" headers="r1c1-t18"> |
| <p>Reference Name</p> |
| </td> |
| <td align="left" headers="r2c1-t18 r1c2-t18">Specifies the reference's name, such as <code dir="ltr">myDataSource</code>. Note that the name of the message destination reference is relative to the <code dir="ltr">java:comp/env context</code>. For example, the name should be <code dir="ltr">jms/MyBidQueue</code> and not <code dir="ltr">java:comp/env/jms/MyBidQueue</code>.</td> |
| </tr> |
| <tr align="left" valign="top"> |
| <td align="left" id="r3c1-t18" headers="r1c1-t18"> |
| <p>Reference Type</p> |
| </td> |
| <td align="left" headers="r3c1-t18 r1c2-t18">Specifies the expected type of the referenced destination, either <code dir="ltr">java.jms.Queue</code> or <code dir="ltr">java.jms.Topic</code>.</td> |
| </tr> |
| <tr align="left" valign="top"> |
| <td align="left" id="r4c1-t18" headers="r1c1-t18"> |
| <p>Usage</p> |
| </td> |
| <td align="left" headers="r4c1-t18 r1c2-t18">Specifies what the message destination does to messages: consumes, produces, or both.</td> |
| </tr> |
| <tr align="left" valign="top"> |
| <td align="left" id="r5c1-t18" headers="r1c1-t18"> |
| <p>Link to Message Destination</p> |
| </td> |
| <td align="left" headers="r5c1-t18 r1c2-t18">Name of the message destination.</td> |
| </tr> |
| <tr align="left" valign="top"> |
| <td align="left" id="r6c1-t18" headers="r1c1-t18"> |
| <p>Description</p> |
| </td> |
| <td align="left" headers="r6c1-t18 r1c2-t18">Specifies a description for the reference.</td> |
| </tr> |
| </tbody> |
| </table> |
| <br /> |
| <!-- --> |
| <a id="NBCSH3859" name="NBCSH3859"></a> |
| <hr><p><b>Related Topics</b></p> |
| <p><i>Developing Applications with NetBeans IDE</i>, |
| <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"> |
| <param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG2812"> |
| <param name="text" value="<html><u>"About Deployment Descriptors"</u></html>"> |
| <param name="textFontSize" value="medium"> |
| <param name="textColor" value="blue"> |
| </object> |
| </p> |
| <p><i>Developing Applications with NetBeans IDE</i>, |
| <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"> |
| <param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1111"> |
| <param name="text" value="<html><u>"Configuring a Web Application"</u></html>"> |
| <param name="textFontSize" value="medium"> |
| <param name="textColor" value="blue"> |
| </object> |
| </p> |
| |
| <!-- --> |
| <!-- Start Footer --> |
| |
| |
| <table summary="" cellspacing="0" cellpadding="0" width="100%"> |
| <tr> |
| <td align="left" width="86%"><a href="legal_notice.htm"> |
| Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements; and to You under the Apache License, Version 2.0.</a> |
| </td> |
| </tr> |
| </table> |
| <!-- --> |
| </body> |
| </html> |