[metro~svn:841] update docs

  • From: snajper@...
  • To: commits@...
  • Subject: [metro~svn:841] update docs
  • Date: Thu, 13 Jun 2013 22:29:05 +0000

Project:    metro
Repository: svn
Revision:   841
Author:     snajper
Date:       2013-06-13 22:29:03 UTC
Link:       

Log Message:
------------
update docs


Revisions:
----------
841


Modified Paths:
---------------
trunk/www/2.3/guide/ch20.html
trunk/www/2.3/guide/index.html
trunk/www/2.3/guide/ch13.html
trunk/www/2.3/guide/ch06.html
trunk/www/2.3/guide/ch08.html
trunk/www/2.3/guide/ch05.html
trunk/www/2.3/guide/ch02.html
trunk/www/2.3/guide/ch04.html
trunk/www/2.3/guide/ch12.html
trunk/www/2.3/guide/ch18.html
trunk/www/2.3/guide/ch09.html
trunk/www/2.3/guide/ch14.html
trunk/www/2.3/guide/ch21.html
trunk/www/2.3/guide/ch15.html
trunk/www/2.3/guide/user-guide.pdf
trunk/www/2.3/guide/user-guide.html
trunk/www/2.3/guide/ch10.html
trunk/www/2.3/guide/ch16.html
trunk/www/2.3/guide/ch19.html
trunk/www/2.3/guide/ch03.html
trunk/www/2.3/guide/ch11.html


Diffs:
------
Index: trunk/www/2.3/guide/user-guide.html
===================================================================
--- trunk/www/2.3/guide/user-guide.html (revision 840)
+++ trunk/www/2.3/guide/user-guide.html (revision 841)
@@ -13,7 +13,7 @@
 </script></head><body bgcolor="white" text="black" link="#0000FF" 
vlink="#840084" alink="#0000FF"><small 
xmlns:fo="http://www.w3.org/1999/XSL/Format" class="small";>Links: <a 
href="index.html">Table of Contents</a> | <a href="user-guide.html">Single 
HTML</a> | <a href="user-guide.pdf">Single PDF</a></small><div lang="en" 
class="book" title="Metro User Guide"><div class="titlepage"><div><div><h1 
class="title"><a name="user-guide"></a>Metro User 
Guide</h1></div></div><hr></div><div class="toc"><p><b>Table of 
Contents</b></p><dl><dt><span class="preface"><a 
href="#preface">Preface</a></span></dt><dt><span class="chapter"><a 
href="#ahiaj">1. Introduction to Metro</a></span></dt><dd><dl><dt><span 
class="section"><a href="#ahiae">1.1. Required 
Software</a></span></dt><dt><span class="section"><a href="#ahiak">1.2. What 
is WSIT?</a></span></dt><dd><dl><dt><span class="section"><a 
href="#ahiam">1.2.1. Bootstrapping and Configuration</a></span></dt><dt><span 
class="section"><a href="#ahiao">1
 .2.2. Message Optimization Technology</a></span></dt><dt><span 
class="section"><a href="#ahiap">1.2.3. Reliable Messaging 
Technology</a></span></dt><dt><span class="section"><a href="#ahiaq">1.2.4. 
Security Technology</a></span></dt></dl></dd><dt><span class="section"><a 
href="#ahiar">1.3. How Metro Relates to .NET Windows Communication Foundation
         (WCF)</a></span></dt><dt><span class="section"><a href="#ahias">1.4. 
Metro Specifications</a></span></dt><dd><dl><dt><span class="section"><a 
href="#ahiat">1.4.1. Bootstrapping and Configuration 
Specifications</a></span></dt><dt><span class="section"><a 
href="#ahiav">1.4.2. Message Optimization 
Specifications</a></span></dt><dt><span class="section"><a 
href="#ahiax">1.4.3. Reliable Messaging 
Specifications</a></span></dt><dt><span class="section"><a 
href="#ahiaz">1.4.4. Security 
Specifications</a></span></dt></dl></dd><dt><span class="section"><a 
href="#ahibb">1.5. How the Metro Technologies 
Work</a></span></dt><dd><dl><dt><span class="section"><a href="#ahibc">1.5.1. 
How Message Optimization Works</a></span></dt><dt><span class="section"><a 
href="#ahibd">1.5.2. How Reliable Messaging Works</a></span></dt><dt><span 
class="section"><a href="#ahibg">1.5.3. How Security 
Works</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a 
href="#using-metro">2. Using Metro</a><
 /span></dt><dd><dl><dt><span class="section"><a href="#metro-tools">2.1. 
Metro Tools</a></span></dt><dd><dl><dt><span class="section"><a 
href="#useful-tools-for-your-toolbox">2.1.1. Useful tools for your 
toolbox</a></span></dt></dl></dd><dt><span class="section"><a 
href="#using-mavenized-metro-binaries">2.2. Using Mavenized Metro 
Binaries</a></span></dt><dd><dl><dt><span class="section"><a 
href="#using-metro-in-a-maven-project">2.2.1. Using Metro in a Maven 
project</a></span></dt><dt><span class="section"><a 
href="#using-metro-in-a-non-maven-project">2.2.2. Using Metro in a non-Maven 
project</a></span></dt></dl></dd><dt><span class="section"><a 
href="#using_metro-developing_with_nb">2.3. Developing with 
NetBeans</a></span></dt><dd><dl><dt><span class="section"><a 
href="#ahibo">2.3.1. Registering GlassFish with the 
IDE</a></span></dt><dt><span class="section"><a href="#ahibp">2.3.2. Creating 
a Web Service</a></span></dt><dt><span class="section"><a 
href="#ahibq">2.3.3. Configuring Me
 tro's WSIT Features in the Web
             Service</a></span></dt><dt><span class="section"><a 
