[jbossws-commits] JBossWS SVN: r1576 - in trunk/docs/online/tutorial-doc/en: . modules modules/installation

Author: sam.griffith(a)jboss.com Date: 2006-12-06 10:24:38 -0500 (Wed, 06 Dec 2006) New Revision: 1576 Modified: trunk/docs/online/tutorial-doc/en/master.template trunk/docs/online/tutorial-doc/en/modules/installation/install-jboss.xml trunk/docs/online/tutorial-doc/en/modules/installation/installation.xml trunk/docs/online/tutorial-doc/en/modules/introduction.xml Log: Docbook edit of the tutorial. First checkin of docbook edits... more coming. Wanted to get first edit working with Docbook and checked in. Modified: trunk/docs/online/tutorial-doc/en/master.template =================================================================== --- trunk/docs/online/tutorial-doc/en/master.template 2006-12-06 14:17:04 UTC (rev 1575) +++ trunk/docs/online/tutorial-doc/en/master.template 2006-12-06 15:24:38 UTC (rev 1576) @@ -1,104 +1,53 @@ -<?xml version='1.0' encoding="iso-8859-1"?> - -<!-- $Id: master.xml 118 2006-04-06 14:44:24Z thomas.diesler(a)jboss.com $ --> - -<!DOCTYPE book PUBLIC - "-//OASIS//DTD DocBook XML V4.3CR3//EN" - "../../../docbook-support/support/docbook-dtd/docbookx.dtd" -[ -<!ENTITY ch-introduction SYSTEM "modules/introduction.xml"> -<!ENTITY ch-installation SYSTEM "modules/installation/installation.xml"> -<!ENTITY s-install-jboss SYSTEM "modules/installation/install-jboss.xml"> -<!ENTITY s-install-tomcat SYSTEM "modules/installation/install-tomcat.xml"> -<!ENTITY ch-installation SYSTEM "modules/installation/installation.xml"> -<!ENTITY ch-getting-started SYSTEM "modules/getting-started/getting-started.xml"> -<!ENTITY s-rpc-endpoints SYSTEM "modules/getting-started/rpc-endpoints.xml"> -<!ENTITY s-doc-endpoints SYSTEM "modules/getting-started/doc-endpoints.xml"> -<!ENTITY s-message-style SYSTEM "modules/getting-started/message-endpoints.xml"> -<!ENTITY ch-endpoints SYSTEM "modules/endpoints/endpoints.xml"> -<!ENTITY s-jsr109-endpoints SYSTEM "modules/endpoints/jsr109-endpoints.xml"> -<!ENTITY s-jsr109-pojo-endpoint SYSTEM "modules/endpoints/jsr109-pojo-endpoint.xml"> -<!ENTITY s-jsr109-ejb-endpoint SYSTEM "modules/endpoints/jsr109-ejb-endpoint.xml"> -<!ENTITY s-jsr181-endpoints SYSTEM "modules/endpoints/jsr181-endpoints.xml"> -<!ENTITY s-jsr181-pojo-endpoint SYSTEM "modules/endpoints/jsr181-pojo-endpoint.xml"> -<!ENTITY s-jsr181-ejb3-endpoint SYSTEM "modules/endpoints/jsr181-ejb3-endpoint.xml"> -<!ENTITY s-service-lifecycle SYSTEM "modules/endpoints/service-lifecycle.xml"> -<!ENTITY s-templates SYSTEM "modules/endpoints/template-config.xml"> -<!ENTITY ch-clients SYSTEM "modules/clients/clients.xml"> -<!ENTITY s-jsr109-clients SYSTEM "modules/clients/jsr109-clients.xml"> -<!ENTITY s-dii-clients SYSTEM "modules/clients/dii-clients.xml"> -<!ENTITY s-stub-properties SYSTEM "modules/clients/stub-properties.xml"> -<!ENTITY ch-headers-handlers SYSTEM "modules/headers-handlers/headers-handlers.xml"> -<!ENTITY s-headers SYSTEM "modules/headers-handlers/headers.xml"> -<!ENTITY s-handlers SYSTEM "modules/headers-handlers/handlers.xml"> -<!ENTITY s-dynamic-handlers SYSTEM "modules/headers-handlers/dynamic-handlers.xml"> -<!ENTITY ch-holders SYSTEM "modules/holders/inout-parameters.xml"> -<!ENTITY ch-exceptions SYSTEM "modules/exceptions/exceptions.xml"> -<!ENTITY ch-oneway SYSTEM "modules/oneway/oneway.xml"> -<!ENTITY ch-attachments SYSTEM "modules/attachments/attachments.xml"> -<!ENTITY ch-mtom-xop SYSTEM "modules/mtom-xop/mtom-xop.xml"> -<!ENTITY ch-jms-transport SYSTEM "modules/jmstransport/jms-transport.xml"> -<!ENTITY s-jms-endpoint SYSTEM "modules/jmstransport/jms-endpoint.xml"> -<!ENTITY s-jms-client SYSTEM "modules/jmstransport/jms-client.xml"> -<!ENTITY ch-secure-ejb SYSTEM "modules/secureejb/secure-ejb.xml"> -<!ENTITY ch-wssecurity SYSTEM "modules/wssecurity/wssecurity.xml"> -<!ENTITY ch-wsaddressing SYSTEM "modules/wsaddressing/wsaddressing.xml"> -<!ENTITY ch-wseventing SYSTEM "modules/wseventing/wseventing.xml"> -<!ENTITY ch-wstransaction SYSTEM "modules/wstransaction/wstransaction.xml"> -<!ENTITY ch-xmlregistry SYSTEM "modules/xmlregistry/xmlregistry.xml"> -<!ENTITY appendix-a SYSTEM "modules/appendix-a.xml"> -]> - - -<book lang="en"> - - <bookinfo> - <title>JBossWS User Guide</title> - <subtitle&gt;jbossws-@version.id(a)&lt;/subtitle&gt; - <releaseinfo&gt;@build.date(a)&lt;/releaseinfo&gt; - <releaseinfo> - <ulink url="http://labs.jboss.com/jbossws/user-guide/en/html/index.html&quo... Pages]</ulink>, - <ulink url="http://labs.jboss.com/jbossws/user-guide/en/html_single/index.h... Page]</ulink>, - <ulink url="http://labs.jboss.com/jbossws/user-guide/en/pdf/jbossws-usergui... - </releaseinfo> - </bookinfo> - - <toc/> - - <preface id="preface" revision="1"> - <title>Preface</title> - <para> After JBoss J2EE-1.4 certification in Jun/2004 we have decided to develop our - own JAXRPC SOAP stack that fits better in the overall JBoss architecture and is - generally more suiteable for the specific J2EE requirements for web services. - JBossWS is our new implementation of J2EE compatible web services. - This document describes the JBossWS feature set and its usage. - </para> - <para> If you have questions regarding JBossWS, please feel to ask the JBossWS team.</para> - - <para>Web Service Lead - Thomas Diesler</para> - <para>WS-Security, WSTools - Jason Greene</para> - <para>WS-Eventing, Standards - Heiko Braun</para> - - </preface> - - &ch-introduction; - &ch-installation; - &ch-getting-started; - &ch-endpoints; - &ch-clients; - &ch-headers-handlers; - &ch-holders; - &ch-exceptions; - &ch-oneway; - &ch-attachments; - &ch-mtom-xop; - &ch-jms-transport; - &ch-secure-ejb; - &ch-wssecurity; - &ch-wsaddressing; - &ch-wseventing; - &ch-wstransaction; - &ch-xmlregistry; - &appendix-a; - -</book> +<?xml version='1.0' encoding="iso-8859-1"?> + +<!-- $Id: master.xml 118 2006-04-06 14:44:24Z thomas.diesler(a)jboss.com $ --> + +<!DOCTYPE book PUBLIC + "-//OASIS//DTD DocBook XML V4.3CR3//EN" + "../../../docbook-support/support/docbook-dtd/docbookx.dtd" +[ +<!ENTITY ch-introduction SYSTEM "modules/introduction.xml"> +<!ENTITY s-what-is-a-web-service SYSTEM "modules/what-is-a-web-service.xml"> +<!ENTITY ch-installation SYSTEM "modules/installation/installation.xml"> +<!ENTITY s-install-jboss SYSTEM "modules/installation/install-jboss.xml"> +<!ENTITY s-install-on-jboss-5 SYSTEM "modules/installation/install-on-jboss-5.xml"> +<!ENTITY ch-getting-started SYSTEM "modules/getting-started/getting-started.xml"> +<!ENTITY s-rpc-endpoints SYSTEM "modules/getting-started/rpc-endpoints.xml"> +<!ENTITY s-doc-endpoints SYSTEM "modules/getting-started/doc-endpoints.xml"> +<!ENTITY s-message-style SYSTEM "modules/getting-started/message-endpoints.xml"> +]> + + +<book lang="en"> + + <bookinfo> + <title>JBossWS Tutorials</title> + <subtitle&gt;jbossws-@version.id(a)&lt;/subtitle&gt; + <releaseinfo&gt;@build.date(a)&lt;/releaseinfo&gt; + <releaseinfo> + <ulink url="http://labs.jboss.com/jbossws/tutorials/en/html/index.html"... Pages]</ulink>, + <ulink url="http://labs.jboss.com/jbossws/tutorials/en/html_single/index.ht... Page]</ulink>, + <ulink url="http://labs.jboss.com/jbossws/tutorials/en/pdf/jbossws-userguid... + </releaseinfo> + </bookinfo> + + <toc/> + + <preface id="preface" revision="1"> + <title>Preface</title> + <para> + Tutorials covering the JAX-WS 2.0 web services stack for the JBoss Application Server. + </para> + <para> If you have questions regarding JBossWS, please feel to ask the JBossWS team.</para> + + <para>Web Service Lead - Thomas Diesler</para> + <para>WS-Security, WSTools - Jason Greene</para> + <para>WS-Eventing, Standards - Heiko Braun</para> + + </preface> + + &ch-introduction; + &ch-installation; + <!-- &ch-getting-started; --> + +</book> Modified: trunk/docs/online/tutorial-doc/en/modules/installation/install-jboss.xml =================================================================== --- trunk/docs/online/tutorial-doc/en/modules/installation/install-jboss.xml 2006-12-06 14:17:04 UTC (rev 1575) +++ trunk/docs/online/tutorial-doc/en/modules/installation/install-jboss.xml 2006-12-06 15:24:38 UTC (rev 1576) @@ -1,10 +1,8 @@ <?xml version="1.0" encoding="UTF-8"?> -<!-- $Id: install-jboss.xml 1495 2006-11-21 20:29:19Z thomas.diesler(a)jboss.com $ --> - <sect1 id="install-jboss"> - <title>Install on JBoss Application Server</title> + <title>Web Services on JBoss Application Server</title> <para>To take advantage of optimum integration it is best to install JBossWS on the appserver with embedded Tomcat. In this way you get access to the full set of advanced J2EE features (JMS, JAAS, EJB, etc.) advanced class loading, @@ -13,28 +11,6 @@ <para>For additional information, see <ulink url="http://wiki.jboss.org/wiki/Wiki.jsp?page=TomcatStandalonevsEmbe... Standalone vs Embedded</ulink>.</para> - <para>Installing JBossWS on JBoss is a matter of two simple steps.</para> - - <itemizedlist> - <listitem> - <para> - Deploy jbossws.sar to ${jboss.home}/server/default/deploy. - Recommended is an expanded deployment for easy access to JBossWS configuration files. - </para> - </listitem> - <listitem> - <para> - Copy jbossws-client.jar to ${jboss.home}/client. - </para> - </listitem> - </itemizedlist> - - <para>If you are running JBoss on jdk1.4, you need to deploy jbossws14.sar and jbossws14-client.jar respectivly.</para> - - <para>The integration layer hooks into the JBoss deployer architecture and allows you to hot-deploy POJO and EJB endpoints. The - packaging of a standard portable J2EE-1.4 web service endpoints is defined by the JSR109 specification. JBossWS also supports - JSR181 endpoints, which are significantly easier to develop and maintain.</para> - <para>Additionally, please have a look at the <ulink url="http://labs.jboss.com/jbossws/user-guide/en/Install.txt"&g... specific install instructions</ulink>.</para> </sect1> Modified: trunk/docs/online/tutorial-doc/en/modules/installation/installation.xml =================================================================== --- trunk/docs/online/tutorial-doc/en/modules/installation/installation.xml 2006-12-06 14:17:04 UTC (rev 1575) +++ trunk/docs/online/tutorial-doc/en/modules/installation/installation.xml 2006-12-06 15:24:38 UTC (rev 1576) @@ -5,13 +5,20 @@ <title>Installation</title> <para> - JBossWS is based on the <ulink url="http://labs.jboss.com/portal/jbossmc">JBoss Microcontainer</ulink>, which - supports direct POJO deployment and standalone use outside the JBoss application server. Currently, we have integration - layers for the JBoss application server and Apache Tomcat. - </para> + JBossWS 2.0 (JAX-WS 2.0) is based on the + <ulink url="http://labs.jboss.com/portal/jbossmc">JBoss Microcontainer</ulink>, + which supports direct POJO deployment and standalone use outside the JBoss + application server. Currently, we have integration layers for the JBoss application + server and Apache Tomcat. + </para> + <para> + For this series of tutorials we are going to focus on using the JBoss Web Services + stack on the JBoss Application Server. If you need to know how to work with Tomcat, + please see the JBoss Web Services User Guide for more details. + </para> + &s-install-jboss; - &s-install-tomcat; + &s-install-on-jboss-5; </chapter> - Modified: trunk/docs/online/tutorial-doc/en/modules/introduction.xml =================================================================== --- trunk/docs/online/tutorial-doc/en/modules/introduction.xml 2006-12-06 14:17:04 UTC (rev 1575) +++ trunk/docs/online/tutorial-doc/en/modules/introduction.xml 2006-12-06 15:24:38 UTC (rev 1576) @@ -3,62 +3,21 @@ <chapter id="introduction"> <title>Introduction</title> - <sect1 id="features"> - <title>Features</title> - <itemizedlist> - <listitem> - <para>RPC style and Document style endpoints (wrapped and bare)</para> - </listitem> - <listitem> - <para>SOAP header values bound/unbound to endpoint parameters</para> - </listitem> - <listitem> - <para>J2EE endpoint development model for EJB and Java (JSR-109)</para> - </listitem> - <listitem> - <para>J2EE client development model (JSR-109)</para> - </listitem> - <listitem> - <para>Dynamic Invocation Interface (DII)</para> - </listitem> - <listitem> - <para>JAX-RPC client/server side handlers</para> - </listitem> - <listitem> - <para>Holders for INOUT/OUT parameters</para> - </listitem> - <listitem> - <para>Message style endpoints</para> - </listitem> - <listitem> - <para>Attachments Profile Version 1.0</para> - </listitem> - <listitem> - <para>Dynamic client/server side handler injection</para> - </listitem> - <listitem> - <para>Web Service Metadata (JSR-181)</para> - </listitem> - <listitem> - <para>EJB3 Stateless Session endpoints</para> - </listitem> - <listitem> - <para>WS-Security1.0 for XML Encryption/Signature of the SOAP message</para> - </listitem> - <listitem> - <para>WS-Addressing (W3C candidate release) and JSR-261</para> - </listitem> - <listitem> - <para>WS-Eventing</para> - </listitem> - <listitem> - <para>WS-Policy</para> - </listitem> - <listitem> - <para>MTOM/XOP</para> - </listitem> - </itemizedlist> - </sect1> + <para> + Welcome to the JBoss JAX-WS 2.0 series of tutorials. This set of tutorials is intended to help + developers in getting started with the new JAX-WS 2.0 web services stack. The initial + tutorial covers installation, a simple web service and client programs to use the simple + web service from both Eclipse and NetBeans. Over the next few weeks, further tutorials will + include adding security, MTOM example, wstools options and others. + </para> + <para> + The tutorials assume your working against JBoss Application Server 5 Beta 1 or after. If you haven't + downloaded a version of AS 5 yet, you can get it here: + <ulink url="http://labs.jboss.com/portal/jbossas/download/index.html"/... + </para> + + &s-what-is-a-web-service; + </chapter>