Author: dennyxu Date: 2008-07-03 02:32:39 -0400 (Thu, 03 Jul 2008) New Revision: 9053 Added: trunk/ws/docs/reference/en/images/Jbossws_preference.png trunk/ws/docs/reference/en/images/Jbossws_preference_new.png trunk/ws/docs/reference/en/images/jbossws_facet.png trunk/ws/docs/reference/en/images/jbossws_newruntime.png trunk/ws/docs/reference/en/images/jbossws_ws_creation1.png trunk/ws/docs/reference/en/images/jbossws_ws_creation1_1.png trunk/ws/docs/reference/en/images/jbossws_ws_creation2.png Modified: trunk/ws/docs/reference/en/modules/preference.xml trunk/ws/docs/reference/en/modules/topdown.xml Log: add documents Added: trunk/ws/docs/reference/en/images/Jbossws_preference.png =================================================================== (Binary files differ) Property changes on: trunk/ws/docs/reference/en/images/Jbossws_preference.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/ws/docs/reference/en/images/Jbossws_preference_new.png =================================================================== (Binary files differ) Property changes on: trunk/ws/docs/reference/en/images/Jbossws_preference_new.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/ws/docs/reference/en/images/jbossws_facet.png =================================================================== (Binary files differ) Property changes on: trunk/ws/docs/reference/en/images/jbossws_facet.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/ws/docs/reference/en/images/jbossws_newruntime.png =================================================================== (Binary files differ) Property changes on: trunk/ws/docs/reference/en/images/jbossws_newruntime.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/ws/docs/reference/en/images/jbossws_ws_creation1.png =================================================================== (Binary files differ) Property changes on: trunk/ws/docs/reference/en/images/jbossws_ws_creation1.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/ws/docs/reference/en/images/jbossws_ws_creation1_1.png =================================================================== (Binary files differ) Property changes on: trunk/ws/docs/reference/en/images/jbossws_ws_creation1_1.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/ws/docs/reference/en/images/jbossws_ws_creation2.png =================================================================== (Binary files differ) Property changes on: trunk/ws/docs/reference/en/images/jbossws_ws_creation2.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Modified: trunk/ws/docs/reference/en/modules/preference.xml =================================================================== --- trunk/ws/docs/reference/en/modules/preference.xml 2008-07-03 05:37:05 UTC (rev 9052) +++ trunk/ws/docs/reference/en/modules/preference.xml 2008-07-03 06:32:39 UTC (rev 9053) @@ -9,36 +9,32 @@ </section> - <section id="jbosswspreference"> - <title>Set JBossWS Runtime Location</title> - <para>Open - <emphasis><property>Window > Preferences > Web Services > JBossWS Preferences</property></emphasis>. In this Page , you can set JBossWS Runtime.</para> - <para>Now JBoss Tools only support JBoss EAP or JBoss AS as JBossWS Runtime.</para> - <para>After set JBoss WS Runtime, click <property>OK</property> button to save the JBoss WS Runtime location.</para> - <figure> - <title></title> - <mediaobject> - <imageobject> - <imagedata fileref="images/"></imagedata> - </imageobject> - </mediaobject> - </figure> - </section> + <title>JBossWS Preferences</title> - <section id="serverruntime"> - <title>Set default Server and Runtime</title> - <para>Open - <emphasis><property>Window > Preferences > Web Services > Server and Runtime</property></emphasis>. In this page, you can set default server and runtime.</para> - <para>For ease of use, the better way is to set runtime = JBoss WS.</para> - <para>After set server and runtime, click <property>Aplly</property> button to save the value.</para> - <figure> - <title></title> - <mediaobject> - <imageobject> - <imagedata fileref="images/"/> - </imageobject> - </mediaobject> - </figure> - </section> - +<para>In this chapter you get to know how JBossWS preferences can be modified during the development process.</para> + + <para>JBossWS preferences can be set using the JBossWS preference page. Click on <emphasis><property>Window > Preferences > JBoss Tools > Web > JBossWS Preference</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/Jbossws_preference.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Clicking on <property>Edit</property> button you will get the form where you can change the path of JBossWS runtime home folder, + modify name and version. Press <property>Finish</property> to apply the changes.</para> + + <figure> + <title>Edit JBossWS Runtime</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/Jbossws_preference_new.png"/> + </imageobject> + </mediaobject> + </figure> </chapter> Modified: trunk/ws/docs/reference/en/modules/topdown.xml =================================================================== --- trunk/ws/docs/reference/en/modules/topdown.xml 2008-07-03 05:37:05 UTC (rev 9052) +++ trunk/ws/docs/reference/en/modules/topdown.xml 2008-07-03 06:32:39 UTC (rev 9053) @@ -0,0 +1,127 @@ +<?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.</para> + + <section id="createproject"> + <title>Creating a Dynamic Web project</title> + <para>Before create a web service, you must have a Dynamic Web Project</para> + <para>Create the service 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 you installed. If it is not listed, click New and browse to the location where it is installed. You may set <emphasis><property>Target Runtime</property></emphasis> to <emphasis><property>None</property></emphasis>, + in this case, you must <link linkend="addfacet">add JBoss Web Service facet to the project</link> </para> + </listitem> + </itemizedlist> + <para>Click <property>Finish</property> button.</para> + </section> + + <section id="addfacet"> + <title>Configure JBoss Web Service facet settings</title> + <para>If you have already create a dynamic web project, the next step is to add JBoss Web Service facet to the project </para> + <figure id="figure_addfacet"> + <title>Configure JBoss Web Service Facet</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/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> to finish the configuration of JBoss Web Service facet. </emphasis> + </para> + <para>If the project has no <emphasis><property>Target Runtime</property></emphasis> settings, you must check the second radio button and specify a JBossWS runtime from the list. + You also can create a new JBossWS runtime, click <emphasis><property>New...</property></emphasis> button will bring you to another dialog for configuring new JBossWS runtime.</para> + <figure id="figure_addfacet"> + <title>Configure JBossWS Runtime</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/jbossws_newruntime.png"/> + </imageobject> + </mediaobject> + </figure> + <para>See how to <link linkend="preference">configure a new JBossWS runtime</link> </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 create a dynamic Web project with JBoss Web Service facet get installed. </para> + <para>To make it see <link linkend="webproject">create dynamic Web project</link>> and <link linkend="facet">add JBoss Web Service facet</link></para> + + <para>To create Web Service using JBossWS runtime select<emphasis> + <property>File > New > Other > Web Services > Web Service</property> to run Web Service creation wizard. + </emphasis> </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/jbossws_ws_creation1.png"/> + </imageobject> + </mediaobject> + </figure> + <para>First, please select <property>Top down Java bean Web Service</property> from Web Service type list, + and select a WSDL document from workspace, click the link <emphasis><property>Server</property></emphasis> 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/jbossws_ws_creation1_1.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Click on <emphasis> + <property>Finish</property> + </emphasis> Button you will have the following wizard view.</para> + + <figure id="figure_create_ws_topdown"> + <title>New Web Service Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/jbossws_ws_creation1.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Click on <emphasis><property>Next</property></emphasis> button to next step</para> + <figure id="figure_create_ws_topdown_codegen"> + <title>New Web Service Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/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. If you want the wizard 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 update the default Web.xml file with the Web Service servlets get configured, check <emphasis> <property>Update the default Web.xml</property> </emphasis> + check box. Click on <emphasis><property>Next</property> </emphasis> or <emphasis><property>Finish</property> </emphasis> button to generate code </para> + + <para>In previous step, the Web Service code is generated, then you can view the implementation class and add business logic to each method.</para> + + </section> + + <section id="bottomupws"> + <title>Creating a Web service from a Java bean using JBossWS runtime </title> + </section> + +</chapter>