href="#ahibr">2.3.4. Deploying and Testing a Web 
Service</a></span></dt><dt><span class="section"><a 
href="#wsit_example_with_nb-creating_wsit_client">2.3.5. Creating a Client to 
Consume a WSIT-Enabled Web
-            Service</a></span></dt></dl></dd><dt><span class="section"><a 
href="#developing-with-eclipse">2.4. Developing with 
Eclipse</a></span></dt><dd><dl><dt><span class="section"><a 
href="#setup">2.4.1. Setup</a></span></dt><dt><span class="section"><a 
href="#create-a-metro-web-services-endpoint">2.4.2. Create a Metro Web 
Services Endpoint</a></span></dt><dt><span class="section"><a 
href="#creating-web-service-client-using-wsimport-cli">2.4.3. Creating Web 
Service Client using Wsimport CLI</a></span></dt><dt><span class="section"><a 
href="#creating-web-service-client-using-wsimport-ant-task">2.4.4. Creating 
Web Service Client using Wsimport Ant Task</a></span></dt><dt><span 
class="section"><a 
href="#creating-web-service-client-using-soap-ui-plugin">2.4.5. Creating Web 
Service Client using SOAP UI Plugin</a></span></dt></dl></dd><dt><span 
class="section"><a href="#logging">2.5. 
Logging</a></span></dt><dd><dl><dt><span class="section"><a 
href="#dynamic_tube-based_message_logging"
 >2.5.1. Dynamic tube-based message logging</a></span></dt><dt><span 
 >class="section"><a href="#dumping-soap-messages-on-client">2.5.2. Dumping 
 >SOAP messages on client</a></span></dt><dt><span class="section"><a 
 >href="#dumping-soap-messages-on-server">2.5.3. Dumping SOAP messages on 
 >server</a></span></dt></dl></dd><dt><span class="section"><a 
 >href="#using-jax-ws-2.x---metro-1.x-2.0-with-java-se-6">2.6. Using JAX-WS 
 >2.x / Metro 1.x/2.0 with Java SE 6</a></span></dt><dd><dl><dt><span 
 >class="section"><a href="#mustanga1">2.6.1. Using JAX-WS 2.x with Java SE 
 >6</a></span></dt><dt><span class="section"><a href="#mustanga2">2.6.2. 
 >Using Metro 1.x with Java SE 6</a></span></dt><dt><span class="section"><a 
 >href="#mustanga3">2.6.3. Using Metro 2.0 with Java SE 
 >6</a></span></dt></dl></dd><dt><span class="section"><a 
 >href="#deploying-metro-endpoint">2.7. Deploying Metro 
 >endpoint</a></span></dt><dd><dl><dt><span class="section"><a 
 >href="#the-war-contents">2.7.1. The WAR Contents</a></span></dt><dt
 ><span class="section"><a href="#using-sun-jaxws.xml">2.7.2. Using 
 >sun-jaxws.xml</a></span></dt><dt><span class="section"><a 
 >href="#using-109-deployment-descriptor">2.7.3. Using 109 Deployment 
 >Descriptor</a></span></dt><dt><span class="section"><a 
 >href="#using-spring">2.7.4. Using Spring</a></span></dt></dl></dd><dt><span 
 >class="section"><a href="#handlers-and-messagecontext">2.8. Handlers and 
 >MessageContext</a></span></dt><dd><dl><dt><span class="section"><a 
 >href="#messagecontext-in-jax-ws">2.8.1. MessageContext in 
 >JAX-WS</a></span></dt><dt><span class="section"><a 
 >href="#handlers-in-jax-ws">2.8.2. Handlers in 
 >JAX-WS</a></span></dt><dt><span class="section"><a 
 >href="#efficient-handlers-in-jax-ws-ri">2.8.3. Efficient Handlers in JAX-WS 
 >RI</a></span></dt></dl></dd><dt><span class="section"><a 
 >href="#deploying-jax-ws-with-...">2.9. Deploying Metro with 
 >...</a></span></dt><dd><dl><dt><span class="section"><a 
 >href="#weblogic-10">2.9.1. WebLogic 12</a></span></dt></dl></dd><dt><span 
 >clas
 s="section"><a 
href="#developing-client-application-with-locally-packaged-wsdl">2.10. 
Developing client application with locally packaged
+            Service</a></span></dt></dl></dd><dt><span class="section"><a 
href="#developing-with-eclipse">2.4. Developing with 
Eclipse</a></span></dt><dd><dl><dt><span class="section"><a 
href="#setup">2.4.1. Setup</a></span></dt><dt><span class="section"><a 
href="#create-a-metro-web-services-endpoint">2.4.2. Create a Metro Web 
Services Endpoint</a></span></dt><dt><span class="section"><a 
href="#creating-web-service-client-using-wsimport-cli">2.4.3. Creating Web 
Service Client using Wsimport CLI</a></span></dt><dt><span class="section"><a 
href="#creating-web-service-client-using-wsimport-ant-task">2.4.4. Creating 
Web Service Client using Wsimport Ant Task</a></span></dt><dt><span 
class="section"><a 
href="#creating-web-service-client-using-soap-ui-plugin">2.4.5. Creating Web 
Service Client using SOAP UI Plugin</a></span></dt></dl></dd><dt><span 
class="section"><a href="#logging">2.5. 
Logging</a></span></dt><dd><dl><dt><span class="section"><a 
href="#dynamic_tube-based_message_logging"
 >2.5.1. Dynamic tube-based message logging</a></span></dt><dt><span 
 >class="section"><a href="#dumping-soap-messages-on-client">2.5.2. Dumping 
 >SOAP messages on client</a></span></dt><dt><span class="section"><a 
 >href="#dumping-soap-messages-on-server">2.5.3. Dumping SOAP messages on 
 >server</a></span></dt></dl></dd><dt><span class="section"><a 
 >href="#using-jax-ws-2.x---metro-1.x-2.0-with-java-se-6">2.6. Using JAX-WS / 
 >Metro with Java SE</a></span></dt><dd><dl><dt><span class="section"><a 
 >href="#mustanga1">2.6.1. Using JAX-WS with Java SE</a></span></dt><dt><span 
 >class="section"><a href="#mustanga3">2.6.2. Using Metro with Java 
 >SE</a></span></dt></dl></dd><dt><span class="section"><a 
 >href="#deploying-metro-endpoint">2.7. Deploying Metro 
 >endpoint</a></span></dt><dd><dl><dt><span class="section"><a 
 >href="#the-war-contents">2.7.1. The WAR Contents</a></span></dt><dt><span 
 >class="section"><a href="#using-sun-jaxws.xml">2.7.2. Using 
 >sun-jaxws.xml</a></span></dt><dt><span class="section"><a h
 ref="#using-109-deployment-descriptor">2.7.3. Using 109 Deployment 
Descriptor</a></span></dt><dt><span class="section"><a 
href="#using-spring">2.7.4. Using Spring</a></span></dt></dl></dd><dt><span 
class="section"><a href="#handlers-and-messagecontext">2.8. Handlers and 
MessageContext</a></span></dt><dd><dl><dt><span class="section"><a 
href="#messagecontext-in-jax-ws">2.8.1. MessageContext in 
JAX-WS</a></span></dt><dt><span class="section"><a 
href="#handlers-in-jax-ws">2.8.2. Handlers in JAX-WS</a></span></dt><dt><span 
class="section"><a href="#efficient-handlers-in-jax-ws-ri">2.8.3. Efficient 
Handlers in JAX-WS RI</a></span></dt></dl></dd><dt><span class="section"><a 
href="#deploying-jax-ws-with-...">2.9. Deploying Metro with 
...</a></span></dt><dd><dl><dt><span class="section"><a 
href="#weblogic-10">2.9.1. WebLogic 12</a></span></dt></dl></dd><dt><span 
class="section"><a 
href="#developing-client-application-with-locally-packaged-wsdl">2.10. 
Developing client application with local
 ly packaged
         WSDL</a></span></dt><dd><dl><dt><span class="section"><a 
href="#service-api-to-pass-the-wsdl-information">2.10.1. Service API to pass 
the WSDL information</a></span></dt><dt><span class="section"><a 
href="#xml-catalog">2.10.2. Xml Catalog</a></span></dt><dt><span 
class="section"><a href="#using--wsdllocation-switch">2.10.3. Using 
-wsdlLocation switch</a></span></dt></dl></dd><dt><span class="section"><a 
href="#how-to-invoke-and-endpoint-by-overriding-endpoint-address-in-the-wsdl">2.11.
 How to invoke and endpoint by overriding endpoint address in
         the WSDL</a></span></dt><dd><dl><dt><span class="section"><a 
href="#bindingprovider.endpoint_address_property">2.11.1. 
BindingProvider.ENDPOINT_ADDRESS_PROPERTY</a></span></dt><dt><span 
class="section"><a href="#create-service-using-updated-wsdl">2.11.2. Create 
Service using updated WSDL</a></span></dt></dl></dd><dt><span 
class="section"><a href="#maintaining-state-in-web-services">2.12. 
Maintaining State in Web Services</a></span></dt><dt><span class="section"><a 
href="#fastinfoset">2.13. FastInfoset</a></span></dt><dd><dl><dt><span 
class="section"><a href="#using-fastinfoset">2.13.1. Using 
FastInfoset</a></span></dt></dl></dd><dt><span class="section"><a 
href="#using_metro-ha_support">2.14. High Availability Support in 
Metro</a></span></dt></dl></dd><dt><span class="chapter"><a 
href="#compiling-wsdl">3. Compiling WSDL</a></span></dt><dd><dl><dt><span 
class="section"><a 
href="#compiling-multiple-wsdls-that-share-a-common-schema">3.1. Compiling 
multiple WSDLs that share a co
 mmon schema</a></span></dt><dt><span class="section"><a 
