Author: irooskov(a)redhat.com
Date: 2010-03-11 20:08:20 -0500 (Thu, 11 Mar 2010)
New Revision: 20788
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/
branches/jbosstools-3.1.x/ws/docs/reference/en-US/Author_Group.xml
branches/jbosstools-3.1.x/ws/docs/reference/en-US/Book_Info.xml
branches/jbosstools-3.1.x/ws/docs/reference/en-US/JBoss_Web_Services_User_Guide.ent
branches/jbosstools-3.1.x/ws/docs/reference/en-US/JBoss_Web_Services_User_Guide.xml
branches/jbosstools-3.1.x/ws/docs/reference/en-US/Preface.xml
branches/jbosstools-3.1.x/ws/docs/reference/en-US/Revision_History.xml
branches/jbosstools-3.1.x/ws/docs/reference/en-US/client.xml
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/client/
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/client/jbossws_client.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/client/jbossws_client_1.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/client/jbossws_client_2.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/client/jbossws_client_3.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/jbosstools_logo.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/preference/
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/preference/Jbossws_preference.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/preference/Jbossws_preference_new.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/preference/jbossws_container1.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/preference/jbossws_container2.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/preference/jbossws_server_runtime.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_1.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_2.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_3.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_4.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_5.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_6.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_facet.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_facet_0.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_newruntime.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_webproject_1.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_webproject_2.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_webproject_3.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_ws_Impl_code_view.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_ws_creation1.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_ws_creation1_1.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_ws_creation2.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_ws_webxml.png
branches/jbosstools-3.1.x/ws/docs/reference/en-US/master.xml
branches/jbosstools-3.1.x/ws/docs/reference/en-US/master_output.xml
branches/jbosstools-3.1.x/ws/docs/reference/en-US/overview.xml
branches/jbosstools-3.1.x/ws/docs/reference/en-US/preference.xml
branches/jbosstools-3.1.x/ws/docs/reference/en-US/topdown.xml
branches/jbosstools-3.1.x/ws/docs/reference/publican.cfg
Removed:
branches/jbosstools-3.1.x/ws/docs/reference/en/
Modified:
branches/jbosstools-3.1.x/ws/docs/reference/pom.xml
Log:
updated to build with publican
Added: branches/jbosstools-3.1.x/ws/docs/reference/en-US/Author_Group.xml
===================================================================
--- branches/jbosstools-3.1.x/ws/docs/reference/en-US/Author_Group.xml
(rev 0)
+++ branches/jbosstools-3.1.x/ws/docs/reference/en-US/Author_Group.xml 2010-03-12 01:08:20
UTC (rev 20788)
@@ -0,0 +1,5 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+<authorgroup><author><firstname>Denny</firstname><surname>Xu</surname><email>dxu(a)redhat.com</email></author>
+
<author><firstname>Grid</firstname><surname>Qian</surname><email>fqian(a)redhat.com</email></author></authorgroup>
Added: branches/jbosstools-3.1.x/ws/docs/reference/en-US/Book_Info.xml
===================================================================
--- branches/jbosstools-3.1.x/ws/docs/reference/en-US/Book_Info.xml
(rev 0)
+++ branches/jbosstools-3.1.x/ws/docs/reference/en-US/Book_Info.xml 2010-03-12 01:08:20
UTC (rev 20788)
@@ -0,0 +1,4 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+<bookinfo><title>JBoss Web Services User
Guide</title><subtitle>Provides information relating to the JBoss Web Services
module.</subtitle><productname>JBoss Developer
Studio</productname><productnumber>3.0</productnumber><edition>1.0</edition><pubsnumber>0</pubsnumber><abstract><para>The
JBoss Web Services User Guide explains how to use the JBoss Web Services module to
implement web services in
Java.</para></abstract><corpauthor><inlinemediaobject><imageobject><imagedata
fileref="Common_Content/images/title_logo.svg"
format="SVG"></imagedata></imageobject></inlinemediaobject></corpauthor><xi:include
href="Common_Content/Legal_Notice.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include&g...
href="Author_Group.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include&g...
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/JBoss_Web_Services_User_Guide.ent
===================================================================
--- branches/jbosstools-3.1.x/ws/docs/reference/en-US/JBoss_Web_Services_User_Guide.ent
(rev 0)
+++
branches/jbosstools-3.1.x/ws/docs/reference/en-US/JBoss_Web_Services_User_Guide.ent 2010-03-12
01:08:20 UTC (rev 20788)
@@ -0,0 +1,4 @@
+<!ENTITY PRODUCT "JBoss">
+<!ENTITY BOOKID "JBoss_Web_Services_User_Guide">
+<!ENTITY YEAR "2010">
+<!ENTITY HOLDER "Red Hat">
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/JBoss_Web_Services_User_Guide.xml
===================================================================
--- branches/jbosstools-3.1.x/ws/docs/reference/en-US/JBoss_Web_Services_User_Guide.xml
(rev 0)
+++
branches/jbosstools-3.1.x/ws/docs/reference/en-US/JBoss_Web_Services_User_Guide.xml 2010-03-12
01:08:20 UTC (rev 20788)
@@ -0,0 +1,13 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+<book>
+<xi:include href="Book_Info.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+<xi:include href="Preface.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+<xi:include href="overview.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+<xi:include href="topdown.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+<xi:include href="client.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+<xi:include href="preference.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+<!--<xi:include href="webproject.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include&g...
+<xi:include href="Revision_History.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+</book>
Added: branches/jbosstools-3.1.x/ws/docs/reference/en-US/Preface.xml
===================================================================
--- branches/jbosstools-3.1.x/ws/docs/reference/en-US/Preface.xml
(rev 0)
+++ branches/jbosstools-3.1.x/ws/docs/reference/en-US/Preface.xml 2010-03-12 01:08:20 UTC
(rev 20788)
@@ -0,0 +1,4 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+<preface><title>Preface</title><xi:include
href="Common_Content/Conventions.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include&g...
href="Feedback.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"><xi:fallback
xmlns:xi="http://www.w3.org/2001/XInclude"><xi:include
href="Common_Content/Feedback.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include&g...
Added: branches/jbosstools-3.1.x/ws/docs/reference/en-US/Revision_History.xml
===================================================================
--- branches/jbosstools-3.1.x/ws/docs/reference/en-US/Revision_History.xml
(rev 0)
+++ branches/jbosstools-3.1.x/ws/docs/reference/en-US/Revision_History.xml 2010-03-12
01:08:20 UTC (rev 20788)
@@ -0,0 +1,4 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+<appendix><title>Revision
History</title><simpara><revhistory><revision><revnumber>0</revnumber><date>Fri
Nov 20
2009</date><author><firstname>Isaac</firstname><surname>Rooskov</surname><email>irooskov@redhat.com</email></author><revdescription><simplelist><member>Initial
creation of book by
publican</member></simplelist></revdescription></revision></revhistory></simpara></appendix>
Added: branches/jbosstools-3.1.x/ws/docs/reference/en-US/client.xml
===================================================================
--- branches/jbosstools-3.1.x/ws/docs/reference/en-US/client.xml
(rev 0)
+++ branches/jbosstools-3.1.x/ws/docs/reference/en-US/client.xml 2010-03-12 01:08:20 UTC
(rev 20788)
@@ -0,0 +1,69 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<chapter id="client" revisionflag="added">
+ <title>Creating a Web Service Client from a WSDL Document using JBoss
WS</title>
+ <para>To create a Web Service Client from a WSDL Document using JBoss WS you need
to fulfil the following steps:</para>
+ <para>Setup <link linkend="preference">JBoss WS and development
environment</link>.</para>
+ <para><link linkend="createproject">Create a Dynamic Web
project</link>.</para>
+ <para><link linkend="addfacet">Add JBossWS Facet to Web
project</link>.</para>
+ <para>Then you can create a Web Service Client from a WSDL document:
</para>
+ <itemizedlist>
+ <listitem>
+ <para>Switch to the Java EE perspective
<emphasis><property>Window > Open Perspective > Java
EE</property></emphasis>.</para>
+ </listitem>
+ <listitem>
+ <para>Click <emphasis><property>File > New >
Other</property></emphasis>. Select Web Services in order to display the
various Web service wizards. Select the Web Service Client wizard. Click on the
<property>Next</property> button.</para>
+ <figure>
+ <title>New Web Service Client</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/client/jbossws_client.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ <listitem>
+ <para>The first and the second Web Service Client wizard pages are the
same as for <link linkend="topdownwebservice">Web Service from a WSDL
document</link>.</para>
+ <figure>
+ <title>Set Web Service Common values</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/client/jbossws_client_1.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <figure>
+ <title>Set Web Service values related to WSDL file</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/client/jbossws_client_2.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>The only difference is:</para>
+ <itemizedlist>
+ <listitem>
+ <para><property>Client Type:</property> Support of
Java Proxy only.</para>
+ </listitem>
+ </itemizedlist>
+ <para>Click on the <property>Finish</property>
button.</para>
+ </listitem>
+ </itemizedlist>
+ <para>After the Web Service Client has been created, the following may occur
depending on the options you selected:</para>
+ <itemizedlist>
+ <listitem>
+ <para> the generated web service and client codes</para>
+ </listitem>
+ <listitem>
+ <para>a client sample class.</para>
+ <figure>
+ <title>Client Sample Class</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="80"
fileref="images/client/jbossws_client_3.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </itemizedlist>
+ <para>JBoss WS use a Java class to test Web Service. A client sample class
will be generated, you may run this client as a java application to call a web
service.</para>
+</chapter>
Added: branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/client/jbossws_client.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/client/jbossws_client.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/client/jbossws_client_1.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/client/jbossws_client_1.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/client/jbossws_client_2.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/client/jbossws_client_2.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/client/jbossws_client_3.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/client/jbossws_client_3.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/jbosstools_logo.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/jbosstools_logo.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/preference/Jbossws_preference.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/preference/Jbossws_preference.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/preference/Jbossws_preference_new.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/preference/Jbossws_preference_new.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/preference/jbossws_container1.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/preference/jbossws_container1.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/preference/jbossws_container2.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/preference/jbossws_container2.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/preference/jbossws_server_runtime.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/preference/jbossws_server_runtime.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_1.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_1.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_2.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_2.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_3.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_3.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_4.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_4.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_5.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_5.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_6.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_bottomup_6.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_facet.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_facet.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_facet_0.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_facet_0.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_newruntime.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_newruntime.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_webproject_1.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_webproject_1.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_webproject_2.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_webproject_2.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_webproject_3.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_webproject_3.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_ws_Impl_code_view.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_ws_Impl_code_view.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_ws_creation1.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_ws_creation1.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_ws_creation1_1.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_ws_creation1_1.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_ws_creation2.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_ws_creation2.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_ws_webxml.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/ws/docs/reference/en-US/images/topdown/jbossws_ws_webxml.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: branches/jbosstools-3.1.x/ws/docs/reference/en-US/master.xml
===================================================================
--- branches/jbosstools-3.1.x/ws/docs/reference/en-US/master.xml
(rev 0)
+++ branches/jbosstools-3.1.x/ws/docs/reference/en-US/master.xml 2010-03-12 01:08:20 UTC
(rev 20788)
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3CR3//EN"
+"http://www.docbook.org/xml/4.3/docbookx.dtd"
+
+[<!ENTITY overview SYSTEM "overview.xml">
+<!ENTITY topdown SYSTEM "topdown.xml">
+<!ENTITY preference SYSTEM "preference.xml">
+<!ENTITY webproject SYSTEM "webproject.xml">
+<!ENTITY client SYSTEM "client.xml">
+]>
+
+<book>
+
+ <bookinfo>
+ <title>JBoss Web Services User Guide</title>
+
+ <corpauthor>
+ <inlinemediaobject>
+ <imageobject role="fo">
+ <imagedata format="PNG"
fileref="images/jbosstools_logo.png" />
+ </imageobject>
+ <imageobject role="html">
+ <imagedata/>
+ </imageobject>
+ </inlinemediaobject>
+ </corpauthor>
+
<author><firstname>Denny</firstname><surname>Xu</surname><email>dxu(a)redhat.com</email></author>
+
<author><firstname>Grid</firstname><surname>Qian</surname><email>fqian(a)redhat.com</email></author>
+
+ <copyright>
+ <year>2008</year>
+ <year>2009</year>
+ <year>2010</year>
+ <holder>JBoss by Red Hat</holder>
+ </copyright>
+ <releaseinfo>
+ Version: 1.1.0.GA
+ </releaseinfo>
+<abstract>
+ <title/>
+ <para>
+ <ulink
url="http://download.jboss.org/jbosstools/nightly-docs/en/ws_ref_gui...
version</ulink>
+ </para>
+</abstract>
+
+
+ </bookinfo>
+
+ <toc/>
+ &overview;
+ &topdown;
+ &client;
+ &preference;
+</book>
Added: branches/jbosstools-3.1.x/ws/docs/reference/en-US/master_output.xml
===================================================================
--- branches/jbosstools-3.1.x/ws/docs/reference/en-US/master_output.xml
(rev 0)
+++ branches/jbosstools-3.1.x/ws/docs/reference/en-US/master_output.xml 2010-03-12
01:08:20 UTC (rev 20788)
@@ -0,0 +1,705 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3CR3//EN"
+"http://www.docbook.org/xml/4.3/docbookx.dtd"
+
+[<!ENTITY overview SYSTEM "modules/overview.xml">
+<!ENTITY topdown SYSTEM "modules/topdown.xml">
+<!ENTITY preference SYSTEM "modules/preference.xml">
+<!ENTITY webproject SYSTEM "modules/webproject.xml">
+<!ENTITY client SYSTEM "modules/client.xml">
+]><book
xmlns:diffmk="http://diffmk.sf.net/ns/diff">
+
+ <bookinfo>
+ <title>JBoss WS User Guide</title>
+
+ <corpauthor>
+ <inlinemediaobject>
+ <imageobject role="fo">
+ <imagedata fileref="images/jbosstools_logo.png"
format="PNG"></imagedata>
+ </imageobject>
+ <imageobject role="html">
+ <imagedata></imagedata>
+ </imageobject>
+ </inlinemediaobject>
+ </corpauthor>
+
<author><firstname>Denny</firstname><surname>Xu</surname><email>dxu(a)redhat.com</email></author>
+
<author><firstname>Grid</firstname><surname>Qian</surname><email>fqian(a)redhat.com</email></author>
+
+ <copyright>
+ <year>2008</year>
+ <year>2009</year>
+ <year>2010</year>
+ <holder>JBoss by Red Hat</holder>
+ </copyright>
+ <releaseinfo><diffmk:wrapper diffmk:change="changed">
+ Version: 1.1.0.GA
+ </diffmk:wrapper></releaseinfo>
+<abstract>
+ <title></title>
+ <para>
+ <ulink
url="http://download.jboss.org/jbosstools/nightly-docs/en/ws_ref_gui...
version</ulink>
+ </para>
+</abstract>
+
+
+ </bookinfo>
+
+ <toc></toc>
+
+<chapter id="overview"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/ws/docs/reference/en/modules/overview.xml">
+ <title>JBossWS Runtime Overview</title>
+
+ <para>JBossWS is a web service framework developed as a part of the JBoss
Application Server. It implements the JAX-WS specification that defines a programming
model and run-time architecture for implementing web services in Java, targeted at the
Java Platform, Enterprise Edition 5 (Java EE 5).</para>
+ <para>JBossWS integrates with most current JBoss Application Server releases as
well as earlier ones, that did implement the J2EE 1.4 specifications. Even though JAX-RPC,
the web service specification for J2EE 1.4, is still supported JBossWS does put a clear
focus on JAX-WS.</para>
+
+<section>
+ <title>Key Features of JBossWS</title>
+ <para>For a start, we propose you to look through the table of main features of
JBossWS Runtime:</para>
+
+ <table>
+
+ <title>Key Functionality for JBossWS</title>
+ <tgroup cols="2">
+
+ <colspec align="left" colnum="1"
colwidth="2*"></colspec>
+ <colspec colnum="2" colwidth="4*"></colspec>
+
+
+ <thead>
+ <row>
+ <entry>Feature</entry>
+ <entry>Benefit</entry>
+
+ </row>
+ </thead>
+
+ <tbody>
+
+ <row>
+ <entry><para>JAX-RPC and JAX-WS
support</para></entry>
+ <entry><para>JBossWS implements both the JAX-WS and
JAX-RPC specifications.</para></entry>
+
+ </row>
+
+ <row>
+ <entry><para>EJB 2.1, EJB3 and JSE
endpoints</para></entry>
+ <entry><para>JBossWS supports EJB 2.1, EJB3 and JSE as
Web Service Endpoints.</para></entry>
+
+ </row>
+
+ <row>
+ <entry><para>WS-Security 1.0 for XML Encryption/Signature
of the SOAP message</para></entry>
+ <entry><para>WS-Security standardizes authorization,
encryption, and digital signature processing of web services.</para></entry>
+
+ </row>
+
+ <row>
+ <entry><para>JBoss AS</para></entry>
+ <entry><para>JBoss Application Server 5 (JavaEE 5
compliant) web service stack.</para></entry>
+
+ </row>
+
+ <row>
+ <entry><para>Support for MTOM/XOP and
SwA-Ref</para></entry>
+ <entry><para>Message Transmission Optimization Mechanism
(MTOM) and XML-binary Optimized Packaging (XOP) more efficiently serialize XML Infosets
that have certain types of content.</para></entry>
+
+ </row>
+
+ </tbody>
+
+ </tgroup>
+ </table>
+
+
+</section>
+<section>
+ <title>Other relevant resources on the topic</title>
+
+ <para>You can find some extra information on:</para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <ulink
url="http://www.jboss.org/community/wiki/JBossWS-FAQ#Tools">... Tools
Wiki FAQ.</ulink>
+ </para>
+ </listitem>
+ </itemizedlist>
+
+
+ </section>
+
+
+
+
+</chapter>
+
+<chapter id="create_ws_topdown"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/ws/docs/reference/en/modules/topdown.xml">
+ <?dbhtml filename="topdown.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Web Service</keyword>
+ <keyword>JBossWS Web Service runtime</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Creating a Web Service using JBossWS runtime</title>
+ <para>In this chapter we provide you with the necessary steps to create a Web
Service using
+ JBossWS runtime. First you need to create a Dynamic Web project:</para>
+
+ <section id="createproject">
+ <title>Creating a Dynamic Web project</title>
+
+ <para>Before creating a web service, you should have a Dynamic Web Project
created:</para>
+ <figure float="0">
+ <title>Dynamic Web Project</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_webproject_1.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Create a Web project by selecting <emphasis>
+ <property moreinfo="none">New > Project... >
Dynamic Web project</property></emphasis>. Enter the following information:
</para>
+ <itemizedlist>
+ <listitem>
+ <para>Project Name: enter a project name</para>
+ </listitem>
+ <listitem>
+ <para>Target runtime: any server depending on your installation. If it
is not listed,
+ click <property moreinfo="none">New</property>
button and browse to the location where it is installed to. You may set <emphasis>
+ <property moreinfo="none">Target
Runtime</property>
+ </emphasis> to <emphasis>
+ <property
moreinfo="none">None</property></emphasis>, in this case, you
should add <link linkend="addfacet">JBoss Web Service
+ facet to the project</link>.</para>
+ <figure float="0">
+ <title>Dynamic Web Project Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_webproject_2.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ <listitem>
+ <para>Configuration: You may add <link
linkend="addfacet">JBoss Web Service
+ facet to the project</link> by clicking <property
moreinfo="none">Modify...</property> button. The opened page is like
<property moreinfo="none">Figure 2.4</property>.</para>
+ </listitem>
+ <listitem>
+ <para>Configure Web Module values:</para>
+ <figure float="0">
+ <title>Web Module Settings Configuration</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_webproject_3.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </itemizedlist>
+ <para>If you added the JBoss Web Service facet to the project, now the
<property moreinfo="none">Finish</property> button is disable. You
must click <property moreinfo="none">Next</property> button to set
more information about the JBoss Web Service facet. The page is like <property
moreinfo="none">Figure 2.5</property>. Then click on the <property
moreinfo="none">Finish</property> button.</para>
+ <para>If you didn't add the JBoss Web Service facet to the project, click
on the <property moreinfo="none">Finish</property> button. Next you
will need to add JBoss Web Service facet to the project.</para>
+ </section>
+
+ <section id="addfacet">
+ <title>Configure JBoss Web Service facet settings</title>
+ <para>If you have already created a new Dynamic Web project and not set the
JBoss Web Service facet to the project, the next step is to add JBoss Web
+ Service facet to the project. Right-click on the project, select its
<emphasis><property
moreinfo="none">Properties</property></emphasis> and then find
<emphasis>Project Facets</emphasis> in the tree-view on the left-side of the
project properties dialog.
+ Tick on the check box for JBoss Web Services. You will see what like this:
</para>
+ <figure float="0" id="figure_addfacet_0">
+ <title>Choose JBoss Web Service Facet</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_facet_0.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>At the bottom-left of the right-side of the project properties dialog,
there is a error link: <emphasis><property moreinfo="none">Further
configuration required...</property></emphasis> . You must click the link to
set more information about JBoss Web Service facet.</para>
+ <para>Click on the <emphasis><property
moreinfo="none">Further configuration
required...</property></emphasis> link. In the opened window</para>
+ <figure float="0" id="figure_addfacet">
+ <title>Configure JBoss Web Service Facet</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_facet.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Server Supplied JBossWS Runtime: If you have already set a JBoss
runtime to the
+ project's target runtime, you may choose <emphasis>
+ <property moreinfo="none">Server Supplied JBossWS
Runtime</property>
+ </emphasis> and then click <emphasis>
+ <property moreinfo="none">Ok</property>
+ </emphasis> to finish the configuration of JBoss Web Service facet.
</para>
+ <para>If the project has no <emphasis>
+ <property moreinfo="none">Target Runtime</property>
+ </emphasis> settings, you should check the second radio button and specify
a JBossWS
+ runtime from the list. You also can create a new JBossWS runtime, click on the
<emphasis>
+ <property moreinfo="none">New...</property>
+ </emphasis> button will bring you to another dialog to configure new
JBossWS runtime.</para>
+ <figure float="0" id="figure_addfacet1">
+ <title>Configure JBossWS Runtime</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_newruntime.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>See how to configure a new JBossWS runtime <link
linkend="preference">here</link>.</para>
+ <para>After setting the information about JBoss Web Service facet, for saving
the result, you should click the <property
moreinfo="none">Apply</property> or <property
moreinfo="none">OK</property> button at the bottom-right of the
right-side of the project properties dialog.</para>
+ </section>
+
+
+ <section id="topdownwebservice">
+ <title>Creating a Web Service from a WSDL document using JBossWS
runtime</title>
+ <para>In this chapter we provide you with the necessary steps to create a Web
Service from a
+ WSDL document using JBossWS runtime.</para>
+ <para>At first, please make sure that you have already created a dynamic Web
project with
+ JBoss Web Service facet installed. </para>
+ <para>See how to make it <link
linkend="createproject">here</link> and <link
linkend="addfacet">here</link>.</para>
+
+ <para>To create a Web Service using JBossWS runtime select<emphasis>
+ <property moreinfo="none">File > New > Other
> Web Services > Web Service</property>
+ </emphasis> to run Web Service creation wizard. </para>
+ <para>Let's get through the wizard step-by-step:</para>
+ <figure float="0" id="figure_create_ws_topdown">
+ <title>New Web Service Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_ws_creation1.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>First, please select <property moreinfo="none">Top down
Java bean Web Service</property> from the Web
+ Service type list, and select a WSDL document from workspace, click on the
Server name
+ link on the page will bring you to another dialog. Here you can specify the
server to a
+ JBoss Server and Web Service runtime to JBossWS runtime:</para>
+ <figure float="0"
id="figure_create_ws_topdown_setserver">
+ <title>Select Server and Web Service runtime</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_ws_creation1_1.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Click on the <emphasis>
+ <property moreinfo="none">Finish</property>
+ </emphasis> button to see the next wizard view opened:</para>
+
+ <figure float="0" id="figure_create_ws_topdown1">
+ <title>New Web Service Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_ws_creation1.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Click on the <emphasis>
+ <property moreinfo="none">Next</property>
+ </emphasis> button to proceed:</para>
+ <figure float="0" id="figure_create_ws_topdown_codegen">
+ <title>New Web Service Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_ws_creation2.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>On this page, the default package name comes from the namespace of the
WSDL document,
+ you also can change it to any valid package name you want. JAX-WS specification
should be
+ set to 2.0 if your JBossWS runtime in JBoss Server is JBossWS native runtime.
You can
+ specify a catalog file and binding files if you have them. If you want the
wizard to
+ generate empty implementation classes for the Web Service, check the
<emphasis>
+ <property moreinfo="none">Generate default Web Service
implementation classes</property>
+ </emphasis> check box. If you want to update the default Web.xml file with
the Web Service
+ servlets configured, check the <emphasis>
+ <property moreinfo="none">Update the default
Web.xml</property>
+ </emphasis> check box. Click on the <emphasis>
+ <property moreinfo="none">Next</property>
+ </emphasis> or on the <emphasis>
+ <property moreinfo="none">Finish</property>
+ </emphasis> button to generate code.</para>
+
+ <para>Once the Web Service code is generated, you can view the implementation
class and add
+ business logic to each method.</para>
+ <figure float="0" id="figure_impl_code">
+ <title>The generated implementation Java code</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_ws_Impl_code_view.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>View the Web.xml file:</para>
+ <figure float="0" id="figure_webxml">
+ <title>Web.xml</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_ws_webxml.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+<para>In the next chapter you will find out how to create a Web service from a Java
bean.</para>
+ </section>
+
+ <section id="bottomupws">
+ <title>Creating a Web service from a Java bean using JBossWS
runtime</title>
+ <para>The Web Service wizard assists you in creating a new Web service,
configuring it for
+ deployment, and then deploying it to the server.</para>
+ <para>To create a Web service from a bean using JBoss WS:</para>
+ <para>Setup <link linkend="preference">JBoss WS and
development environment</link>.</para>
+ <para>Create <link linkend="createproject">a Dynamic Web
project</link>.</para>
+ <para>Add <link linkend="addfacet">JBossWS Facet</link>
to Web project.</para>
+ <para>Create a Web Service from a java bean: </para>
+ <itemizedlist>
+ <listitem>
+ <para>Switch to the Java EE perspective <emphasis>
+ <property moreinfo="none">Window > Open
Perspective > Java EE</property></emphasis>.</para>
+ </listitem>
+ <listitem>
+ <para>In the Project Explorer view, select the bean that you created or
imported into
+ the source folder of your Web project.</para>
+ <figure float="0">
+ <title>Select the Bean Created</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_bottomup.png"
scale="80"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ <listitem>
+ <para>Click <emphasis>
+ <property moreinfo="none">File > New >
Other</property></emphasis>. Select Web Services in order to display various
Web service wizards.
+ Select the Web Service wizard. Click on the <property
moreinfo="none">Next</property> button.</para>
+ <figure float="0">
+ <title>New Web Service</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_bottomup_1.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ <listitem>
+ <para>On the first Web Service wizard page: select <property
moreinfo="none">Bottom up Java bean Web
+ service</property> as your Web service type, and select the Java
bean from which
+ the service will be created:</para>
+ <figure float="0">
+ <title>Set Web Service Common values</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_bottomup_2.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>Select the stages of Web service development that you want
to complete using
+ the slider: </para>
+ <itemizedlist>
+ <listitem>
+ <para>Develop: this will develop the WSDL definition and
implementation of
+ the Web service. This includes such tasks as creating modules
that will
+ contain generated code, WSDL files, deployment descriptors,
and Java
+ files when appropriate.</para>
+ </listitem>
+ <listitem>
+ <para>Assemble: this ensures the project that will host the
Web service or
+ client gets associated to an EAR when required by the target
application
+ server.</para>
+ </listitem>
+ <listitem>
+ <para>Deploy: this will create the deployment code for the
service.</para>
+ </listitem>
+ <listitem>
+ <para>Install: this will install and configure the Web
module and EARs on
+ the target server.</para>
+ </listitem>
+ <listitem>
+ <para>Start: this will start the server once the service
has been installed
+ on it. The server-config.wsdd file will be
generated.</para>
+ </listitem>
+ <listitem>
+ <para>Test: this will provide various options for testing
the service, such
+ as using the Web Service Explorer or sample
JSPs.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>Select your server: the default server is displayed. If you
want to deploy
+ your service to a different server click the link to specify a
different server.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Select your runtime: ensure the JBoss WS runtime is
selected.</para>
+ </listitem>
+ <listitem>
+ <para>Select the service project: the project selected in your
workspace is
+ displayed. To select a different project click on the project link. If
you are
+ deploying to JBoss Application Server you will also be asked to select
the EAR
+ associated with the project. Ensure that the project selected as the
Client Web
+ Project is different from the Service Web Project, or the service will
be
+ overwritten by the client's generated artifacts.</para>
+ </listitem>
+ <listitem>
+ <para>If you want to create a client, select the type of proxy to
be generated
+ and repeat the above steps for the client. The better way is to create
a web
+ service client project separately.</para>
+ </listitem>
+ </itemizedlist>
+ <para>Click on the <property
moreinfo="none">Next</property> button.</para>
+ </listitem>
+ <listitem>
+ <para>On the JBoss Web Service Code Generation Configuration page, set
the following
+ values:</para>
+ <figure float="0">
+ <title>Set Web Service values for Code Generation</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_bottomup_3.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>Generate WSDL file: select it, you will get a generated
WSDL file in your
+ project. But this wsdl's services' address location values
are not a real
+ address. </para>
+ </listitem>
+ <listitem>
+ <para>After the Web service has been created, the following
option can become
+ available depending on the options you selected: Update the default
web.xm
+ file. If selected, you may test the web service by
Explorer.</para>
+ </listitem>
+ </itemizedlist>
+ <para>Click on the <property
moreinfo="none">Next</property> button.</para>
+ </listitem>
+ <listitem>
+ <para>On this page, the project is deployed to the server. You can
start the server and
+ test the web service. If you want to publish the web service to a UDDI
registry, you
+ may click the <property
moreinfo="none">Next</property> button to publish it. If not, you may
click
+ the <property moreinfo="none">Finish</property>
button.</para>
+ <figure float="0">
+ <title>Start a Server</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_bottomup_4.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </itemizedlist>
+ <para>After the Web Service has been created, the following options may
become available
+ depending on the options selected:</para>
+ <itemizedlist>
+ <listitem>
+ <para>the generated web services code</para>
+ </listitem>
+ <listitem>
+ <para>If you selected to generate a WSDL file, you will get the file in
your project's wsdl folder.</para>
+ <figure float="0">
+ <title>The Generated HelloWorldService.wsdl File in the wsdl
Folder</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_bottomup_6.png"
scale="80"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ <listitem>
+ <para>If you selected to update the default web.xml, you will test the
web service in
+ the browser. Open the Explorer, input the url for the web service
according to
+ web.xml plus <property
moreinfo="none">?wsdl.</property>, you will get the WSDL file from
Explorer. </para>
+ <figure float="0">
+ <title>The Updated web.xml file</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_bottomup_5.png"
scale="80"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </itemizedlist>
+ <para>In the next chapter you will be able to create a Web Service Client from a
WSDL document using JBoss WS.</para>
+
+ </section>
+
+</chapter>
+
+
+<chapter id="client" revisionflag="added"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/ws/docs/reference/en/modules/client.xml">
+ <title>Creating a Web Service Client from a WSDL Document using JBoss
WS</title>
+ <para>To create a Web Service Client from a WSDL Document using JBoss WS you need
to fulfil the following steps:</para>
+ <para>Setup <link linkend="preference">JBoss WS and development
environment</link>.</para>
+ <para><link linkend="createproject">Create a Dynamic Web
project</link>.</para>
+ <para><link linkend="addfacet">Add JBossWS Facet to Web
project</link>.</para>
+ <para>Then you can create a Web Service Client from a WSDL document:
</para>
+ <itemizedlist>
+ <listitem>
+ <para>Switch to the Java EE perspective <emphasis><property
moreinfo="none">Window > Open Perspective > Java
EE</property></emphasis>.</para>
+ </listitem>
+ <listitem>
+ <para>Click <emphasis><property
moreinfo="none">File > New >
Other</property></emphasis>. Select Web Services in order to display the
various Web service wizards. Select the Web Service Client wizard. Click on the
<property moreinfo="none">Next</property> button.</para>
+ <figure float="0">
+ <title>New Web Service Client</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/client/jbossws_client.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ <listitem>
+ <para>The first and the second Web Service Client wizard pages are the
same as for <link linkend="topdownwebservice">Web Service from a WSDL
document</link>.</para>
+ <figure float="0">
+ <title>Set Web Service Common values</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/client/jbossws_client_1.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <figure float="0">
+ <title>Set Web Service values related to WSDL file</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/client/jbossws_client_2.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>The only difference is:</para>
+ <itemizedlist>
+ <listitem>
+ <para><property moreinfo="none">Client
Type:</property> Support of Java Proxy only.</para>
+ </listitem>
+ </itemizedlist>
+ <para>Click on the <property
moreinfo="none">Finish</property> button.</para>
+ </listitem>
+ </itemizedlist>
+ <para>After the Web Service Client has been created, the following may occur
depending on the options you selected:</para>
+ <itemizedlist>
+ <listitem>
+ <para> the generated web service and client codes</para>
+ </listitem>
+ <listitem>
+ <para>a client sample class.</para>
+ <figure float="0">
+ <title>Client Sample Class</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/client/jbossws_client_3.png"
scale="80"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </itemizedlist>
+ <para>JBoss WS use a Java class to test Web Service. A client sample class
will be generated, you may run this client as a java application to call a web
service.</para>
+</chapter>
+
+
+<chapter id="preference" revisionflag="added"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/ws/docs/reference/en/modules/preference.xml">
+ <title>JBoss WS and development environment</title>
+
+ <para>In this chapter you will learn how to change JBossWS preferences and how
to set default server and runtime.</para>
+ <section id="jbosswspreference">
+
+
+ <title>JBossWS Preferences</title>
+
+ <para>In this section you will know how JBossWS preferences can be modified
during the
+ development process.</para>
+
+ <para>JBossWS preferences can be set on the JBossWS preference page. Click
on
+ <emphasis><property moreinfo="none">Window
> Preferences > JBoss Tools > Web > JBossWS
+ Preferences</property>.</emphasis></para>
+
+ <para>On this page you can manage the JBossWS Runtime. Use the appropriate
buttons to
+ <property moreinfo="none">Add</property> more
runtimes or to <property moreinfo="none">Remove</property> those
that
+ are not needed.</para>
+
+ <figure float="0">
+ <title>JBossWS Preferences Page</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/preference/Jbossws_preference.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Clicking on <emphasis>
+ <property moreinfo="none">Add</property>
+ </emphasis> or <emphasis>
+ <property moreinfo="none">Edit</property>
+ </emphasis> button will open the form where you can configure a new
JBossWS runtime and
+ change the path to JBossWS runtime home folder, modify the name and version
of the
+ existing JBossWS runtime settings. Press <property
moreinfo="none">Finish</property> to apply the
+ changes.</para>
+
+ <figure float="0">
+ <title>Edit JBossWS Runtime</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/preference/Jbossws_preference_new.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+
+
+
+ <para>WS container allows Source and JavaDoc locations to be set via the
Properties dialog on each contained .jar: right-click on any .jar file in the Project
Explorer view, select <emphasis><property
moreinfo="none">Properties</property></emphasis>. Choose
<emphasis><property moreinfo="none">Java Source
Attachment</property></emphasis> and select location (folder, JAR or zip)
containing new source for the chosen .jar using one of the suggested options (workspace,
external folder or file) or enter the path manually:</para>
+
+ <figure float="0">
+ <title>Classpath Container: Java Source Attachment</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/preference/jbossws_container1.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Click on <emphasis><property
moreinfo="none">Apply</property></emphasis> and then on
<emphasis><property
moreinfo="none">Ok</property></emphasis>.</para>
+ <para>To change JavaDoc Location choose <emphasis><property
moreinfo="none">Javadoc Location</property></emphasis> and
specify URL to the documentation generated by Javadoc. The Javadoc location will contain a
file called <emphasis><property
moreinfo="none">package-list</property></emphasis>:</para>
+
+ <figure float="0">
+ <title>Classpath Container: Javadoc Location</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/preference/jbossws_container2.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Click on <emphasis><property
moreinfo="none">Apply</property></emphasis> and then on
<emphasis><property
moreinfo="none">Ok</property></emphasis>.</para>
+
+
+
+
+
+
+ </section>
+ <section id="serverruntime">
+ <title>Default Server and Runtime</title>
+ <para>Open <emphasis>
+ <property moreinfo="none">Window > Preferences
> Web Services > Server and Runtime</property></emphasis>. On
this page, you can specify a default server and runtime.</para>
+ <para>For ease of use, the better way is to set runtime to JBoss
WS.</para>
+ <para>After server and runtime are specified, click on the <property
moreinfo="none">Apply</property> button
+ to save the values.</para>
+ <figure float="0">
+ <title>Specifing a default server and runtime</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/preference/jbossws_server_runtime.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>On the whole, this guide covers the fundamental concepts of work with
tooling for
+ <property moreinfo="none">JBossWS</property>. It
describes how to easily create a Web Service and a Web Service Client using
+ JBossWS Runtime and adjust JBossWS and development environment as
well.</para>
+
+ <para>If the information on JBossWS tools in this guide isn't enough
for you, ask
+ questions on our <ulink
url="http://www.jboss.com/index.html?module=bb&op=viewforum&...;.
Your comments and suggestions are also welcome.</para>
+ </section>
+</chapter>
+
+</book>
Added: branches/jbosstools-3.1.x/ws/docs/reference/en-US/overview.xml
===================================================================
--- branches/jbosstools-3.1.x/ws/docs/reference/en-US/overview.xml
(rev 0)
+++ branches/jbosstools-3.1.x/ws/docs/reference/en-US/overview.xml 2010-03-12 01:08:20 UTC
(rev 20788)
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<chapter id="overview">
+ <title>JBossWS Runtime Overview</title>
+
+ <para>JBossWS is a web service framework developed as a part of the JBoss
Application Server. It implements the JAX-WS specification that defines a programming
model and run-time architecture for implementing web services in Java, targeted at the
Java Platform, Enterprise Edition 5 (Java EE 5).</para>
+ <para>JBossWS integrates with most current JBoss Application Server releases as
well as earlier ones, that did implement the J2EE 1.4 specifications. Even though JAX-RPC,
the web service specification for J2EE 1.4, is still supported JBossWS does put a clear
focus on JAX-WS.</para>
+
+<section>
+ <title>Key Features of JBossWS</title>
+ <para>For a start, we propose you to look through the table of main features of
JBossWS Runtime:</para>
+
+ <table>
+
+ <title>Key Functionality for JBossWS</title>
+ <tgroup cols="2">
+
+ <colspec colnum="1" align="left"
colwidth="2*"/>
+ <colspec colnum="2" colwidth="4*"/>
+
+
+ <thead>
+ <row>
+ <entry>Feature</entry>
+ <entry>Benefit</entry>
+
+ </row>
+ </thead>
+
+ <tbody>
+
+ <row>
+ <entry><para>JAX-RPC and JAX-WS
support</para></entry>
+ <entry><para>JBossWS implements both the JAX-WS and
JAX-RPC specifications.</para></entry>
+
+ </row>
+
+ <row>
+ <entry><para>EJB 2.1, EJB3 and JSE
endpoints</para></entry>
+ <entry><para>JBossWS supports EJB 2.1, EJB3 and JSE as
Web Service Endpoints.</para></entry>
+
+ </row>
+
+ <row>
+ <entry><para>WS-Security 1.0 for XML Encryption/Signature
of the SOAP message</para></entry>
+ <entry><para>WS-Security standardizes authorization,
encryption, and digital signature processing of web services.</para></entry>
+
+ </row>
+
+ <row>
+ <entry><para>JBoss AS</para></entry>
+ <entry><para>JBoss Application Server 5 (JavaEE 5
compliant) web service stack.</para></entry>
+
+ </row>
+
+ <row>
+ <entry><para>Support for MTOM/XOP and
SwA-Ref</para></entry>
+ <entry><para>Message Transmission Optimization Mechanism
(MTOM) and XML-binary Optimized Packaging (XOP) more efficiently serialize XML Infosets
that have certain types of content.</para></entry>
+
+ </row>
+
+ </tbody>
+
+ </tgroup>
+ </table>
+
+
+</section>
+<section>
+ <title>Other relevant resources on the topic</title>
+
+ <para>You can find some extra information on:</para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <ulink
url="http://www.jboss.org/community/wiki/JBossWS-FAQ#Tools">... Tools
Wiki FAQ.</ulink>
+ </para>
+ </listitem>
+ </itemizedlist>
+
+
+ </section>
+
+
+
+
+</chapter>
\ No newline at end of file
Added: branches/jbosstools-3.1.x/ws/docs/reference/en-US/preference.xml
===================================================================
--- branches/jbosstools-3.1.x/ws/docs/reference/en-US/preference.xml
(rev 0)
+++ branches/jbosstools-3.1.x/ws/docs/reference/en-US/preference.xml 2010-03-12 01:08:20
UTC (rev 20788)
@@ -0,0 +1,104 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<chapter id="preference" revisionflag="added">
+ <title>JBoss WS and development environment</title>
+
+ <para>In this chapter you will learn how to change JBossWS preferences and how
to set default server and runtime.</para>
+ <section id="jbosswspreference">
+
+
+ <title>JBossWS Preferences</title>
+
+ <para>In this section you will know how JBossWS preferences can be modified
during the
+ development process.</para>
+
+ <para>JBossWS preferences can be set on the JBossWS preference page. Click
on
+ <emphasis><property>Window > Preferences >
JBoss Tools > Web > JBossWS
+ Preferences</property>.</emphasis></para>
+
+ <para>On this page you can manage the JBossWS Runtime. Use the appropriate
buttons to
+ <property>Add</property> more runtimes or to
<property>Remove</property> those that
+ are not needed.</para>
+
+ <figure>
+ <title>JBossWS Preferences Page</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/preference/Jbossws_preference.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Clicking on <emphasis>
+ <property>Add</property>
+ </emphasis> or <emphasis>
+ <property>Edit</property>
+ </emphasis> button will open the form where you can configure a new
JBossWS runtime and
+ change the path to JBossWS runtime home folder, modify the name and version
of the
+ existing JBossWS runtime settings. Press
<property>Finish</property> to apply the
+ changes.</para>
+
+ <figure>
+ <title>Edit JBossWS Runtime</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/preference/Jbossws_preference_new.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+
+
+
+ <para>WS container allows Source and JavaDoc locations to be set via the
Properties dialog on each contained .jar: right-click on any .jar file in the Project
Explorer view, select
<emphasis><property>Properties</property></emphasis>. Choose
<emphasis><property>Java Source Attachment</property></emphasis>
and select location (folder, JAR or zip) containing new source for the chosen .jar using
one of the suggested options (workspace, external folder or file) or enter the path
manually:</para>
+
+ <figure>
+ <title>Classpath Container: Java Source Attachment</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/preference/jbossws_container1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Click on
<emphasis><property>Apply</property></emphasis> and then on
<emphasis><property>Ok</property></emphasis>.</para>
+ <para>To change JavaDoc Location choose
<emphasis><property>Javadoc Location</property></emphasis> and
specify URL to the documentation generated by Javadoc. The Javadoc location will contain a
file called
<emphasis><property>package-list</property></emphasis>:</para>
+
+ <figure>
+ <title>Classpath Container: Javadoc Location</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/preference/jbossws_container2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Click on
<emphasis><property>Apply</property></emphasis> and then on
<emphasis><property>Ok</property></emphasis>.</para>
+
+
+
+
+
+
+ </section>
+ <section id="serverruntime">
+ <title>Default Server and Runtime</title>
+ <para>Open <emphasis>
+ <property>Window > Preferences > Web Services
> Server and Runtime</property></emphasis>. On this page, you can
specify a default server and runtime.</para>
+ <para>For ease of use, the better way is to set runtime to JBoss
WS.</para>
+ <para>After server and runtime are specified, click on the
<property>Apply</property> button
+ to save the values.</para>
+ <figure>
+ <title>Specifing a default server and runtime</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/preference/jbossws_server_runtime.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>On the whole, this guide covers the fundamental concepts of work with
tooling for
+ <property>JBossWS</property>. It describes how to easily create a
Web Service and a Web Service Client using
+ JBossWS Runtime and adjust JBossWS and development environment as
well.</para>
+
+ <para>If the information on JBossWS tools in this guide isn't enough
for you, ask
+ questions on our <ulink
url="http://www.jboss.com/index.html?module=bb&op=viewforum&...;.
Your comments and suggestions are also welcome.</para>
+ </section>
+</chapter>
Added: branches/jbosstools-3.1.x/ws/docs/reference/en-US/topdown.xml
===================================================================
--- branches/jbosstools-3.1.x/ws/docs/reference/en-US/topdown.xml
(rev 0)
+++ branches/jbosstools-3.1.x/ws/docs/reference/en-US/topdown.xml 2010-03-12 01:08:20 UTC
(rev 20788)
@@ -0,0 +1,396 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<chapter id="create_ws_topdown">
+ <?dbhtml filename="topdown.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Web Service</keyword>
+ <keyword>JBossWS Web Service runtime</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Creating a Web Service using JBossWS runtime</title>
+ <para>In this chapter we provide you with the necessary steps to create a Web
Service using
+ JBossWS runtime. First you need to create a Dynamic Web project:</para>
+
+ <section id="createproject">
+ <title>Creating a Dynamic Web project</title>
+
+ <para>Before creating a web service, you should have a Dynamic Web Project
created:</para>
+ <figure>
+ <title>Dynamic Web Project</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_webproject_1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Create a Web project by selecting <emphasis>
+ <property>New > Project... > Dynamic Web
project</property></emphasis>. Enter the following information: </para>
+ <itemizedlist>
+ <listitem>
+ <para>Project Name: enter a project name</para>
+ </listitem>
+ <listitem>
+ <para>Target runtime: any server depending on your installation. If it
is not listed,
+ click <property>New</property> button and browse to the
location where it is installed to. You may set <emphasis>
+ <property>Target Runtime</property>
+ </emphasis> to <emphasis>
+ <property>None</property></emphasis>, in this case,
you should add <link linkend="addfacet">JBoss Web Service
+ facet to the project</link>.</para>
+ <figure>
+ <title>Dynamic Web Project Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_webproject_2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ <listitem>
+ <para>Configuration: You may add <link
linkend="addfacet">JBoss Web Service
+ facet to the project</link> by clicking
<property>Modify...</property> button. The opened page is like
<property>Figure 2.4</property>.</para>
+ </listitem>
+ <listitem>
+ <para>Configure Web Module values:</para>
+ <figure>
+ <title>Web Module Settings Configuration</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_webproject_3.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </itemizedlist>
+ <para>If you added the JBoss Web Service facet to the project, now the
<property>Finish</property> button is disable. You must click
<property>Next</property> button to set more information about the JBoss Web
Service facet. The page is like <property>Figure 2.5</property>. Then click on
the <property>Finish</property> button.</para>
+ <para>If you didn't add the JBoss Web Service facet to the project, click
on the <property>Finish</property> button. Next you will need to add JBoss Web
Service facet to the project.</para>
+ </section>
+
+ <section id="addfacet">
+ <title>Configure JBoss Web Service facet settings</title>
+ <para>If you have already created a new Dynamic Web project and not set the
JBoss Web Service facet to the project, the next step is to add JBoss Web
+ Service facet to the project. Right-click on the project, select its
<emphasis><property>Properties</property></emphasis> and then find
<emphasis>Project Facets</emphasis> in the tree-view on the left-side of the
project properties dialog.
+ Tick on the check box for JBoss Web Services. You will see what like this:
</para>
+ <figure id="figure_addfacet_0">
+ <title>Choose JBoss Web Service Facet</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/topdown/jbossws_facet_0.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>At the bottom-left of the right-side of the project properties dialog,
there is a error link: <emphasis><property>Further configuration
required...</property></emphasis> . You must click the link to set more
information about JBoss Web Service facet.</para>
+ <para>Click on the <emphasis><property>Further configuration
required...</property></emphasis> link. In the opened window</para>
+ <figure id="figure_addfacet">
+ <title>Configure JBoss Web Service Facet</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/topdown/jbossws_facet.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Server Supplied JBossWS Runtime: If you have already set a JBoss
runtime to the
+ project's target runtime, you may choose <emphasis>
+ <property>Server Supplied JBossWS Runtime</property>
+ </emphasis> and then click <emphasis>
+ <property>Ok</property>
+ </emphasis> to finish the configuration of JBoss Web Service facet.
</para>
+ <para>If the project has no <emphasis>
+ <property>Target Runtime</property>
+ </emphasis> settings, you should check the second radio button and specify
a JBossWS
+ runtime from the list. You also can create a new JBossWS runtime, click on the
<emphasis>
+ <property>New...</property>
+ </emphasis> button will bring you to another dialog to configure new
JBossWS runtime.</para>
+ <figure id="figure_addfacet1">
+ <title>Configure JBossWS Runtime</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_newruntime.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>See how to configure a new JBossWS runtime <link
linkend="preference">here</link>.</para>
+ <para>After setting the information about JBoss Web Service facet, for saving
the result, you should click the <property>Apply</property> or
<property>OK</property> button at the bottom-right of the right-side of the
project properties dialog.</para>
+ </section>
+
+
+ <section id="topdownwebservice">
+ <title>Creating a Web Service from a WSDL document using JBossWS
runtime</title>
+ <para>In this chapter we provide you with the necessary steps to create a Web
Service from a
+ WSDL document using JBossWS runtime.</para>
+ <para>At first, please make sure that you have already created a dynamic Web
project with
+ JBoss Web Service facet installed. </para>
+ <para>See how to make it <link
linkend="createproject">here</link> and <link
+ linkend="addfacet">here</link>.</para>
+
+ <para>To create a Web Service using JBossWS runtime select<emphasis>
+ <property>File > New > Other > Web Services > Web
Service</property>
+ </emphasis> to run Web Service creation wizard. </para>
+ <para>Let's get through the wizard step-by-step:</para>
+ <figure id="figure_create_ws_topdown">
+ <title>New Web Service Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_ws_creation1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>First, please select <property>Top down Java bean Web
Service</property> from the Web
+ Service type list, and select a WSDL document from workspace, click on the
Server name
+ link on the page will bring you to another dialog. Here you can specify the
server to a
+ JBoss Server and Web Service runtime to JBossWS runtime:</para>
+ <figure id="figure_create_ws_topdown_setserver">
+ <title>Select Server and Web Service runtime</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_ws_creation1_1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Click on the <emphasis>
+ <property>Finish</property>
+ </emphasis> button to see the next wizard view opened:</para>
+
+ <figure id="figure_create_ws_topdown1">
+ <title>New Web Service Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_ws_creation1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Click on the <emphasis>
+ <property>Next</property>
+ </emphasis> button to proceed:</para>
+ <figure id="figure_create_ws_topdown_codegen">
+ <title>New Web Service Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_ws_creation2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>On this page, the default package name comes from the namespace of the
WSDL document,
+ you also can change it to any valid package name you want. JAX-WS specification
should be
+ set to 2.0 if your JBossWS runtime in JBoss Server is JBossWS native runtime.
You can
+ specify a catalog file and binding files if you have them. If you want the
wizard to
+ generate empty implementation classes for the Web Service, check the
<emphasis>
+ <property>Generate default Web Service implementation
classes</property>
+ </emphasis> check box. If you want to update the default Web.xml file with
the Web Service
+ servlets configured, check the <emphasis>
+ <property>Update the default Web.xml</property>
+ </emphasis> check box. Click on the <emphasis>
+ <property>Next</property>
+ </emphasis> or on the <emphasis>
+ <property>Finish</property>
+ </emphasis> button to generate code.</para>
+
+ <para>Once the Web Service code is generated, you can view the implementation
class and add
+ business logic to each method.</para>
+ <figure id="figure_impl_code">
+ <title>The generated implementation Java code</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_ws_Impl_code_view.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>View the Web.xml file:</para>
+ <figure id="figure_webxml">
+ <title>Web.xml</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_ws_webxml.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+<para>In the next chapter you will find out how to create a Web service from a Java
bean.</para>
+ </section>
+
+ <section id="bottomupws">
+ <title>Creating a Web service from a Java bean using JBossWS
runtime</title>
+ <para>The Web Service wizard assists you in creating a new Web service,
configuring it for
+ deployment, and then deploying it to the server.</para>
+ <para>To create a Web service from a bean using JBoss WS:</para>
+ <para>Setup <link linkend="preference">JBoss WS and
development environment</link>.</para>
+ <para>Create <link linkend="createproject">a Dynamic Web
project</link>.</para>
+ <para>Add <link linkend="addfacet">JBossWS Facet</link>
to Web project.</para>
+ <para>Create a Web Service from a java bean: </para>
+ <itemizedlist>
+ <listitem>
+ <para>Switch to the Java EE perspective <emphasis>
+ <property>Window > Open Perspective > Java
EE</property></emphasis>.</para>
+ </listitem>
+ <listitem>
+ <para>In the Project Explorer view, select the bean that you created or
imported into
+ the source folder of your Web project.</para>
+ <figure>
+ <title>Select the Bean Created</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="80"
fileref="images/topdown/jbossws_bottomup.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ <listitem>
+ <para>Click <emphasis>
+ <property>File > New >
Other</property></emphasis>. Select Web Services in order to display various
Web service wizards.
+ Select the Web Service wizard. Click on the
<property>Next</property> button.</para>
+ <figure>
+ <title>New Web Service</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_bottomup_1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ <listitem>
+ <para>On the first Web Service wizard page: select
<property>Bottom up Java bean Web
+ service</property> as your Web service type, and select the Java
bean from which
+ the service will be created:</para>
+ <figure>
+ <title>Set Web Service Common values</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_bottomup_2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>Select the stages of Web service development that you want
to complete using
+ the slider: </para>
+ <itemizedlist>
+ <listitem>
+ <para>Develop: this will develop the WSDL definition and
implementation of
+ the Web service. This includes such tasks as creating modules
that will
+ contain generated code, WSDL files, deployment descriptors,
and Java
+ files when appropriate.</para>
+ </listitem>
+ <listitem>
+ <para>Assemble: this ensures the project that will host the
Web service or
+ client gets associated to an EAR when required by the target
application
+ server.</para>
+ </listitem>
+ <listitem>
+ <para>Deploy: this will create the deployment code for the
service.</para>
+ </listitem>
+ <listitem>
+ <para>Install: this will install and configure the Web
module and EARs on
+ the target server.</para>
+ </listitem>
+ <listitem>
+ <para>Start: this will start the server once the service
has been installed
+ on it. The server-config.wsdd file will be
generated.</para>
+ </listitem>
+ <listitem>
+ <para>Test: this will provide various options for testing
the service, such
+ as using the Web Service Explorer or sample
JSPs.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>Select your server: the default server is displayed. If you
want to deploy
+ your service to a different server click the link to specify a
different server.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Select your runtime: ensure the JBoss WS runtime is
selected.</para>
+ </listitem>
+ <listitem>
+ <para>Select the service project: the project selected in your
workspace is
+ displayed. To select a different project click on the project link. If
you are
+ deploying to JBoss Application Server you will also be asked to select
the EAR
+ associated with the project. Ensure that the project selected as the
Client Web
+ Project is different from the Service Web Project, or the service will
be
+ overwritten by the client's generated artifacts.</para>
+ </listitem>
+ <listitem>
+ <para>If you want to create a client, select the type of proxy to
be generated
+ and repeat the above steps for the client. The better way is to create
a web
+ service client project separately.</para>
+ </listitem>
+ </itemizedlist>
+ <para>Click on the <property>Next</property>
button.</para>
+ </listitem>
+ <listitem>
+ <para>On the JBoss Web Service Code Generation Configuration page, set
the following
+ values:</para>
+ <figure>
+ <title>Set Web Service values for Code Generation</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_bottomup_3.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>Generate WSDL file: select it, you will get a generated
WSDL file in your
+ project. But this wsdl's services' address location values
are not a real
+ address. </para>
+ </listitem>
+ <listitem>
+ <para>After the Web service has been created, the following
option can become
+ available depending on the options you selected: Update the default
web.xm
+ file. If selected, you may test the web service by
Explorer.</para>
+ </listitem>
+ </itemizedlist>
+ <para>Click on the <property>Next</property>
button.</para>
+ </listitem>
+ <listitem>
+ <para>On this page, the project is deployed to the server. You can
start the server and
+ test the web service. If you want to publish the web service to a UDDI
registry, you
+ may click the <property>Next</property> button to publish it.
If not, you may click
+ the <property>Finish</property> button.</para>
+ <figure>
+ <title>Start a Server</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/topdown/jbossws_bottomup_4.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </itemizedlist>
+ <para>After the Web Service has been created, the following options may
become available
+ depending on the options selected:</para>
+ <itemizedlist>
+ <listitem>
+ <para>the generated web services code</para>
+ </listitem>
+ <listitem>
+ <para>If you selected to generate a WSDL file, you will get the file in
your project's wsdl folder.</para>
+ <figure>
+ <title>The Generated HelloWorldService.wsdl File in the wsdl
Folder</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="80"
fileref="images/topdown/jbossws_bottomup_6.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ <listitem>
+ <para>If you selected to update the default web.xml, you will test the
web service in
+ the browser. Open the Explorer, input the url for the web service
according to
+ web.xml plus <property>?wsdl.</property>, you will get the
WSDL file from Explorer. </para>
+ <figure>
+ <title>The Updated web.xml file</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="80"
fileref="images/topdown/jbossws_bottomup_5.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </itemizedlist>
+ <para>In the next chapter you will be able to create a Web Service Client from a
WSDL document using JBoss WS.</para>
+
+ </section>
+
+</chapter>
Modified: branches/jbosstools-3.1.x/ws/docs/reference/pom.xml
===================================================================
--- branches/jbosstools-3.1.x/ws/docs/reference/pom.xml 2010-03-12 01:05:58 UTC (rev
20787)
+++ branches/jbosstools-3.1.x/ws/docs/reference/pom.xml 2010-03-12 01:08:20 UTC (rev
20788)
@@ -14,7 +14,7 @@
<profile>
<id>release</id>
<properties>
- <master>master_output.xml</master>
+ <!-- <master>master_output.xml</master> -->
<xsl-single>classpath:/xslt/org/jboss/tools/xhtml-single-release.xsl</xsl-single>
<xsl-chunked>classpath:/xslt/org/jboss/tools/xhtml-release.xsl</xsl-chunked>
<xsl-pdf>classpath:/xslt/org/jboss/tools/pdf.xsl</xsl-pdf>
@@ -23,7 +23,7 @@
<profile>
<id>releaseTest</id>
<properties>
- <master>master_output.xml</master>
+ <!-- <master>master_output.xml</master> -->
<xsl-single>classpath:/xslt/org/jboss/tools/xhtml-single-release-nomarker.xsl</xsl-single>
<xsl-chunked>classpath:/xslt/org/jboss/tools/xhtml-release-nomarker.xsl</xsl-chunked>
<xsl-pdf>classpath:/xslt/org/jboss/tools/pdf.xsl</xsl-pdf>
@@ -32,7 +32,7 @@
<profile>
<id>releaseJBDS</id>
<properties>
- <master>master.xml</master>
+ <!-- <master>master_output.xml</master> -->
<xsl-single>classpath:/xslt/com/jboss/tools/xhtml-single-release.xsl</xsl-single>
<xsl-chunked>classpath:/xslt/com/jboss/tools/xhtml-release.xsl</xsl-chunked>
<xsl-pdf>classpath:/xslt/com/jboss/tools/pdf.xsl</xsl-pdf>
@@ -42,7 +42,7 @@
<profile>
<id>diffmk</id>
<properties>
- <master>master_output.xml</master>
+ <!-- <master>master_output.xml</master> -->
<xsl-single>classpath:/xslt/org/jboss/tools/xhtml-single-diff.xsl</xsl-single>
<xsl-chunked>classpath:/xslt/org/jboss/tools/xhtml-diff.xsl</xsl-chunked>
<xsl-pdf>classpath:/xslt/org/jboss/tools/pdf-diff.xsl</xsl-pdf>
@@ -93,18 +93,18 @@
</dependency>
</dependencies>
- <configuration>
- <sourceDocumentName>${master}</sourceDocumentName>
- <sourceDirectory>${pom.basedir}/en</sourceDirectory>
- <imageResource>
- <directory>${pom.basedir}/en</directory>
- <includes>
- <include>images/**/*</include>
- </includes>
- </imageResource>
- <cssResource>
- <directory>${pom.basedir}/${cssdir}</directory>
- </cssResource>
+ <configuration>
+ <sourceDocumentName>master.xml</sourceDocumentName>
+ <sourceDirectory>${pom.basedir}/en-US</sourceDirectory>
+ <imageResource>
+ <directory>${pom.basedir}/en-US</directory>
+ <includes>
+ <include>images/**/*</include>
+ </includes>
+ </imageResource>
+ <cssResource>
+ <directory>${pom.basedir}/${cssdir}</directory>
+ </cssResource>
<formats>
<format>
@@ -163,7 +163,7 @@
<xsl-chunked>classpath:/xslt/org/jboss/tools/xhtml.xsl</xsl-chunked>
<xsl-pdf>classpath:/xslt/org/jboss/tools/pdf.xsl</xsl-pdf>
<cssdir>../../../documentation/jbosstools-jdocbook-style/src/main/org/css/</cssdir>
- <master>master.xml</master>
+ <master>JBoss_Web_Services_User_Guide</master>
<translation>en-US</translation>
</properties>
Added: branches/jbosstools-3.1.x/ws/docs/reference/publican.cfg
===================================================================
--- branches/jbosstools-3.1.x/ws/docs/reference/publican.cfg (rev
0)
+++ branches/jbosstools-3.1.x/ws/docs/reference/publican.cfg 2010-03-12 01:08:20 UTC (rev
20788)
@@ -0,0 +1,7 @@
+# Config::Simple 4.59
+# Fri Nov 20 13:19:45 2009
+
+xml_lang: en-US
+type: Book
+brand: JBoss
+