| <?xml version="1.0" encoding="UTF-8"?> |
| <!DOCTYPE html |
| PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| <html lang="en-us" xml:lang="en-us"> |
| <head> |
| <!-- /******************************************************************************* |
| * Copyright (c) 2000, 2005 IBM Corporation and others. |
| * All rights reserved. This program and the accompanying materials |
| * are made available under the terms of the Eclipse Public License v1.0 |
| * which accompanies this distribution, and is available at |
| * http://www.eclipse.org/legal/epl-v10.html |
| * |
| * Contributors: |
| * IBM Corporation - initial API and implementation |
| *******************************************************************************/ --> |
| <link rel="stylesheet" type="text/css" href="../../org.eclipse.wst.doc.user/common.css" /> |
| <title>Creating message-driven beans with XDoclet annotation support</title> |
| </head> |
| <body id="temessb"><a name="temessb"><!-- --></a> |
| |
| <h1 class="topictitle1">Creating message-driven beans with XDoclet annotation support</h1> |
| <div><p>You can use a wizard to create a message-driven bean and add it |
| to your project.</p> |
| <div class="p">Before you can create an enterprise bean, you must:<ul><li>Define an EJB project to contain the enterprise bean. See <a href="tecrtpro.html">Creating EJB projects</a>.</li> |
| <li>Install XDoclet annotation support and enable it. See <a href="txdocletconf.html">Configuring XDoclet annotation support</a>.</li> |
| </ul> |
| </div> |
| <div class="section"><p>To create a message-driven bean:</p> |
| </div> |
| <ol><li class="stepexpand"><span>In the |
| J2EE perspective, click <b>File</b> > <b>New</b> > <b>Other</b> > <b>EJB</b> > <b>XDoclet Enterprise JavaBean</b></span>. |
| The Create Enterprise JavaBean wizard appears.</li> |
| <li class="stepexpand"><span>Select the <b>MessageDrivenBean</b> radio button.</span></li> |
| <li class="stepexpand"><span>Click <b>Next</b>.</span></li> |
| <li class="stepexpand"><span>Select the <b>Project</b> that will contain the |
| new bean.</span></li> |
| |
| <li class="stepexpand"><span>In the <b>Folder</b> field, select the folder for |
| the new bean.</span></li> |
| <li class="stepexpand"><span>In the <b>Java package</b> field, enter the package |
| name for the new bean.</span></li> |
| <li class="stepexpand"><span>In the <strong>Class name</strong> field, type a name for the enterprise |
| bean. By convention, bean names should begin with an uppercase letter.</span> <div class="note"><b>Note: </b>You can use Unicode characters for the bean name, but Unicode |
| characters are not supported for enterprise bean packages and classes associated |
| with enterprise beans.</div> |
| </li> |
| <li class="stepexpand"><span>Change the <b>Superclass</b> for the bean if you |
| want it to inherit from a class other than <samp class="codeph">java.lang.Object</samp>.</span></li> |
| |
| <li class="stepexpand"><span>Click <b>Next</b>.</span></li> |
| <li class="stepexpand"><span>Provide an <b>EJB Name</b> for the bean.</span> This is the name of the enterprise bean class.</li> |
| <li class="stepexpand"><span>Provide an <b>Destination JNDI Name</b> for the bean.</span> This is a logical name used by the server to locate an enterprise bean |
| at runtime.</li> |
| <li class="stepexpand"><span>Provide an <b>Display Name</b> for the bean.</span> This is a short name for the enterprise bean that is used by tools.</li> |
| <li class="stepexpand"><span>Provide a text <b>Description</b> for the bean.</span></li> |
| <li class="stepexpand"><span>Select a <b>Destination</b> for the new bean: </span><ul><li><b>Queue</b> specifies that the point-to-point JMS messaging model will be used.</li> |
| <li><b>Topic</b> specifies that the publish-and-subscribe JMS messaging model will be used.</li></ul></li> |
| <li class="stepexpand"><span>Select a <b>Transaction Type</b> for the new bean:</span><ul><li><b>Container</b> specifies that the transaction demarcation |
| is performed by the container.</li> |
| <li><b>Bean</b> specifies that the transaction demarcation |
| is performed by the bean.</li> |
| </ul> |
| </li> |
| <li class="stepexpand"><span>Click <b>Next</b>.</span></li> |
| <li class="stepexpand"><span>Select the type of <b>Modifiers</b> to use for |
| the class. Choices are <b>Public</b>, <b>Abstract</b>, |
| and <b>Final</b>.</span></li> |
| <li class="stepexpand"><span>Select the <b>Interfaces</b> you want the bean |
| to implement:</span><ul><li>Click the <b>Add</b> button to open the Type Selection |
| dialog box where you can select the interface that you want to implement.</li> |
| <li>If you added an interface that you no longer want to implement, select |
| the interface in the list and click <strong>Remove</strong>.</li> |
| </ul> |
| </li> |
| <li class="stepexpand"><span>Select the method stubs that you want the wizard to create. Choices |
| include <b>main</b>, <b>Inherited abstract methods</b>, |
| and <b>Constructors from the superclass</b>.</span></li> |
| <li class="stepexpand"><span>Click <b>Finish</b>.</span> The new bean |
| is added to the specified EJB project.</li> |
| </ol> |
| </div> |
| <p> |
| (C) Copyright IBM Corporation 2000, 2005. All Rights Reserved. |
| </p> |
| </body> |
| </html> |