href="#dealing-with-schemas-that-are-not-referenced">3.2. Dealing with 
schemas that are not referenced</a></span></dt><dt><span class="section"><a 
href="#customizing-xml-schema-binding">3.3. Customizing XML Schema 
binding</a></span></dt><dd><dl><dt><span class="section"><a 
href="#how-to-get-simple-and-better-typed-binding">3.3.1. How to get simple 
and better typed binding</a></span></dt></dl></dd><dt><span 
class="section"><a href="#generating-javadocs-from-wsdl-documentation">3.4. 
Generating Javadocs from WSDL documentation</a></span></dt><dt><span 
class="section"><a href="#passing-java-compiler-options-to-wsimport">3.5. 
Passing Java Compiler options to Wsimport</a></span></dt></dl></dd><dt><span 
class="chapter"><a href="#soap">4. SOAP</a></span></dt><dd><dl><dt><span 
class="section"><a href="#soap-headers">4.1. SOAP 
headers</a></span></dt><dd><dl><dt><span class="section"><a 
href="#adding-soap-headers-when-sending-requests">4.
 1.1. Adding SOAP headers when sending requests</a></span></dt><dt><span 
class="section"><a 
href="#accessing-soap-headers-for-incoming-messages">4.1.2. Accessing SOAP 
headers for incoming messages</a></span></dt><dt><span class="section"><a 
href="#adding-soap-headers-when-sending-replies">4.1.3. Adding SOAP headers 
when sending replies</a></span></dt><dt><span class="section"><a 
href="#mapping-additional-wsdl-headers-to-method-parameters">4.1.4. Mapping 
additional WSDL headers to method
             parameters</a></span></dt></dl></dd><dt><span class="section"><a 
href="#schema-validation">4.2. Schema 
Validation</a></span></dt><dd><dl><dt><span class="section"><a 
href="#server-side-schema-validation">4.2.1. Server Side Schema 
Validation</a></span></dt><dt><span class="section"><a 
href="#client-side-schema-validation">4.2.2. Client Side Schema 
Validation</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a 
href="#http">5. HTTP</a></span></dt><dd><dl><dt><span class="section"><a 
href="#http-headers">5.1. HTTP headers</a></span></dt><dd><dl><dt><span 
class="section"><a href="#sending-http-headers-on-request">5.1.1. Sending 
HTTP headers on request</a></span></dt><dt><span class="section"><a 
href="#accessing-http-headers-of-the-response">5.1.2. Accessing HTTP headers 
of the response</a></span></dt></dl></dd><dt><span class="section"><a 
href="#http-compression">5.2. HTTP compression</a></span></dt><dt><span 
class="section"><a href="#http-cookies">5.3. HTTP cooki
 es</a></span></dt><dd><dl><dt><span class="section"><a 
href="#enabling-cookie-support">5.3.1. Enabling cookie 
support</a></span></dt><dt><span class="section"><a 
href="#accessing-http-cookies-in-the-response">5.3.2. Accessing HTTP cookies 
in the response</a></span></dt><dt><span class="section"><a 
href="#accessing-http-cookies-on-the-server">5.3.3. Accessing HTTP cookies on 
the server</a></span></dt></dl></dd><dt><span class="section"><a 
href="#http-client-streaming-support">5.4. HTTP client streaming 
support</a></span></dt><dt><span class="section"><a 
href="#access-http-headers-in-a-handler">5.5. Access HTTP headers in a 
Handler</a></span></dt><dd><dl><dt><span class="section"><a 
href="#from-client-side-handler">5.5.1. From Client side 
handler</a></span></dt><dt><span class="section"><a 
href="#from-server-side-handler">5.5.2. From Server side 
handler</a></span></dt></dl></dd><dt><span class="section"><a 
href="#http-timeouts">5.6. HTTP Timeouts</a></span></dt><dt><span 
class="sectio
 n"><a href="#http-persistent-connections-keep-alive">5.7. HTTP Persistent 
Connections (keep-alive)</a></span></dt><dt><span class="section"><a 
href="#https-hostnameverifier">5.8. HTTPS 
HostnameVerifier</a></span></dt><dt><span class="section"><a 
href="#https-sslsocketfactory">5.9. HTTPS 
SSLSocketFactory</a></span></dt><dt><span class="section"><a 
href="#http-address-in-soapaddress-and-import-locations">5.10. HTTP address 
in soap:address and import locations</a></span></dt></dl></dd><dt><span 
class="chapter"><a href="#processing-large-data">6. Processing Large 
Data</a></span></dt><dd><dl><dt><span class="section"><a 
href="#receiving-large-soap-requests">6.1. Receiving large SOAP 
requests</a></span></dt><dd><dl><dt><span class="section"><a 
href="#providermessage">6.1.1. 
Provider&lt;Message&gt;</a></span></dt></dl></dd><dt><span class="section"><a 
href="#binary-attachments-mtom">6.2. Binary Attachments 
(MTOM)</a></span></dt><dd><dl><dt><span class="section"><a 
href="#mtom">6.2.1. MTOM<
 /a></span></dt><dt><span class="section"><a 
href="#enabling-mtom-on-server">6.2.2. Enabling MTOM on 
server</a></span></dt><dt><span class="section"><a 
href="#enabling-mtom-on-client">6.2.3. Enabling MTOM on 
client</a></span></dt><dt><span class="section"><a 
href="#mtom-threshold">6.2.4. MTOM threshold</a></span></dt><dt><span 
class="section"><a href="#net-interoperability">6.2.5. .NET 
interoperability</a></span></dt></dl></dd><dt><span class="section"><a 
href="#large-attachments">6.3. Large 
Attachments</a></span></dt><dd><dl><dt><span class="section"><a 
href="#client-side">6.3.1. Client Side</a></span></dt><dt><span 
class="section"><a href="#server-side">6.3.2. Server 
Side</a></span></dt><dt><span class="section"><a href="#configuration">6.3.3. 
Configuration</a></span></dt><dt><span class="section"><a 
href="#large-attachments-summary">6.3.4. Large Attachments 
Summary</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a 
href="#bootstrap_config">7. Bootstrapping and Configu
 ration</a></span></dt><dd><dl><dt><span class="section"><a 
href="#bootstrap_config-server_endpoint">7.1. What is a Server-Side 
Endpoint?</a></span></dt><dt><span class="section"><a 
href="#bootstrap_config-client_from_wsdl">7.2. Creating a Client from 
WSDL</a></span></dt><dt><span class="section"><a 
href="#bootstrap_config-client_from_wsdl_examples">7.3. Client From WSDL 
Examples</a></span></dt></dl></dd><dt><span class="chapter"><a 
href="#ahibx">8. Message Optimization</a></span></dt><dd><dl><dt><span 
class="section"><a href="#ahiby">8.1. Creating a MTOM Web 
Service</a></span></dt><dt><span class="section"><a href="#ahibz">8.2. 
Configuring Message Optimization in a Web Service</a></span></dt><dt><span 
class="section"><a href="#ahica">8.3. Deploying and Testing a Web Service 
with Message Optimization
@@ -52,10 +52,10 @@
                     libraries</a></dt><dt>21.5. <a 
