cb6.html

j2eePDF格式的电子书

</p>
<a name="wp66019"> </a><p class="pBodyRelative">
<code class="cCode">run-test-price:<br />run-test-client:<br />&nbsp;&nbsp;[java] 07/21/03 08/20/03<br />&nbsp;&nbsp;[java] Kona 6.50<br />&nbsp;&nbsp;[java] French Roast 5.00<br />&nbsp;&nbsp;[java] Wake Up Call 5.50<br />&nbsp;&nbsp;[java] Mocca 4.00</code>
</p>
</ol></div>
<a name="wp87471"> </a><h3 class="pHeading2">
Building, Packaging, and Deploying the SAAJ Service
</h3>
<a name="wp66021"> </a><p class="pBody">
To build the SAAJ service and client library and package and deploy the SAAJ service: 
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp66022"> </a><div class="pSmartList1"><li>In a terminal window, go to <code class="cCode">&lt;</code><code class="cVariable">INSTALL</code><code class="cCode">&gt;/j2eetutorial14/examples/cb/saaj/</code>.</li></div>
<a name="wp82676"> </a><div class="pSmartList1"><li>Run <code class="cCode">asant</code> <code class="cCode">build</code>. This task creates the client library and compiles the server classes.</li></div>
<a name="wp82678"> </a><div class="pSmartList1"><li>Make sure the J2EE application server is started.</li></div>
<a name="wp106398"> </a><div class="pSmartList1"><li>Start <code class="cCode">deploytool</code>.</li></div>
<a name="wp106399"> </a><div class="pSmartList1"><li>Create a standalone Web module called <code class="cCode">saaj-coffee-supplier in &lt;</code><code class="cVariable">INSTALL</code><code class="cCode">&gt;/j2eetutorial14/examples/cb/saaj/</code>.</li></div>
<a name="wp106400"> </a><div class="pSmartList1"><li>Set the context root to <code class="cCode">/saaj-coffee-supplier</code>.</li></div>
<a name="wp106401"> </a><div class="pSmartList1"><li>Add the <code class="cCode">com</code> directory under <code class="cCode">&lt;</code><code class="cVariable">INSTALL</code><code class="cCode">&gt;/j2eetutorial14/examples/cb/saaj/build/server/</code> to the module. </li></div>
<a name="wp106402"> </a><div class="pSmartList1"><li>Add the <code class="cCode">ConfirmationServlet</code> Web component. Choose the Servlet component type.</li></div>
<a name="wp106403"> </a><div class="pSmartList1"><li>Add the alias <code class="cCode">/orderCoffee </code>to the <code class="cCode">ConfirmationServlet</code> Web component.</li></div>
<a name="wp106404"> </a><div class="pSmartList1"><li>Add the <code class="cCode">PriceListServlet</code> Web component to the existing <code class="cCode">saaj-coffee-supplier</code> WAR.</li></div>
<a name="wp106405"> </a><div class="pSmartList1"><li>Add the alias <code class="cCode">/getPriceList</code> to the <code class="cCode">PriceListServlet</code> Web component.</li></div>
<a name="wp106406"> </a><div class="pSmartList1"><li>Save the module.</li></div>
<a name="wp106407"> </a><div class="pSmartList1"><li>Deploy the module.</li></div>
<a name="wp66026"> </a><div class="pSmartList1"><li>Test that the SAAJ service has been deployed correctly by running one or both of the test programs <code class="cCode">asant</code> <code class="cCode">run-test-price and asant</code> <code class="cCode">run-test-order</code>.</li></div>
</ol></div>
<a name="wp66027"> </a><h3 class="pHeading2">
Building, Packaging, and Deploying the Coffee Break Server
</h3>
<a name="wp66028"> </a><p class="pBody">
To build, package, and deploy the Coffee Break server: 
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp66029"> </a><div class="pSmartList1"><li>In a terminal window, go to <code class="cCode">&lt;</code><code class="cVariable">INSTALL</code><code class="cCode">&gt;/j2eetutorial14/examples/cb/server/</code>.</li></div>
<a name="wp66030"> </a><div class="pSmartList1"><li>Run <code class="cCode">asant</code> <code class="cCode">build</code>. This task compiles the server classes and copies the classes, JSP pages, and tag libraries into the correct location for packaging.</li></div>
<a name="wp66031"> </a><div class="pSmartList1"><li>Make sure the J2EE server is started.</li></div>
<a name="wp106462"> </a><div class="pSmartList1"><li>Start deploytool.</li></div>
<a name="wp106463"> </a><div class="pSmartList1"><li>Create a standalone Web module called <code class="cCode">cbserver in &lt;</code><code class="cVariable">INSTALL</code><code class="cCode">&gt;/j2eetutorial14/examples/cb/server/</code>.</li></div>
<a name="wp106464"> </a><div class="pSmartList1"><li>Set the context root to <code class="cCode">/cbserver</code>.</li></div>
<a name="wp106465"> </a><div class="pSmartList1"><li>Add the content to the Web module.</li></div>
<div class="pSmartList2"><ol type="a" class="pSmartList2">
<a name="wp106466"> </a><div class="pSmartList2"><li>Add all the JSP pages, <code class="cCode">tutorial-template.tld</code>, and the <code class="cCode">template</code> and <code class="cCode">com</code> directories under <code class="cCode">&lt;</code><code class="cVariable">INSTALL</code><code class="cCode">&gt;/j2eetutorial14/examples/cb/server/build/</code> to the module.</li></div>
<a name="wp106467"> </a><div class="pSmartList2"><li>In the Web module contents editor, drag the <code class="cCode">com</code> directory (containing <code class="cCode">sun/cb/CoffeeBreak.properties</code>) from the context root to <code class="cCode">WEB-INF/classes</code>.</li></div>
<a name="wp106468"> </a><div class="pSmartList2"><li>Add the JAX-RPC client library in <code class="cCode">&lt;</code><code class="cVariable">INSTALL</code><code class="cCode">&gt;/j2eetutorial14/examples/cb/jaxrpc/dist/jaxrpc-client.jar</code> to the module.</li></div>
<a name="wp106469"> </a><div class="pSmartList2"><li>Add the SAAJ client library in <code class="cCode">&lt;</code><code class="cVariable">INSTALL</code><code class="cCode">&gt;/j2eetutorial14/examples/cb/saaj/dist/saaj-client.jar</code> to the module.</li></div>
</ol></div>
<a name="wp106470"> </a><div class="pSmartList1"><li>Create a <code class="cCode">Dispatcher</code> Web component. Choose the Servlet component type.</li></div>
<a name="wp106471"> </a><div class="pSmartList1"><li>Add the aliases <code class="cCode">/orderForm</code>., <code class="cCode">/checkoutForm</code> and <code class="cCode">/checkoutAck</code> to the <code class="cCode">Dispatcher</code> component.</li></div>
<a name="wp106472"> </a><div class="pSmartList1"><li>Add the <code class="cCode">RetailPriceListServlet</code> Web component to the existing <code class="cCode">cbserver</code> WAR.</li></div>
<a name="wp106473"> </a><div class="pSmartList1"><li>Add the alias <code class="cCode">/loadPriceList</code> to the <code class="cCode">RetailPriceListServlet</code> component.</li></div>
<a name="wp106474"> </a><div class="pSmartList1"><li>Add a resource reference of type <code class="cCode">javax.xml.registry.ConnectionFactory </code>named <code class="cCode">eis/JAXR</code> mapped to the JAXR connection factory <code class="cCode">eis/JAXR</code>. </li></div>
<a name="wp106475"> </a><div class="pSmartList1"><li>Add a JSP property group named <code class="cCode">cbserver</code>. The property group applies to the URL pattern <code class="cCode">*.jsp</code>. Add the include prelude <code class="cCode">/template/prelude.jspf</code>.</li></div>
<a name="wp106476"> </a><div class="pSmartList1"><li>Add a context parameter named <code class="cCode">javax.servlet.jsp.jstl.fmt.localizationContext</code> and value <code class="cCode">com.sun.cb.messages.CBMessages</code>.</li></div>
<a name="wp106477"> </a><div class="pSmartList1"><li>Specify a security constraint for <code class="cCode">RetailPriceListServlet</code>.</li></div>
<div class="pSmartList2"><ol type="a" class="pSmartList2">
<a name="wp106478"> </a><div class="pSmartList2"><li>Select Basic as the User Authentication Method.</li></div>
<a name="wp106479"> </a><div class="pSmartList2"><li>Add a security constraint and a web resource collection. Use the default names provided by <code class="cCode">deploytool</code>.</li></div>
<a name="wp106480"> </a><div class="pSmartList2"><li>Add<code class="cCode"> com.sun.cb.RetailPriceListServlet</code> to the web resource collection. </li></div>
<a name="wp106481"> </a><div class="pSmartList2"><li>Select the GET HTTP method.</li></div>
<a name="wp106482"> </a><div class="pSmartList2"><li>Add the security role <code class="cCode">admin</code>.</li></div>
</ol></div>
<a name="wp106483"> </a><div class="pSmartList1"><li>Map the <code class="cCode">admin</code> role to the <code class="cCode">admin</code> user.</li></div>
<a name="wp106484"> </a><div class="pSmartList1"><li>Save the module.</li></div>
<a name="wp106485"> </a><div class="pSmartList1"><li>Deploy the module.</li></div>
</ol></div>
<a name="wp66033"> </a><h3 class="pHeading2">
Running the Coffee Break Client
</h3>
<a name="wp91815"> </a><p class="pBody">
After you have installed all the Web applications, check that all the applications are running in deploytool or the Admin Console. You should see <code class="cCode">cbserver</code>, <code class="cCode">jaxrpc-coffee-supplier</code>, and <code class="cCode">saaj-coffee-supplier</code> in the list of applications.
</p>
<a name="wp69552"> </a><p class="pBody">
Then, to run the Coffee Break client, open the Coffee Break server URL in a Web browser:
</p>
<div class="pPreformattedRelative"><pre class="pPreformattedRelative">
http://localhost:8080/cbserver/orderForm<a name="wp69553"> </a>
</pre></div>
<a name="wp69557"> </a><p class="pBody">
You should see a page something like the one shown in <a  href="CB6.html#wp66060">Figure 31-2</a>.
</p>
<a name="wp66058"> </a><p class="pBody">
</p><div align="left"><img src="images/orderForm2.gif" height="428" width="392" alt="Coffee Break Order Form" border="0" hspace="0" vspace="0"/>
</div><p class="pBody">
</p>

