| <?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 session beans with XDoclet annotation support</title> |
| </head> |
| <body id="tesessb"><a name="tesessb"><!-- --></a> |
| |
| <h1 class="topictitle1">Creating session beans with XDoclet annotation support</h1> |
| <div><p>You can use a wizard to create a session 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 session 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>. The Create an Enterprise |
| Bean wizard appears.</span></li> |
| <li class="stepexpand"><span>Select the <b>SessionBean</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 session 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>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 the <b>State type</b> for the new bean:</span><ul><li>A <b>Stateful</b> session bean maintains client-specific |
| session information, or conversational state, across multiple method calls |
| and transactions. An instance of a stateful session bean has a unique identity |
| that is assigned by the container at create time.</li> |
| <li>A <b>Stateless</b> session bean does not maintain |
| conversational state. Instances of a stateless session bean have no conversational |
| state. All instances of a stateless session bean have the same object identifier, |
| which is assigned by the container.</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> |