href="#f0.2952713070263785">Netbeans 6.1 - Adding a 
Webservice</a></dt><dt>21.6. <a href="#f0.6896137896548253">Netbeans 6.5 - 
Creating a Web Application</a></dt><dt>21.7. <a 
href="#f0.44980859181463606">Netbeans 6.5 - Creating a Web 
Application</a></dt><dt>21.8. <a href="#f0.7488236063243116">Netbeans 6.5 - 
Creating a Web Application - Servers
                     and Settings</a></dt><dt>21.9. <a 
href="#f0.70966785130944">Netbeans 6.5 - Creating a Web Application - Spring
                     dependencies</a></dt><dt>21.10. <a 
href="#f0.12494192198301834">Netbeans 6.5 - Creating a Web Application - 
Adding
-                    libraries</a></dt><dt>21.11. <a 
href="#f0.8720359728656875">Netbeans 6.5 - Adding a Web 
Service</a></dt><dt>21.12. <a href="#f0.5173347854521261">Netbeans - Edit Web 
Service Attributes</a></dt></dl></div><div class="list-of-tables"><p><b>List 
of Tables</b></p><dl><dt>1.1. <a href="#gfrxa">Metro Specification 
Versions</a></dt><dt>2.1. <a href="#d0e2648">Endpoint 
attributes</a></dt><dt>3.1. <a href="#d0e3381"><code 
class="code">wsdl:documentation</code> to Javadoc mapping</a></dt><dt>6.1. <a 
href="#d0e3937">JAXB Mapping Rules</a></dt><dt>10.1. <a 
href="#endpoint_rm_config_options">Reliable Messaging Configuration Options 
for Service
+                    libraries</a></dt><dt>21.11. <a 
href="#f0.8720359728656875">Netbeans 6.5 - Adding a Web 
Service</a></dt><dt>21.12. <a href="#f0.5173347854521261">Netbeans - Edit Web 
Service Attributes</a></dt></dl></div><div class="list-of-tables"><p><b>List 
of Tables</b></p><dl><dt>1.1. <a href="#gfrxa">Metro Specification 
Versions</a></dt><dt>2.1. <a href="#d0e2567">Endpoint 
attributes</a></dt><dt>3.1. <a href="#d0e3300"><code 
class="code">wsdl:documentation</code> to Javadoc mapping</a></dt><dt>6.1. <a 
href="#d0e3856">JAXB Mapping Rules</a></dt><dt>10.1. <a 
href="#endpoint_rm_config_options">Reliable Messaging Configuration Options 
for Service
             Endpoint</a></dt><dt>10.2. <a 
href="#client_rm_config_options">Reliable Messaging Configuration Options for 
Service
             Client</a></dt><dt>10.3. <a 
href="#rm_assertion_namespaces">Namespaces used within Metro Reliable 
Messaging WS-Policy
-            Assertions</a></dt><dt>10.4. <a 
href="#rm_feature_summary">Reliable Messaging Configuration Features - 
Layout</a></dt><dt>10.5. <a href="#d0e5187">Enable Reliable Messaging + 
version</a></dt><dt>10.6. <a href="#d0e5207">Sequence Inactivity 
Timeout</a></dt><dt>10.7. <a href="#d0e5227">Acknowledgement 
interval</a></dt><dt>10.8. <a href="#d0e5247">Retransmission 
Interval</a></dt><dt>10.9. <a href="#d0e5269">Retransmission Interval 
Adjustment Algorithm</a></dt><dt>10.10. <a href="#d0e5292">Maximum 
Retransmission Count</a></dt><dt>10.11. <a href="#d0e5314">Close sequence 
timeout</a></dt><dt>10.12. <a href="#d0e5337">Acknowledgement request 
interval</a></dt><dt>10.13. <a href="#d0e5357">Bind RM sequence to security 
token</a></dt><dt>10.14. <a href="#d0e5376">Bind RM sequence to secured 
transport</a></dt><dt>10.15. <a href="#d0e5395">Exactly once 
delivery</a></dt><dt>10.16. <a href="#d0e5414">At Most once 
delivery</a></dt><dt>10.17. <a href="#d0e5433">At Least once delivery</a>
 </dt><dt>10.18. <a href="#d0e5453">InOrder delivery</a></dt><dt>10.19. <a 
href="#d0e5473">Flow Control</a></dt><dt>10.20. <a href="#d0e5493">Maximum 
Flow Control Buffer Size</a></dt><dt>10.21. <a href="#d0e5513">Maximum 
concurrent RM sessions</a></dt><dt>10.22. <a href="#d0e5532">Reliable 
Messaging Persistence</a></dt><dt>10.23. <a href="#d0e5551">Sequence manager 
maintenace task execution period</a></dt><dt>12.1. <a href="#ahico">Summary 
of Service-Side Configuration
+            Assertions</a></dt><dt>10.4. <a 
href="#rm_feature_summary">Reliable Messaging Configuration Features - 
Layout</a></dt><dt>10.5. <a href="#d0e5106">Enable Reliable Messaging + 
version</a></dt><dt>10.6. <a href="#d0e5126">Sequence Inactivity 
Timeout</a></dt><dt>10.7. <a href="#d0e5146">Acknowledgement 
interval</a></dt><dt>10.8. <a href="#d0e5166">Retransmission 
Interval</a></dt><dt>10.9. <a href="#d0e5188">Retransmission Interval 
Adjustment Algorithm</a></dt><dt>10.10. <a href="#d0e5211">Maximum 
Retransmission Count</a></dt><dt>10.11. <a href="#d0e5233">Close sequence 
timeout</a></dt><dt>10.12. <a href="#d0e5256">Acknowledgement request 
interval</a></dt><dt>10.13. <a href="#d0e5276">Bind RM sequence to security 
token</a></dt><dt>10.14. <a href="#d0e5295">Bind RM sequence to secured 
transport</a></dt><dt>10.15. <a href="#d0e5314">Exactly once 
delivery</a></dt><dt>10.16. <a href="#d0e5333">At Most once 
delivery</a></dt><dt>10.17. <a href="#d0e5352">At Least once delivery</a>
 </dt><dt>10.18. <a href="#d0e5372">InOrder delivery</a></dt><dt>10.19. <a 
href="#d0e5392">Flow Control</a></dt><dt>10.20. <a href="#d0e5412">Maximum 
Flow Control Buffer Size</a></dt><dt>10.21. <a href="#d0e5432">Maximum 
concurrent RM sessions</a></dt><dt>10.22. <a href="#d0e5451">Reliable 
Messaging Persistence</a></dt><dt>10.23. <a href="#d0e5470">Sequence manager 
maintenace task execution period</a></dt><dt>12.1. <a href="#ahico">Summary 
of Service-Side Configuration
                 Requirements</a></dt><dt>12.2. <a href="#ahicq">Summary of 
Client-Side Configuration
                 Requirements</a></dt><dt>12.3. <a href="#ahidp">Keystore and 
Truststore Aliases</a></dt><dt>12.4. <a href="#ahidq">Keystore and Truststore 
Aliases for STS</a></dt><dt>13.1. <a href="#ahifk">Security Mechanism 
Configuration Options</a></dt><dt>16.1. <a href="#ahiih">CLR to XML Schema 
Type Mapping</a></dt><dt>18.1. <a 
href="#using_wsat-components_table">Components of Web Services Atomic 
Transactions</a></dt><dt>18.2. <a href="#using_wsat-config_table">Web 
Services Atomic Transactions Configuration
                 Options</a></dt><dt>18.3. <a 