<p>
  <a name="66060"> </a><strong><font >Figure 31-2    Order Form</font></strong>
</p>

<a name="wp66061"> </a><p class="pBody">
After you have gone through the application screens, you will get an order confirmation that looks like the one shown in <a  href="CB6.html#wp66070">Figure 31-3</a>.
</p>
<a name="wp66068"> </a><p class="pBody">
</p><div align="left"><img src="images/confirmation3.gif" height="373" width="384" alt="Coffee Break Order Confirmation" border="0" hspace="0" vspace="0"/>
</div><p class="pBody">
</p>

<p>
  <a name="66070"> </a><strong><font >Figure 31-3    Order Confirmation</font></strong>
</p>

<a name="wp74814"> </a><h3 class="pHeading2">
Removing the Coffee Break Application
</h3>
<a name="wp74815"> </a><p class="pBody">
To remove the Coffee Break application, perform the following steps:
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp106500"> </a><div class="pSmartList1"><li>Undeploy the JAX-RPC and SAAJ services and the Coffee Break server using <code class="cCode">deploytool</code> or the <code class="cCode">Admin Console</code>.</li></div>
<a name="wp91854"> </a><div class="pSmartList1"><li>Stop the J2EE application server.</li></div>
</ol></div>
<a name="wp74892"> </a><p class="pBody">
If you want to remove the <code class="cCode">build</code> and <code class="cCode">dist</code> directories, run <code class="cCode">ant</code> <code class="cCode">clean</code> in each directory, including <code class="cCode">&lt;</code><code class="cVariable">INSTALL</code><code class="cCode">&gt;/j2eetutorial14/examples/cb/common/</code>.
</p>
    </blockquote>

   <img src="images/blueline.gif" width="550" height="8" ALIGN="BOTTOM" NATURALSIZEFLAG="3" ALT="Divider">


    <table width="550" summary="layout" id="SummaryNotReq1">
      <tr>
	<td align="left" valign="center">
	<font size="-1">
	<a href="http://java.sun.com/j2ee/1.4/download.html#tutorial" target="_blank">Download</a>
	<br>
	<a href="http://java.sun.com/j2ee/1.4/docs/tutorial/information/faq.html" target="_blank">FAQ</a>
	<br>
	<a href="http://java.sun.com/j2ee/1.4/docs/tutorial/information/history.html" target="_blank">History</a>
	</td>
        <td align="center" valign="center">
