[jbosstools-commits] JBoss Tools SVN: r32989 - in branches/jbosstools-3.2.x/ws/docs/reference: en-US and 2 other directories.

Author: irooskov(a)redhat.com Date: 2011-07-17 22:56:55 -0400 (Sun, 17 Jul 2011) New Revision: 32989 Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/Author_Group.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/Book_Info.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/Feedback.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/JBoss_Web_Services_User_Guide.ent branches/jbosstools-3.2.x/ws/docs/reference/en-US/JBoss_Web_Services_User_Guide.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/Preface.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/Revision_History.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/images/preference/Jbossws_preference.png branches/jbosstools-3.2.x/ws/docs/reference/en-US/images/preference/Jbossws_preference_new.png branches/jbosstools-3.2.x/ws/docs/reference/en-US/images/topdown/jbossws_facet.png branches/jbosstools-3.2.x/ws/docs/reference/en-US/images/topdown/jbossws_newruntime.png branches/jbosstools-3.2.x/ws/docs/reference/en-US/images/topdown/jbossws_ws_creation2.png branches/jbosstools-3.2.x/ws/docs/reference/en-US/master.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/overview.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/preference.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-generate_a_sample_restful_web_service.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-new_project_example.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-test_JAX-RS.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-test_JAX-WS.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-test_resteasy_JAX-RS.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-test_restfulsample_JAX-RS.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/sample_web_service_wizards.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/testing_a_restful_web_service-web_service_test_view.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/testing_a_web_service-web_service_test_view.xml branches/jbosstools-3.2.x/ws/docs/reference/en-US/topdown.xml branches/jbosstools-3.2.x/ws/docs/reference/pom.xml branches/jbosstools-3.2.x/ws/docs/reference/publican.cfg Log: updated for GA Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/Author_Group.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/Author_Group.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/Author_Group.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -1,15 +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" [ ]> -&lt;authorgroup&gt;&lt;author&gt;&lt;firstname&gt;Denny&lt;/firstname&gt;&lt;surname&gt;Xu&lt;/surname&gt;&lt;email&gt;dxu(a)redhat.com&lt;/email&gt;&lt;/author&gt; - <author&gt;&lt;firstname&gt;Grid&lt;/firstname&gt;&lt;surname&gt;Qian&lt;/surname&gt;&lt;email&gt;fqian(a)redhat.com&lt;/email&gt;&lt;/author&gt;&lt;author&gt; +<authorgroup><author><firstname>Denny</firstname><surname>Xu</surname></author> + <author><firstname>Grid</firstname><surname>Qian</surname></author><author> <firstname>Brian </firstname> <surname>Fitzpatrick</surname> - <email&gt;bfitzpat(a)redhat.com&lt;/email&gt; </author> <author> <firstname>Ben </firstname> <surname>Clare</surname> - <email&gt;bclare(a)redhat.com&lt;/email&gt; </author> - <editor&gt;&lt;firstname&gt;Isaac&lt;/firstname&gt;&lt;surname&gt;Rooskov&lt;/surname&gt;&lt;email&gt;irooskov(a)redhat.com&lt;/email&gt;&lt;/editor&gt;&lt;/authorgroup&gt; + <editor><firstname>Isaac</firstname><surname>Rooskov</surname></editor></authorgroup> Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/Book_Info.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/Book_Info.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/Book_Info.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -5,9 +5,9 @@ <title>JBoss Web Services User Guide</title> <subtitle>Provides information relating to the JBoss Web Services module.</subtitle> <productname>JBoss Developer Studio</productname> - <productnumber>4.0</productnumber> - <edition>4.0.0</edition> - <pubsnumber>4</pubsnumber> + <productnumber>4.1</productnumber> + <edition>4.1.0</edition> + <pubsnumber>6</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> Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/Feedback.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/Feedback.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/Feedback.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -1,20 +1,92 @@ <?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Document_Conventions.ent"> +%BOOK_ENTITIES; +]> +<appendix id="sect_JBoss-Getting_Help_and_Giving_Feedback" lang="en-US"> + <title>Getting Help and Giving Feedback</title> + <section id="sect_JBoss-Do_You_Need_Help"> + <title>Do You Need Help?</title> + <indexterm> + <primary>help</primary> + <secondary>getting help</secondary> -<section id="sect-Beginners_Guide-We_Need_Feedback" lang="en-US"> - <title>We Need Feedback!</title> - <indexterm> - <primary>feedback</primary> - <secondary>contact information for this manual</secondary> - </indexterm> - <para> - If you find a typographical error in this manual, or if you have thought of a way to make this manual better, we would love to hear from you! Please submit a report in JIRA against JBoss Developer Studio: <ulink url="https://jira.jboss.org/jira/secure/CreateIssue.jspa?pid=1231050... - </para> - <para> - When submitting a bug report, be sure to mention the manual's name and to select the "documentation" component. - </para> - <para> - If you have a suggestion for improving the documentation, try to be as specific as possible when describing it. If you have found an error, please include the section number and some of the surrounding text so we can find it easily. - </para> -</section> + </indexterm> + <para> + If you experience difficulty with a procedure described in this documentation, visit the Red Hat Customer Portal at <ulink url="http://access.redhat.com" />. Through the customer portal, you can: + </para> + <itemizedlist> + <listitem> + <para> + search or browse through a knowledgebase of technical support articles about Red Hat products. + </para> + </listitem> + <listitem> + <para> + submit a support case to Red Hat Global Support Services (GSS). + </para> + </listitem> + <listitem> + <para> + access other product documentation. + </para> + + </listitem> + + </itemizedlist> + <para> + Red Hat also hosts a large number of electronic mailing lists for discussion of Red Hat software and technology. You can find a list of publicly available mailing lists at <ulink url="https://www.redhat.com/mailman/listinfo" />. Click on the name of any mailing list to subscribe to that list or to access the list archives. + </para> + + </section> + + <section id="jboss-feedback"> + <title>Give us Feedback</title> + <!-- NOTE: You will need the following entities defined in your .ent file. + You will need to replace _YOUR_PRODUCT_HERE_, _YOUR_COMPONENT_ + and _YOUR_SUMMARY_ - entities are not replaced in URLs. + <!ENTITY PRODUCT "JBoss Product Name"> + <!ENTITY BZCOMPONENT "doc-triage"> + <!ENTITY BZURL "<ulink url='https://bugzilla.example.com/enter_bug.cgi?product=_YOUR_PRODUCT... + + These entities should not affect translated documents, since Bugzilla is not localised. + --> <indexterm> + <primary>feedback</primary> + <secondary>contact information for this manual</secondary> + + </indexterm> + <para> + If you find a typographical error, or know how this guide can be improved, we would love to hear from you. Submit a report in Bugzilla against the product <literal>&BZPRODUCT;</literal> and the component <literal>&BZCOMPONENT;</literal>. The following link will take you to a pre-filled bug report for this product: &BZURL;. + </para> + <para> + Fill out the following template in Bugzilla's <literal>Description</literal> field. Be as specific as possible when describing the issue; this will help ensure that we can fix it quickly. + </para> + +<screen>Document URL: + + +Section Number and Name: + + +Describe the issue: + + +Suggestions for improvement: + + +Additional information: + + +</screen> + <para> + Be sure to give us your name so that you can receive full credit for reporting the issue. + </para> + + </section> + + +</appendix> + + Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/JBoss_Web_Services_User_Guide.ent =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/JBoss_Web_Services_User_Guide.ent 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/JBoss_Web_Services_User_Guide.ent 2011-07-18 02:56:55 UTC (rev 32989) @@ -1,8 +1,7 @@ <!ENTITY PRODUCT "JBoss"> <!ENTITY BOOKID "JBoss_Web_Services_User_Guide"> -<!ENTITY YEAR "2010"> +<!ENTITY YEAR "2011"> <!ENTITY HOLDER "Red Hat"> - - -<!--<!ENTITY HORIZ_LINE "&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;&boxh;"> ---> +<!ENTITY BZPRODUCT "JBoss Developer Studio"> +<!ENTITY BZCOMPONENT "Web Services User Guide"> +<!ENTITY BZURL "<ulink url='https://bugzilla.redhat.com/enter_bug.cgi?product=JBoss&perc... Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/JBoss_Web_Services_User_Guide.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/JBoss_Web_Services_User_Guide.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/JBoss_Web_Services_User_Guide.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -14,5 +14,6 @@ <xi:include href="sample_web_service_wizards.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="resteasy_simple_project_example.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="web_service_test_view.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<xi:include href="Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> </book> Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/Preface.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/Preface.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/Preface.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -8,9 +8,5 @@ <para> This manual uses several conventions to highlight certain words and phrases and draw attention to specific pieces of information. To get more information on these conventions please refer to the <guilabel>Document Conventions</guilabel> manual, which can be found on the <ulink url="http://docs.redhat.com/docs/en-US/JBoss_Developer_Studio/index.... Hat Documentation</ulink> website under the <guilabel>JBoss Developer Studio</guilabel> section. </para> - <!--<xi:include href="Common_Content/Conventions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include 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:fallback> - </xi:include>--> </preface> Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/Revision_History.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/Revision_History.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/Revision_History.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -5,6 +5,17 @@ <title>Revision History</title> <simpara> <revhistory> + <revision> + <revnumber>3.0</revnumber><date>Mon Jun 27 2011</date> + <author> + <firstname>Isaac</firstname><surname>Rooskov</surname><email></email> + </author> + <revdescription> + <simplelist> + <member>Updated with new information concerning JBoss Web Service Code Generation Configuration</member> + </simplelist> + </revdescription> + </revision> <revision> <revnumber>2.0</revnumber><date>Tue Nov 16 2010</date> <author> Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/images/preference/Jbossws_preference.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/images/preference/Jbossws_preference_new.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/images/topdown/jbossws_facet.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/images/topdown/jbossws_newruntime.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/images/topdown/jbossws_ws_creation2.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/master.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/master.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/master.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -28,31 +28,29 @@ </imageobject> </inlinemediaobject> </corpauthor> - <author&gt;&lt;firstname&gt;Denny&lt;/firstname&gt;&lt;surname&gt;Xu&lt;/surname&gt;&lt;email&gt;dxu(a)redhat.com&lt;/email&gt;&lt;/author&gt; + <author><firstname>Denny</firstname><surname>Xu</surname></author> <author> <firstname>Grid</firstname> <surname>Qian</surname> - <email&gt;fqian(a)redhat.com&lt;/email&gt; </author> <author> <firstname>Brian </firstname> <surname>Fitzpatrick</surname> - <email&gt;bfitzpatrick(a)redhat.com&lt;/email&gt; </author> <author> <firstname>Ben </firstname> <surname>Clare</surname> - <email&gt;bclare(a)redhat.com&lt;/email&gt; </author> - + <editor> + <firstname>Isaac</firstname> + <surname>Rooskov</surname> + </editor> <copyright> - <year>2008</year> - <year>2009</year> - <year>2010</year> + <year>2011</year> <holder>JBoss by Red Hat</holder> </copyright> <releaseinfo> - Version: 3.2.0.GA + Version: 3.2.1.GA </releaseinfo> <!--<abstract> <title/> Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/overview.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/overview.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/overview.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -1,14 +1,14 @@ <?xml version="1.0" encoding="ISO-8859-1"?> <chapter id="overview"> - <title>JBossWS Runtime Overview</title> - + <title>JBossWS Runtime and Tools support Overview</title> <para>JBossWS is a web service framework developed as a part of the JBoss Application Server. It implements the JAX-WS and JAX-RS specifications. JAX-WS (Java API for XML Web Services) 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). JAX-RS (Java API for RESTful Web Services) is a Java API that supports the creation of Representational State Transfer (REST) web services, using annotations. </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> - + <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> + <para>JBossWS Tool works with <property>JBossWS Runtime</property>. Users can easily create, deploy and run a Web Service(WSDL base or RESTful base) and a Web Service Client using JBossWS Tool and JBossWS Runtime.</para> + <para>Also JBossWS Tool gives a way to test a web service running on a server.</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> @@ -71,9 +71,7 @@ </tbody> </tgroup> - </table> - - + </table> </section> <section> <title>Other relevant resources on the topic</title> @@ -82,15 +80,14 @@ <itemizedlist> <listitem> <para> - <ulink url="http://www.jboss.org/community/wiki/JBossWS-FAQ#Tools">... Tools Wiki FAQ.</ulink> + <ulink url="http://www.jboss.org/community/wiki/JBossWS-FAQ#Tools">... Wiki FAQ.</ulink> </para> </listitem> - </itemizedlist> - - - </section> - - - - + <listitem> + <para> + <ulink url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... Tools Forum.</ulink> + </para> + </listitem> + </itemizedlist> +</section> </chapter> \ No newline at end of file Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/preference.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/preference.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/preference.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -1,104 +1,102 @@ <?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 &gt; Preferences &gt; JBoss Tools &gt; Web &gt; 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 &gt; Preferences &gt; Web Services &gt; 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&amp;op=viewforum&...;. Your comments and suggestions are also welcome.</para> - </section> + <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 &gt; Preferences &gt; JBoss Tools &gt; Web &gt; 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 <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>Web Services</guimenuitem><guimenuitem>Server and Runtime</guimenuitem></menuchoice>. 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>Specifying a default server and runtime</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preference/jbossws_server_runtime.png"/> + </imageobject> + </mediaobject> + </figure> + </section> </chapter> Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-generate_a_sample_restful_web_service.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-generate_a_sample_restful_web_service.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-generate_a_sample_restful_web_service.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -209,7 +209,7 @@ </step> <step><title>Browse the web.xml deployment descriptor</title> <para> - Double click the <filename>web.xml</filename> file and note the <parameter>jax.ws.rs.Application</parameter> paramater mapped to the <application>Application</application> class. Note also that: + Double click the <filename>web.xml</filename> file and note the <parameter>jax.ws.rs.Application</parameter> parameter mapped to the <application>Application</application> class. Note also that: </para> <itemizedlist> <listitem> Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-new_project_example.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-new_project_example.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-new_project_example.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -124,7 +124,7 @@ </step> <step><title>Determine the URL for the web service</title> <para> - Double click the <filename>web.xml</filename> file and note the <parameter>jax.ws.rs.Application</parameter> paramater mapped to the <application>Application</application> class. Note also that: + Double click the <filename>web.xml</filename> file and note the <parameter>jax.ws.rs.Application</parameter> parameter mapped to the <application>Application</application> class. Note also that: </para> <itemizedlist> <listitem> Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-test_JAX-RS.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-test_JAX-RS.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-test_JAX-RS.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -216,7 +216,7 @@ </para> </formalpara> <figure id="figure-jbt-test_resteasy_JAX-RS_09"> - <title>Custmer data updated</title> + <title>Customer data updated</title> <mediaobject> <imageobject> <imagedata fileref="images/image-jbt-test_resteasy_JAX-RS_09.png" format="PNG"/> @@ -263,7 +263,7 @@ </para> </formalpara> <figure id="figure-jbt-test_resteasy_JAX-RS_10"> - <title>Custmer data deleted</title> + <title>Customer data deleted</title> <mediaobject> <imageobject> <imagedata fileref="images/image-jbt-test_resteasy_JAX-RS_10.png" format="PNG"/> Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-test_JAX-WS.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-test_JAX-WS.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-test_JAX-WS.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -59,7 +59,7 @@ <step> <title>Select the required service attributes</title> <para> - Select the <guilabel>Service</guilabel>, <guibutton>Port</guibutton> and <guibutton>Operation</guibutton> from the combo boxes and click <guibutton>OK</guibutton>. + Select the <guilabel>Service</guilabel>, <guibutton>Port</guibutton> and <guibutton>Operation</guibutton> from the comboboxes and click <guibutton>OK</guibutton>. </para> <formalpara><title>Results:</title> <para> Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-test_resteasy_JAX-RS.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-test_resteasy_JAX-RS.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-test_resteasy_JAX-RS.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -216,7 +216,7 @@ </para> </formalpara> <figure id="figure-jbt-test_resteasy_JAX-RS_09"> - <title>Custmer data updated</title> + <title>Customer data updated</title> <mediaobject> <imageobject> <imagedata fileref="images/image-jbt-test_resteasy_JAX-RS_09.png" format="PNG"/> @@ -263,7 +263,7 @@ </para> </formalpara> <figure id="figure-jbt-test_resteasy_JAX-RS_10"> - <title>Custmer data deleted</title> + <title>Customer data deleted</title> <mediaobject> <imageobject> <imagedata fileref="images/image-jbt-test_resteasy_JAX-RS_10.png" format="PNG"/> Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-test_restfulsample_JAX-RS.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-test_restfulsample_JAX-RS.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/proc-jbt-test_restfulsample_JAX-RS.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -9,7 +9,7 @@ <substeps> <step><title>Query the available options</title> <para> - Select <guilabel>OPTIONS</guilabel> from the available combo box options. + Select <guilabel>OPTIONS</guilabel> from the available combobox options. </para> </step> <step> @@ -46,7 +46,7 @@ <substeps> <step> <para> - Having established that the <guilabel>GET</guilabel> request is valid, select <guilabel>GET</guilabel> from the available combo box options. + Having established that the <guilabel>GET</guilabel> request is valid, select <guilabel>GET</guilabel> from the available combobox options. </para> </step> <step> Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/sample_web_service_wizards.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/sample_web_service_wizards.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/sample_web_service_wizards.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -16,7 +16,7 @@ </listitem> <listitem> <para> - <guilabel>Create a sample RESTful Web Service</guilabel> for a JAX-WS web service. + <guilabel>Create a sample RESTful Web Service</guilabel> for a JAX-RS web service. </para> </listitem> </itemizedlist> Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/testing_a_restful_web_service-web_service_test_view.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/testing_a_restful_web_service-web_service_test_view.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/testing_a_restful_web_service-web_service_test_view.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -4,31 +4,41 @@ %BOOK_ENTITIES; ]>--> <section id="web_service_test_view-testing_a_restful_web_service"> - <title>Testing a RESTful Web Service</title> + <title>Testing a RESTful Web Service</title> <para> - Testing a RESTful (<acronym>JAX-RS</acronym>) web service is achieved by following a similar procedure to testing a JAX-WS web service. Instead of selecting the JAX-WS option in the combo box, the JAX-RS service is invoked by sending HTTP method requests of the form OPTIONS, GET, POST, PUT and DELETE. As there is no WSDL file associated with a JAX-RS service, the available options can be determined by selecting <guilabel>OPTIONS</guilabel> in the combo box. + Testing a RESTful ( + <acronym> + JAX-RS + </acronym> + ) web service is achieved by following a similar procedure to testing a JAX-WS web service. Instead of selecting the JAX-WS option in the combobox, the JAX-RS service is invoked by sending HTTP method requests of the form OPTIONS, GET, POST, PUT and DELETE. As there is no WSDL file associated with a JAX-RS service, the available options can be determined by selecting <guilabel> OPTIONS </guilabel> in the combobox. </para> - <para> - A JAX-RS web service can be tested by using the <guilabel>Web Service Tester View </guilabel> displayed in <xref linkend="figure-jbt-web_service_test_view"/>. The JAX-RS test is specified by: + + <para> + A JAX-RS web service can be tested by using the <guilabel> Web Service Tester View </guilabel> displayed in <xref linkend="figure-jbt-web_service_test_view"/>. The JAX-RS test is specified by: </para> + <orderedlist> <listitem> <para> - Selecting the <guilabel>OPTIONS</guilabel> combo box option. + Selecting the <guilabel> OPTIONS </guilabel> combobox option. </para> </listitem> + <listitem id="restful_step2"> <para> Entering the url of the JAX-RS web service. </para> </listitem> - </orderedlist> - <para> - The test procedure is discussed in the following sections for both the <application>RestfulSample</application> and the <application>RESTEasy</application> sample projects developed earlier. - </para> - <xi:include href="restfulsample_project-web_service_test_view.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="resteasy_sample_project-web_service_test_view.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <!-- + </orderedlist> + + <para> + The test procedure is discussed in the following sections for both the <application>RestfulSample</application> and the <application>RESTEasy</application> sample projects developed earlier. + </para> + + <xi:include href="restfulsample_project-web_service_test_view.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + + <xi:include href="resteasy_sample_project-web_service_test_view.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<!-- <formalpara><title>Testing a JAX-RS web service - Preliminaries</title> <para> <xref linkend="proc-jbt-test_JAX-RS_prelim"/> lists the preliminary steps required before testing a JAX-RS web service project. @@ -49,4 +59,4 @@ </formalpara> <xi:include href="proc-jbt-test_JAX-RS.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> --> -</section> \ No newline at end of file +</section> Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/testing_a_web_service-web_service_test_view.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/testing_a_web_service-web_service_test_view.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/testing_a_web_service-web_service_test_view.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -11,7 +11,7 @@ <orderedlist> <listitem> <para> - Selecting the <guilabel>JAX-WS</guilabel> combo box option. + Selecting the <guilabel>JAX-WS</guilabel> combobox option. </para> </listitem> <listitem id="step2"> Modified: branches/jbosstools-3.2.x/ws/docs/reference/en-US/topdown.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/en-US/topdown.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/en-US/topdown.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -1,403 +1,660 @@ <?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> +<?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 read the section <xref linkend="addfacet"/>. + </para> + + <figure> + <title>Dynamic Web Project Wizard</title> + <mediaobject> <imageobject> - <imagedata fileref="images/topdown/jbossws_webproject_1.png"/> + <imagedata fileref="images/topdown/jbossws_webproject_2.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 read the section <xref linkend="addfacet"/>.</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 <xref linkend="addfacet"/> by clicking the <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 unavailable. 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> + </mediaobject> + </figure> + </listitem> + + <listitem> + <para> + Configuration: You may <xref linkend="addfacet"/> by clicking the <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_facet_0.png"/> + <imagedata fileref="images/topdown/jbossws_webproject_3.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> + </mediaobject> + </figure> + </listitem> + </itemizedlist> + + <para> + If you added the JBoss Web Service facet to the project, now the <property>Finish</property> button is unavailable. 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 in the <xref linkend="preference"/> section. + </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 in the <xref linkend="createproject"/> section and in the <xref + linkend="addfacet"/> section. + </para> + <!-- + <note> + <para> + To use the + <guilabel> + Simple Web Service + </guilabel> + wizard to create this Web Service, replace the + <guilabel> + Class + </guilabel> + and + <guilabel> + Applicaiton Class + </guilabel> + fields with your specific classes, within the instructions in <xref linkend="simple_web_service" />. + </para> + </note> + --> + <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&apos;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> + + <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> + First, 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> + + <itemizedlist> + <listitem> + <para> + <emphasis> <property>WSDL Service</property> </emphasis> : display the services in your WSDL file, you can select one to generate Web Service. + </para> + </listitem> + <listitem> + <para> + <emphasis> <property>Source Folder</property> </emphasis> : display the source codes folder in your web project, you can select one to generate java codes. + </para> + </listitem> + <listitem> + <para> + <emphasis> <property>Package name</property> </emphasis> : input a package name. You can click the Brown button to choose one. If you don't input a package name, system will generate one for you. + </para> + </listitem> + <listitem> + <para> + <emphasis> <property>JAX-WS specificaiton</property> </emphasis> : display the supported JAX-WS version, include, 2.0, 2.1, 2.2 + </para> + </listitem> + <listitem> + <para> + <emphasis> <property>Catalog file</property> </emphasis> : specify a catalog file. + </para> + </listitem> + <listitem> + <para> + <emphasis> <property>Binding files</property> </emphasis> : specify some binding files that are used by your WSDL file + </para> + </listitem> + <listitem> + <para> + <emphasis> <property>Enable binding extension support (Only available for JBossWS 3.0 or later)</property> </emphasis> : select it if you need the binding extension support. Only work based on JBossWS 3.0 or later. + </para> + </listitem> + <listitem> + <para> + <emphasis> <property>Generate default Web Service implementation classes</property> </emphasis> : select it if you want to generate empty implementation classes for the selected WSDL Service. + </para> + </listitem> + <listitem> + <para> + <emphasis> <property>Update the default Web.xml</property> </emphasis> : update the Web.xml file with your Web Service servlets configured. + </para> + </listitem> + <listitem> + <para> + <emphasis> <property>Additional Options</property> </emphasis> : the senior options for the generating process. Only for the senior user. + </para> + </listitem> + </itemizedlist> + <para> + 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 <xref linkend="preference"/>. + </para> + + <para> + Create <xref linkend="createproject"/>. + </para> + + <note> + <para> + To use the + <guilabel> + Simple Web Service + </guilabel> + wizard to create this Web Service, replace the + <guilabel> + Class + </guilabel> + and + <guilabel> + Applicaiton Class + </guilabel> + fields with your specific classes, within the instructions in <xref linkend="simple_web_service" />. + </para> + </note> + + <para> + <xref linkend="addfacet"/> + </para> + + <para> + Create a Web Service from a java bean: + </para> + + <itemizedlist> + <listitem> + <para> + Switch to the Java EE perspective <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Open Perspective</guimenuitem><guimenuitem>Java EE</guimenuitem></menuchoice>. + </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 fileref="images/topdown/jbossws_facet.png"/> + <imagedata scale="80" fileref="images/topdown/jbossws_bottomup.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> + </mediaobject> + </figure> + </listitem> + + <listitem> + <para> + Click <menuchoice><guimenuitem>File</guimenuitem><guimenuitem>New</guimenuitem><guimenuitem>Other</guimenuitem></menuchoice>. 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_newruntime.png"/> + <imagedata fileref="images/topdown/jbossws_bottomup_1.png"/> </imageobject> - </mediaobject> - </figure> - <para>See how to configure a new JBossWS runtime in the <xref linkend="preference"/> section.</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 in the <xref linkend="createproject"/> section and in the <xref - linkend="addfacet"/> section.</para> - <note> - <para> - To use the <guilabel>Simple Web Service</guilabel> wizard to create this Web Service, replace the <guilabel>Class</guilabel> and <guilabel>Applicaiton Class</guilabel> fields with your specific classes, within the instructions in <xref linkend="simple_web_service" />. - </para> - </note> - <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&apos;s get through the wizard step-by-step:</para> - <figure id="figure_create_ws_topdown"> - <title>New Web Service Wizard</title> - <mediaobject> + </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_ws_creation1.png"/> + <imagedata fileref="images/topdown/jbossws_bottomup_2.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> + </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_ws_creation1_1.png"/> + <imagedata fileref="images/topdown/jbossws_bottomup_3.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> + </mediaobject> + </figure> + + <itemizedlist> + <listitem> + <para> + Generate WSDL file: select it, you will get a generated WSDL file in your project. But this wsdl's service 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.xml 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_ws_creation1.png"/> + <imagedata fileref="images/topdown/jbossws_bottomup_4.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> + </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 fileref="images/topdown/jbossws_ws_creation2.png"/> + <imagedata scale="80" fileref="images/topdown/jbossws_bottomup_6.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> + </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 fileref="images/topdown/jbossws_ws_Impl_code_view.png"/> + <imagedata scale="80" fileref="images/topdown/jbossws_bottomup_5.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 <xref linkend="preference"/>.</para> - <para>Create <xref linkend="createproject"/>.</para> - <note> - <para> - To use the <guilabel>Simple Web Service</guilabel> wizard to create this Web Service, replace the <guilabel>Class</guilabel> and <guilabel>Applicaiton Class</guilabel> fields with your specific classes, within the instructions in <xref linkend="simple_web_service" />. - </para> - </note> - <para><xref linkend="addfacet"/></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 service 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> - + </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.2.x/ws/docs/reference/pom.xml =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/pom.xml 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/pom.xml 2011-07-18 02:56:55 UTC (rev 32989) @@ -1,7 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<project xmlns="http://maven.apache.org/POM/4.0.0" - xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" - xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> +<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>org.jboss.tools</groupId> @@ -10,229 +8,232 @@ <packaging>jdocbook</packaging> <name>${bookname}-(${translation})</name> - <properties> - <translation>en-US</translation> - <docname>WS_Reference_Guide</docname> - <bookname>WS Reference Guide</bookname> - </properties> - - <profiles> + <properties> + <translation>en-US</translation> + <docname>WS_Reference_Guide</docname> + <bookname>WS Reference Guide</bookname> + </properties> + <profiles> + <!-- mvn compile --> - <profile> - <id>all</id> - <activation> - <activeByDefault>true</activeByDefault> - </activation> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <version>2.3.3</version> - <extensions>true</extensions> - <configuration> - <formats> - <format> - <formatName>pdf</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${docname}.pdf</finalName> - </format> - <format> - <formatName>html</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <format> - <formatName>html_single</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <format> - <formatName>eclipse</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/eclipse.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> + <profile> + <id>all</id> + <activation> + <activeByDefault>true</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.3.4</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>pdf</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> + <finalName>${docname}.pdf</finalName> + </format> + <format> + <formatName>html</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + <format> + <formatName>html_single</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + <format> + <formatName>eclipse</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/eclipse.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + <options> + <useRelativeImageUris>true</useRelativeImageUris> + </options> + </configuration> + </plugin> </plugins> </build> </profile> <!-- mvn compile -Phtml --> - <profile> - <id>html</id> - <activation> - <activeByDefault>false</activeByDefault> - </activation> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <version>2.3.3</version> - <extensions>true</extensions> - <configuration> - <formats> - <format> - <formatName>html</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> + <profile> + <id>html</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.3.3</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>html</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + </configuration> + </plugin> </plugins> </build> </profile> <!-- mvn compile -Phtml-single --> - <profile> - <id>html-single</id> - <activation> - <activeByDefault>false</activeByDefault> - </activation> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <version>2.3.3</version> - <extensions>true</extensions> - </plugin> + <profile> + <id>html-single</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.3.3</version> + <extensions>true</extensions> + </plugin> </plugins> </build> </profile> <!-- mvn compile -Ppdf --> - <profile> - <id>pdf</id> - <activation> - <activeByDefault>false</activeByDefault> - </activation> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <version>2.3.3</version> - <extensions>true</extensions> - <configuration> - <formats> - <format> - <formatName>pdf</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${docname}.pdf</finalName> - </format> - </formats> - </configuration> - </plugin> + <profile> + <id>pdf</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.3.3</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>pdf</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> + <finalName>${docname}.pdf</finalName> + </format> + </formats> + </configuration> + </plugin> </plugins> </build> </profile> <!-- mvn compile -Peclipse --> - <profile> - <id>eclipse</id> - <activation> - <activeByDefault>false</activeByDefault> - </activation> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <version>2.3.3</version> - <extensions>true</extensions> - <configuration> - <formats> - <format> - <formatName>eclipse</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/eclipse.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> + <profile> + <id>eclipse</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.3.3</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>eclipse</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/eclipse.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> - </profiles> - <build> - <pluginManagement> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <version>2.3.3</version> - <extensions>true</extensions> - <dependencies> - <dependency> - <groupId>org.jboss.pressgang</groupId> - <artifactId>pressgang-xslt</artifactId> - <version>1.2.0</version> - </dependency> - <dependency> - <groupId>org.jboss</groupId> - <artifactId>jbossorg-jdocbook-style</artifactId> - <version>1.1.1</version> - <type>jdocbook-style</type> - </dependency> - </dependencies> - <configuration> - <sourceDirectory>${project.basedir}</sourceDirectory> + </profiles> + <build> + <pluginManagement> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.3.3</version> + <extensions>true</extensions> + <dependencies> + <dependency> + <groupId>org.jboss.pressgang</groupId> + <artifactId>pressgang-xslt</artifactId> + <version>1.2.0</version> + </dependency> + <dependency> + <groupId>org.jboss</groupId> + <artifactId>jbossorg-jdocbook-style</artifactId> + <version>1.1.1</version> + <type>jdocbook-style</type> + </dependency> + </dependencies> + <configuration> + <sourceDirectory>${project.basedir}</sourceDirectory> <!-- <sourceDocumentName>${docname}.xml</sourceDocumentName> --> - <sourceDocumentName>master.xml</sourceDocumentName> - <masterTranslation>en-US</masterTranslation> - <imageResource> - <directory>${project.basedir}/en-US</directory> - <includes> - <include>images/**/*</include> - </includes> - </imageResource> - <formats> - <format> - <formatName>pdf</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${pdf.name}</finalName> - </format> - <format> - <formatName>html</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <format> - <formatName>html_single</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <format> - <formatName>eclipse</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/eclipse.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - <options> - <xincludeSupported>true</xincludeSupported> - <xmlTransformerType>saxon</xmlTransformerType> - <docbookVersion>1.72.0</docbookVersion> - <localeSeparator>-</localeSeparator> - <transformerParameters> - <property> - <name>javax.xml.parsers.DocumentBuilderFactory</name> - <value>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</value> - </property> - <property> - <name>javax.xml.parsers.SAXParserFactory</name> - <value>org.apache.xerces.jaxp.SAXParserFactoryImpl</value> - </property> - </transformerParameters> - </options> - </configuration> - </plugin> - </plugins> - </pluginManagement> - </build> + <sourceDocumentName>master.xml</sourceDocumentName> + <masterTranslation>en-US</masterTranslation> + <imageResource> + <directory>${project.basedir}/en-US</directory> + <includes> + <include>images/**/*</include> + </includes> + </imageResource> + <formats> + <format> + <formatName>pdf</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> + <finalName>${pdf.name}</finalName> + </format> + <format> + <formatName>html</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + <format> + <formatName>html_single</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + <format> + <formatName>eclipse</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/eclipse.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + <options> + <xincludeSupported>true</xincludeSupported> + <xmlTransformerType>saxon</xmlTransformerType> + <docbookVersion>1.72.0</docbookVersion> + <localeSeparator>-</localeSeparator> + <transformerParameters> + <property> + <name>javax.xml.parsers.DocumentBuilderFactory</name> + <value>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</value> + </property> + <property> + <name>javax.xml.parsers.SAXParserFactory</name> + <value>org.apache.xerces.jaxp.SAXParserFactoryImpl</value> + </property> + </transformerParameters> + </options> + </configuration> + </plugin> + </plugins> + </pluginManagement> + </build> </project> Modified: branches/jbosstools-3.2.x/ws/docs/reference/publican.cfg =================================================================== --- branches/jbosstools-3.2.x/ws/docs/reference/publican.cfg 2011-07-18 02:52:59 UTC (rev 32988) +++ branches/jbosstools-3.2.x/ws/docs/reference/publican.cfg 2011-07-18 02:56:55 UTC (rev 32989) @@ -4,4 +4,3 @@ xml_lang: en-US type: Book brand: JBoss -