href="#using_wsat-flow_types_table">Flow Types Values</a></dt><dt>18.4. <a 
href="#using_wsat-wsat_1-2_assertion_values">Web Services Atomic Transaction 
Policy Assertion
@@ -608,14 +608,14 @@
                         authenticate itself to the web service.</p></li><li 
class="listitem"><p>The web service sends a X509 Certificate to
                         authenticate itself to the 
client.</p></li></ol></div><p>All communication uses SOAP 
messages.</p></div></div></div></div><div lang="en" class="chapter" 
title="Chapter&nbsp;2.&nbsp;Using Metro"><div class="titlepage"><div><div><h2 
class="title"><a name="using-metro"></a>Chapter&nbsp;2.&nbsp;Using 
Metro</h2></div></div></div><div class="toc"><p><b>Table of 
Contents</b></p><dl><dt><span class="section"><a href="#metro-tools">2.1. 
Metro Tools</a></span></dt><dd><dl><dt><span class="section"><a 
href="#useful-tools-for-your-toolbox">2.1.1. Useful tools for your 
toolbox</a></span></dt></dl></dd><dt><span class="section"><a 
href="#using-mavenized-metro-binaries">2.2. Using Mavenized Metro 
Binaries</a></span></dt><dd><dl><dt><span class="section"><a 
href="#using-metro-in-a-maven-project">2.2.1. Using Metro in a Maven 
project</a></span></dt><dt><span class="section"><a 
href="#using-metro-in-a-non-maven-project">2.2.2. Using Metro in a non-Maven 
project</a></span></dt>
 </dl></dd><dt><span class="section"><a 
href="#using_metro-developing_with_nb">2.3. Developing with 
NetBeans</a></span></dt><dd><dl><dt><span class="section"><a 
href="#ahibo">2.3.1. Registering GlassFish with the 
IDE</a></span></dt><dt><span class="section"><a href="#ahibp">2.3.2. Creating 
a Web Service</a></span></dt><dt><span class="section"><a 
href="#ahibq">2.3.3. Configuring Metro's WSIT Features in the Web
             Service</a></span></dt><dt><span class="section"><a 
href="#ahibr">2.3.4. Deploying and Testing a Web 
Service</a></span></dt><dt><span class="section"><a 
href="#wsit_example_with_nb-creating_wsit_client">2.3.5. Creating a Client to 
Consume a WSIT-Enabled Web
-            Service</a></span></dt></dl></dd><dt><span class="section"><a 
href="#developing-with-eclipse">2.4. Developing with 
Eclipse</a></span></dt><dd><dl><dt><span class="section"><a 
href="#setup">2.4.1. Setup</a></span></dt><dt><span class="section"><a 
href="#create-a-metro-web-services-endpoint">2.4.2. Create a Metro Web 
Services Endpoint</a></span></dt><dt><span class="section"><a 
href="#creating-web-service-client-using-wsimport-cli">2.4.3. Creating Web 
Service Client using Wsimport CLI</a></span></dt><dt><span class="section"><a 
href="#creating-web-service-client-using-wsimport-ant-task">2.4.4. Creating 
Web Service Client using Wsimport Ant Task</a></span></dt><dt><span 
class="section"><a 
href="#creating-web-service-client-using-soap-ui-plugin">2.4.5. Creating Web 
Service Client using SOAP UI Plugin</a></span></dt></dl></dd><dt><span 
class="section"><a href="#logging">2.5. 
Logging</a></span></dt><dd><dl><dt><span class="section"><a 
href="#dynamic_tube-based_message_logging"
 >2.5.1. Dynamic tube-based message logging</a></span></dt><dt><span 
 >class="section"><a href="#dumping-soap-messages-on-client">2.5.2. Dumping 
 >SOAP messages on client</a></span></dt><dt><span class="section"><a 
 >href="#dumping-soap-messages-on-server">2.5.3. Dumping SOAP messages on 
 >server</a></span></dt></dl></dd><dt><span class="section"><a 
 >href="#using-jax-ws-2.x---metro-1.x-2.0-with-java-se-6">2.6. Using JAX-WS 
 >2.x / Metro 1.x/2.0 with Java SE 6</a></span></dt><dd><dl><dt><span 
 >class="section"><a href="#mustanga1">2.6.1. Using JAX-WS 2.x with Java SE 
 >6</a></span></dt><dt><span class="section"><a href="#mustanga2">2.6.2. 
 >Using Metro 1.x with Java SE 6</a></span></dt><dt><span class="section"><a 
 >href="#mustanga3">2.6.3. Using Metro 2.0 with Java SE 
 >6</a></span></dt></dl></dd><dt><span class="section"><a 
 >href="#deploying-metro-endpoint">2.7. Deploying Metro 
 >endpoint</a></span></dt><dd><dl><dt><span class="section"><a 
 >href="#the-war-contents">2.7.1. The WAR Contents</a></span></dt><dt
 ><span class="section"><a href="#using-sun-jaxws.xml">2.7.2. Using 
 >sun-jaxws.xml</a></span></dt><dt><span class="section"><a 
 >href="#using-109-deployment-descriptor">2.7.3. Using 109 Deployment 
 >Descriptor</a></span></dt><dt><span class="section"><a 
 >href="#using-spring">2.7.4. Using Spring</a></span></dt></dl></dd><dt><span 
 >class="section"><a href="#handlers-and-messagecontext">2.8. Handlers and 
 >MessageContext</a></span></dt><dd><dl><dt><span class="section"><a 
 >href="#messagecontext-in-jax-ws">2.8.1. MessageContext in 
 >JAX-WS</a></span></dt><dt><span class="section"><a 
 >href="#handlers-in-jax-ws">2.8.2. Handlers in 
 >JAX-WS</a></span></dt><dt><span class="section"><a 
 >href="#efficient-handlers-in-jax-ws-ri">2.8.3. Efficient Handlers in JAX-WS 
 >RI</a></span></dt></dl></dd><dt><span class="section"><a 
 >href="#deploying-jax-ws-with-...">2.9. Deploying Metro with 
 >...</a></span></dt><dd><dl><dt><span class="section"><a 
 >href="#weblogic-10">2.9.1. WebLogic 12</a></span></dt></dl></dd><dt><span 
 >clas
 s="section"><a 
href="#developing-client-application-with-locally-packaged-wsdl">2.10. 
Developing client application with locally packaged
+            Service</a></span></dt></dl></dd><dt><span class="section"><a 
href="#developing-with-eclipse">2.4. Developing with 
Eclipse</a></span></dt><dd><dl><dt><span class="section"><a 
href="#setup">2.4.1. Setup</a></span></dt><dt><span class="section"><a 
href="#create-a-metro-web-services-endpoint">2.4.2. Create a Metro Web 
Services Endpoint</a></span></dt><dt><span class="section"><a 
href="#creating-web-service-client-using-wsimport-cli">2.4.3. Creating Web 
Service Client using Wsimport CLI</a></span></dt><dt><span class="section"><a 
href="#creating-web-service-client-using-wsimport-ant-task">2.4.4. Creating 
Web Service Client using Wsimport Ant Task</a></span></dt><dt><span 
class="section"><a 
href="#creating-web-service-client-using-soap-ui-plugin">2.4.5. Creating Web 
Service Client using SOAP UI Plugin</a></span></dt></dl></dd><dt><span 
class="section"><a href="#logging">2.5. 
Logging</a></span></dt><dd><dl><dt><span class="section"><a 
href="#dynamic_tube-based_message_logging"
 >2.5.1. Dynamic tube-based message logging</a></span></dt><dt><span 
 >class="section"><a href="#dumping-soap-messages-on-client">2.5.2. Dumping 
 >SOAP messages on client</a></span></dt><dt><span class="section"><a 
 >href="#dumping-soap-messages-on-server">2.5.3. Dumping SOAP messages on 
 >server</a></span></dt></dl></dd><dt><span class="section"><a 
 >href="#using-jax-ws-2.x---metro-1.x-2.0-with-java-se-6">2.6. Using JAX-WS / 
 >Metro with Java SE</a></span></dt><dd><dl><dt><span class="section"><a 
 >href="#mustanga1">2.6.1. Using JAX-WS with Java SE</a></span></dt><dt><span 
 >class="section"><a href="#mustanga3">2.6.2. Using Metro with Java 
 >SE</a></span></dt></dl></dd><dt><span class="section"><a 
 >href="#deploying-metro-endpoint">2.7. Deploying Metro 
 >endpoint</a></span></dt><dd><dl><dt><span class="section"><a 
 >href="#the-war-contents">2.7.1. The WAR Contents</a></span></dt><dt><span 
 >class="section"><a href="#using-sun-jaxws.xml">2.7.2. Using 
 >sun-jaxws.xml</a></span></dt><dt><span class="section"><a h
 ref="#using-109-deployment-descriptor">2.7.3. Using 109 Deployment 