<a accesskey="p" href="CB5.html"><img id="LongDescNotReq1" src="images/PrevArrow.gif" width="26" height="26" border="0" alt="Prev" /></a><a accesskey="c" href="J2EETutorialFront.html"><img id="LongDescNotReq1" src="images/UpArrow.gif" width="26" height="26" border="0" alt="Home" /></a><a accesskey="n" href="Ebank.html"><img id="LongDescNotReq3" src="images/NextArrow.gif" width="26" height="26" border="0" alt="Next" /></a><a accesskey="i" href="J2EETutorialIX.html"></a>
        </td>
	<td align="right" valign="center">
	<font size="-1">
	<a href="http://java.sun.com/j2ee/1.4/docs/api/index.html" target="_blank">API</a>
	<br>
	<a href="http://java.sun.com/j2ee/1.4/docs/tutorial/information/search.html" target="_blank">Search</a>
	<br>
	<a href="http://java.sun.com/j2ee/1.4/docs/tutorial/information/sendusmail.html" target="_blank">Feedback</a></font>
	</font>
	</td>
      </tr>
    </table>

    <img src="images/blueline.gif" width="550" height="8" ALIGN="BOTTOM" NATURALSIZEFLAG="3" ALT="Divider">

<p><font size="-1">All of the material in <em>The J2EE(TM) 1.4 Tutorial</em> is 
<a href="J2EETutorialFront2.html">copyright</a>-protected and may not be published in other works
without express written permission from Sun Microsystems.</font>

  </body>
</html>