Descriptor</a></span></dt><dt><span class="section"><a 
href="#using-spring">2.7.4. Using Spring</a></span></dt></dl></dd><dt><span 
class="section"><a href="#handlers-and-messagecontext">2.8. Handlers and 
MessageContext</a></span></dt><dd><dl><dt><span class="section"><a 
href="#messagecontext-in-jax-ws">2.8.1. MessageContext in 
JAX-WS</a></span></dt><dt><span class="section"><a 
href="#handlers-in-jax-ws">2.8.2. Handlers in JAX-WS</a></span></dt><dt><span 
class="section"><a href="#efficient-handlers-in-jax-ws-ri">2.8.3. Efficient 
Handlers in JAX-WS RI</a></span></dt></dl></dd><dt><span class="section"><a 
href="#deploying-jax-ws-with-...">2.9. Deploying Metro with 
...</a></span></dt><dd><dl><dt><span class="section"><a 
href="#weblogic-10">2.9.1. WebLogic 12</a></span></dt></dl></dd><dt><span 
class="section"><a 
href="#developing-client-application-with-locally-packaged-wsdl">2.10. 
Developing client application with local
 ly packaged
         WSDL</a></span></dt><dd><dl><dt><span class="section"><a 
href="#service-api-to-pass-the-wsdl-information">2.10.1. Service API to pass 
the WSDL information</a></span></dt><dt><span class="section"><a 
href="#xml-catalog">2.10.2. Xml Catalog</a></span></dt><dt><span 
class="section"><a href="#using--wsdllocation-switch">2.10.3. Using 
-wsdlLocation switch</a></span></dt></dl></dd><dt><span class="section"><a 
href="#how-to-invoke-and-endpoint-by-overriding-endpoint-address-in-the-wsdl">2.11.
 How to invoke and endpoint by overriding endpoint address in
         the WSDL</a></span></dt><dd><dl><dt><span class="section"><a 
href="#bindingprovider.endpoint_address_property">2.11.1. 
BindingProvider.ENDPOINT_ADDRESS_PROPERTY</a></span></dt><dt><span 
class="section"><a href="#create-service-using-updated-wsdl">2.11.2. Create 
Service using updated WSDL</a></span></dt></dl></dd><dt><span 
class="section"><a href="#maintaining-state-in-web-services">2.12. 
Maintaining State in Web Services</a></span></dt><dt><span class="section"><a 
href="#fastinfoset">2.13. FastInfoset</a></span></dt><dd><dl><dt><span 
class="section"><a href="#using-fastinfoset">2.13.1. Using 
FastInfoset</a></span></dt></dl></dd><dt><span class="section"><a 
href="#using_metro-ha_support">2.14. High Availability Support in 
Metro</a></span></dt></dl></div><div class="section" title="2.1.&nbsp;Metro 
Tools"><div class="titlepage"><div><div><h2 class="title" style="clear: 
both"><a name="metro-tools"></a>2.1.&nbsp;Metro 
Tools</h2></div></div></div><p>Metro provides these tools to h
 elp develop Web services
         applications:</p><div class="orderedlist"><ol class="orderedlist" 
type="1"><li class="listitem"><p><a class="link" 
href="http://jax-ws.java.net/2.2.8/docs/release-documentation.html#tools" ;
target="_top">Overview</a></p></li><li class="listitem"><p><a class="link" 
href="http://jax-ws.java.net/2.2.8/docs/release-documentation.html#tools-wsimport";
 target="_top">Wsimport CLI</a></p></li><li class="listitem"><p><a 
class="link" 
href="http://jax-ws.java.net/2.2.8/docs/release-documentation.html#tools-wsimport-ant-task";
 target="_top">Wsimport Ant Task</a></p></li><li class="listitem"><p><a 
class="link" 
href="http://jax-ws.java.net/2.2.8/docs/release-documentation.html#tools-wsgen";
 target="_top">Wsgen CLI</a></p></li><li class="listitem"><p><a class="link" 
href="http://jax-ws.java.net/2.2.8/docs/release-documentation.html#tools-wsgen-ant-task";
 target="_top">Wsgen Ant Task</a></p></li><li class="listitem"><p><a 
class="link" href="http://jax-ws.java.net/2.2.8/docs/release-documentation
 .html#tools-apt" target="_top">Apt</a></p></li><li class="listitem"><p><a 
class="link" href="http://jax-ws-commons.java.net/jaxws-maven-plugin/" ;
target="_top">Wsimport
                 and Wsgen Maven2 plugin</a></p></li></ol></div><p>Note that 
these tools are located in the
         <code class="code">webservices-tools.jar</code> file in the <code 
class="code">lib/</code>
-        subdirectory of either the GlassFish V2 or Metro (standalone)
-        download. In GlassFish 3.x these tools are located in the
+        subdirectory of Metro (standalone)
+        download. In GlassFish these tools are located in the
         <code class="code">webservices-osgi.jar</code> under <code 
class="code">glassfish/modules</code>
         subdirectory. Shell script versions that of the tools are located
         under <code class="code">glassfish/bin</code>.</p><div 
class="section" title="2.1.1.&nbsp;Useful tools for your toolbox"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="useful-tools-for-your-toolbox"></a>2.1.1.&nbsp;Useful tools for your 
toolbox</h3></div></div></div><p>Over the years, the Metro team has found the 
following tools
@@ -636,21 +636,21 @@
         system from Ant to Maven. The main Metro build as well as the whole
         <a class="link" href="http://wsit.java.net" target="_top";>WSIT 
project</a> modules
         have been fully mavenized and currently Metro is built, assembled and
-        installed using Maven. Metro is deployed to the <a class="link" 
href="http://download.java.net/maven/2/" target="_top";>Java.Net Maven2
-        Repository</a>. The Metro modules share a new common root
+        installed using Maven. Metro releases are deployed to Maven central. 
+        The Metro modules share a new common root
         <code class="code">groupId</code> with a value of <code 
class="code">org.glassfish.metro</code>
-        and can be browsed at the following location: <a class="link" 
href="http://download.java.net/maven/2/org/glassfish/metro/" ;
target="_top">http://download.java.net/maven/2/org/glassfish/metro/</a>.
+        and can be browsed at the following location: <a class="link" 
href="http://search.maven.org/#search%7Cga%7C1%7Corg.glassfish.metro" ;
target="_top">http://search.maven.org/#search%7Cga%7C1%7Corg.glassfish.metro</a>.
         All Metro binaries, sources as well as javadoc and samples are all
-        available in the Java.Net Maven2 repository. The main Metro maven
-        project is located at <a class="link" 
href="http://download.java.net/maven/2/org/glassfish/metro/metro-project/" ;
target="_top">http://download.java.net/maven/2/org/glassfish/metro/metro-project/</a>.</p><div
 class="section" title="2.2.1.&nbsp;Using Metro in a Maven project"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="using-metro-in-a-maven-project"></a>2.2.1.&nbsp;Using Metro in a Maven 
project</h3></div></div></div><p>If you want to use Metro in a Maven project, 
you need to
-            declare a dependency on the Metro runtime bundle:</p><div 
class="example"><a name="d0e917"></a><p 
class="title"><b>Example&nbsp;2.1.&nbsp;Declaring Metro non-OSGi 
dependencies</b></p><div class="example-contents"><pre 
class="programlisting">&lt;project&gt;
+        available in the maven repository.
+        </p><div class="section" title="2.2.1.&nbsp;Using Metro in a Maven 
project"><div class="titlepage"><div><div><h3 class="title"><a 
name="using-metro-in-a-maven-project"></a>2.2.1.&nbsp;Using Metro in a Maven 
project</h3></div></div></div><p>If you want to use Metro in a Maven project, 
you need to
+            declare a dependency on the Metro runtime bundle:</p><div 
class="example"><a name="d0e911"></a><p 
class="title"><b>Example&nbsp;2.1.&nbsp;Declaring Metro non-OSGi 
dependencies</b></p><div class="example-contents"><pre 
class="programlisting">&lt;project&gt;
     ...
     &lt;dependencies&gt;
         ...
         &lt;dependency&gt;
             &lt;groupId&gt;org.glassfish.metro&lt;/groupId&gt;
             &lt;artifactId&gt;webservices-rt&lt;/artifactId&gt;
-            &lt;version&gt;2.1&lt;/version&gt;
+            &lt;version&gt;2.3&lt;/version&gt;
         &lt;/dependency&gt;
         ...
     &lt;/dependencies&gt;
@@ -659,60 +659,28 @@
             transitive dependencies and gets all the jars that
             <code class="code">webservices-rt</code> module depends on. 
Should you want to
             use OSGi-fied Metro bundle, you need to declare the following
-            dependency instead:</p><div class="example"><a 
name="d0e927"></a><p class="title"><b>Example&nbsp;2.2.&nbsp;Declaring Metro 
OSGi dependencies</b></p><div class="example-contents"><pre 
class="programlisting">&lt;project&gt;
+            dependency instead:</p><div class="example"><a 
name="d0e921"></a><p class="title"><b>Example&nbsp;2.2.&nbsp;Declaring Metro 
OSGi dependencies</b></p><div class="example-contents"><pre 
class="programlisting">&lt;project&gt;
     ...
     &lt;dependencies&gt;
         ...
         &lt;dependency&gt;
             &lt;groupId&gt;org.glassfish.metro&lt;/groupId&gt;
             &lt;artifactId&gt;webservices-osgi&lt;/artifactId&gt;
-            &lt;version&gt;2.1&lt;/version&gt;
+            &lt;version&gt;2.3&lt;/version&gt;
         &lt;/dependency&gt;
         ...
     &lt;/dependencies&gt;
     ...
-&lt;/project&gt;</pre></div></div><br class="example-break"><p>Additionally, 
the following entries need to be added into
-            your project's <code class="code">pom.xml</code> or into your
-            <code class="code">settings.xml</code> configuration 
file:</p><div class="example"><a name="d0e940"></a><p 
class="title"><b>Example&nbsp;2.3.&nbsp;Maven repository 
configuration</b></p><div class="example-contents"><pre 
class="programlisting">&lt;repositories&gt;
-    ...
-    &lt;repository&gt;
-        &lt;id&gt;maven-repository.java.net&lt;/id&gt;
-        &lt;name&gt;Java.net Repository for Maven 1&lt;/name&gt;
-        &lt;url&gt;http://download.java.net/maven/1/&lt;/url&gt;
-        &lt;layout&gt;legacy&lt;/layout&gt;
-    &lt;/repository&gt;
-    &lt;repository&gt;
-        &lt;id&gt;maven2-repository.java.net&lt;/id&gt;
-        &lt;name&gt;Java.net Repository for Maven 2&lt;/name&gt;
-        &lt;url&gt;http://download.java.net/maven/2/&lt;/url&gt;
-    &lt;/repository&gt;
-    ...
-&lt;/repositories&gt;
-
-&lt;pluginRepositories&gt;
-    ...
-    &lt;pluginRepository&gt;
-        &lt;id&gt;maven2-repository.java.net&lt;/id&gt;
-        &lt;name&gt;Java.net Repository for Maven 2&lt;/name&gt;
-        &lt;url&gt;http://download.java.net/maven/2/&lt;/url&gt;
-        &lt;layout&gt;default&lt;/layout&gt;
-    &lt;/pluginRepository&gt;
-    ...
-&lt;/pluginRepositories&gt;</pre></div></div><br 
class="example-break"><p>Both <code class="code">repository</code> and
-            <code class="code">pluginRepository</code> sections will need to 
be added. If
-            you're behind a proxy, check the <a class="link" 
href="http://maven.apache.org/guides/mini/guide-proxies.html" ;
target="_top">Maven
-            guide to using proxies</a> to learn about configuring proxy
-            settings in Maven.</p><div class="section" 
title="2.2.1.1.&nbsp;Using Metro Tools from Maven"><div 
class="titlepage"><div><div><h4 class="title"><a 
name="using-metro-tools-from-maven"></a>2.2.1.1.&nbsp;Using Metro Tools from 
Maven</h4></div></div></div><p>Metro has Maven plugins for standard JAX-WS 
WSImport and
+&lt;/project&gt;</pre></div></div><br class="example-break"><div 
class="section" title="2.2.1.1.&nbsp;Using Metro Tools from Maven"><div 
class="titlepage"><div><div><h4 class="title"><a 
name="using-metro-tools-from-maven"></a>2.2.1.1.&nbsp;Using Metro Tools from 
Maven</h4></div></div></div><p>Metro has Maven plugins for standard JAX-WS 
WSImport and
                 WSGen tools and this <a class="link" 
href="http://jax-ws-commons.java.net/jaxws-maven-plugin/usage.html" ;
target="_top">snippet
                 from pom.xml</a> shows the usage of these maven plugins.
                 More information on using these plugins is available at <a 
class="link" href="http://jax-ws-commons.java.net/jaxws-maven-plugin/" ;
target="_top">JAX-WS
                 Maven Plugin Project</a> site.</p></div></div><div 
class="section" title="2.2.2.&nbsp;Using Metro in a non-Maven project"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="using-metro-in-a-non-maven-project"></a>2.2.2.&nbsp;Using Metro in a 
non-Maven project</h3></div></div></div><p>Even though Metro is currently 
Maven-based and fully
             available from a Maven repository, you can, of course, still use
             it in a non-Maven project or install it manually to your
-            container. First, you need to go to the <a class="link" 
href="http://download.java.net/maven/2/org/glassfish/metro/metro-standalone/" ;
target="_top">Metro
+            container. First, you need to go to the <a class="link" 
href="http://search.maven.org/#search%7Cga%7C1%7Ca%3A%22metro-standalone%22" ;
target="_top">Metro
             Standalone Bundle</a> root in the Maven repository and download
-            and unzip a version of your choice, e.g. <a class="link" 
href="http://download.java.net/maven/2/org/glassfish/metro/metro-standalone/2.1/metro-standalone-2.1.zip";
 target="_top">Metro
-            2.1 Standalone Bundle</a>. For further instructions, please
+            and unzip a version of your choice. For further instructions, 
please
             consult the <code class="code">readme.html</code> file available 
under the
             unzipped <code class="code">metro</code> root 
directory.</p></div></div><div class="section" title="2.3.&nbsp;Developing 
with NetBeans"><div class="titlepage"><div><div><h2 class="title" 
style="clear: both"><a 
name="using_metro-developing_with_nb"></a>2.3.&nbsp;Developing with 
NetBeans</h2></div></div></div><div class="section" 
title="2.3.1.&nbsp;Registering GlassFish with the IDE"><div 
class="titlepage"><div><div><h3 class="title"><a 
name="ahibo"></a>2.3.1.&nbsp;Registering GlassFish with the 
IDE</h3></div></div></div><p>Before you create the web service, make sure 
GlassFish has
             been registered with the NetBeans IDE. The registered server list
@@ -736,7 +704,7 @@
             <code class="code">javax.jws.WebService</code> annotation. The
             <code class="code">WebService</code> annotation defines the 
class as a web
             service endpoint. The following Java code shows a web service. 
The
-            IDE will create most of this Java code for you.</p><div 
class="example"><a name="d0e1072"></a><p 
class="title"><b>Example&nbsp;2.4.&nbsp;</b></p><div 
class="example-contents"><pre class="programlisting">package 
org.me.calculator;
+            IDE will create most of this Java code for you.</p><div 
class="example"><a name="d0e1039"></a><p 
class="title"><b>Example&nbsp;2.3.&nbsp;</b></p><div 
class="example-contents"><pre class="programlisting">package 
org.me.calculator;
 
 import javax.jws.WebService;
 import javax.jws.WebMethod;
@@ -826,13 +794,13 @@
                         <span class="guilabel">Source</span> tab for 
CalculatorWS.java
                         in the right pane. Notice that the <code 
class="code">add</code>
                         method has been added to the source
-                        code.</strong></span></p><div class="example"><a 
name="d0e1279"></a><p class="title"><b>Example&nbsp;2.5.&nbsp;</b></p><div 
class="example-contents"><pre 
class="programlisting">@WebMethod(operationName="add")
+                        code.</strong></span></p><div class="example"><a 
name="d0e1246"></a><p class="title"><b>Example&nbsp;2.4.&nbsp;</b></p><div 
class="example-contents"><pre 
class="programlisting">@WebMethod(operationName="add")
 public int add(@WebParam(name = "i") int i, @WebParam(name = "j") int j) {
     // TODO write your implementation code here
     return 0;
 }</pre></div></div><br class="example-break"></li><li class="step" 
title="Step 14"><p><span class="bold"><strong>Change the
                         <code class="code">add</code> method to the following
-                        :</strong></span></p><div class="example"><a 
name="d0e1289"></a><p class="title"><b>Example&nbsp;2.6.&nbsp;</b></p><div 
class="example-contents"><pre 
class="programlisting">@WebMethod(operationName="add")
+                        :</strong></span></p><div class="example"><a 
name="d0e1256"></a><p class="title"><b>Example&nbsp;2.5.&nbsp;</b></p><div 
class="example-contents"><pre 
class="programlisting">@WebMethod(operationName="add")
 public int add(@WebParam(name = "i") int i, @WebParam(name = "j") int j) {
     int k = i + j;
     return k;
@@ -926,7 +894,7 @@
                         the web service that you want the client to consume
                         into the <span class="guilabel">WSDL URL</span> 
field.
                         </strong></span></p><p>For example, here is the URL 
for the
-                        <code class="code">CalculatorWS</code> web 
service:</p><div class="example"><a name="d0e1578"></a><p 
class="title"><b>Example&nbsp;2.7.&nbsp;</b></p><div 
class="example-contents"><pre 
class="programlisting">http://localhost:8080/CalculatorApplication/CalculatorWSService?wsdl</pre></div></div><br
 class="example-break"><p>When JAX-WS generates the web service, it
+                        <code class="code">CalculatorWS</code> web 
service:</p><div class="example"><a name="d0e1545"></a><p 
class="title"><b>Example&nbsp;2.6.&nbsp;</b></p><div 
class="example-contents"><pre 
class="programlisting">http://localhost:8080/CalculatorApplication/CalculatorWSService?wsdl</pre></div></div><br
 class="example-break"><p>When JAX-WS generates the web service, it
                         appends <code class="code">Service</code> to the 
class name by
                         default.</p></li><li class="step" title="Step 
7"><p><span class="bold"><strong>Click
                         <span class="guibutton">Finish</span>. 
</strong></span></p></li><li class="step" title="Step 8"><p><span 
class="bold"><strong>Right-click the
@@ -948,10 +916,10 @@
                         Editor</span>, remove the line that comments out
                         the body of the <code 
class="code">processRequest</code> method.
                         </strong></span></p><p>This is the start-comment 
line that starts the
-                        section that comments out the code:</p><div 
class="example"><a name="d0e1663"></a><p 
class="title"><b>Example&nbsp;2.8.&nbsp;</b></p><div 
class="example-contents"><pre class="programlisting">/* TODO output your page 
here</pre></div></div><br class="example-break"></li><li class="step" 
title="Step 13"><p><span class="bold"><strong>Delete the end-comment
+                        section that comments out the code:</p><div 
class="example"><a name="d0e1630"></a><p 
class="title"><b>Example&nbsp;2.7.&nbsp;</b></p><div 
class="example-contents"><pre class="programlisting">/* TODO output your page 
here</pre></div></div><br class="example-break"></li><li class="step" 
title="Step 13"><p><span class="bold"><strong>Delete the end-comment
                         line that ends the section of commented out
-                        code:</strong></span></p><div class="example"><a 
name="d0e1670"></a><p class="title"><b>Example&nbsp;2.9.&nbsp;</b></p><div 
class="example-contents"><pre class="programlisting">*/</pre></div></div><br 
class="example-break"></li><li class="step" title="Step 14"><p><span 
class="bold"><strong>Add some empty lines after
-                        the following line:</strong></span></p><div 
class="example"><a name="d0e1677"></a><p 
class="title"><b>Example&nbsp;2.10.&nbsp;</b></p><div 
class="example-contents"><pre 
class="programlisting">out.println("&lt;h1&gt;Servlet ClientServlet at " +
+                        code:</strong></span></p><div class="example"><a 
name="d0e1637"></a><p class="title"><b>Example&nbsp;2.8.&nbsp;</b></p><div 
class="example-contents"><pre class="programlisting">*/</pre></div></div><br 
class="example-break"></li><li class="step" title="Step 14"><p><span 
class="bold"><strong>Add some empty lines after
+                        the following line:</strong></span></p><div 
class="example"><a name="d0e1644"></a><p 
class="title"><b>Example&nbsp;2.9.&nbsp;</b></p><div 
class="example-contents"><pre 
class="programlisting">out.println("&lt;h1&gt;Servlet ClientServlet at " +
         request.getContextPath () + "&lt;/h1&gt;");</pre></div></div><br 
class="example-break"></li><li class="step" title="Step 15"><p><span 
class="bold"><strong>Right-click in one of the
                         empty lines that you added, then choose
                         <span class="guimenuite
[truncated due to length]



[metro~svn:841] update docs

snajper 06/13/2013
Terms of Use; Privacy Policy; Copyright ©2013-2016 (revision 20151030.c1dd42a)
 
 
Close
loading
Please Confirm
Close