JBoss Tools SVN: r15216 - in branches/jbosstools-3.0.x/ws/docs/reference: en and 2 other directories.
by jbosstools-commits@lists.jboss.org
Author: smukhina
Date: 2009-05-11 12:55:55 -0400 (Mon, 11 May 2009)
New Revision: 15216
Removed:
branches/jbosstools-3.0.x/ws/docs/reference/en/images/Jbossws_preference.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_ws_creation1_1.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_ws_webxml.png
branches/jbosstools-3.0.x/ws/docs/reference/en/modules/webproject.xml
Modified:
branches/jbosstools-3.0.x/ws/docs/reference/en/master.xml
branches/jbosstools-3.0.x/ws/docs/reference/en/master_output.xml
branches/jbosstools-3.0.x/ws/docs/reference/en/modules/client.xml
branches/jbosstools-3.0.x/ws/docs/reference/en/modules/overview.xml
branches/jbosstools-3.0.x/ws/docs/reference/en/modules/preference.xml
branches/jbosstools-3.0.x/ws/docs/reference/en/modules/topdown.xml
branches/jbosstools-3.0.x/ws/docs/reference/pom.xml
Log:
https://jira.jboss.org/jira/browse/JBDS-717 merged changes from trunk are added to the corresponding branch
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/Jbossws_preference.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_ws_creation1_1.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_ws_webxml.png
===================================================================
(Binary files differ)
Modified: branches/jbosstools-3.0.x/ws/docs/reference/en/master.xml
===================================================================
--- branches/jbosstools-3.0.x/ws/docs/reference/en/master.xml 2009-05-11 16:44:55 UTC (rev 15215)
+++ branches/jbosstools-3.0.x/ws/docs/reference/en/master.xml 2009-05-11 16:55:55 UTC (rev 15216)
@@ -12,7 +12,7 @@
<book>
<bookinfo>
- <title>JBoss WS User Guide</title>
+ <title>JBoss WS User Guide</title>
<author><firstname>Denny</firstname><surname>Xu</surname><email>dxu(a)redhat.com</email></author>
<author><firstname>Grid</firstname><surname>Qian</surname><email>fqian(a)redhat.com</email></author>
<pubdate>July 2008</pubdate>
@@ -22,7 +22,7 @@
<holder>JBoss, a division of Red Hat</holder>
</copyright>
<releaseinfo>
- Version: 1.0.0.GA
+ Version: 1.0.1.GA
</releaseinfo>
<abstract>
<title/>
@@ -39,4 +39,4 @@
&topdown;
&client;
&preference;
-</book>
+</book>
Modified: branches/jbosstools-3.0.x/ws/docs/reference/en/master_output.xml
===================================================================
--- branches/jbosstools-3.0.x/ws/docs/reference/en/master_output.xml 2009-05-11 16:44:55 UTC (rev 15215)
+++ branches/jbosstools-3.0.x/ws/docs/reference/en/master_output.xml 2009-05-11 16:55:55 UTC (rev 15216)
@@ -16,11 +16,11 @@
<pubdate>July 2008</pubdate>
<copyright>
<year>2008</year>
- <year diffmk:change="added"><diffmk:wrapper diffmk:change="added">2009</diffmk:wrapper></year>
- <holder><diffmk:wrapper diffmk:change="changed">JBoss, a division of Red Hat</diffmk:wrapper></holder>
+ <year>2009</year>
+ <holder>JBoss, a division of Red Hat</holder>
</copyright>
<releaseinfo><diffmk:wrapper diffmk:change="changed">
- Version: 1.0.0.GA
+ Version: 1.0.1.GA
</diffmk:wrapper></releaseinfo>
<abstract>
<title></title>
@@ -38,7 +38,7 @@
<title>JBossWS Runtime Overview</title>
<para>JBossWS is a web service framework developed as a part of the JBoss Application Server. It implements the JAX-WS specification that defines a programming model and run-time architecture for implementing web services in Java, targeted at the Java Platform, Enterprise Edition 5 (Java EE 5).</para>
-
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">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.</diffmk:wrapper></para>
</chapter>
<chapter id="create_ws_topdown" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/ws/docs/reference/en/modules/topdown.xml">
@@ -52,8 +52,8 @@
</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>
+ <para><diffmk:wrapper diffmk:change="changed">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:</diffmk:wrapper></para>
<section id="createproject">
<title>Creating a Dynamic Web project</title>
@@ -63,13 +63,12 @@
<title>Dynamic Web Project</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_webproject_1.png"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_webproject_1.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
<para>Create a Web project by selecting <emphasis>
- <property moreinfo="none">New > Project... > Dynamic Web project</property>
- </emphasis>. Enter the following information: </para>
+ <property moreinfo="none">New > Project... > Dynamic Web project</property></emphasis>. Enter the following information: </para>
<itemizedlist>
<listitem>
<para>Project Name: enter a project name</para>
@@ -79,14 +78,13 @@
click New and browse to the location where it is installed to. You may set <emphasis>
<property moreinfo="none">Target Runtime</property>
</emphasis> to <emphasis>
- <property moreinfo="none">None</property>
- </emphasis>, in this case, you should add <link linkend="addfacet">JBoss Web Service
+ <property moreinfo="none">None</property></emphasis>, in this case, you should add <link linkend="addfacet">JBoss Web Service
facet to the project</link>.</para>
<figure float="0">
<title>Dynamic Web Project Wizard</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_webproject_2.png"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_webproject_2.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
@@ -97,24 +95,24 @@
<title>Web Module Settings Configuration</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_webproject_3.png"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_webproject_3.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
</listitem>
</itemizedlist>
- <para>Click on the <property moreinfo="none">Finish</property> button.</para>
+ <para>Click on the <property moreinfo="none">Finish</property><diffmk:wrapper diffmk:change="changed"> button. Next you will need to add JBoss Web Service facet to the project:</diffmk:wrapper></para>
</section>
<section id="addfacet">
<title>Configure JBoss Web Service facet settings</title>
- <para>If you have already created a new Dynamic Web project, the next step is to add JBoss Web
- Service facet to the project:</para>
+ <para><diffmk:wrapper diffmk:change="added">If you have already created a new Dynamic Web project, the next step is to add JBoss Web
+ Service facet to the project. Right-click on the project, select its </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Properties</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> and then find </diffmk:wrapper><emphasis diffmk:change="added"><diffmk:wrapper diffmk:change="added">Project Facets</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> in the tree-view on the left-side of the project properties dialog. Tick on the check box for JBoss Web Services and open additional configuration for it, having clicked on the </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Further configuration required...</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> link. In the opened window</diffmk:wrapper></para>
<figure float="0" id="figure_addfacet">
<title>Configure JBoss Web Service Facet</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_facet.png"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_facet.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
@@ -134,11 +132,11 @@
<title>Configure JBossWS Runtime</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_newruntime.png"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_newruntime.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para>See how to configure a new JBossWS runtime <link linkend="preference">here</link>:</para>
+ <para>See how to configure a new JBossWS runtime <link linkend="preference">here</link><diffmk:wrapper diffmk:change="changed">.</diffmk:wrapper></para>
</section>
@@ -149,7 +147,7 @@
WSDL document using JBossWS runtime.</para>
<para>At first, please make sure that you have already created a dynamic Web project with
JBoss Web Service facet installed. </para>
- <para>See how to make it <link linkend="createproject">here</link>> and <link linkend="addfacet">here</link>.</para>
+ <para>See how to make it <link linkend="createproject">here</link><diffmk:wrapper diffmk:change="changed"> and </diffmk:wrapper><link linkend="addfacet">here</link>.</para>
<para>To create a Web Service using JBossWS runtime select<emphasis>
<property moreinfo="none">File > New > Other > Web Services > Web Service</property>
@@ -159,19 +157,19 @@
<title>New Web Service Wizard</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_ws_creation1.png"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_ws_creation1.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para>First, please select <property moreinfo="none">Top down Java bean Web Service</property> from the Web
+ <para>First, please select <property moreinfo="none">Top down Java bean Web Service</property><diffmk:wrapper diffmk:change="changed"> from the Web
Service type list, and select a WSDL document from workspace, click on the Server name
- lilnk 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>
+ 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:</diffmk:wrapper></para>
<figure float="0" id="figure_create_ws_topdown_setserver">
<title>Select Server and Web Service runtime</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_ws_creation1_1.png"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_ws_creation1_1.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
@@ -184,7 +182,7 @@
<title>New Web Service Wizard</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_ws_creation1.png"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_ws_creation1.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
@@ -196,7 +194,7 @@
<title>New Web Service Wizard</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_ws_creation2.png"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_ws_creation2.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
@@ -221,7 +219,7 @@
<title>The generated implementation Java code</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_ws_Impl_code_view.png"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_ws_Impl_code_view.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
@@ -230,11 +228,11 @@
<title>Web.xml</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_ws_webxml.png"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_ws_webxml.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
-
+<para diffmk:change="added"><diffmk:wrapper diffmk:change="added">In the next chapter you will find out how to create a Web service from a Java bean.</diffmk:wrapper></para>
</section>
<section id="bottomupws" role="updated">
@@ -249,31 +247,29 @@
<itemizedlist>
<listitem>
<para>Switch to the Java EE perspective <emphasis>
- <property moreinfo="none">Window > Open Perspective > Java EE</property>
- </emphasis>.</para>
+ <property moreinfo="none">Window > Open Perspective > Java EE</property></emphasis>.</para>
</listitem>
<listitem>
<para>In the Project Explorer view, select the bean that you created or imported into
the source folder of your Web project.</para>
<figure float="0">
- <title>Create a new Bean Class</title>
+ <title><diffmk:wrapper diffmk:change="changed">Select the Bean Created</diffmk:wrapper></title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_bottomup.png" scale="80"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_bottomup.png" scale="80"></imagedata>
</imageobject>
</mediaobject>
</figure>
</listitem>
<listitem>
<para>Click <emphasis>
- <property moreinfo="none">File > New > Other</property>
- </emphasis>. Select Web Services in order to display various Web service wizards.
+ <property moreinfo="none">File > New > Other</property></emphasis>. Select Web Services in order to display various Web service wizards.
Select the Web Service wizard. Click on the <property moreinfo="none">Next</property> button.</para>
<figure float="0">
<title>New Web Service</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_bottomup_1.png"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_bottomup_1.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
@@ -286,7 +282,7 @@
<title>Set Web Service Common values</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_bottomup_2.png"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_bottomup_2.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
@@ -354,7 +350,7 @@
<title>Set Web Service values for Code Generation</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_bottomup_3.png"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_bottomup_3.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
@@ -381,7 +377,7 @@
<title>Start a Server</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_bottomup_4.png"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_bottomup_4.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
@@ -396,10 +392,10 @@
<listitem>
<para>If you selected to generate a WSDL file, you will get the file in your project's wsdl folder.</para>
<figure float="0">
- <title>The generated WSDL file</title>
+ <title><diffmk:wrapper diffmk:change="changed">The Generated HelloWorldService.wsdl File in the wsdl Folder</diffmk:wrapper></title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_bottomup_6.png" scale="80"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_bottomup_6.png" scale="80"></imagedata>
</imageobject>
</mediaobject>
</figure>
@@ -412,12 +408,14 @@
<title>The Updated web.xml file</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_bottomup_5.png" scale="80"></imagedata>
+ <imagedata fileref="images/topdown/jbossws_bottomup_5.png" scale="80"></imagedata>
</imageobject>
</mediaobject>
</figure>
</listitem>
</itemizedlist>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">In the next chapter you will be able to create a Web Service Client from a WSDL document using JBoss WS.</diffmk:wrapper></para>
+
</section>
</chapter>
@@ -425,54 +423,51 @@
<chapter id="client" revisionflag="added" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/ws/docs/reference/en/modules/client.xml">
<title>Creating a Web Service Client from a WSDL Document using JBoss WS</title>
- <para>To create a Web Service Client from a WSDL Document using JBoss WS:</para>
+ <para><diffmk:wrapper diffmk:change="changed">To create a Web Service Client from a WSDL Document using JBoss WS you need to fulfil the following steps:</diffmk:wrapper></para>
<para>Setup <link linkend="preference">JBoss WS and development environment</link>.</para>
- <para><link linkend="createproject">Creating a Dynamic Web project</link>.</para>
+ <para><link linkend="createproject"><diffmk:wrapper diffmk:change="changed">Create a Dynamic Web project</diffmk:wrapper></link>.</para>
<para><link linkend="addfacet">Add JBossWS Facet to Web project</link>.</para>
- <para>Create a Web Service Client from a WSDL document: </para>
+ <para><diffmk:wrapper diffmk:change="changed">Then you can create a Web Service Client from a WSDL document: </diffmk:wrapper></para>
<itemizedlist>
<listitem>
<para>Switch to the Java EE perspective <emphasis><property moreinfo="none">Window > Open Perspective > Java EE</property></emphasis>.</para>
</listitem>
<listitem>
- <para>In the Project Explorer view, select the bean that you created or imported into the source folder of your Web project.</para>
- </listitem>
- <listitem>
- <para>Click <emphasis><property moreinfo="none">File > New > Other</property></emphasis>.Select Web Services in order to display the various Web service wizards. Select the Web Service Client wizard. Click <property moreinfo="none">Next</property> button.</para>
+ <para>Click <emphasis><property moreinfo="none">File > New > Other</property></emphasis><diffmk:wrapper diffmk:change="changed">. Select Web Services in order to display the various Web service wizards. Select the Web Service Client wizard. Click on the </diffmk:wrapper><property moreinfo="none">Next</property> button.</para>
<figure float="0">
<title>New Web Service Client</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_client.png"></imagedata>
+ <imagedata fileref="images/client/jbossws_client.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
</listitem>
<listitem>
- <para>The first and second Web Service Client wizard page are same to <link linkend="topdownwebservice">Web Service from a WSDL document</link>.</para>
+ <para><diffmk:wrapper diffmk:change="changed">The first and the second Web Service Client wizard pages are the same as for </diffmk:wrapper><link linkend="topdownwebservice">Web Service from a WSDL document</link>.</para>
<figure float="0">
<title>Set Web Service Common values</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_client_1.png"></imagedata>
+ <imagedata fileref="images/client/jbossws_client_1.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
<figure float="0">
- <title>Set Web Service values about WSDL file</title>
+ <title><diffmk:wrapper diffmk:change="changed">Set Web Service values related to WSDL file</diffmk:wrapper></title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_client_2.png"></imagedata>
+ <imagedata fileref="images/client/jbossws_client_2.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para>The differences are:</para>
+ <para><diffmk:wrapper diffmk:change="changed">The only difference is:</diffmk:wrapper></para>
<itemizedlist>
<listitem>
- <para><property moreinfo="none">Client Type:</property> Now only support Java Proxy.</para>
+ <para><property moreinfo="none">Client Type:</property><diffmk:wrapper diffmk:change="changed"> Support of Java Proxy only.</diffmk:wrapper></para>
</listitem>
</itemizedlist>
- <para>Click <property moreinfo="none">Finish</property> button.</para>
+ <para><diffmk:wrapper diffmk:change="changed">Click on the </diffmk:wrapper><property moreinfo="none">Finish</property> button.</para>
</listitem>
</itemizedlist>
<para>After the Web Service Client has been created, the following may occur depending on the options you selected:</para>
@@ -486,7 +481,7 @@
<title>Client Sample Class</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_client_3.png" scale="80"></imagedata>
+ <imagedata fileref="images/client/jbossws_client_3.png" scale="80"></imagedata>
</imageobject>
</mediaobject>
</figure>
@@ -498,7 +493,11 @@
<chapter id="preference" revisionflag="added" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/ws/docs/reference/en/modules/preference.xml">
<title>JBoss WS and development environment</title>
+
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">In this chapter you will learn how to change JBossWS preferences and how to set default server and runtime.</diffmk:wrapper></para>
<section id="jbosswspreference">
+
+
<title>JBossWS Preferences</title>
<para>In this section you will know how JBossWS preferences can be modified during the
@@ -516,7 +515,7 @@
<title>JBossWS Preferences Page</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/Jbossws_preference.png"></imagedata>
+ <imagedata fileref="images/preference/Jbossws_preference.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
@@ -525,16 +524,16 @@
<property moreinfo="none">Add</property>
</emphasis> or <emphasis>
<property moreinfo="none">Edit</property>
- </emphasis> button will open the form where you can configure a new JbossWS runtime and
+ </emphasis><diffmk:wrapper diffmk:change="changed"> button will open the form where you can configure a new JBossWS runtime and
change the path to JBossWS runtime home folder, modify the name and version of the
- existing JBossWS runtime settings. Press <property moreinfo="none">Finish</property> to apply the
+ existing JBossWS runtime settings. Press </diffmk:wrapper><property moreinfo="none">Finish</property> to apply the
changes.</para>
<figure float="0">
<title>Edit JBossWS Runtime</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/Jbossws_preference_new.png"></imagedata>
+ <imagedata fileref="images/preference/Jbossws_preference_new.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
@@ -542,28 +541,28 @@
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">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 </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Properties</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added">. Choose </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Java Source Attachment</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> 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:</diffmk:wrapper></para>
+ <para>WS container allows Source and JavaDoc locations to be set via the Properties dialog on each contained .jar: right-click on any .jar file in the Project Explorer view, select <emphasis><property moreinfo="none">Properties</property></emphasis>. Choose <emphasis><property moreinfo="none">Java Source Attachment</property></emphasis> and select location (folder, JAR or zip) containing new source for the chosen .jar using one of the suggested options (workspace, external folder or file) or enter the path manually:</para>
- <figure diffmk:change="added" float="0">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Classpath Container: Java Source Attachment</diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/jbossws_container1.png"></imagedata>
+ <figure float="0">
+ <title>Classpath Container: Java Source Attachment</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/preference/jbossws_container1.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Click on </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Apply</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> and then on </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Ok</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">To change Javadoc Location choose </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Javadoc Location</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> and specify URL to the documentation generated by Javadoc. The Javadoc location will contain a file called </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">package-list</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added">:</diffmk:wrapper></para>
+ <para>Click on <emphasis><property moreinfo="none">Apply</property></emphasis> and then on <emphasis><property moreinfo="none">Ok</property></emphasis>.</para>
+ <para><diffmk:wrapper diffmk:change="changed">To change JavaDoc Location choose </diffmk:wrapper><emphasis><property moreinfo="none">Javadoc Location</property></emphasis> and specify URL to the documentation generated by Javadoc. The Javadoc location will contain a file called <emphasis><property moreinfo="none">package-list</property></emphasis>:</para>
- <figure diffmk:change="added" float="0">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Classpath Container: Javadoc Location</diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/jbossws_container2.png"></imagedata>
+ <figure float="0">
+ <title>Classpath Container: Javadoc Location</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/preference/jbossws_container2.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Click on </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Apply</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> and then on </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Ok</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
+ <para>Click on <emphasis><property moreinfo="none">Apply</property></emphasis> and then on <emphasis><property moreinfo="none">Ok</property></emphasis>.</para>
@@ -574,16 +573,15 @@
<section id="serverruntime">
<title>Default Server and Runtime</title>
<para>Open <emphasis>
- <property moreinfo="none">Window > Preferences > Web Services > Server and Runtime</property>
- </emphasis>. On this page, you can specify a default server and runtime.</para>
+ <property moreinfo="none">Window > Preferences > Web Services > Server and Runtime</property></emphasis>. On this page, you can specify a default server and runtime.</para>
<para>For ease of use, the better way is to set runtime to JBoss WS.</para>
- <para>After server and runtime are specified, click on the <property moreinfo="none">Aply</property> button
+ <para>After server and runtime are specified, click on the <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Apply</diffmk:wrapper></property> button
to save the values.</para>
<figure float="0">
<title></title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_server_runtime.png"></imagedata>
+ <imagedata fileref="images/preference/jbossws_server_runtime.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
Modified: branches/jbosstools-3.0.x/ws/docs/reference/en/modules/client.xml
===================================================================
--- branches/jbosstools-3.0.x/ws/docs/reference/en/modules/client.xml 2009-05-11 16:44:55 UTC (rev 15215)
+++ branches/jbosstools-3.0.x/ws/docs/reference/en/modules/client.xml 2009-05-11 16:55:55 UTC (rev 15216)
@@ -1,54 +1,51 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<chapter id="client" revisionflag="added">
<title>Creating a Web Service Client from a WSDL Document using JBoss WS</title>
- <para>To create a Web Service Client from a WSDL Document using JBoss WS:</para>
+ <para>To create a Web Service Client from a WSDL Document using JBoss WS you need to fulfil the following steps:</para>
<para>Setup <link linkend="preference">JBoss WS and development environment</link>.</para>
- <para><link linkend="createproject">Creating a Dynamic Web project</link>.</para>
+ <para><link linkend="createproject">Create a Dynamic Web project</link>.</para>
<para><link linkend="addfacet">Add JBossWS Facet to Web project</link>.</para>
- <para>Create a Web Service Client from a WSDL document: </para>
+ <para>Then you can create a Web Service Client from a WSDL document: </para>
<itemizedlist>
<listitem>
<para>Switch to the Java EE perspective <emphasis><property>Window > Open Perspective > Java EE</property></emphasis>.</para>
</listitem>
<listitem>
- <para>In the Project Explorer view, select the bean that you created or imported into the source folder of your Web project.</para>
- </listitem>
- <listitem>
- <para>Click <emphasis><property>File > New > Other</property></emphasis>.Select Web Services in order to display the various Web service wizards. Select the Web Service Client wizard. Click <property>Next</property> button.</para>
+ <para>Click <emphasis><property>File > New > Other</property></emphasis>. Select Web Services in order to display the various Web service wizards. Select the Web Service Client wizard. Click on the <property>Next</property> button.</para>
<figure>
<title>New Web Service Client</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_client.png"></imagedata>
+ <imagedata fileref="images/client/jbossws_client.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
</listitem>
<listitem>
- <para>The first and second Web Service Client wizard page are same to <link linkend="topdownwebservice">Web Service from a WSDL document</link>.</para>
+ <para>The first and the second Web Service Client wizard pages are the same as for <link linkend="topdownwebservice">Web Service from a WSDL document</link>.</para>
<figure>
<title>Set Web Service Common values</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_client_1.png"></imagedata>
+ <imagedata fileref="images/client/jbossws_client_1.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
<figure>
- <title>Set Web Service values about WSDL file</title>
+ <title>Set Web Service values related to WSDL file</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_client_2.png"></imagedata>
+ <imagedata fileref="images/client/jbossws_client_2.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para>The differences are:</para>
+ <para>The only difference is:</para>
<itemizedlist>
<listitem>
- <para><property>Client Type:</property> Now only support Java Proxy.</para>
+ <para><property>Client Type:</property> Support of Java Proxy only.</para>
</listitem>
</itemizedlist>
- <para>Click <property>Finish</property> button.</para>
+ <para>Click on the <property>Finish</property> button.</para>
</listitem>
</itemizedlist>
<para>After the Web Service Client has been created, the following may occur depending on the options you selected:</para>
@@ -62,7 +59,7 @@
<title>Client Sample Class</title>
<mediaobject>
<imageobject>
- <imagedata scale="80" fileref="images/jbossws_client_3.png"></imagedata>
+ <imagedata scale="80" fileref="images/client/jbossws_client_3.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
Modified: branches/jbosstools-3.0.x/ws/docs/reference/en/modules/overview.xml
===================================================================
--- branches/jbosstools-3.0.x/ws/docs/reference/en/modules/overview.xml 2009-05-11 16:44:55 UTC (rev 15215)
+++ branches/jbosstools-3.0.x/ws/docs/reference/en/modules/overview.xml 2009-05-11 16:55:55 UTC (rev 15216)
@@ -3,5 +3,5 @@
<title>JBossWS Runtime Overview</title>
<para>JBossWS is a web service framework developed as a part of the JBoss Application Server. It implements the JAX-WS specification that defines a programming model and run-time architecture for implementing web services in Java, targeted at the Java Platform, Enterprise Edition 5 (Java EE 5).</para>
-
+ <para>JBossWS integrates with most current JBoss Application Server releases as well as earlier ones, that did implement the J2EE 1.4 specifications. Even though JAX-RPC, the web service specification for J2EE 1.4, is still supported JBossWS does put a clear focus on JAX-WS.</para>
</chapter>
\ No newline at end of file
Modified: branches/jbosstools-3.0.x/ws/docs/reference/en/modules/preference.xml
===================================================================
--- branches/jbosstools-3.0.x/ws/docs/reference/en/modules/preference.xml 2009-05-11 16:44:55 UTC (rev 15215)
+++ branches/jbosstools-3.0.x/ws/docs/reference/en/modules/preference.xml 2009-05-11 16:55:55 UTC (rev 15216)
@@ -1,7 +1,11 @@
<?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
@@ -19,7 +23,7 @@
<title>JBossWS Preferences Page</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/Jbossws_preference.png"/>
+ <imagedata fileref="images/preference/Jbossws_preference.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -28,7 +32,7 @@
<property>Add</property>
</emphasis> or <emphasis>
<property>Edit</property>
- </emphasis> button will open the form where you can configure a new JbossWS runtime and
+ </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>
@@ -37,7 +41,7 @@
<title>Edit JBossWS Runtime</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/Jbossws_preference_new.png"/>
+ <imagedata fileref="images/preference/Jbossws_preference_new.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -51,18 +55,18 @@
<title>Classpath Container: Java Source Attachment</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_container1.png"/>
+ <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>
+ <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/jbossws_container2.png"/>
+ <imagedata fileref="images/preference/jbossws_container2.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -77,16 +81,15 @@
<section id="serverruntime">
<title>Default Server and Runtime</title>
<para>Open <emphasis>
- <property>Window > Preferences > Web Services > Server and Runtime</property>
- </emphasis>. On this page, you can specify a default server and runtime.</para>
+ <property>Window > Preferences > Web Services > Server and Runtime</property></emphasis>. On this page, you can specify a default server and runtime.</para>
<para>For ease of use, the better way is to set runtime to JBoss WS.</para>
- <para>After server and runtime are specified, click on the <property>Aply</property> button
+ <para>After server and runtime are specified, click on the <property>Apply</property> button
to save the values.</para>
<figure>
<title/>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_server_runtime.png"/>
+ <imagedata fileref="images/preference/jbossws_server_runtime.png"/>
</imageobject>
</mediaobject>
</figure>
Modified: branches/jbosstools-3.0.x/ws/docs/reference/en/modules/topdown.xml
===================================================================
--- branches/jbosstools-3.0.x/ws/docs/reference/en/modules/topdown.xml 2009-05-11 16:44:55 UTC (rev 15215)
+++ branches/jbosstools-3.0.x/ws/docs/reference/en/modules/topdown.xml 2009-05-11 16:55:55 UTC (rev 15216)
@@ -11,7 +11,7 @@
<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>
+ JBossWS runtime. First you need to create a Dynamic Web project:</para>
<section id="createproject">
<title>Creating a Dynamic Web project</title>
@@ -21,13 +21,12 @@
<title>Dynamic Web Project</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_webproject_1.png"/>
+ <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>
+ <property>New > Project... > Dynamic Web project</property></emphasis>. Enter the following information: </para>
<itemizedlist>
<listitem>
<para>Project Name: enter a project name</para>
@@ -37,14 +36,13 @@
click New and browse to the location where it is installed to. You may set <emphasis>
<property>Target Runtime</property>
</emphasis> to <emphasis>
- <property>None</property>
- </emphasis>, in this case, you should add <link linkend="addfacet">JBoss Web Service
+ <property>None</property></emphasis>, in this case, you should add <link linkend="addfacet">JBoss Web Service
facet to the project</link>.</para>
<figure>
<title>Dynamic Web Project Wizard</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_webproject_2.png"/>
+ <imagedata fileref="images/topdown/jbossws_webproject_2.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -55,24 +53,24 @@
<title>Web Module Settings Configuration</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_webproject_3.png"/>
+ <imagedata fileref="images/topdown/jbossws_webproject_3.png"/>
</imageobject>
</mediaobject>
</figure>
</listitem>
</itemizedlist>
- <para>Click on the <property>Finish</property> button.</para>
+ <para>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, the next step is to add JBoss Web
- Service facet to the project:</para>
+ 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 and open additional configuration for it, having clicked 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/jbossws_facet.png"/>
+ <imagedata fileref="images/topdown/jbossws_facet.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -92,11 +90,11 @@
<title>Configure JBossWS Runtime</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_newruntime.png"/>
+ <imagedata fileref="images/topdown/jbossws_newruntime.png"/>
</imageobject>
</mediaobject>
</figure>
- <para>See how to configure a new JBossWS runtime <link linkend="preference">here</link>:</para>
+ <para>See how to configure a new JBossWS runtime <link linkend="preference">here</link>.</para>
</section>
@@ -107,7 +105,7 @@
WSDL document using JBossWS runtime.</para>
<para>At first, please make sure that you have already created a dynamic Web project with
JBoss Web Service facet installed. </para>
- <para>See how to make it <link linkend="createproject">here</link>> and <link
+ <para>See how to make it <link linkend="createproject">here</link> and <link
linkend="addfacet">here</link>.</para>
<para>To create a Web Service using JBossWS runtime select<emphasis>
@@ -118,19 +116,19 @@
<title>New Web Service Wizard</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_ws_creation1.png"/>
+ <imagedata fileref="images/topdown/jbossws_ws_creation1.png"/>
</imageobject>
</mediaobject>
</figure>
<para>First, please select <property>Top down Java bean Web Service</property> from the Web
Service type list, and select a WSDL document from workspace, click on the Server name
- lilnk on the page will bring you to another dialog. Here you can specify the server to a
+ 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/jbossws_ws_creation1_1.png"/>
+ <imagedata fileref="images/topdown/jbossws_ws_creation1_1.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -143,7 +141,7 @@
<title>New Web Service Wizard</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_ws_creation1.png"/>
+ <imagedata fileref="images/topdown/jbossws_ws_creation1.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -155,7 +153,7 @@
<title>New Web Service Wizard</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_ws_creation2.png"/>
+ <imagedata fileref="images/topdown/jbossws_ws_creation2.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -180,7 +178,7 @@
<title>The generated implementation Java code</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_ws_Impl_code_view.png"/>
+ <imagedata fileref="images/topdown/jbossws_ws_Impl_code_view.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -189,11 +187,11 @@
<title>Web.xml</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_ws_webxml.png"/>
+ <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">
@@ -208,31 +206,29 @@
<itemizedlist>
<listitem>
<para>Switch to the Java EE perspective <emphasis>
- <property>Window > Open Perspective > Java EE</property>
- </emphasis>.</para>
+ <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>Create a new Bean Class</title>
+ <title>Select the Bean Created</title>
<mediaobject>
<imageobject>
- <imagedata scale="80" fileref="images/jbossws_bottomup.png"/>
+ <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.
+ <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/jbossws_bottomup_1.png"/>
+ <imagedata fileref="images/topdown/jbossws_bottomup_1.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -245,7 +241,7 @@
<title>Set Web Service Common values</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_bottomup_2.png"/>
+ <imagedata fileref="images/topdown/jbossws_bottomup_2.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -313,7 +309,7 @@
<title>Set Web Service values for Code Generation</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_bottomup_3.png"/>
+ <imagedata fileref="images/topdown/jbossws_bottomup_3.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -340,7 +336,7 @@
<title>Start a Server</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/jbossws_bottomup_4.png"/>
+ <imagedata fileref="images/topdown/jbossws_bottomup_4.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -355,10 +351,10 @@
<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 WSDL file</title>
+ <title>The Generated HelloWorldService.wsdl File in the wsdl Folder</title>
<mediaobject>
<imageobject>
- <imagedata scale="80" fileref="images/jbossws_bottomup_6.png"/>
+ <imagedata scale="80" fileref="images/topdown/jbossws_bottomup_6.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -371,12 +367,14 @@
<title>The Updated web.xml file</title>
<mediaobject>
<imageobject>
- <imagedata scale="80" fileref="images/jbossws_bottomup_5.png"/>
+ <imagedata scale="80" fileref="images/topdown/jbossws_bottomup_5.png"/>
</imageobject>
</mediaobject>
</figure>
</listitem>
</itemizedlist>
+ <para>In the next chapter you will be able to create a Web Service Client from a WSDL document using JBoss WS.</para>
+
</section>
</chapter>
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/modules/webproject.xml
===================================================================
--- branches/jbosstools-3.0.x/ws/docs/reference/en/modules/webproject.xml 2009-05-11 16:44:55 UTC (rev 15215)
+++ branches/jbosstools-3.0.x/ws/docs/reference/en/modules/webproject.xml 2009-05-11 16:55:55 UTC (rev 15216)
@@ -1,45 +0,0 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<chapter id="webproject" revisionflag="added">
- <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/webproject1.png"></imagedata>
- </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 New and browse to the location where it is installed to. You may set <emphasis><property>Target Runtime</property></emphasis> to <emphasis><property>None</property></emphasis>,
- in this case, you should add <link linkend="addfacet">JBoss Web Service facet to the project</link>.</para>
- <figure>
- <title>Dynamic Web Project Wizard</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/webproject2.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </listitem>
- <listitem>
- <para>Configure Web Module values:</para>
- <figure>
- <title> Web Module Settings Configuration</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/webproject3.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </listitem>
- </itemizedlist>
- <para>Click on the <property>Finish</property> button.</para>
-</chapter>
Modified: branches/jbosstools-3.0.x/ws/docs/reference/pom.xml
===================================================================
--- branches/jbosstools-3.0.x/ws/docs/reference/pom.xml 2009-05-11 16:44:55 UTC (rev 15215)
+++ branches/jbosstools-3.0.x/ws/docs/reference/pom.xml 2009-05-11 16:55:55 UTC (rev 15216)
@@ -86,6 +86,11 @@
<version>1.1.0</version>
<type>jdocbook-style</type>
</dependency>
+ <dependency>
+ <groupId>org.apache.xmlgraphics</groupId>
+ <artifactId>fop</artifactId>
+ <version>0.95</version>
+ </dependency>
</dependencies>
<configuration>
15 years, 5 months
JBoss Tools SVN: r15215 - branches/jbosstools-3.0.x/ws/docs/reference/en/images.
by jbosstools-commits@lists.jboss.org
Author: smukhina
Date: 2009-05-11 12:44:55 -0400 (Mon, 11 May 2009)
New Revision: 15215
Removed:
branches/jbosstools-3.0.x/ws/docs/reference/en/images/Jbossws_preference_new.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_bottomup_1.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_bottomup_2.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_bottomup_3.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_bottomup_4.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_bottomup_5.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_bottomup_6.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_client_1.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_client_2.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_client_3.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_container1.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_container2.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_facet.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_newruntime.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_webproject_1.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_webproject_2.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_webproject_3.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_ws_Impl_code_view.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_ws_creation1.png
branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_ws_creation2.png
Log:
https://jira.jboss.org/jira/browse/JBDS-717 merged changes from trunk are added to the corresponding branch
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/Jbossws_preference_new.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_bottomup_1.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_bottomup_2.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_bottomup_3.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_bottomup_4.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_bottomup_5.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_bottomup_6.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_client_1.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_client_2.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_client_3.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_container1.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_container2.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_facet.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_newruntime.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_webproject_1.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_webproject_2.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_webproject_3.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_ws_Impl_code_view.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_ws_creation1.png
===================================================================
(Binary files differ)
Deleted: branches/jbosstools-3.0.x/ws/docs/reference/en/images/jbossws_ws_creation2.png
===================================================================
(Binary files differ)
15 years, 5 months
JBoss Tools SVN: r15214 - in branches/jbosstools-3.0.x/struts/docs: struts_tools_ref_guide/en/modules and 3 other directories.
by jbosstools-commits@lists.jboss.org
Author: smukhina
Date: 2009-05-11 12:44:04 -0400 (Mon, 11 May 2009)
New Revision: 15214
Modified:
branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/modules/introduction.xml
branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/modules/projects.xml
branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/modules/rel_resources_links.xml
branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/pom.xml
branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/images/struts_application/struts_application_4.png
branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/images/struts_application/struts_application_5.png
branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/modules/coding_files.xml
branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/modules/generating_stub.xml
branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/modules/introduction.xml
branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/modules/struts_application.xml
branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/pom.xml
Log:
https://jira.jboss.org/jira/browse/JBDS-717 merged changes from trunk are added to the corresponding branch
Modified: branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/modules/introduction.xml
===================================================================
--- branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/modules/introduction.xml 2009-05-11 16:43:48 UTC (rev 15213)
+++ branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/modules/introduction.xml 2009-05-11 16:44:04 UTC (rev 15214)
@@ -84,7 +84,7 @@
<row>
<entry><para>Verification and Validation</para></entry>
- <entry><para>All occuring errors will be immediately reported by verification
+ <entry><para>All occurring errors will be immediately reported by verification
feature, no matter in what view you are working. Constant validation and
errors checking allows to catch many of the errors during development
process that significantly reduces development time.</para></entry>
Modified: branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/modules/projects.xml
===================================================================
--- branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/modules/projects.xml 2009-05-11 16:43:48 UTC (rev 15213)
+++ branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/modules/projects.xml 2009-05-11 16:44:04 UTC (rev 15214)
@@ -253,7 +253,7 @@
</mediaobject>
</figure>
- <para>When done, you can open end edit the struts-config.xml file using usefull Struts
+ <para>When done, you can open end edit the struts-config.xml file using useful Struts
configuration file editor provided by JBDS. (The Struts configuration is shown below in
the Tree viewer).</para>
Modified: branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/modules/rel_resources_links.xml
===================================================================
--- branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/modules/rel_resources_links.xml 2009-05-11 16:43:48 UTC (rev 15213)
+++ branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/modules/rel_resources_links.xml 2009-05-11 16:44:04 UTC (rev 15214)
@@ -28,4 +28,6 @@
leave your questions and suggestions on our <ulink
url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201"
>Forum</ulink>.</para>
+ <para>We hope, this guide helped you to get started with the JBoss Struts Tools. Besides, for additional information you are welcome on <ulink
+ url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201">JBoss forum</ulink>.</para>
</chapter>
Modified: branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/pom.xml
===================================================================
--- branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/pom.xml 2009-05-11 16:43:48 UTC (rev 15213)
+++ branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/pom.xml 2009-05-11 16:44:04 UTC (rev 15214)
@@ -77,7 +77,11 @@
<artifactId>jbosstools-docbook-xslt</artifactId>
<version>1.0.0-SNAPSHOT</version>
</dependency>
- </dependencies>
+ <dependency>
+ <groupId>org.apache.xmlgraphics</groupId>
+ <artifactId>fop</artifactId>
+ <version>0.95</version>
+ </dependency> </dependencies>
<configuration>
<sourceDocumentName>${master}</sourceDocumentName>
Modified: branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/images/struts_application/struts_application_4.png
===================================================================
(Binary files differ)
Modified: branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/images/struts_application/struts_application_5.png
===================================================================
(Binary files differ)
Modified: branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/modules/coding_files.xml
===================================================================
--- branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/modules/coding_files.xml 2009-05-11 16:43:48 UTC (rev 15213)
+++ branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/modules/coding_files.xml 2009-05-11 16:44:04 UTC (rev 15214)
@@ -34,7 +34,7 @@
<listitem>
<para>You are looking at a Java stub class that was generated by JBoss
- Developer Studio. Now we are going to edit the file</para>
+ Tools. Now we are going to edit the file</para>
</listitem>
<listitem>
@@ -42,7 +42,6 @@
</listitem>
</itemizedlist>
<programlisting role="JAVA"><![CDATA[private String name = "";
- private String greetName = "";
]]></programlisting>
<itemizedlist>
@@ -52,7 +51,6 @@
</listitem>
</itemizedlist>
<programlisting role="JAVA"><![CDATA[this.name = "";
- this.greetName = "";
]]></programlisting>
<itemizedlist>
@@ -68,17 +66,19 @@
<itemizedlist>
<listitem>
<para>Right-click and select <emphasis>
- <property>Source > Generate Getters and Setters...</property>
+ <property>Source > Generate Getters and Setters</property>
</emphasis>from the context menu</para>
</listitem>
<listitem>
- <para>In the dialog box, check the check boxes for name and greetName,
+ <para>In the dialog box, check the check box for <emphasis>
+ <property>name</property>,</emphasis>
select First method for Insertion point, and click on the <emphasis>
<property>OK</property>
</emphasis> button</para>
</listitem>
</itemizedlist>
- <para>The final GetNameForm.java file should look like this:</para>
+ <para>The final <emphasis>
+ <property>GetNameForm.java</property></emphasis> file should look like this:</para>
<programlisting role="JAVA"><![CDATA[package sample;
import javax.servlet.http.HttpServletRequest;
import org.apache.struts.action.ActionErrors;
@@ -88,7 +88,6 @@
{
private String name = "";
- private String greetName = "";
public String getName()
{
@@ -99,16 +98,6 @@
this.name = name;
}
- public String getGreetName()
- {
- return greetName;
- }
-
- public void setGreetName(String greetName)
- {
- this.greetName = greetName;
- }
-
public GetNameForm()
{
}
@@ -116,7 +105,6 @@
public void reset(ActionMapping actionMapping, HttpServletRequest request)
{
this.name = "";
- this.greetName = "";
}
public ActionErrors validate(ActionMapping actionMapping,
@@ -138,7 +126,8 @@
<title>GreetingAction.java</title>
<itemizedlist>
<listitem>
- <para>Open GreetingAction.java for editing</para>
+ <para>Open <emphasis>
+ <property>GreetingAction.java</property></emphasis> for editing</para>
</listitem>
<listitem>
<para>Inside the execute method, delete the TO DO lines and add the
@@ -152,7 +141,8 @@
return mapping.findForward(FORWARD_sayHello);
]]></programlisting>
- <para>The final version of GreetingAction.java should look like this:</para>
+ <para>The final version of <emphasis>
+ <property>GreetingAction.java</property></emphasis> should look like this:</para>
<programlisting role="JAVA"><![CDATA[package sample;
import javax.servlet.http.HttpServletRequest;
@@ -267,7 +257,7 @@
</emphasis></para>
</listitem>
<listitem>
- <para>In the StrutsForm library in the JBoss Tools Palette, select <emphasis>
+ <para>In the StrutsForm library in the <property>JBoss Tools Palette</property>, select <emphasis>
<property>submit</property>
</emphasis>, and drag it to right after the text box in the Visual pane
of the editor</para>
@@ -322,19 +312,21 @@
</html>
]]></programlisting>
- <para>To complete editing of this file, we will use macros from the JBoss Tools
- Palette. This palette is a view that should be available to the right of the
+ <para>To complete editing of this file, we will use macros from the <property>JBoss Tools
+ Palette</property>. This palette is a view that should be available to the right of the
editing area.</para>
<itemizedlist>
<listitem>
<para>Click on the <emphasis>
<property>Struts Common</property>
- </emphasis> folder in the JBoss Tools Palette to open it</para>
+ </emphasis> folder in the <property>JBoss Tools Palette</property> to open it</para>
</listitem>
<listitem>
- <para>Position the cursor at the beginning of the greeting.jsp file in the
- Source pane and then click on bean taglib in the JBoss Tools
- Palette</para>
+ <para>Position the cursor at the beginning of the <emphasis>
+ <property>greeting.jsp</property></emphasis> file in the
+ Source pane and then click on <emphasis>
+ <property>bean taglib</property></emphasis> in the <property>JBoss Tools
+ Palette</property></para>
</listitem>
</itemizedlist>
<para>This will insert the following line at the top of the file:</para>
@@ -345,7 +337,7 @@
<listitem>
<para>Click on the <emphasis>
<property>Struts Bean</property>
- </emphasis> folder in the JBoss Tools Palette to open it</para>
+ </emphasis> folder in the <property>JBoss Tools Palette</property> to open it</para>
</listitem>
<listitem>
<para>Position the cursor inside the <emphasis role="bold">
@@ -353,15 +345,16 @@
</emphasis> element</para>
</listitem>
<listitem>
- <para>Click on write in the JBoss Tools Palette</para>
+ <para>Click on <emphasis>
+ <property>write</property></emphasis> in the <property>JBoss Tools Palette</property></para>
</listitem>
<listitem>
<para>Type in "GetNameForm" for the <emphasis
role="italic">
- <property>"name"</property>
+ <property>name</property>
</emphasis> attribute and add a <emphasis role="italic">
- <property>"property"</property>
- </emphasis> attribute with "greetName" as its
+ <property>property</property>
+ </emphasis> attribute with "name" as its
value</para>
</listitem>
</itemizedlist>
@@ -378,28 +371,31 @@
</section>
<section id="index.jsp">
<title>index.jsp</title>
- <para>Finally, we will need to create and edit an index.jsp page. This page will use
+ <para>Finally, we will need to create and edit an <emphasis>
+ <property>index.jsp</property></emphasis> page. This page will use
a Struts forward to simply redirect us to the getName global forward.</para>
<itemizedlist>
<listitem>
<para>In the Web Projects view, right-click on <emphasis>
<property>StrutsHello > WEB-ROOT(WebContent)</property>
</emphasis> node and select <emphasis>
- <property>New > File > JSP..</property>
+ <property>New > File > JSP</property>
</emphasis></para>
</listitem>
<listitem>
- <para>Type index for Name and click on the <emphasis>
+ <para>Type <emphasis>
+ <property>index</property></emphasis> for Name and click on the <emphasis>
<property>Finish</property>
</emphasis> button</para>
</listitem>
<listitem>
- <para>On the JBoss Tools Palette, select the <emphasis>
+ <para>On the <property>JBoss Tools Palette</property>, select the <emphasis>
<property>Struts Common</property>
</emphasis> folder of macros by clicking on it in the palette</para>
</listitem>
<listitem>
- <para>Click on the logic taglib icon</para>
+ <para>Click on the <emphasis>
+ <property>logic taglib</property></emphasis> icon</para>
</listitem>
<listitem>
<para>Press the <emphasis>
@@ -412,7 +408,8 @@
</emphasis> folder of macros</para>
</listitem>
<listitem>
- <para>Click on redirect</para>
+ <para>Click on <emphasis>
+ <property>redirect</property></emphasis></para>
</listitem>
<listitem>
<para>Delete the ending tag, put a forward slash in front of the closing
Modified: branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/modules/generating_stub.xml
===================================================================
--- branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/modules/generating_stub.xml 2009-05-11 16:43:48 UTC (rev 15213)
+++ branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/modules/generating_stub.xml 2009-05-11 16:44:04 UTC (rev 15214)
@@ -45,7 +45,7 @@
</itemizedlist>
<para>The Java files will be generated in a <emphasis>
<property>JavaSource > sample</property>
- </emphasis> folder that you can see in the Package Explorer view under the
+ </emphasis> folder that you can see in the <property>Package Explorer view</property> under the
"StrutsHello" node. One Action stub and one FormBean stub will have
been generated.</para>
</chapter>
\ No newline at end of file
Modified: branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/modules/introduction.xml
===================================================================
--- branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/modules/introduction.xml 2009-05-11 16:43:48 UTC (rev 15213)
+++ branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/modules/introduction.xml 2009-05-11 16:44:04 UTC (rev 15214)
@@ -27,8 +27,8 @@
<section>
<title>Other relevant resources on the topic</title>
- <para>All JBoss Developer Studio/JBoss Tools documentation you can find <ulink url="http://docs.jboss.org/tools/">here</ulink>.</para>
- <para>The latest documentation builds are available <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">here</ulink>.</para>
+ <para>All JBoss Developer Studio/JBoss Tools release documentation you can find at<ulink url="http://docs.jboss.org/tools/">http://docs.jboss.org/tools</ulink> in the corresponding release directory.</para>
+ <para>The latest documentation builds are available at <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">http://download.jboss.org/jbosstools/nightly-docs</ulink>.</para>
</section>
Modified: branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/modules/struts_application.xml
===================================================================
--- branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/modules/struts_application.xml 2009-05-11 16:43:48 UTC (rev 15213)
+++ branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/modules/struts_application.xml 2009-05-11 16:44:04 UTC (rev 15214)
@@ -11,7 +11,7 @@
<title>Creating a Simple Struts Application</title>
- <para>Firstly, we assume that you have already launched Eclipse with JBoss Tools installed and
+ <para>Firstly, we assume that you have already launched Eclipse with <property>JBoss Tools</property> installed and
also that the <property>Web Development perspective</property> is the current perspective. (If not, make it
active by selecting <emphasis>
<property>Window > Open Perspective > Other > Web
@@ -24,31 +24,27 @@
<itemizedlist>
<listitem>
<para>Go to the menu bar and select <emphasis>
- <property>File > New > Project...</property>
- </emphasis>.</para>
- </listitem>
- <listitem>
- <para>Select <emphasis>
- <property>JBoss Tools Web > Struts > Struts Project</property>
- </emphasis> in the New Project dialog box</para>
- </listitem>
- <listitem>
- <para>Click <emphasis>
- <property>Next </property>
+ <property>File > New > Struts Project</property>
</emphasis></para>
</listitem>
<listitem>
- <para>Enter "StrutsHello" as the project name</para>
+ <para>Next enter "StrutsHello" as the project name</para>
</listitem>
<listitem>
- <para>Leave everything else as is, and click <emphasis>
+ <para>Leave everything else as it is, and click <emphasis>
<property>Next</property>
</emphasis></para>
</listitem>
<listitem>
+ <para>If you have server runtime already defined, just pass to next point. Otherwise in the <emphasis>
+ <property>Runtime</property></emphasis> section click the <emphasis>
+ <property>New</property></emphasis> button and target at needed server runtime environment. Click <emphasis>
+ <property>Finish</property>.</emphasis></para>
+ </listitem>
+ <listitem>
<para>Click <emphasis>
<property>Next</property>
- </emphasis> again</para>
+ </emphasis></para>
</listitem>
<listitem>
<para>Make sure that <emphasis>
@@ -57,13 +53,13 @@
<property>struts-html.tld</property>
</emphasis>, and <emphasis>
<property>struts-logic.tld</property>
- </emphasis> are checked in the list of included tag libraries and then click <emphasis>
+ </emphasis> are checked in the list of included tag libraries and then hit <emphasis>
<property>Finish</property>
</emphasis></para>
</listitem>
</itemizedlist>
- <para>A "StrutsHello" node should appear in the upper-left Package
- Explorer view.</para>
+ <para>A "StrutsHello" node should appear in the <property>Package
+ Explorer view</property>.</para>
<itemizedlist>
<listitem>
<para>Click the plus sign next to <emphasis>
@@ -73,12 +69,14 @@
<listitem>
<para>Click the plus sign next to <emphasis>
<property>WebContent</property>
- </emphasis> under StrutsHello</para>
+ </emphasis> under <emphasis>
+ <property>StrutsHello</property></emphasis></para>
</listitem>
<listitem>
<para>Click the plus sign next to <emphasis>
<property>WEB-INF</property>
- </emphasis> under WebContent</para>
+ </emphasis> under <emphasis>
+ <property>WebContent</property></emphasis></para>
</listitem>
<listitem>
<para>Then, double-click on the <emphasis>
@@ -94,7 +92,7 @@
<?dbhtml filename="CreatingtheApplicationComponents.html"?>
<title>Creating the Application Components</title>
<para>Now, we will design the application by creating the individual components as
- placeholders first. (We dont have to complete all of the details inside the components
+ placeholders first. (We don't have to complete all of the details inside the components
until afterwards.)</para>
<section id="CreatingJSPPagePlaceholders">
<title>Creating JSP Page Placeholders</title>
@@ -105,7 +103,7 @@
<title>Creating the Page Placeholders</title>
<itemizedlist>
<listitem>
- <para>Bring the Web Projects view to the front of the Package Explorer view
+ <para>Bring the <property>Web Projects view</property> to the front of the <property>Package Explorer view</property>
by selecting the <emphasis>
<property>Web Projects</property>
</emphasis> tab next to that tab.</para>
@@ -113,7 +111,7 @@
<listitem>
<para>Right-click the <emphasis>
<property>StrutsHello > WEB-ROOT (WebContent)</property>
- </emphasis> folder in the Web Projects view and select <emphasis>
+ </emphasis> folder in the <property>Web Projects view</property> and select <emphasis>
<property>New > Folder...</property>
</emphasis></para>
</listitem>
@@ -130,8 +128,9 @@
</listitem>
<listitem>
- <para>Right-click the pages folder and select <emphasis>
- <property>New > Fila > JSP...</property>
+ <para>Right-click the <emphasis>
+ <property>pages</property></emphasis> folder and select <emphasis>
+ <property>New > File > JSP...</property>
</emphasis>
</para>
</listitem>
@@ -146,14 +145,16 @@
</emphasis> button</para>
</listitem>
<listitem>
- <para>Right-click the pages folder again and select <emphasis>
+ <para>Right-click the <emphasis>
+ <property>pages</property></emphasis> folder again and select <emphasis>
<property>New > File > JSP...</property>
</emphasis></para>
</listitem>
<listitem>
<para>For Name type in <emphasis>
<property>greeting</property>
- </emphasis>, for Template leave as Blank, and then click on the <emphasis>
+ </emphasis>, for Template leave as <emphasis>
+ <property>Blank</property>,</emphasis> and then click on the <emphasis>
<property>Finish</property>
</emphasis> button</para>
</listitem>
@@ -167,18 +168,18 @@
<listitem>
<para>Click on the <emphasis>
<property>struts-config.xml</property>
- </emphasis> tab in the Editing area to bring the diagram to the
+ </emphasis> tab in the editing area to bring the diagram to the
front</para>
</listitem>
<listitem>
<para>Click on the <emphasis>
<property>inputname.jsp</property>
- </emphasis> page in the Web Projects view, drag it onto the diagram, and
+ </emphasis> page in the <property>Web Projects view</property>, drag it onto the diagram, and
drop it</para>
</listitem>
<listitem><para>Click on the <emphasis>
<property>greeting.jsp</property>
- </emphasis> page in the Web Projects view, drag it onto the diagram, and
+ </emphasis> page in the <property>Web Projects view</property>, drag it onto the diagram, and
drop it to the right of the <emphasis>
<property>/pages/inputname.jsp</property>
</emphasis> icon with some extra space</para></listitem>
@@ -193,7 +194,7 @@
<itemizedlist>
<listitem>
<para>Right-click between the two icons and select <emphasis>
- <property>Add > Action</property>
+ <property>New > Action</property>
</emphasis></para>
</listitem>
<listitem>
@@ -240,14 +241,18 @@
<para>The <emphasis>
<property>/greeting</property>
</emphasis> action should appear in four places, in the diagram, under the
- action-mappings node, under the struts-config.xml node in Tree view, in Web Projects
- view and in the Outline view. Also, note the asterisk to the right of the name,
- struts-config.xml, in the Outline view showing that the file has been changed, but
+ <emphasis>
+ <property>action-mappings</property></emphasis> node, under the <emphasis>
+ <property>struts-config.xml</property></emphasis> node in Tree view, in <property>Web Projects
+ view</property> and in the <property>Outline view</property>. Also, note the asterisk to the right of the name,
+ <emphasis>
+ <property>struts-config.xml</property>,</emphasis> in the <property>Outline view</property> showing that the file has been changed, but
not saved to disk.</para>
</section>
<section id="CreatingaLink">
<title>Creating a Link</title>
- <para>Let's now create a link from the inputname.jsp page to the action.</para>
+ <para>Let's now create a link from the <emphasis>
+ <property>inputname.jsp</property></emphasis> page to the action.</para>
<itemizedlist>
<listitem>
<para>On the left-hand side of the diagram in the column of icons, click on this
@@ -300,7 +305,8 @@
</listitem>
<listitem>
<para>That's it. A link will be drawn from the actions new greeting
- forward to the greeting.jsp JSP page. Note that the forwards name will be
+ forward to the <emphasis>
+ <property>greeting.jsp</property></emphasis> JSP page. Note that the forwards name will be
set based on the name of the target JSP file name. If you don't
like it, you can easily change it</para>
</listitem>
@@ -312,12 +318,13 @@
</listitem>
<listitem>
<para>Expand the <emphasis>
- <property>struts-config.xml/action-mappings//greeting</property>
+ <property>struts-config.xml/action-mappings/ /greeting</property>
</emphasis> node and then select the greeting forward</para>
</listitem>
<listitem>
<para>In the Properties Editor to the right, change the text to
- "sayHello" in the Name field</para>
+ "sayHello" in the <emphasis>
+ <property>Name</property></emphasis> field</para>
</listitem>
<listitem>
<para>Select the <emphasis>
@@ -333,13 +340,14 @@
<itemizedlist>
<listitem>
<para>Somewhere in the top-left corner of diagram, right-click and select <emphasis>
- <property> Add > Global Forward...</property>
+ <property>New > Global Forward</property>
</emphasis></para>
</listitem>
<listitem>
<para>Enter <emphasis>
<property>getName</property>
- </emphasis> in the Name field</para>
+ </emphasis> in the <emphasis>
+ <property>Name</property></emphasis> field</para>
</listitem>
<listitem>
<para>Select the <emphasis>
@@ -389,7 +397,8 @@
<para>One last thing that we need to do is to create a form bean.</para>
<itemizedlist>
<listitem>
- <para>Switch to the Tree viewer in the editor for the struts-config.xml file, by
+ <para>Switch to the Tree viewer in the editor for the <emphasis>
+ <property>struts-config.xml</property></emphasis> file, by
selecting the <emphasis>
<property>Tree</property>
</emphasis> tab at the bottom of the editor window</para>
@@ -417,7 +426,8 @@
</emphasis> from the menu bar</para>
</listitem>
</itemizedlist>
- <para>Note the disappearance of the asterisk next to the name, struts-config.xml.</para>
+ <para>Note the disappearance of the asterisk next to the name, <emphasis>
+ <property>struts-config.xml</property>.</emphasis></para>
</section>
</section>
</chapter>
\ No newline at end of file
Modified: branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/pom.xml
===================================================================
--- branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/pom.xml 2009-05-11 16:43:48 UTC (rev 15213)
+++ branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/pom.xml 2009-05-11 16:44:04 UTC (rev 15214)
@@ -87,6 +87,11 @@
<artifactId>jbosstools-docbook-xslt</artifactId>
<version>1.0.0-SNAPSHOT</version>
</dependency>
+ <dependency>
+ <groupId>org.apache.xmlgraphics</groupId>
+ <artifactId>fop</artifactId>
+ <version>0.95</version>
+ </dependency>
</dependencies>
<configuration>
15 years, 5 months
JBoss Tools SVN: r15213 - branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en.
by jbosstools-commits@lists.jboss.org
Author: smukhina
Date: 2009-05-11 12:43:48 -0400 (Mon, 11 May 2009)
New Revision: 15213
Added:
branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/master_output.xml
Removed:
branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/master_output.xml
Log:
https://jira.jboss.org/jira/browse/JBDS-717 merged changes from trunk are added to the corresponding branch
Deleted: branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/master_output.xml
===================================================================
--- branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/master_output.xml 2009-05-11 16:43:34 UTC (rev 15212)
+++ branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/master_output.xml 2009-05-11 16:43:48 UTC (rev 15213)
@@ -1,1340 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-"http://www.docbook.org/xml/4.3/docbookx.dtd"
-
-[<!ENTITY introduction SYSTEM "modules/introduction.xml">
-<!ENTITY struts_application SYSTEM "modules/struts_application.xml">
-<!ENTITY generating_stub SYSTEM "modules/generating_stub.xml">
-<!ENTITY coding_files SYSTEM "modules/coding_files.xml">
-<!ENTITY compiling_and_running SYSTEM "modules/compiling_and_running.xml">
-<!ENTITY struts_validation SYSTEM "modules/struts_validation.xml">
-<!ENTITY relevant_resources SYSTEM "modules/relevant_resources.xml">
-
-<!ENTITY seamlink "../../seam/html_single/index.html">
-<!ENTITY aslink "../../as/html_single/index.html">
-<!ENTITY esblink "../../esb_ref_guide/html_single/index.html">
-<!ENTITY gsglink "../../GettingStartedGuide/html_single/index.html">
-<!ENTITY hibernatelink "../../hibernatetools/html_single/index.html">
-<!ENTITY jbpmlink "../../jbpm/html_single/index.html">
-<!ENTITY jsflink "../../jsf/html_single/index.html">
-<!ENTITY jsfreflink "../../jsf_tools_ref_guide/html_single/index.html">
-<!ENTITY jsftutoriallink "../../jsf_tools_tutorial/html_single/index.html">
-<!ENTITY strutsreflink "../../struts_tools_ref_guide/html_single/index.html">
-<!ENTITY strutstutoriallink "../../struts_tools_tutorial/html_single/index.html">
-
-]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff">
-
- <bookinfo>
- <title>Struts Tools Tutorial</title>
-
- <author><firstname>Anatoly</firstname><surname>Fedosik</surname></author>
- <author><firstname>Olga</firstname><surname>Chikvina</surname></author>
- <author><firstname>Svetlana</firstname><surname>Mukhina</surname><email>smukhina(a)exadel.com</email></author>
-
- <pubdate>April 2008</pubdate>
- <copyright>
- <year>2007</year>
- <year><diffmk:wrapper diffmk:change="changed">2009</diffmk:wrapper></year>
- <holder><diffmk:wrapper diffmk:change="changed">JBoss, a division of Red Hat</diffmk:wrapper></holder>
- </copyright>
- <releaseinfo><diffmk:wrapper diffmk:change="changed">
- Version: 3.0.0.GA
- </diffmk:wrapper></releaseinfo>
-
-<abstract>
- <title></title>
- <para>
- <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/struts_tools_tutoria...">PDF version</ulink>
- </para>
-</abstract>
-
-
- </bookinfo>
-
- <toc></toc>
-
-
-<chapter id="introduction" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_tutorial/en/modules/introduction.xml" xreflabel="introduction">
- <?dbhtml filename="introduction.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Tools</keyword>
- <keyword>Eclipse</keyword>
- <keyword>Java</keyword>
- <keyword>JBoss</keyword>
- </keywordset>
- </chapterinfo>
- <title>Introduction</title>
- <para>The following chapters describe how to deal with classic/old style of Struts development. We
- recommend users to use <ulink url="../../seam/html_single/index.html">JBoss Seam</ulink> to
- simplify development, but until then you can read about classical Struts usage here.</para>
-
- <para>We are going to show you how to create a simple <emphasis>
- <property moreinfo="none">Struts application</property>
- </emphasis> using the JBoss Tools. The completed application will ask a user to enter
- a name and click a button. The resulting new page will display the familiar message,
- "Hello <name>!"</para>
- <para>This document will show you how to create such an application from the beginning, along the
- way demonstrating some of the powerful features of JBoss Tools. With the help of our tutorial you will design the
- application, generate stub code for the application, fill in the stub coding, compile the
- application, and finally run it all from inside the Eclipse.</para>
-
- <section>
- <title>Other relevant resources on the topic</title>
-
- <para>All JBoss Developer Studio/JBoss Tools documentation you can find <ulink url="http://docs.jboss.org/tools/">here</ulink>.</para>
- <para>The latest documentation builds are available <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">here</ulink>.</para>
-
- </section>
-
-</chapter>
-
-
-<chapter id="struts_application" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_tutorial/en/modules/struts_application.xml" xreflabel="struts_application">
- <?dbhtml filename="struts_application.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Tools</keyword>
- <keyword>Struts</keyword>
- <keyword>Struts Application</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Creating a Simple Struts Application</title>
-
- <para>Firstly, we assume that you have already launched Eclipse with JBoss Tools installed and
- also that the <property moreinfo="none">Web Development perspective</property> is the current perspective. (If not, make it
- active by selecting <emphasis>
- <property moreinfo="none">Window > Open Perspective > Other > Web
- Development</property>
- </emphasis> from the menu bar.)</para>
-
- <section id="StartingUp">
- <title>Starting Up</title>
- <para>We are first going to create a new project for the application.</para>
- <itemizedlist>
- <listitem>
- <para>Go to the menu bar and select <emphasis>
- <property moreinfo="none">File > New > Project...</property>
- </emphasis>.</para>
- </listitem>
- <listitem>
- <para>Select <emphasis>
- <property moreinfo="none">JBoss Tools Web > Struts > Struts Project</property>
- </emphasis> in the New Project dialog box</para>
- </listitem>
- <listitem>
- <para>Click <emphasis>
- <property moreinfo="none">Next </property>
- </emphasis></para>
- </listitem>
- <listitem>
- <para>Enter "StrutsHello" as the project name</para>
- </listitem>
- <listitem>
- <para>Leave everything else as is, and click <emphasis>
- <property moreinfo="none">Next</property>
- </emphasis></para>
- </listitem>
- <listitem>
- <para>Click <emphasis>
- <property moreinfo="none">Next</property>
- </emphasis> again</para>
- </listitem>
- <listitem>
- <para>Make sure that <emphasis>
- <property moreinfo="none">struts-bean.tld</property>
- </emphasis>, <emphasis>
- <property moreinfo="none">struts-html.tld</property>
- </emphasis>, and <emphasis>
- <property moreinfo="none">struts-logic.tld</property>
- </emphasis> are checked in the list of included tag libraries and then click <emphasis>
- <property moreinfo="none">Finish</property>
- </emphasis></para>
- </listitem>
- </itemizedlist>
- <para>A "StrutsHello" node should appear in the upper-left Package
- Explorer view.</para>
- <itemizedlist>
- <listitem>
- <para>Click the plus sign next to <emphasis>
- <property moreinfo="none">StrutsHello</property>
- </emphasis> to reveal the child nodes</para>
- </listitem>
- <listitem>
- <para>Click the plus sign next to <emphasis>
- <property moreinfo="none">WebContent</property>
- </emphasis> under StrutsHello</para>
- </listitem>
- <listitem>
- <para>Click the plus sign next to <emphasis>
- <property moreinfo="none">WEB-INF</property>
- </emphasis> under WebContent</para>
- </listitem>
- <listitem>
- <para>Then, double-click on the <emphasis>
- <property moreinfo="none">struts-config.xml</property>
- </emphasis> node to display a diagram of the Struts application configuration
- file in the editing area</para>
- </listitem>
- </itemizedlist>
- <para>At this point, its empty except for the background grid lines.</para>
- </section>
-
- <section id="CreatingtheApplicationComponents">
- <?dbhtml filename="CreatingtheApplicationComponents.html"?>
- <title>Creating the Application Components</title>
- <para>Now, we will design the application by creating the individual components as
- placeholders first. (We dont have to complete all of the details inside the components
- until afterwards.)</para>
- <section id="CreatingJSPPagePlaceholders">
- <title>Creating JSP Page Placeholders</title>
- <para>Next, let's create and place two JSP pages. We will not write any code
- for the files, but only create them as placeholders so that we can create links to
- them in the diagram. We will write the code a little bit later.</para>
- <section id="CreatingthePagePlaceholders">
- <title>Creating the Page Placeholders</title>
- <itemizedlist>
- <listitem>
- <para>Bring the Web Projects view to the front of the Package Explorer view
- by selecting the <emphasis>
- <property moreinfo="none">Web Projects</property>
- </emphasis> tab next to that tab.</para>
- </listitem>
- <listitem>
- <para>Right-click the <emphasis>
- <property moreinfo="none">StrutsHello > WEB-ROOT (WebContent)</property>
- </emphasis> folder in the Web Projects view and select <emphasis>
- <property moreinfo="none">New > Folder...</property>
- </emphasis></para>
- </listitem>
- <listitem>
- <para>Enter <emphasis>
- <property moreinfo="none">pages</property>
- </emphasis> for a folder name and click <emphasis>
- <property moreinfo="none">Finish</property>
- </emphasis></para>
- </listitem>
-
- <listitem>
- <para>We will keep our presentation files in this folder</para>
- </listitem>
-
- <listitem>
- <para>Right-click the pages folder and select <emphasis>
- <property moreinfo="none">New > Fila > JSP...</property>
- </emphasis>
- </para>
- </listitem>
- <listitem>
- <para>For Name type in <emphasis>
- <property moreinfo="none">inputname</property>
- </emphasis> (the JSP extension will be automatically added to the file),
- for Template select <emphasis>
- <property moreinfo="none">StrutsForm</property>
- </emphasis> and then click on the <emphasis>
- <property moreinfo="none">Finish</property>
- </emphasis> button</para>
- </listitem>
- <listitem>
- <para>Right-click the pages folder again and select <emphasis>
- <property moreinfo="none">New > File > JSP...</property>
- </emphasis></para>
- </listitem>
- <listitem>
- <para>For Name type in <emphasis>
- <property moreinfo="none">greeting</property>
- </emphasis>, for Template leave as Blank, and then click on the <emphasis>
- <property moreinfo="none">Finish</property>
- </emphasis> button</para>
- </listitem>
- </itemizedlist>
- <para>Just leave these files as is for now.</para>
- </section>
- <section id="PlacingthePagePlaceholders">
- <title>Placing the Page Placeholders</title>
- <para>Lets now place the two pages just created on the diagram.</para>
- <itemizedlist>
- <listitem>
- <para>Click on the <emphasis>
- <property moreinfo="none">struts-config.xml</property>
- </emphasis> tab in the Editing area to bring the diagram to the
- front</para>
- </listitem>
- <listitem>
- <para>Click on the <emphasis>
- <property moreinfo="none">inputname.jsp</property>
- </emphasis> page in the Web Projects view, drag it onto the diagram, and
- drop it</para>
- </listitem>
- <listitem><para>Click on the <emphasis>
- <property moreinfo="none">greeting.jsp</property>
- </emphasis> page in the Web Projects view, drag it onto the diagram, and
- drop it to the right of the <emphasis>
- <property moreinfo="none">/pages/inputname.jsp</property>
- </emphasis> icon with some extra space</para></listitem>
- </itemizedlist>
- <para>You should now have two JSP pages in the diagram.</para>
- </section>
- </section>
- <section id="CreatinganActionMappings">
- <title>Creating an Action Mappings</title>
- <para>Using a context menu on the diagram, we are next going to create an Action
- mapping.</para>
- <itemizedlist>
- <listitem>
- <para>Right-click between the two icons and select <emphasis>
- <property moreinfo="none">Add > Action</property>
- </emphasis></para>
- </listitem>
- <listitem>
- <para>Enter the following values:</para>
- </listitem>
- </itemizedlist>
- <table>
- <title>Action values</title>
- <tgroup cols="2">
- <tbody>
- <row>
- <entry>path</entry>
- <entry>/greeting</entry>
- </row>
- <row>
- <entry>name</entry>
- <entry>GetNameForm</entry>
- </row>
- <row>
- <entry>scope</entry>
- <entry>request</entry>
- </row>
- <row>
- <entry>type</entry>
- <entry>sample.GreetingAction</entry>
- </row>
- <row>
- <entry>validate</entry>
- <entry><leave blank></entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- <para>("GetNameForm" is the name for a form bean that we will create
- later.)</para>
- <itemizedlist>
- <listitem>
- <para>Click <emphasis>
- <property moreinfo="none">Finish</property>
- </emphasis></para>
- </listitem>
- </itemizedlist>
-
- <para>The <emphasis>
- <property moreinfo="none">/greeting</property>
- </emphasis> action should appear in four places, in the diagram, under the
- action-mappings node, under the struts-config.xml node in Tree view, in Web Projects
- view and in the Outline view. Also, note the asterisk to the right of the name,
- struts-config.xml, in the Outline view showing that the file has been changed, but
- not saved to disk.</para>
- </section>
- <section id="CreatingaLink">
- <title>Creating a Link</title>
- <para>Let's now create a link from the inputname.jsp page to the action.</para>
- <itemizedlist>
- <listitem>
- <para>On the left-hand side of the diagram in the column of icons, click on this
- icon:</para>
- </listitem>
- </itemizedlist>
- <figure float="0">
- <title>Create New Connection Icon</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts_application/struts_application_1.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <itemizedlist>
- <listitem>
- <para>In the connect-the-components mode you are in now, click on the <emphasis>
- <property moreinfo="none">/pages/inputname.jsp</property>
- </emphasis> icon in the diagram and then click on the <emphasis>
- <property moreinfo="none">/greeting</property>
- </emphasis> action</para>
- </listitem>
- </itemizedlist>
- <para>A link will be created from the page to the action.</para>
- </section>
- <section id="CreatingaForward">
- <title>Creating a Forward</title>
- <para>Next, we are going to create a forward for the action.</para>
- <itemizedlist>
- <listitem>
- <para>On the left-hand side of the diagram in the column of icons, click on this
- icon, again:</para>
- </listitem>
- </itemizedlist>
- <figure float="0">
- <title>Create New Connection Icon</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts_application/struts_application_1.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <itemizedlist>
- <listitem>
- <para>Click on the <emphasis>
- <property moreinfo="none">/greeting</property>
- </emphasis> action icon in the diagram and then click on the <emphasis>
- <property moreinfo="none">pages/greeting.jsp</property>
- </emphasis> icon</para>
- </listitem>
- <listitem>
- <para>That's it. A link will be drawn from the actions new greeting
- forward to the greeting.jsp JSP page. Note that the forwards name will be
- set based on the name of the target JSP file name. If you don't
- like it, you can easily change it</para>
- </listitem>
- <listitem>
- <para>Select the <emphasis>
- <property moreinfo="none">Tree</property>
- </emphasis> tab at the bottom of the editor window (between Diagram and
- Source)</para>
- </listitem>
- <listitem>
- <para>Expand the <emphasis>
- <property moreinfo="none">struts-config.xml/action-mappings//greeting</property>
- </emphasis> node and then select the greeting forward</para>
- </listitem>
- <listitem>
- <para>In the Properties Editor to the right, change the text to
- "sayHello" in the Name field</para>
- </listitem>
- <listitem>
- <para>Select the <emphasis>
- <property moreinfo="none">Diagram</property>
- </emphasis> tab at the bottom of the editor window and see how the diagram
- is also updated to reflect the change</para>
- </listitem>
- </itemizedlist>
- </section>
- <section id="CreatingaGlobalForward">
- <title>Creating a Global Forward</title>
- <para>One last component that we need to create in the diagram is a global forward.</para>
- <itemizedlist>
- <listitem>
- <para>Somewhere in the top-left corner of diagram, right-click and select <emphasis>
- <property moreinfo="none"> Add > Global Forward...</property>
- </emphasis></para>
- </listitem>
- <listitem>
- <para>Enter <emphasis>
- <property moreinfo="none">getName</property>
- </emphasis> in the Name field</para>
- </listitem>
- <listitem>
- <para>Select the <emphasis>
- <property moreinfo="none">Change...</property>
- </emphasis>button for Path</para>
- </listitem>
- <listitem>
- <para>In the Edit Path window, switch to the <emphasis>
- <property moreinfo="none">Pages</property>
- </emphasis> tab</para>
- </listitem>
- <listitem>
- <para>Expand the <emphasis>
- <property moreinfo="none">StrutsHello > WEB-ROOT (WebContent) > pages</property>
- </emphasis> node and then select the inputname.jsp page</para>
- </listitem>
- <listitem>
- <para>Click <emphasis>
- <property moreinfo="none">Ok</property>
- </emphasis>.</para>
- </listitem>
- <listitem>
- <para>Leave the rest of the fields blank and click <emphasis>
- <property moreinfo="none">OK</property>
- </emphasis></para>
- </listitem>
- </itemizedlist>
- <para>A forward object now appears on the diagram and also in the global-forwards folder
- in the Outline view.</para>
- <itemizedlist>
- <listitem>
- <para>Tidy up the diagram, by clicking and dragging around each icon, so that
- the diagram looks something like this:</para>
- </listitem>
- </itemizedlist>
- <figure float="0">
- <title>Diagram View</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts_application/struts_application_2.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section id="CreatingaFormBean">
- <title>Creating a Form Bean</title>
- <para>One last thing that we need to do is to create a form bean.</para>
- <itemizedlist>
- <listitem>
- <para>Switch to the Tree viewer in the editor for the struts-config.xml file, by
- selecting the <emphasis>
- <property moreinfo="none">Tree</property>
- </emphasis> tab at the bottom of the editor window</para>
- </listitem>
- <listitem>
- <para>Right-click <emphasis>
- <property moreinfo="none">struts-config.xml > form-beans</property>
- </emphasis> and select Create Form Bean</para>
- </listitem>
- <listitem>
- <para>Enter <emphasis>
- <property moreinfo="none">GetNameForm</property>
- </emphasis> in the name field and <emphasis>
- <property moreinfo="none">sample.GetNameForm</property>
- </emphasis> for type</para>
- </listitem>
- <listitem>
- <para>Click <emphasis>
- <property moreinfo="none">Finish</property>
- </emphasis></para>
- </listitem>
- <listitem>
- <para>To save your changes to struts-config.xml, select <emphasis>
- <property moreinfo="none">File > Save</property>
- </emphasis> from the menu bar</para>
- </listitem>
- </itemizedlist>
- <para>Note the disappearance of the asterisk next to the name, struts-config.xml.</para>
- </section>
- </section>
-</chapter>
-
-<chapter id="generating_stub" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_tutorial/en/modules/generating_stub.xml" xreflabel="generating_stub">
- <?dbhtml filename="generating_stub.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Tools</keyword>
- <keyword>Struts</keyword>
- <keyword>Struts Application</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Generating Stub Coding</title>
- <para>We are done with designing the application through the diagram. Now we need to write
- code for the action component. We also need to write an action class for the <emphasis>
- <property moreinfo="none">/greeting</property>
- </emphasis> mapping along with a FormBean. To aid in the coding phase, JBoss Developer
- Studio can generate Java class stubs for all of the components shown in the diagram.</para>
- <itemizedlist>
- <listitem>
- <para>Switch back to the diagram, by selecting the <emphasis>
- <property moreinfo="none">Diagram</property>
- </emphasis> tab at the bottom of the editor window</para>
- </listitem>
- <listitem>
- <para>Right-click a blank space in the diagram and select <emphasis>
- <property moreinfo="none">Generate Java Code</property>
- </emphasis></para>
- </listitem>
- <listitem>
- <para>Leave everything as is in the dialog box and click <emphasis>
- <property moreinfo="none">Generate</property>
- </emphasis></para>
- </listitem>
- </itemizedlist>
- <para>You should see a screen that says:</para>
- <para>Generated classes: 2</para>
- <para>Actions: 1</para>
- <para>Form beans: 1</para>
- <itemizedlist>
- <listitem>
- <para>Click <emphasis>
- <property moreinfo="none">Finish</property>
- </emphasis></para>
- </listitem>
- </itemizedlist>
- <para>The Java files will be generated in a <emphasis>
- <property moreinfo="none">JavaSource > sample</property>
- </emphasis> folder that you can see in the Package Explorer view under the
- "StrutsHello" node. One Action stub and one FormBean stub will have
- been generated.</para>
- </chapter>
-
-<chapter id="coding_files" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_tutorial/en/modules/coding_files.xml" xreflabel="coding_files">
- <?dbhtml filename="coding_files.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Tools</keyword>
- <keyword>Struts</keyword>
- <keyword>Struts Application</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Coding the Various Files</title>
- <para>We will now code both the Java stub classes just generated, the JSP files left in as
- placeholders from previous steps, and a new start JSP page we will have to create.</para>
- <section id="JavaStubClasses">
- <title>Java Stub Classes</title>
- <itemizedlist>
- <listitem>
- <para>To finish the two Java classes, switch to the <emphasis>
- <property moreinfo="none">Package Explorer</property>
- </emphasis> view and expand the <emphasis>
- <property moreinfo="none">JavaSource > sample</property>
- </emphasis> folder</para>
- </listitem>
- </itemizedlist>
- <section id="GetNameForm.java">
- <title>GetNameForm.java</title>
- <itemizedlist>
- <listitem>
- <para>Double-click <emphasis>
- <property moreinfo="none">GetNameForm.java</property>
- </emphasis> for editing</para>
- </listitem>
-
- <listitem>
- <para>You are looking at a Java stub class that was generated by JBoss
- Developer Studio. Now we are going to edit the file</para>
- </listitem>
-
- <listitem>
- <para>Add the following attributes at the beginning of the class:</para>
- </listitem>
- </itemizedlist>
- <programlisting format="linespecific" role="JAVA"><![CDATA[private String name = "";
- private String greetName = "";
-]]></programlisting>
-
- <itemizedlist>
- <listitem>
- <para>Inside the reset method, delete the TO DO and throw lines and
- add:</para>
- </listitem>
- </itemizedlist>
- <programlisting format="linespecific" role="JAVA"><![CDATA[this.name = "";
- this.greetName = "";
-]]></programlisting>
-
- <itemizedlist>
- <listitem>
- <para>Inside the validate method, delete the TO DO and throw lines and
- add:</para>
- </listitem>
- </itemizedlist>
- <programlisting format="linespecific" role="JAVA"><![CDATA[ActionErrors errors = new ActionErrors();
- return errors;
-]]></programlisting>
-
- <itemizedlist>
- <listitem>
- <para>Right-click and select <emphasis>
- <property moreinfo="none">Source > Generate Getters and Setters...</property>
- </emphasis>from the context menu</para>
- </listitem>
- <listitem>
- <para>In the dialog box, check the check boxes for name and greetName,
- select First method for Insertion point, and click on the <emphasis>
- <property moreinfo="none">OK</property>
- </emphasis> button</para>
- </listitem>
- </itemizedlist>
- <para>The final GetNameForm.java file should look like this:</para>
- <programlisting format="linespecific" role="JAVA"><![CDATA[package sample;
-import javax.servlet.http.HttpServletRequest;
-import org.apache.struts.action.ActionErrors;
-import org.apache.struts.action.ActionMapping;
-
-public class GetNameForm extends org.apache.struts.action.ActionForm
-{
-
- private String name = "";
- private String greetName = "";
-
- public String getName()
- {
- return name;
- }
- public void setName(String name)
- {
- this.name = name;
- }
-
- public String getGreetName()
- {
- return greetName;
- }
-
- public void setGreetName(String greetName)
- {
- this.greetName = greetName;
- }
-
- public GetNameForm()
- {
- }
-
- public void reset(ActionMapping actionMapping, HttpServletRequest request)
- {
- this.name = "";
- this.greetName = "";
- }
-
- public ActionErrors validate(ActionMapping actionMapping,
- HttpServletRequest request)
- {
- ActionErrors errors = new ActionErrors();
- return errors;
- }
-}
-]]></programlisting>
-
- <itemizedlist>
- <listitem>
- <para>Save the file</para>
- </listitem>
- </itemizedlist>
- </section>
- <section id="GreetingAction.java">
- <title>GreetingAction.java</title>
- <itemizedlist>
- <listitem>
- <para>Open GreetingAction.java for editing</para>
- </listitem>
- <listitem>
- <para>Inside the execute method, delete the TO DO lines and add the
- following:</para>
- </listitem>
- </itemizedlist>
-
- <programlisting format="linespecific" role="JAVA"><![CDATA[String name = ((GetNameForm)form).getName();
-String greeting = "Hello, "+name+"!";
-((GetNameForm)form).setName(greeting);
-return mapping.findForward(FORWARD_sayHello);
-]]></programlisting>
-
- <para>The final version of GreetingAction.java should look like this:</para>
-
- <programlisting format="linespecific" role="JAVA"><![CDATA[package sample;
-import javax.servlet.http.HttpServletRequest;
-import javax.servlet.http.HttpServletResponse;
-import org.apache.struts.action.ActionForm;
-import org.apache.struts.action.ActionForward;
-import org.apache.struts.action.ActionMapping;
-
-public class GreetingAction extends org.apache.struts.action.Action
-{
-
- // Global Forwards
- public static final String GLOBAL_FORWARD_getName = "getName";
-
- // Local Forwards
- public static final String FORWARD_sayHello = "sayHello";
-
- public GreetingAction()
- {
- }
- public ActionForward execute(ActionMapping mapping, ActionForm form,
- HttpServletRequest request, HttpServletResponse response) throws Exception
- {
- String name = ((GetNameForm)form).getName();
- String greeting = "Hello, "+name+"!";
- ((GetNameForm)form).setName(greeting);
- return mapping.findForward(FORWARD_sayHello);
- }
-}
-]]></programlisting>
- <itemizedlist>
- <listitem>
- <para>Save the file</para>
- </listitem>
- <listitem>
- <para>Close the editors for the two Java files</para>
- </listitem>
- </itemizedlist>
- <para>The last thing left to do is to code the JSP files whose editors should still
- be open from having been created as placeholders.</para>
- </section>
- </section>
- <section id="JSPPages">
- <title>JSP Pages</title>
- <section id="inputname.jsp">
- <title>inputname.jsp</title>
- <para>In this page, the user will enter any name and click the <emphasis>
- <property moreinfo="none">submit</property>
- </emphasis> button. Then, the greeting action will be called through the form.</para>
- <itemizedlist>
- <listitem>
- <para>Click on the <emphasis>
- <property moreinfo="none">inputname.jsp</property>
- </emphasis> tab in the Editing area to bring its editor forward</para>
- </listitem>
- <listitem>
- <para>In the Web Projects view, expand <emphasis>
- <property moreinfo="none">StrutsHello > Configuration > default
- > struts-config.xml > action-mappings</property>
- </emphasis> and select <emphasis>
- <property moreinfo="none">/greeting</property>
- </emphasis></para>
- </listitem>
- <listitem>
- <para>Drag it and drop it between the quotes for the <emphasis role="italic">
- <property moreinfo="none">"action"</property>
- </emphasis> attribute to the <emphasis role="bold">
- <property moreinfo="none"><html:form></property>
- </emphasis> element in the Source pane of the editor</para>
- </listitem>
- <listitem>
- <para>Then type this text on a new line just below this line:</para>
- <programlisting format="linespecific" role="XML"><![CDATA[Input name:
- ]]></programlisting>
- </listitem>
-
- <listitem>
- <para>Select the <emphasis>
- <property moreinfo="none">Visual</property>
- </emphasis> pane of the editor</para>
- </listitem>
- <listitem>
- <para>Then, in the JBoss Tools Palette, expand the <emphasis>
- <property moreinfo="none">Struts Form</property>
- </emphasis> library, select <emphasis>
- <property moreinfo="none">text</property>
- </emphasis>, and drag it onto the box
- <note>
- <title>Note:</title>
- <para>By default there are only four groups on the JBoss Tools
- Palette. If you wish to make some group visible click the <emphasis>
- <property moreinfo="none">Show/Hide</property>
- </emphasis> button on the top of palette and in the prompted
- dialog check the group (or groups) you want to be shown.</para>
- </note>
- </para>
- </listitem>
- </itemizedlist>
- <figure float="0">
- <title>JBoss Tools Palette</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts_application/struts_application_3.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <itemizedlist>
- <listitem>
- <para>In the Insert Tag dialog box, type in name for property and select <emphasis>
- <property moreinfo="none">Finish</property>
- </emphasis></para>
- </listitem>
- <listitem>
- <para>In the StrutsForm library in the JBoss Tools Palette, select <emphasis>
- <property moreinfo="none">submit</property>
- </emphasis>, and drag it to right after the text box in the Visual pane
- of the editor</para>
- </listitem>
- <listitem>
- <para>Right-click the <emphasis>
- <property moreinfo="none">submit</property>
- </emphasis> button and select <emphasis role="bold">
- <property moreinfo="none"><html:submit></property>
- </emphasis> Attributes from the context menu</para>
- </listitem>
- <listitem>
- <para>In the Attributes dialog box, select the <emphasis>
- <property moreinfo="none">value</property>
- </emphasis> field and type in "Say Hello!" for its
- value</para>
- </listitem>
- </itemizedlist>
- <para>After tidying the page source, the Editor window for the file should look
- something like this:</para>
- <figure float="0">
- <title>Editor Window</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts_application/struts_application_4.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section id="greeting.jsp">
- <title>greeting.jsp</title>
- <para>Next, we will fill in the result page.</para>
- <itemizedlist>
- <listitem>
- <para>Click on the <emphasis>
- <property moreinfo="none">greeting.jsp</property>
- </emphasis> tab in the Editing area to bring its editor forward</para>
- </listitem>
- <listitem>
- <para>Type in the following code:</para>
- </listitem>
- </itemizedlist>
- <programlisting format="linespecific" role="XML"><![CDATA[<html>
-<head>
- <title>Greeting</title>
-</head>
- <body>
- <p>
- </p>
- </body>
-</html>
-]]></programlisting>
-
- <para>To complete editing of this file, we will use macros from the JBoss Tools
- Palette. This palette is a view that should be available to the right of the
- editing area.</para>
- <itemizedlist>
- <listitem>
- <para>Click on the <emphasis>
- <property moreinfo="none">Struts Common</property>
- </emphasis> folder in the JBoss Tools Palette to open it</para>
- </listitem>
- <listitem>
- <para>Position the cursor at the beginning of the greeting.jsp file in the
- Source pane and then click on bean taglib in the JBoss Tools
- Palette</para>
- </listitem>
- </itemizedlist>
- <para>This will insert the following line at the top of the file:</para>
- <programlisting format="linespecific" role="JAVA"><![CDATA[
-<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %>
-]]></programlisting>
- <itemizedlist>
- <listitem>
- <para>Click on the <emphasis>
- <property moreinfo="none">Struts Bean</property>
- </emphasis> folder in the JBoss Tools Palette to open it</para>
- </listitem>
- <listitem>
- <para>Position the cursor inside the <emphasis role="bold">
- <property moreinfo="none"><p></property>
- </emphasis> element</para>
- </listitem>
- <listitem>
- <para>Click on write in the JBoss Tools Palette</para>
- </listitem>
- <listitem>
- <para>Type in "GetNameForm" for the <emphasis role="italic">
- <property moreinfo="none">"name"</property>
- </emphasis> attribute and add a <emphasis role="italic">
- <property moreinfo="none">"property"</property>
- </emphasis> attribute with "greetName" as its
- value</para>
- </listitem>
- </itemizedlist>
- <para>The editor should now look like this:</para>
- <figure float="0">
- <title>Editor Window</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts_application/struts_application_5.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section id="index.jsp">
- <title>index.jsp</title>
- <para>Finally, we will need to create and edit an index.jsp page. This page will use
- a Struts forward to simply redirect us to the getName global forward.</para>
- <itemizedlist>
- <listitem>
- <para>In the Web Projects view, right-click on <emphasis>
- <property moreinfo="none">StrutsHello > WEB-ROOT(WebContent)</property>
- </emphasis> node and select <emphasis>
- <property moreinfo="none">New > File > JSP..</property>
- </emphasis></para>
- </listitem>
- <listitem>
- <para>Type index for Name and click on the <emphasis>
- <property moreinfo="none">Finish</property>
- </emphasis> button</para>
- </listitem>
- <listitem>
- <para>On the JBoss Tools Palette, select the <emphasis>
- <property moreinfo="none">Struts Common</property>
- </emphasis> folder of macros by clicking on it in the palette</para>
- </listitem>
- <listitem>
- <para>Click on the logic taglib icon</para>
- </listitem>
- <listitem>
- <para>Press the <emphasis>
- <property moreinfo="none">Enter</property>
- </emphasis> key in the editor to go to the next line</para>
- </listitem>
- <listitem>
- <para>Back on the palette, select the <emphasis>
- <property moreinfo="none">Struts Logic</property>
- </emphasis> folder of macros</para>
- </listitem>
- <listitem>
- <para>Click on redirect</para>
- </listitem>
- <listitem>
- <para>Delete the ending tag, put a forward slash in front of the closing
- angle bracket, and type "forward=getName" in front of
- the slash</para>
- </listitem>
- </itemizedlist>
- <para>The finished code for the page is shown below:</para>
- <programlisting format="linespecific" role="JAVA"><![CDATA[<%@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic" %>
-<logic:redirect forward="getName"/>
-]]></programlisting>
- <itemizedlist>
- <listitem>
- <para>To save all the edits to files, select <emphasis>
- <property moreinfo="none">File>Save All</property>
- </emphasis> from the menu bar</para>
- </listitem>
- </itemizedlist>
- </section>
- </section>
- </chapter>
-
-<chapter id="compiling_and_running" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_tutorial/en/modules/compiling_and_running.xml" xreflabel="compiling_and_running">
- <?dbhtml filename="compiling_and_running.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Tools</keyword>
- <keyword>Struts</keyword>
- <keyword>Struts Application</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Compiling the Classes and Running the Application</title>
-
- <para>As this is the Eclipse environment, no explicit compilation step is required. By
- default, Eclipse compiles as you go.</para>
-
- <para>Thus at this point everything is ready for running our application without having to leave JBoss
- Developer Studio by using the JBoss Application Server engine that comes with the JBoss
- Developer Studio. For controlling JBoss AS within JBoss Developer Studio, there is JBoss
- Server view.</para>
- <figure float="0">
- <title>JBoss Server Panel</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts_application/struts_application_6.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <itemizedlist>
- <listitem>
- <para>Start up JBoss AS by clicking on the icon in JBoss Server view. (If JBoss AS
- is already running, stop it by clicking on the red icon and then start it again.
- Remember, the Struts run-time requires restarting the servlet engine when any
- changes have been made.)</para>
- </listitem>
- <listitem>
- <para>After the messages in the Console tabbed view stop scrolling, JBoss AS is
- available. At this point, right-click on the getName global forward in the
- struts-config.xml diagram view and select Run on Server.</para>
- </listitem>
- </itemizedlist>
- <para>The browser should appear with the application started.</para>
- </chapter>
-
-<chapter id="struts_validation" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_tutorial/en/modules/struts_validation.xml" xreflabel="struts_validation">
- <?dbhtml filename="struts_validation.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Developer Studio</keyword>
- <keyword>Struts</keyword>
- <keyword>Struts Validation</keyword>
- </keywordset>
- </chapterinfo>
-<title>Struts Validation Examples</title>
-
-<para><property moreinfo="none">Validation</property> of input is an important part of any Web application. All Apache Jakarta frameworks,
-including Struts, can use a common Jakarta Validation Framework for streamlining this aspect of Web
-application development. The Validation Framework allows you to define validation rules and then apply these rules on the client-side or the server-side.</para>
-
- <para>JBoss Developer Studio makes using the <property moreinfo="none">Validation Framework</property> in Struts even easier with the help of a specialized editor for the XML files that controls validation in a project. In this document, we'll show you how this all works by creating some simple client-side validation and server-side validation examples.</para>
-
-<section id="StartingPoint">
-<?dbhtml filename="StartingPoint.html"?>
-<title>Starting Point</title>
-<para>The example assumes that you have already created our sample "StrutsHello" application from the
-Getting Started Guide for Creating a Struts Application. You should have the JBoss Developer Studio perspective
- open on this StrutsHello project.</para>
-</section>
-
-<section id="DefiningTheValidationRule">
-<?dbhtml filename="DefiningTheValidationRule.html"?>
-<title>Defining the Validation Rule</title>
-<para>In these steps you will set up the validation that can be used for either client-side or
-server side validation. You need to enable validation as a part of the project, define an error message, and tie it into an appropriate part of the application.</para>
-
-<itemizedlist>
-<listitem><para>Right-click on a "plug-ins" node under the <emphasis><property moreinfo="none">StrutsHello > Configuration > default > struts-config.xml</property></emphasis> node in the Web Projects view and select <emphasis><property moreinfo="none">Create Special Plugin > Validators</property></emphasis> from the context menu</para></listitem>
-<listitem><para>Further down in the Web Projects view, right-click on the
-<emphasis><property moreinfo="none">StrutsHello > ResourceBundles</property></emphasis> node and select <emphasis><property moreinfo="none"> New > Properties File...</property></emphasis>from the context menu</para></listitem>
-<listitem><para>In the dialog box, click on the <emphasis><property moreinfo="none">Browse...</property></emphasis>button next to the Folder field, expand the
- JavaSource folder in this next dialog box, select the sample subfolder, and click on the <emphasis><property moreinfo="none">OK</property></emphasis> button</para></listitem>
- <listitem><para>Back in the first dialog box, type in "applResources" for the Name field and click on the <emphasis><property moreinfo="none">Finish</property></emphasis> button</para></listitem>
-<listitem><para>Right-click on a newly created file and select <emphasis><property moreinfo="none">Add > Default Error Messages</property></emphasis>
- from the context menu</para></listitem>
-
-<listitem><para>Drag up the sample.applResources icon until you can drop it on the resources folder under struts-config.xml</para></listitem>
-<listitem><para>Select<emphasis><property moreinfo="none"> File > Save </property></emphasis>All from the menu bar</para></listitem>
-<listitem><para>Select validation.xml under the <emphasis><property moreinfo="none">StrutsHello > Validation</property></emphasis> node and double-click it to open it with the JBoss Tools XML Editor</para></listitem>
-<listitem><para>Here you must create a Formset.</para></listitem>
-<listitem><para>In the validation.xml file editor click the button <emphasis><property moreinfo="none">Create Formset</property></emphasis> on the panel <emphasis><property moreinfo="none">Formsets</property></emphasis></para></listitem>
-<listitem><para>In the dialog <emphasis><property moreinfo="none">Add Formset</property></emphasis> fill the fields <emphasis><property moreinfo="none">Language</property></emphasis> and <emphasis><property moreinfo="none">Country</property></emphasis> or just leave them empty to create a default formset. Click <emphasis><property moreinfo="none">OK</property></emphasis></para></listitem>
-</itemizedlist>
-<figure float="0">
- <title>Create Formset</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts_validation/struts_validation.png"></imagedata>
- </imageobject>
-</mediaobject>
-</figure>
-<itemizedlist>
-<listitem><para>Expand the "form-beans" node under the <emphasis><property moreinfo="none">StrutsHello > Configuration > default > struts-config.xml node.</property></emphasis> Then, drag the form bean "GetNameForm" and drop it onto a formset in the <property moreinfo="none">XML</property> Editor</para></listitem>
-<listitem><para>In the Validation Editor, expand the formset node, right-click GetNameForm, and select <emphasis><property moreinfo="none">Create Field...</property></emphasis> from the context menu</para></listitem>
-<listitem><para>Enter a name for Property in the dialog box. A new property will be created:</para></listitem>
-</itemizedlist>
-<figure float="0">
- <title>New Property Is Added</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts_validation/struts_validation_2.png"></imagedata>
- </imageobject>
-</mediaobject>
-</figure>
-<itemizedlist>
-<listitem><para>In the Properties view for the name field to the right of the "tree" for the validation.xml file, click on the <emphasis><property moreinfo="none">Change...</property></emphasis>button next to the Depends entry field</para></listitem>
-<listitem><para>In the displayed double list, select <emphasis><property moreinfo="none">required</property></emphasis> from the left list and then click <emphasis><property moreinfo="none">Add</property></emphasis></para></listitem>
- <listitem><para>Click <emphasis><property moreinfo="none">Ok</property></emphasis></para></listitem>
-<listitem><para>Right-click name and select <emphasis><property moreinfo="none">Add Arg...</property></emphasis> from the context menu</para></listitem>
-<listitem><para>In the Add Arg dialog box, click on the <emphasis><property moreinfo="none">Change...</property></emphasis>button next to the <emphasis><property moreinfo="none">Key</property></emphasis> field</para></listitem>
- <listitem><para>In the Key dialog box that appears now, click on the <emphasis><property moreinfo="none">Add</property></emphasis> button</para></listitem>
- <listitem><para>Enter "name.required" in the Name field, and enter a person's name in the Value field</para></listitem>
- <listitem><para>Click <emphasis><property moreinfo="none">Finish</property></emphasis>, then <emphasis><property moreinfo="none">Ok</property></emphasis>, and then <emphasis><property moreinfo="none">Ok</property></emphasis> again</para></listitem>
-<listitem><para>Select <emphasis><property moreinfo="none">File > Save All</property></emphasis> from the menu bar</para></listitem>
-</itemizedlist>
-</section>
-
-<section id="Client-SideValidation">
-<?dbhtml filename="Client-SideValidation.html"?>
-<title>Client-Side Validation</title>
-<para>Client-side <property moreinfo="none">validation</property> uses a scripting language (like JavaScript) running in the client browser to actually do the <property moreinfo="none">validation</property>. In a Struts application using the <property moreinfo="none">Validation</property> Framework, however, you don't actually have to do any of the script coding. The <property moreinfo="none">Validation</property> Framework handles this.</para>
-<para>To see how this works in our application, you'll just need to make a couple of modifications to one of the JSP files.</para>
-<itemizedlist>
-<listitem><para>Double-click inputname.jsp under <emphasis><property moreinfo="none">StrutsHello > WEB-ROOT(WebContent) > pages</property></emphasis> to open it for editing</para></listitem>
-<listitem><para>Find the tag near the top and hit Return to make a new line under it</para></listitem>
- <listitem><para>In the JBoss Tools Palette view to the right, open the Struts HTML folder and click on the javascript tag</para></listitem>
-<listitem><para>Back in the editor, just in front of the closing slash for this inserted tag, hit Ctrl+Space and select "formName" from the prompting menu</para></listitem>
-<listitem><para>Over in the Web Projects view, select GetNameForm under the <emphasis><property moreinfo="none">StrutsHello > Configuration > default > struts-config.xml > form-beans</property></emphasis> node, drag it, and drop it between the quotes in the editor</para></listitem>
-<listitem><para>Modify the <emphasis role="bold"><property moreinfo="none"><html:form></property></emphasis> tag by inserting this attribute:</para></listitem>
-</itemizedlist>
-<programlisting format="linespecific" role="XML"><![CDATA[onsubmit="return validateGetNameForm(this)"
-]]></programlisting>
-<para></para>
-<para>The file should now look like this:</para>
-<programlisting format="linespecific" role="XML"><![CDATA[
-<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>
-<html:html>
-<head>
- <title>Input name</title>
- <html:javascript formName="GetNameForm"/>
-</head>
-<body>
- <html:form action="/greeting.do" onsubmit="return
- <para>validateGetNameForm(this)"></para>
- <table border="0" cellspacing="0" cellpadding="0">
- <tr>
- <td><b>Input name:</b></td>
- </tr>
- <tr>
- <td>
- <html:text property="name" />
- <html:submit value=" Say Hello! " />
- </td>
- </tr>
- </table>
- </html:form>
-</body>
-</html:html>
-]]></programlisting>
-<itemizedlist>
-<listitem><para>Select<emphasis><property moreinfo="none"> File > Save </property></emphasis>from the menu bar</para></listitem>
-<listitem><para>Start JBoss Application Server by clicking on its icon (a right-pointing arrow) in the toolbar</para></listitem>
-<listitem><para>Click the Run icon or right click your project folder and select <emphasis><property moreinfo="none">Run As > Run on Server</property></emphasis></para></listitem>
-</itemizedlist>
-<figure float="0">
- <title>Run Icon</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts_validation/struts_validation_1.png"></imagedata>
- </imageobject>
-</mediaobject>
-</figure>
-<itemizedlist><listitem><para>In the browser window, click on the "Say Hello!" button without having entered any name in the form</para></listitem></itemizedlist>
-<para>A JavaScript error message should be displayed in an alert box.</para>
-</section>
-<section id="Server-SideValidation">
-<?dbhtml filename="Server-SideValidation.html"?>
-<title>Server Side Validation</title>
-<para>Server side validation does the validation inside the application on the server. In a Struts application using the Validation Framework, you still don't have to do any of the actual validation coding. The Validation Framework handles this. You will though have to make a few changes to the JSP file you modified for client-side validation along with a change to an action and a few changes to the form bean class.</para>
-</section>
-
-<section id="EditingTheJSPFile">
-<?dbhtml filename="EditingTheJSPFile.html"?>
-<title>Editing the JSP File</title>
-<itemizedlist>
-<listitem><para>Reopen inputname.jsp for editing</para></listitem>
-<listitem><para>Delete the <emphasis role="italic"><property moreinfo="none">"onsubmit"</property></emphasis> attribute in the <emphasis role="bold"><property moreinfo="none"><html:form></property></emphasis> element that you put in for client-side validation</para></listitem>
-
-<listitem><para>Add an <emphasis role="bold"><property moreinfo="none"><html:errors></property></emphasis> tag after the <emphasis role="bold"><property moreinfo="none"><html:form></property></emphasis> tag</para></listitem>
-</itemizedlist>
-<para>The JSP file should now look like this:</para>
-
-<programlisting format="linespecific" role="XML"><![CDATA[<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>
-<html:html>
-<head>
- <title>Input name</title>
- <html:javascript formName="GetNameForm"/>
-</head>
-<body>
- <html:form action="/greeting.do">
- <table border="0" cellspacing="0" cellpadding="0">
- <tr>
- <td><b>Input name:</b></td>
- </tr>
- <tr>
- <td>
- <html:text property="name" />
- <html:submit value=" Say Hello! " />
- </td>
- </tr>
- </table>
- </html:form>
- <html:errors />
-</body>
-</html:html>
-]]></programlisting>
-
-</section>
-
-<section id="EditingTheAction">
-<?dbhtml filename="EditingTheAction.html"?>
-<title>Editing the Action</title>
-<itemizedlist>
-<listitem><para>In the Web Projects view, expand the node under the <emphasis><property moreinfo="none">StrutsHello > Configuration > default > struts-config.xml > action-mappings</property></emphasis> node, right-click the <emphasis><property moreinfo="none">/greeting</property></emphasis> action, and then select <emphasis><property moreinfo="none">Properties...</property></emphasis>from the context menu</para></listitem>
-
- <listitem><para>In the Edit Properties window, insert the cursor into the value column for the input property and click on the <property moreinfo="none">...</property> button</para></listitem>
-
- <listitem><para>In the dialog box, make sure the Pages tab is selected, select <emphasis><property moreinfo="none">StrutsHello > WEB-ROOT(WebContent) > pages > inputname.jsp</property></emphasis>, click the <emphasis><property moreinfo="none">Ok</property></emphasis> button, and then click on the <emphasis><property moreinfo="none">Close</property></emphasis> button</para></listitem>
-</itemizedlist>
-</section>
-<section id="EditingTheFormBean">
-<?dbhtml filename="EditingTheFormBean.html"?>
-
-<title>Editing the Form Bean</title>
-<itemizedlist>
-<listitem><para>Right-click the <emphasis><property moreinfo="none">/greeting</property></emphasis> action again and select Open Form-bean Source to open the GetNameForm.java file for editing</para></listitem>
-<listitem><para>Change the class that it extends from: <emphasis><property moreinfo="none">org.apache.struts.action.ActionForm</property></emphasis> to <emphasis><property moreinfo="none">org.apache.struts.validator.ValidatorForm</property></emphasis></para></listitem>
-<listitem><para>Comment out a validate method</para></listitem>
-</itemizedlist>
-<para>The file should now look like this:</para>
-<programlisting format="linespecific" role="JAVA"><![CDATA[package sample;
-import javax.servlet.http.HttpServletRequest;
-import org.apache.struts.action.ActionErrors;
-import org.apache.struts.action.ActionMapping;
-public class GetNameForm extends
-
-org.apache.struts.validator.ValidatorForm
-{
-
- private String name = "";
-
- /**
- * @return Returns the name.
- */
- public String getName()
- {
- return name;
- }
-
- /**
- * @param name The name to set.
- */
- public void setName(String name)
- {
- this.name = name;
- }
-
- public GetNameForm ()
- {
- }
-
- public void reset(ActionMapping actionMapping,
- HttpServletRequest request)
- {
- this.name = "";
- }
-
- // public ActionErrors validate(ActionMapping actionMapping,
- HttpServletRequest request)
- {
- // ActionErrors errors = new ActionErrors();
- // return errors;
- // }
- }
-]]></programlisting>
-
-<itemizedlist>
-<listitem><para>Select <emphasis><property moreinfo="none">File > Save All </property></emphasis>from the menu bar</para></listitem>
-<listitem><para>Reload the application into JBoss AS by clicking on the "Change Time Stamp" icon (a finger pointing with a little star) in the toolbar</para></listitem>
-<listitem><para>Run the application</para></listitem>
-<listitem><para>In the browser window, click on the "Say Hello!" button without having entered any name in the form</para></listitem>
-</itemizedlist>
-<para>The error message should appear in a refreshed version of the form.</para>
-</section>
-
-</chapter>
-
-<chapter id="relevant_resources" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_tutorial/en/modules/relevant_resources.xml" xreflabel="relevant_resources">
- <?dbhtml filename="relevant_resources.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Tools</keyword>
- <keyword>Struts</keyword>
- <keyword>Struts Application</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Other Relevant Resources on the topic</title>
-
- <para>Our reference: <ulink url="../../struts_tools_ref_guide/html_single/index.html">Struts Tools Reference Guide</ulink></para>
- <para>Apache Struts: <ulink url="http://struts.apache.org/">Struts Technology</ulink></para>
- <para>Struts 2: <ulink url="http://struts.apache.org/2.x/">Apache Struts 2</ulink></para>
- <para>Get Started: <ulink url="http://struts.apache.org/2.x/docs/home.html">Struts Getting
- Started</ulink></para>
- <para>Struts on IBM: <ulink url="http://www.ibm.com/developerworks/library/j-struts/">Struts -
- An open-source MVC implementation</ulink></para>
- <para>FAQ: <ulink url="http://struts.apache.org/2.x/docs/faqs.html">Struts FAQ</ulink></para>
- <para>Download: <ulink url="http://struts.apache.org/download.cgi#struts206">Release of Apache
- Struts</ulink></para>
-
- <para>Thus, this tutorial should help you to execute the hole development circle for building a
- sample Struts-based Web application using <property moreinfo="none">JBoss Tools</property> bundle of Eclipse
- plugins starting from organizing a new Struts project and ending with the running and
- deploying it onto the <property moreinfo="none">JBoss Server</property>.</para>
-
- <para>To find out all the features of <property moreinfo="none">JBoss Tools</property> for working with Struts
- refer to our <ulink url="../../struts_tools_ref_guide/html_single/index.html">Struts Tools Reference Guide</ulink>. If you
- still have questions you are always welcome on <ulink url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201">JBoss
- Tools Forum</ulink>.</para>
-</chapter>
-
-
-
-</book>
Copied: branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/master_output.xml (from rev 15128, trunk/struts/docs/struts_tools_tutorial/en/master_output.xml)
===================================================================
--- branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/master_output.xml (rev 0)
+++ branches/jbosstools-3.0.x/struts/docs/struts_tools_tutorial/en/master_output.xml 2009-05-11 16:43:48 UTC (rev 15213)
@@ -0,0 +1,1340 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+"http://www.docbook.org/xml/4.3/docbookx.dtd"
+
+[<!ENTITY introduction SYSTEM "modules/introduction.xml">
+<!ENTITY struts_application SYSTEM "modules/struts_application.xml">
+<!ENTITY generating_stub SYSTEM "modules/generating_stub.xml">
+<!ENTITY coding_files SYSTEM "modules/coding_files.xml">
+<!ENTITY compiling_and_running SYSTEM "modules/compiling_and_running.xml">
+<!ENTITY struts_validation SYSTEM "modules/struts_validation.xml">
+<!ENTITY relevant_resources SYSTEM "modules/relevant_resources.xml">
+
+<!ENTITY seamlink "../../seam/html_single/index.html">
+<!ENTITY aslink "../../as/html_single/index.html">
+<!ENTITY esblink "../../esb_ref_guide/html_single/index.html">
+<!ENTITY gsglink "../../GettingStartedGuide/html_single/index.html">
+<!ENTITY hibernatelink "../../hibernatetools/html_single/index.html">
+<!ENTITY jbpmlink "../../jbpm/html_single/index.html">
+<!ENTITY jsflink "../../jsf/html_single/index.html">
+<!ENTITY jsfreflink "../../jsf_tools_ref_guide/html_single/index.html">
+<!ENTITY jsftutoriallink "../../jsf_tools_tutorial/html_single/index.html">
+<!ENTITY strutsreflink "../../struts_tools_ref_guide/html_single/index.html">
+<!ENTITY strutstutoriallink "../../struts_tools_tutorial/html_single/index.html">
+
+]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff">
+
+ <bookinfo>
+ <title>Struts Tools Tutorial</title>
+
+ <author><firstname>Anatoly</firstname><surname>Fedosik</surname></author>
+ <author><firstname>Olga</firstname><surname>Chikvina</surname></author>
+ <author><firstname>Svetlana</firstname><surname>Mukhina</surname><email>smukhina(a)exadel.com</email></author>
+
+ <pubdate>April 2008</pubdate>
+ <copyright>
+ <year>2007</year>
+ <year><diffmk:wrapper diffmk:change="changed">2009</diffmk:wrapper></year>
+ <holder><diffmk:wrapper diffmk:change="changed">JBoss, a division of Red Hat</diffmk:wrapper></holder>
+ </copyright>
+ <releaseinfo><diffmk:wrapper diffmk:change="changed">
+ Version: 3.0.0.GA
+ </diffmk:wrapper></releaseinfo>
+
+<abstract>
+ <title></title>
+ <para>
+ <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/struts_tools_tutoria...">PDF version</ulink>
+ </para>
+</abstract>
+
+
+ </bookinfo>
+
+ <toc></toc>
+
+
+<chapter id="introduction" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_tutorial/en/modules/introduction.xml" xreflabel="introduction">
+ <?dbhtml filename="introduction.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Eclipse</keyword>
+ <keyword>Java</keyword>
+ <keyword>JBoss</keyword>
+ </keywordset>
+ </chapterinfo>
+ <title>Introduction</title>
+ <para>The following chapters describe how to deal with classic/old style of Struts development. We
+ recommend users to use <ulink url="../../seam/html_single/index.html">JBoss Seam</ulink> to
+ simplify development, but until then you can read about classical Struts usage here.</para>
+
+ <para>We are going to show you how to create a simple <emphasis>
+ <property moreinfo="none">Struts application</property>
+ </emphasis> using the JBoss Tools. The completed application will ask a user to enter
+ a name and click a button. The resulting new page will display the familiar message,
+ "Hello <name>!"</para>
+ <para>This document will show you how to create such an application from the beginning, along the
+ way demonstrating some of the powerful features of JBoss Tools. With the help of our tutorial you will design the
+ application, generate stub code for the application, fill in the stub coding, compile the
+ application, and finally run it all from inside the Eclipse.</para>
+
+ <section>
+ <title>Other relevant resources on the topic</title>
+
+ <para>All JBoss Developer Studio/JBoss Tools documentation you can find <ulink url="http://docs.jboss.org/tools/">here</ulink>.</para>
+ <para>The latest documentation builds are available <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">here</ulink>.</para>
+
+ </section>
+
+</chapter>
+
+
+<chapter id="struts_application" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_tutorial/en/modules/struts_application.xml" xreflabel="struts_application">
+ <?dbhtml filename="struts_application.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Struts</keyword>
+ <keyword>Struts Application</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Creating a Simple Struts Application</title>
+
+ <para>Firstly, we assume that you have already launched Eclipse with JBoss Tools installed and
+ also that the <property moreinfo="none">Web Development perspective</property> is the current perspective. (If not, make it
+ active by selecting <emphasis>
+ <property moreinfo="none">Window > Open Perspective > Other > Web
+ Development</property>
+ </emphasis> from the menu bar.)</para>
+
+ <section id="StartingUp">
+ <title>Starting Up</title>
+ <para>We are first going to create a new project for the application.</para>
+ <itemizedlist>
+ <listitem>
+ <para>Go to the menu bar and select <emphasis>
+ <property moreinfo="none">File > New > Project...</property>
+ </emphasis>.</para>
+ </listitem>
+ <listitem>
+ <para>Select <emphasis>
+ <property moreinfo="none">JBoss Tools Web > Struts > Struts Project</property>
+ </emphasis> in the New Project dialog box</para>
+ </listitem>
+ <listitem>
+ <para>Click <emphasis>
+ <property moreinfo="none">Next </property>
+ </emphasis></para>
+ </listitem>
+ <listitem>
+ <para>Enter "StrutsHello" as the project name</para>
+ </listitem>
+ <listitem>
+ <para>Leave everything else as is, and click <emphasis>
+ <property moreinfo="none">Next</property>
+ </emphasis></para>
+ </listitem>
+ <listitem>
+ <para>Click <emphasis>
+ <property moreinfo="none">Next</property>
+ </emphasis> again</para>
+ </listitem>
+ <listitem>
+ <para>Make sure that <emphasis>
+ <property moreinfo="none">struts-bean.tld</property>
+ </emphasis>, <emphasis>
+ <property moreinfo="none">struts-html.tld</property>
+ </emphasis>, and <emphasis>
+ <property moreinfo="none">struts-logic.tld</property>
+ </emphasis> are checked in the list of included tag libraries and then click <emphasis>
+ <property moreinfo="none">Finish</property>
+ </emphasis></para>
+ </listitem>
+ </itemizedlist>
+ <para>A "StrutsHello" node should appear in the upper-left Package
+ Explorer view.</para>
+ <itemizedlist>
+ <listitem>
+ <para>Click the plus sign next to <emphasis>
+ <property moreinfo="none">StrutsHello</property>
+ </emphasis> to reveal the child nodes</para>
+ </listitem>
+ <listitem>
+ <para>Click the plus sign next to <emphasis>
+ <property moreinfo="none">WebContent</property>
+ </emphasis> under StrutsHello</para>
+ </listitem>
+ <listitem>
+ <para>Click the plus sign next to <emphasis>
+ <property moreinfo="none">WEB-INF</property>
+ </emphasis> under WebContent</para>
+ </listitem>
+ <listitem>
+ <para>Then, double-click on the <emphasis>
+ <property moreinfo="none">struts-config.xml</property>
+ </emphasis> node to display a diagram of the Struts application configuration
+ file in the editing area</para>
+ </listitem>
+ </itemizedlist>
+ <para>At this point, its empty except for the background grid lines.</para>
+ </section>
+
+ <section id="CreatingtheApplicationComponents">
+ <?dbhtml filename="CreatingtheApplicationComponents.html"?>
+ <title>Creating the Application Components</title>
+ <para>Now, we will design the application by creating the individual components as
+ placeholders first. (We dont have to complete all of the details inside the components
+ until afterwards.)</para>
+ <section id="CreatingJSPPagePlaceholders">
+ <title>Creating JSP Page Placeholders</title>
+ <para>Next, let's create and place two JSP pages. We will not write any code
+ for the files, but only create them as placeholders so that we can create links to
+ them in the diagram. We will write the code a little bit later.</para>
+ <section id="CreatingthePagePlaceholders">
+ <title>Creating the Page Placeholders</title>
+ <itemizedlist>
+ <listitem>
+ <para>Bring the Web Projects view to the front of the Package Explorer view
+ by selecting the <emphasis>
+ <property moreinfo="none">Web Projects</property>
+ </emphasis> tab next to that tab.</para>
+ </listitem>
+ <listitem>
+ <para>Right-click the <emphasis>
+ <property moreinfo="none">StrutsHello > WEB-ROOT (WebContent)</property>
+ </emphasis> folder in the Web Projects view and select <emphasis>
+ <property moreinfo="none">New > Folder...</property>
+ </emphasis></para>
+ </listitem>
+ <listitem>
+ <para>Enter <emphasis>
+ <property moreinfo="none">pages</property>
+ </emphasis> for a folder name and click <emphasis>
+ <property moreinfo="none">Finish</property>
+ </emphasis></para>
+ </listitem>
+
+ <listitem>
+ <para>We will keep our presentation files in this folder</para>
+ </listitem>
+
+ <listitem>
+ <para>Right-click the pages folder and select <emphasis>
+ <property moreinfo="none">New > Fila > JSP...</property>
+ </emphasis>
+ </para>
+ </listitem>
+ <listitem>
+ <para>For Name type in <emphasis>
+ <property moreinfo="none">inputname</property>
+ </emphasis> (the JSP extension will be automatically added to the file),
+ for Template select <emphasis>
+ <property moreinfo="none">StrutsForm</property>
+ </emphasis> and then click on the <emphasis>
+ <property moreinfo="none">Finish</property>
+ </emphasis> button</para>
+ </listitem>
+ <listitem>
+ <para>Right-click the pages folder again and select <emphasis>
+ <property moreinfo="none">New > File > JSP...</property>
+ </emphasis></para>
+ </listitem>
+ <listitem>
+ <para>For Name type in <emphasis>
+ <property moreinfo="none">greeting</property>
+ </emphasis>, for Template leave as Blank, and then click on the <emphasis>
+ <property moreinfo="none">Finish</property>
+ </emphasis> button</para>
+ </listitem>
+ </itemizedlist>
+ <para>Just leave these files as is for now.</para>
+ </section>
+ <section id="PlacingthePagePlaceholders">
+ <title>Placing the Page Placeholders</title>
+ <para>Lets now place the two pages just created on the diagram.</para>
+ <itemizedlist>
+ <listitem>
+ <para>Click on the <emphasis>
+ <property moreinfo="none">struts-config.xml</property>
+ </emphasis> tab in the Editing area to bring the diagram to the
+ front</para>
+ </listitem>
+ <listitem>
+ <para>Click on the <emphasis>
+ <property moreinfo="none">inputname.jsp</property>
+ </emphasis> page in the Web Projects view, drag it onto the diagram, and
+ drop it</para>
+ </listitem>
+ <listitem><para>Click on the <emphasis>
+ <property moreinfo="none">greeting.jsp</property>
+ </emphasis> page in the Web Projects view, drag it onto the diagram, and
+ drop it to the right of the <emphasis>
+ <property moreinfo="none">/pages/inputname.jsp</property>
+ </emphasis> icon with some extra space</para></listitem>
+ </itemizedlist>
+ <para>You should now have two JSP pages in the diagram.</para>
+ </section>
+ </section>
+ <section id="CreatinganActionMappings">
+ <title>Creating an Action Mappings</title>
+ <para>Using a context menu on the diagram, we are next going to create an Action
+ mapping.</para>
+ <itemizedlist>
+ <listitem>
+ <para>Right-click between the two icons and select <emphasis>
+ <property moreinfo="none">Add > Action</property>
+ </emphasis></para>
+ </listitem>
+ <listitem>
+ <para>Enter the following values:</para>
+ </listitem>
+ </itemizedlist>
+ <table>
+ <title>Action values</title>
+ <tgroup cols="2">
+ <tbody>
+ <row>
+ <entry>path</entry>
+ <entry>/greeting</entry>
+ </row>
+ <row>
+ <entry>name</entry>
+ <entry>GetNameForm</entry>
+ </row>
+ <row>
+ <entry>scope</entry>
+ <entry>request</entry>
+ </row>
+ <row>
+ <entry>type</entry>
+ <entry>sample.GreetingAction</entry>
+ </row>
+ <row>
+ <entry>validate</entry>
+ <entry><leave blank></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <para>("GetNameForm" is the name for a form bean that we will create
+ later.)</para>
+ <itemizedlist>
+ <listitem>
+ <para>Click <emphasis>
+ <property moreinfo="none">Finish</property>
+ </emphasis></para>
+ </listitem>
+ </itemizedlist>
+
+ <para>The <emphasis>
+ <property moreinfo="none">/greeting</property>
+ </emphasis> action should appear in four places, in the diagram, under the
+ action-mappings node, under the struts-config.xml node in Tree view, in Web Projects
+ view and in the Outline view. Also, note the asterisk to the right of the name,
+ struts-config.xml, in the Outline view showing that the file has been changed, but
+ not saved to disk.</para>
+ </section>
+ <section id="CreatingaLink">
+ <title>Creating a Link</title>
+ <para>Let's now create a link from the inputname.jsp page to the action.</para>
+ <itemizedlist>
+ <listitem>
+ <para>On the left-hand side of the diagram in the column of icons, click on this
+ icon:</para>
+ </listitem>
+ </itemizedlist>
+ <figure float="0">
+ <title>Create New Connection Icon</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts_application/struts_application_1.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>In the connect-the-components mode you are in now, click on the <emphasis>
+ <property moreinfo="none">/pages/inputname.jsp</property>
+ </emphasis> icon in the diagram and then click on the <emphasis>
+ <property moreinfo="none">/greeting</property>
+ </emphasis> action</para>
+ </listitem>
+ </itemizedlist>
+ <para>A link will be created from the page to the action.</para>
+ </section>
+ <section id="CreatingaForward">
+ <title>Creating a Forward</title>
+ <para>Next, we are going to create a forward for the action.</para>
+ <itemizedlist>
+ <listitem>
+ <para>On the left-hand side of the diagram in the column of icons, click on this
+ icon, again:</para>
+ </listitem>
+ </itemizedlist>
+ <figure float="0">
+ <title>Create New Connection Icon</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts_application/struts_application_1.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>Click on the <emphasis>
+ <property moreinfo="none">/greeting</property>
+ </emphasis> action icon in the diagram and then click on the <emphasis>
+ <property moreinfo="none">pages/greeting.jsp</property>
+ </emphasis> icon</para>
+ </listitem>
+ <listitem>
+ <para>That's it. A link will be drawn from the actions new greeting
+ forward to the greeting.jsp JSP page. Note that the forwards name will be
+ set based on the name of the target JSP file name. If you don't
+ like it, you can easily change it</para>
+ </listitem>
+ <listitem>
+ <para>Select the <emphasis>
+ <property moreinfo="none">Tree</property>
+ </emphasis> tab at the bottom of the editor window (between Diagram and
+ Source)</para>
+ </listitem>
+ <listitem>
+ <para>Expand the <emphasis>
+ <property moreinfo="none">struts-config.xml/action-mappings//greeting</property>
+ </emphasis> node and then select the greeting forward</para>
+ </listitem>
+ <listitem>
+ <para>In the Properties Editor to the right, change the text to
+ "sayHello" in the Name field</para>
+ </listitem>
+ <listitem>
+ <para>Select the <emphasis>
+ <property moreinfo="none">Diagram</property>
+ </emphasis> tab at the bottom of the editor window and see how the diagram
+ is also updated to reflect the change</para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section id="CreatingaGlobalForward">
+ <title>Creating a Global Forward</title>
+ <para>One last component that we need to create in the diagram is a global forward.</para>
+ <itemizedlist>
+ <listitem>
+ <para>Somewhere in the top-left corner of diagram, right-click and select <emphasis>
+ <property moreinfo="none"> Add > Global Forward...</property>
+ </emphasis></para>
+ </listitem>
+ <listitem>
+ <para>Enter <emphasis>
+ <property moreinfo="none">getName</property>
+ </emphasis> in the Name field</para>
+ </listitem>
+ <listitem>
+ <para>Select the <emphasis>
+ <property moreinfo="none">Change...</property>
+ </emphasis>button for Path</para>
+ </listitem>
+ <listitem>
+ <para>In the Edit Path window, switch to the <emphasis>
+ <property moreinfo="none">Pages</property>
+ </emphasis> tab</para>
+ </listitem>
+ <listitem>
+ <para>Expand the <emphasis>
+ <property moreinfo="none">StrutsHello > WEB-ROOT (WebContent) > pages</property>
+ </emphasis> node and then select the inputname.jsp page</para>
+ </listitem>
+ <listitem>
+ <para>Click <emphasis>
+ <property moreinfo="none">Ok</property>
+ </emphasis>.</para>
+ </listitem>
+ <listitem>
+ <para>Leave the rest of the fields blank and click <emphasis>
+ <property moreinfo="none">OK</property>
+ </emphasis></para>
+ </listitem>
+ </itemizedlist>
+ <para>A forward object now appears on the diagram and also in the global-forwards folder
+ in the Outline view.</para>
+ <itemizedlist>
+ <listitem>
+ <para>Tidy up the diagram, by clicking and dragging around each icon, so that
+ the diagram looks something like this:</para>
+ </listitem>
+ </itemizedlist>
+ <figure float="0">
+ <title>Diagram View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts_application/struts_application_2.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="CreatingaFormBean">
+ <title>Creating a Form Bean</title>
+ <para>One last thing that we need to do is to create a form bean.</para>
+ <itemizedlist>
+ <listitem>
+ <para>Switch to the Tree viewer in the editor for the struts-config.xml file, by
+ selecting the <emphasis>
+ <property moreinfo="none">Tree</property>
+ </emphasis> tab at the bottom of the editor window</para>
+ </listitem>
+ <listitem>
+ <para>Right-click <emphasis>
+ <property moreinfo="none">struts-config.xml > form-beans</property>
+ </emphasis> and select Create Form Bean</para>
+ </listitem>
+ <listitem>
+ <para>Enter <emphasis>
+ <property moreinfo="none">GetNameForm</property>
+ </emphasis> in the name field and <emphasis>
+ <property moreinfo="none">sample.GetNameForm</property>
+ </emphasis> for type</para>
+ </listitem>
+ <listitem>
+ <para>Click <emphasis>
+ <property moreinfo="none">Finish</property>
+ </emphasis></para>
+ </listitem>
+ <listitem>
+ <para>To save your changes to struts-config.xml, select <emphasis>
+ <property moreinfo="none">File > Save</property>
+ </emphasis> from the menu bar</para>
+ </listitem>
+ </itemizedlist>
+ <para>Note the disappearance of the asterisk next to the name, struts-config.xml.</para>
+ </section>
+ </section>
+</chapter>
+
+<chapter id="generating_stub" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_tutorial/en/modules/generating_stub.xml" xreflabel="generating_stub">
+ <?dbhtml filename="generating_stub.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Struts</keyword>
+ <keyword>Struts Application</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Generating Stub Coding</title>
+ <para>We are done with designing the application through the diagram. Now we need to write
+ code for the action component. We also need to write an action class for the <emphasis>
+ <property moreinfo="none">/greeting</property>
+ </emphasis> mapping along with a FormBean. To aid in the coding phase, JBoss Developer
+ Studio can generate Java class stubs for all of the components shown in the diagram.</para>
+ <itemizedlist>
+ <listitem>
+ <para>Switch back to the diagram, by selecting the <emphasis>
+ <property moreinfo="none">Diagram</property>
+ </emphasis> tab at the bottom of the editor window</para>
+ </listitem>
+ <listitem>
+ <para>Right-click a blank space in the diagram and select <emphasis>
+ <property moreinfo="none">Generate Java Code</property>
+ </emphasis></para>
+ </listitem>
+ <listitem>
+ <para>Leave everything as is in the dialog box and click <emphasis>
+ <property moreinfo="none">Generate</property>
+ </emphasis></para>
+ </listitem>
+ </itemizedlist>
+ <para>You should see a screen that says:</para>
+ <para>Generated classes: 2</para>
+ <para>Actions: 1</para>
+ <para>Form beans: 1</para>
+ <itemizedlist>
+ <listitem>
+ <para>Click <emphasis>
+ <property moreinfo="none">Finish</property>
+ </emphasis></para>
+ </listitem>
+ </itemizedlist>
+ <para>The Java files will be generated in a <emphasis>
+ <property moreinfo="none">JavaSource > sample</property>
+ </emphasis> folder that you can see in the Package Explorer view under the
+ "StrutsHello" node. One Action stub and one FormBean stub will have
+ been generated.</para>
+ </chapter>
+
+<chapter id="coding_files" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_tutorial/en/modules/coding_files.xml" xreflabel="coding_files">
+ <?dbhtml filename="coding_files.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Struts</keyword>
+ <keyword>Struts Application</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Coding the Various Files</title>
+ <para>We will now code both the Java stub classes just generated, the JSP files left in as
+ placeholders from previous steps, and a new start JSP page we will have to create.</para>
+ <section id="JavaStubClasses">
+ <title>Java Stub Classes</title>
+ <itemizedlist>
+ <listitem>
+ <para>To finish the two Java classes, switch to the <emphasis>
+ <property moreinfo="none">Package Explorer</property>
+ </emphasis> view and expand the <emphasis>
+ <property moreinfo="none">JavaSource > sample</property>
+ </emphasis> folder</para>
+ </listitem>
+ </itemizedlist>
+ <section id="GetNameForm.java">
+ <title>GetNameForm.java</title>
+ <itemizedlist>
+ <listitem>
+ <para>Double-click <emphasis>
+ <property moreinfo="none">GetNameForm.java</property>
+ </emphasis> for editing</para>
+ </listitem>
+
+ <listitem>
+ <para>You are looking at a Java stub class that was generated by JBoss
+ Developer Studio. Now we are going to edit the file</para>
+ </listitem>
+
+ <listitem>
+ <para>Add the following attributes at the beginning of the class:</para>
+ </listitem>
+ </itemizedlist>
+ <programlisting format="linespecific" role="JAVA"><![CDATA[private String name = "";
+ private String greetName = "";
+]]></programlisting>
+
+ <itemizedlist>
+ <listitem>
+ <para>Inside the reset method, delete the TO DO and throw lines and
+ add:</para>
+ </listitem>
+ </itemizedlist>
+ <programlisting format="linespecific" role="JAVA"><![CDATA[this.name = "";
+ this.greetName = "";
+]]></programlisting>
+
+ <itemizedlist>
+ <listitem>
+ <para>Inside the validate method, delete the TO DO and throw lines and
+ add:</para>
+ </listitem>
+ </itemizedlist>
+ <programlisting format="linespecific" role="JAVA"><![CDATA[ActionErrors errors = new ActionErrors();
+ return errors;
+]]></programlisting>
+
+ <itemizedlist>
+ <listitem>
+ <para>Right-click and select <emphasis>
+ <property moreinfo="none">Source > Generate Getters and Setters...</property>
+ </emphasis>from the context menu</para>
+ </listitem>
+ <listitem>
+ <para>In the dialog box, check the check boxes for name and greetName,
+ select First method for Insertion point, and click on the <emphasis>
+ <property moreinfo="none">OK</property>
+ </emphasis> button</para>
+ </listitem>
+ </itemizedlist>
+ <para>The final GetNameForm.java file should look like this:</para>
+ <programlisting format="linespecific" role="JAVA"><![CDATA[package sample;
+import javax.servlet.http.HttpServletRequest;
+import org.apache.struts.action.ActionErrors;
+import org.apache.struts.action.ActionMapping;
+
+public class GetNameForm extends org.apache.struts.action.ActionForm
+{
+
+ private String name = "";
+ private String greetName = "";
+
+ public String getName()
+ {
+ return name;
+ }
+ public void setName(String name)
+ {
+ this.name = name;
+ }
+
+ public String getGreetName()
+ {
+ return greetName;
+ }
+
+ public void setGreetName(String greetName)
+ {
+ this.greetName = greetName;
+ }
+
+ public GetNameForm()
+ {
+ }
+
+ public void reset(ActionMapping actionMapping, HttpServletRequest request)
+ {
+ this.name = "";
+ this.greetName = "";
+ }
+
+ public ActionErrors validate(ActionMapping actionMapping,
+ HttpServletRequest request)
+ {
+ ActionErrors errors = new ActionErrors();
+ return errors;
+ }
+}
+]]></programlisting>
+
+ <itemizedlist>
+ <listitem>
+ <para>Save the file</para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section id="GreetingAction.java">
+ <title>GreetingAction.java</title>
+ <itemizedlist>
+ <listitem>
+ <para>Open GreetingAction.java for editing</para>
+ </listitem>
+ <listitem>
+ <para>Inside the execute method, delete the TO DO lines and add the
+ following:</para>
+ </listitem>
+ </itemizedlist>
+
+ <programlisting format="linespecific" role="JAVA"><![CDATA[String name = ((GetNameForm)form).getName();
+String greeting = "Hello, "+name+"!";
+((GetNameForm)form).setName(greeting);
+return mapping.findForward(FORWARD_sayHello);
+]]></programlisting>
+
+ <para>The final version of GreetingAction.java should look like this:</para>
+
+ <programlisting format="linespecific" role="JAVA"><![CDATA[package sample;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import org.apache.struts.action.ActionForm;
+import org.apache.struts.action.ActionForward;
+import org.apache.struts.action.ActionMapping;
+
+public class GreetingAction extends org.apache.struts.action.Action
+{
+
+ // Global Forwards
+ public static final String GLOBAL_FORWARD_getName = "getName";
+
+ // Local Forwards
+ public static final String FORWARD_sayHello = "sayHello";
+
+ public GreetingAction()
+ {
+ }
+ public ActionForward execute(ActionMapping mapping, ActionForm form,
+ HttpServletRequest request, HttpServletResponse response) throws Exception
+ {
+ String name = ((GetNameForm)form).getName();
+ String greeting = "Hello, "+name+"!";
+ ((GetNameForm)form).setName(greeting);
+ return mapping.findForward(FORWARD_sayHello);
+ }
+}
+]]></programlisting>
+ <itemizedlist>
+ <listitem>
+ <para>Save the file</para>
+ </listitem>
+ <listitem>
+ <para>Close the editors for the two Java files</para>
+ </listitem>
+ </itemizedlist>
+ <para>The last thing left to do is to code the JSP files whose editors should still
+ be open from having been created as placeholders.</para>
+ </section>
+ </section>
+ <section id="JSPPages">
+ <title>JSP Pages</title>
+ <section id="inputname.jsp">
+ <title>inputname.jsp</title>
+ <para>In this page, the user will enter any name and click the <emphasis>
+ <property moreinfo="none">submit</property>
+ </emphasis> button. Then, the greeting action will be called through the form.</para>
+ <itemizedlist>
+ <listitem>
+ <para>Click on the <emphasis>
+ <property moreinfo="none">inputname.jsp</property>
+ </emphasis> tab in the Editing area to bring its editor forward</para>
+ </listitem>
+ <listitem>
+ <para>In the Web Projects view, expand <emphasis>
+ <property moreinfo="none">StrutsHello > Configuration > default
+ > struts-config.xml > action-mappings</property>
+ </emphasis> and select <emphasis>
+ <property moreinfo="none">/greeting</property>
+ </emphasis></para>
+ </listitem>
+ <listitem>
+ <para>Drag it and drop it between the quotes for the <emphasis role="italic">
+ <property moreinfo="none">"action"</property>
+ </emphasis> attribute to the <emphasis role="bold">
+ <property moreinfo="none"><html:form></property>
+ </emphasis> element in the Source pane of the editor</para>
+ </listitem>
+ <listitem>
+ <para>Then type this text on a new line just below this line:</para>
+ <programlisting format="linespecific" role="XML"><![CDATA[Input name:
+ ]]></programlisting>
+ </listitem>
+
+ <listitem>
+ <para>Select the <emphasis>
+ <property moreinfo="none">Visual</property>
+ </emphasis> pane of the editor</para>
+ </listitem>
+ <listitem>
+ <para>Then, in the JBoss Tools Palette, expand the <emphasis>
+ <property moreinfo="none">Struts Form</property>
+ </emphasis> library, select <emphasis>
+ <property moreinfo="none">text</property>
+ </emphasis>, and drag it onto the box
+ <note>
+ <title>Note:</title>
+ <para>By default there are only four groups on the JBoss Tools
+ Palette. If you wish to make some group visible click the <emphasis>
+ <property moreinfo="none">Show/Hide</property>
+ </emphasis> button on the top of palette and in the prompted
+ dialog check the group (or groups) you want to be shown.</para>
+ </note>
+ </para>
+ </listitem>
+ </itemizedlist>
+ <figure float="0">
+ <title>JBoss Tools Palette</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts_application/struts_application_3.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>In the Insert Tag dialog box, type in name for property and select <emphasis>
+ <property moreinfo="none">Finish</property>
+ </emphasis></para>
+ </listitem>
+ <listitem>
+ <para>In the StrutsForm library in the JBoss Tools Palette, select <emphasis>
+ <property moreinfo="none">submit</property>
+ </emphasis>, and drag it to right after the text box in the Visual pane
+ of the editor</para>
+ </listitem>
+ <listitem>
+ <para>Right-click the <emphasis>
+ <property moreinfo="none">submit</property>
+ </emphasis> button and select <emphasis role="bold">
+ <property moreinfo="none"><html:submit></property>
+ </emphasis> Attributes from the context menu</para>
+ </listitem>
+ <listitem>
+ <para>In the Attributes dialog box, select the <emphasis>
+ <property moreinfo="none">value</property>
+ </emphasis> field and type in "Say Hello!" for its
+ value</para>
+ </listitem>
+ </itemizedlist>
+ <para>After tidying the page source, the Editor window for the file should look
+ something like this:</para>
+ <figure float="0">
+ <title>Editor Window</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts_application/struts_application_4.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="greeting.jsp">
+ <title>greeting.jsp</title>
+ <para>Next, we will fill in the result page.</para>
+ <itemizedlist>
+ <listitem>
+ <para>Click on the <emphasis>
+ <property moreinfo="none">greeting.jsp</property>
+ </emphasis> tab in the Editing area to bring its editor forward</para>
+ </listitem>
+ <listitem>
+ <para>Type in the following code:</para>
+ </listitem>
+ </itemizedlist>
+ <programlisting format="linespecific" role="XML"><![CDATA[<html>
+<head>
+ <title>Greeting</title>
+</head>
+ <body>
+ <p>
+ </p>
+ </body>
+</html>
+]]></programlisting>
+
+ <para>To complete editing of this file, we will use macros from the JBoss Tools
+ Palette. This palette is a view that should be available to the right of the
+ editing area.</para>
+ <itemizedlist>
+ <listitem>
+ <para>Click on the <emphasis>
+ <property moreinfo="none">Struts Common</property>
+ </emphasis> folder in the JBoss Tools Palette to open it</para>
+ </listitem>
+ <listitem>
+ <para>Position the cursor at the beginning of the greeting.jsp file in the
+ Source pane and then click on bean taglib in the JBoss Tools
+ Palette</para>
+ </listitem>
+ </itemizedlist>
+ <para>This will insert the following line at the top of the file:</para>
+ <programlisting format="linespecific" role="JAVA"><![CDATA[
+<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %>
+]]></programlisting>
+ <itemizedlist>
+ <listitem>
+ <para>Click on the <emphasis>
+ <property moreinfo="none">Struts Bean</property>
+ </emphasis> folder in the JBoss Tools Palette to open it</para>
+ </listitem>
+ <listitem>
+ <para>Position the cursor inside the <emphasis role="bold">
+ <property moreinfo="none"><p></property>
+ </emphasis> element</para>
+ </listitem>
+ <listitem>
+ <para>Click on write in the JBoss Tools Palette</para>
+ </listitem>
+ <listitem>
+ <para>Type in "GetNameForm" for the <emphasis role="italic">
+ <property moreinfo="none">"name"</property>
+ </emphasis> attribute and add a <emphasis role="italic">
+ <property moreinfo="none">"property"</property>
+ </emphasis> attribute with "greetName" as its
+ value</para>
+ </listitem>
+ </itemizedlist>
+ <para>The editor should now look like this:</para>
+ <figure float="0">
+ <title>Editor Window</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts_application/struts_application_5.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="index.jsp">
+ <title>index.jsp</title>
+ <para>Finally, we will need to create and edit an index.jsp page. This page will use
+ a Struts forward to simply redirect us to the getName global forward.</para>
+ <itemizedlist>
+ <listitem>
+ <para>In the Web Projects view, right-click on <emphasis>
+ <property moreinfo="none">StrutsHello > WEB-ROOT(WebContent)</property>
+ </emphasis> node and select <emphasis>
+ <property moreinfo="none">New > File > JSP..</property>
+ </emphasis></para>
+ </listitem>
+ <listitem>
+ <para>Type index for Name and click on the <emphasis>
+ <property moreinfo="none">Finish</property>
+ </emphasis> button</para>
+ </listitem>
+ <listitem>
+ <para>On the JBoss Tools Palette, select the <emphasis>
+ <property moreinfo="none">Struts Common</property>
+ </emphasis> folder of macros by clicking on it in the palette</para>
+ </listitem>
+ <listitem>
+ <para>Click on the logic taglib icon</para>
+ </listitem>
+ <listitem>
+ <para>Press the <emphasis>
+ <property moreinfo="none">Enter</property>
+ </emphasis> key in the editor to go to the next line</para>
+ </listitem>
+ <listitem>
+ <para>Back on the palette, select the <emphasis>
+ <property moreinfo="none">Struts Logic</property>
+ </emphasis> folder of macros</para>
+ </listitem>
+ <listitem>
+ <para>Click on redirect</para>
+ </listitem>
+ <listitem>
+ <para>Delete the ending tag, put a forward slash in front of the closing
+ angle bracket, and type "forward=getName" in front of
+ the slash</para>
+ </listitem>
+ </itemizedlist>
+ <para>The finished code for the page is shown below:</para>
+ <programlisting format="linespecific" role="JAVA"><![CDATA[<%@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic" %>
+<logic:redirect forward="getName"/>
+]]></programlisting>
+ <itemizedlist>
+ <listitem>
+ <para>To save all the edits to files, select <emphasis>
+ <property moreinfo="none">File>Save All</property>
+ </emphasis> from the menu bar</para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ </section>
+ </chapter>
+
+<chapter id="compiling_and_running" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_tutorial/en/modules/compiling_and_running.xml" xreflabel="compiling_and_running">
+ <?dbhtml filename="compiling_and_running.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Struts</keyword>
+ <keyword>Struts Application</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Compiling the Classes and Running the Application</title>
+
+ <para>As this is the Eclipse environment, no explicit compilation step is required. By
+ default, Eclipse compiles as you go.</para>
+
+ <para>Thus at this point everything is ready for running our application without having to leave JBoss
+ Developer Studio by using the JBoss Application Server engine that comes with the JBoss
+ Developer Studio. For controlling JBoss AS within JBoss Developer Studio, there is JBoss
+ Server view.</para>
+ <figure float="0">
+ <title>JBoss Server Panel</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts_application/struts_application_6.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>Start up JBoss AS by clicking on the icon in JBoss Server view. (If JBoss AS
+ is already running, stop it by clicking on the red icon and then start it again.
+ Remember, the Struts run-time requires restarting the servlet engine when any
+ changes have been made.)</para>
+ </listitem>
+ <listitem>
+ <para>After the messages in the Console tabbed view stop scrolling, JBoss AS is
+ available. At this point, right-click on the getName global forward in the
+ struts-config.xml diagram view and select Run on Server.</para>
+ </listitem>
+ </itemizedlist>
+ <para>The browser should appear with the application started.</para>
+ </chapter>
+
+<chapter id="struts_validation" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_tutorial/en/modules/struts_validation.xml" xreflabel="struts_validation">
+ <?dbhtml filename="struts_validation.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>Struts</keyword>
+ <keyword>Struts Validation</keyword>
+ </keywordset>
+ </chapterinfo>
+<title>Struts Validation Examples</title>
+
+<para><property moreinfo="none">Validation</property> of input is an important part of any Web application. All Apache Jakarta frameworks,
+including Struts, can use a common Jakarta Validation Framework for streamlining this aspect of Web
+application development. The Validation Framework allows you to define validation rules and then apply these rules on the client-side or the server-side.</para>
+
+ <para>JBoss Developer Studio makes using the <property moreinfo="none">Validation Framework</property> in Struts even easier with the help of a specialized editor for the XML files that controls validation in a project. In this document, we'll show you how this all works by creating some simple client-side validation and server-side validation examples.</para>
+
+<section id="StartingPoint">
+<?dbhtml filename="StartingPoint.html"?>
+<title>Starting Point</title>
+<para>The example assumes that you have already created our sample "StrutsHello" application from the
+Getting Started Guide for Creating a Struts Application. You should have the JBoss Developer Studio perspective
+ open on this StrutsHello project.</para>
+</section>
+
+<section id="DefiningTheValidationRule">
+<?dbhtml filename="DefiningTheValidationRule.html"?>
+<title>Defining the Validation Rule</title>
+<para>In these steps you will set up the validation that can be used for either client-side or
+server side validation. You need to enable validation as a part of the project, define an error message, and tie it into an appropriate part of the application.</para>
+
+<itemizedlist>
+<listitem><para>Right-click on a "plug-ins" node under the <emphasis><property moreinfo="none">StrutsHello > Configuration > default > struts-config.xml</property></emphasis> node in the Web Projects view and select <emphasis><property moreinfo="none">Create Special Plugin > Validators</property></emphasis> from the context menu</para></listitem>
+<listitem><para>Further down in the Web Projects view, right-click on the
+<emphasis><property moreinfo="none">StrutsHello > ResourceBundles</property></emphasis> node and select <emphasis><property moreinfo="none"> New > Properties File...</property></emphasis>from the context menu</para></listitem>
+<listitem><para>In the dialog box, click on the <emphasis><property moreinfo="none">Browse...</property></emphasis>button next to the Folder field, expand the
+ JavaSource folder in this next dialog box, select the sample subfolder, and click on the <emphasis><property moreinfo="none">OK</property></emphasis> button</para></listitem>
+ <listitem><para>Back in the first dialog box, type in "applResources" for the Name field and click on the <emphasis><property moreinfo="none">Finish</property></emphasis> button</para></listitem>
+<listitem><para>Right-click on a newly created file and select <emphasis><property moreinfo="none">Add > Default Error Messages</property></emphasis>
+ from the context menu</para></listitem>
+
+<listitem><para>Drag up the sample.applResources icon until you can drop it on the resources folder under struts-config.xml</para></listitem>
+<listitem><para>Select<emphasis><property moreinfo="none"> File > Save </property></emphasis>All from the menu bar</para></listitem>
+<listitem><para>Select validation.xml under the <emphasis><property moreinfo="none">StrutsHello > Validation</property></emphasis> node and double-click it to open it with the JBoss Tools XML Editor</para></listitem>
+<listitem><para>Here you must create a Formset.</para></listitem>
+<listitem><para>In the validation.xml file editor click the button <emphasis><property moreinfo="none">Create Formset</property></emphasis> on the panel <emphasis><property moreinfo="none">Formsets</property></emphasis></para></listitem>
+<listitem><para>In the dialog <emphasis><property moreinfo="none">Add Formset</property></emphasis> fill the fields <emphasis><property moreinfo="none">Language</property></emphasis> and <emphasis><property moreinfo="none">Country</property></emphasis> or just leave them empty to create a default formset. Click <emphasis><property moreinfo="none">OK</property></emphasis></para></listitem>
+</itemizedlist>
+<figure float="0">
+ <title>Create Formset</title>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts_validation/struts_validation.png"></imagedata>
+ </imageobject>
+</mediaobject>
+</figure>
+<itemizedlist>
+<listitem><para>Expand the "form-beans" node under the <emphasis><property moreinfo="none">StrutsHello > Configuration > default > struts-config.xml node.</property></emphasis> Then, drag the form bean "GetNameForm" and drop it onto a formset in the <property moreinfo="none">XML</property> Editor</para></listitem>
+<listitem><para>In the Validation Editor, expand the formset node, right-click GetNameForm, and select <emphasis><property moreinfo="none">Create Field...</property></emphasis> from the context menu</para></listitem>
+<listitem><para>Enter a name for Property in the dialog box. A new property will be created:</para></listitem>
+</itemizedlist>
+<figure float="0">
+ <title>New Property Is Added</title>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts_validation/struts_validation_2.png"></imagedata>
+ </imageobject>
+</mediaobject>
+</figure>
+<itemizedlist>
+<listitem><para>In the Properties view for the name field to the right of the "tree" for the validation.xml file, click on the <emphasis><property moreinfo="none">Change...</property></emphasis>button next to the Depends entry field</para></listitem>
+<listitem><para>In the displayed double list, select <emphasis><property moreinfo="none">required</property></emphasis> from the left list and then click <emphasis><property moreinfo="none">Add</property></emphasis></para></listitem>
+ <listitem><para>Click <emphasis><property moreinfo="none">Ok</property></emphasis></para></listitem>
+<listitem><para>Right-click name and select <emphasis><property moreinfo="none">Add Arg...</property></emphasis> from the context menu</para></listitem>
+<listitem><para>In the Add Arg dialog box, click on the <emphasis><property moreinfo="none">Change...</property></emphasis>button next to the <emphasis><property moreinfo="none">Key</property></emphasis> field</para></listitem>
+ <listitem><para>In the Key dialog box that appears now, click on the <emphasis><property moreinfo="none">Add</property></emphasis> button</para></listitem>
+ <listitem><para>Enter "name.required" in the Name field, and enter a person's name in the Value field</para></listitem>
+ <listitem><para>Click <emphasis><property moreinfo="none">Finish</property></emphasis>, then <emphasis><property moreinfo="none">Ok</property></emphasis>, and then <emphasis><property moreinfo="none">Ok</property></emphasis> again</para></listitem>
+<listitem><para>Select <emphasis><property moreinfo="none">File > Save All</property></emphasis> from the menu bar</para></listitem>
+</itemizedlist>
+</section>
+
+<section id="Client-SideValidation">
+<?dbhtml filename="Client-SideValidation.html"?>
+<title>Client-Side Validation</title>
+<para>Client-side <property moreinfo="none">validation</property> uses a scripting language (like JavaScript) running in the client browser to actually do the <property moreinfo="none">validation</property>. In a Struts application using the <property moreinfo="none">Validation</property> Framework, however, you don't actually have to do any of the script coding. The <property moreinfo="none">Validation</property> Framework handles this.</para>
+<para>To see how this works in our application, you'll just need to make a couple of modifications to one of the JSP files.</para>
+<itemizedlist>
+<listitem><para>Double-click inputname.jsp under <emphasis><property moreinfo="none">StrutsHello > WEB-ROOT(WebContent) > pages</property></emphasis> to open it for editing</para></listitem>
+<listitem><para>Find the tag near the top and hit Return to make a new line under it</para></listitem>
+ <listitem><para>In the JBoss Tools Palette view to the right, open the Struts HTML folder and click on the javascript tag</para></listitem>
+<listitem><para>Back in the editor, just in front of the closing slash for this inserted tag, hit Ctrl+Space and select "formName" from the prompting menu</para></listitem>
+<listitem><para>Over in the Web Projects view, select GetNameForm under the <emphasis><property moreinfo="none">StrutsHello > Configuration > default > struts-config.xml > form-beans</property></emphasis> node, drag it, and drop it between the quotes in the editor</para></listitem>
+<listitem><para>Modify the <emphasis role="bold"><property moreinfo="none"><html:form></property></emphasis> tag by inserting this attribute:</para></listitem>
+</itemizedlist>
+<programlisting format="linespecific" role="XML"><![CDATA[onsubmit="return validateGetNameForm(this)"
+]]></programlisting>
+<para></para>
+<para>The file should now look like this:</para>
+<programlisting format="linespecific" role="XML"><![CDATA[
+<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>
+<html:html>
+<head>
+ <title>Input name</title>
+ <html:javascript formName="GetNameForm"/>
+</head>
+<body>
+ <html:form action="/greeting.do" onsubmit="return
+ <para>validateGetNameForm(this)"></para>
+ <table border="0" cellspacing="0" cellpadding="0">
+ <tr>
+ <td><b>Input name:</b></td>
+ </tr>
+ <tr>
+ <td>
+ <html:text property="name" />
+ <html:submit value=" Say Hello! " />
+ </td>
+ </tr>
+ </table>
+ </html:form>
+</body>
+</html:html>
+]]></programlisting>
+<itemizedlist>
+<listitem><para>Select<emphasis><property moreinfo="none"> File > Save </property></emphasis>from the menu bar</para></listitem>
+<listitem><para>Start JBoss Application Server by clicking on its icon (a right-pointing arrow) in the toolbar</para></listitem>
+<listitem><para>Click the Run icon or right click your project folder and select <emphasis><property moreinfo="none">Run As > Run on Server</property></emphasis></para></listitem>
+</itemizedlist>
+<figure float="0">
+ <title>Run Icon</title>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts_validation/struts_validation_1.png"></imagedata>
+ </imageobject>
+</mediaobject>
+</figure>
+<itemizedlist><listitem><para>In the browser window, click on the "Say Hello!" button without having entered any name in the form</para></listitem></itemizedlist>
+<para>A JavaScript error message should be displayed in an alert box.</para>
+</section>
+<section id="Server-SideValidation">
+<?dbhtml filename="Server-SideValidation.html"?>
+<title>Server Side Validation</title>
+<para>Server side validation does the validation inside the application on the server. In a Struts application using the Validation Framework, you still don't have to do any of the actual validation coding. The Validation Framework handles this. You will though have to make a few changes to the JSP file you modified for client-side validation along with a change to an action and a few changes to the form bean class.</para>
+</section>
+
+<section id="EditingTheJSPFile">
+<?dbhtml filename="EditingTheJSPFile.html"?>
+<title>Editing the JSP File</title>
+<itemizedlist>
+<listitem><para>Reopen inputname.jsp for editing</para></listitem>
+<listitem><para>Delete the <emphasis role="italic"><property moreinfo="none">"onsubmit"</property></emphasis> attribute in the <emphasis role="bold"><property moreinfo="none"><html:form></property></emphasis> element that you put in for client-side validation</para></listitem>
+
+<listitem><para>Add an <emphasis role="bold"><property moreinfo="none"><html:errors></property></emphasis> tag after the <emphasis role="bold"><property moreinfo="none"><html:form></property></emphasis> tag</para></listitem>
+</itemizedlist>
+<para>The JSP file should now look like this:</para>
+
+<programlisting format="linespecific" role="XML"><![CDATA[<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>
+<html:html>
+<head>
+ <title>Input name</title>
+ <html:javascript formName="GetNameForm"/>
+</head>
+<body>
+ <html:form action="/greeting.do">
+ <table border="0" cellspacing="0" cellpadding="0">
+ <tr>
+ <td><b>Input name:</b></td>
+ </tr>
+ <tr>
+ <td>
+ <html:text property="name" />
+ <html:submit value=" Say Hello! " />
+ </td>
+ </tr>
+ </table>
+ </html:form>
+ <html:errors />
+</body>
+</html:html>
+]]></programlisting>
+
+</section>
+
+<section id="EditingTheAction">
+<?dbhtml filename="EditingTheAction.html"?>
+<title>Editing the Action</title>
+<itemizedlist>
+<listitem><para>In the Web Projects view, expand the node under the <emphasis><property moreinfo="none">StrutsHello > Configuration > default > struts-config.xml > action-mappings</property></emphasis> node, right-click the <emphasis><property moreinfo="none">/greeting</property></emphasis> action, and then select <emphasis><property moreinfo="none">Properties...</property></emphasis>from the context menu</para></listitem>
+
+ <listitem><para>In the Edit Properties window, insert the cursor into the value column for the input property and click on the <property moreinfo="none">...</property> button</para></listitem>
+
+ <listitem><para>In the dialog box, make sure the Pages tab is selected, select <emphasis><property moreinfo="none">StrutsHello > WEB-ROOT(WebContent) > pages > inputname.jsp</property></emphasis>, click the <emphasis><property moreinfo="none">Ok</property></emphasis> button, and then click on the <emphasis><property moreinfo="none">Close</property></emphasis> button</para></listitem>
+</itemizedlist>
+</section>
+<section id="EditingTheFormBean">
+<?dbhtml filename="EditingTheFormBean.html"?>
+
+<title>Editing the Form Bean</title>
+<itemizedlist>
+<listitem><para>Right-click the <emphasis><property moreinfo="none">/greeting</property></emphasis> action again and select Open Form-bean Source to open the GetNameForm.java file for editing</para></listitem>
+<listitem><para>Change the class that it extends from: <emphasis><property moreinfo="none">org.apache.struts.action.ActionForm</property></emphasis> to <emphasis><property moreinfo="none">org.apache.struts.validator.ValidatorForm</property></emphasis></para></listitem>
+<listitem><para>Comment out a validate method</para></listitem>
+</itemizedlist>
+<para>The file should now look like this:</para>
+<programlisting format="linespecific" role="JAVA"><![CDATA[package sample;
+import javax.servlet.http.HttpServletRequest;
+import org.apache.struts.action.ActionErrors;
+import org.apache.struts.action.ActionMapping;
+public class GetNameForm extends
+
+org.apache.struts.validator.ValidatorForm
+{
+
+ private String name = "";
+
+ /**
+ * @return Returns the name.
+ */
+ public String getName()
+ {
+ return name;
+ }
+
+ /**
+ * @param name The name to set.
+ */
+ public void setName(String name)
+ {
+ this.name = name;
+ }
+
+ public GetNameForm ()
+ {
+ }
+
+ public void reset(ActionMapping actionMapping,
+ HttpServletRequest request)
+ {
+ this.name = "";
+ }
+
+ // public ActionErrors validate(ActionMapping actionMapping,
+ HttpServletRequest request)
+ {
+ // ActionErrors errors = new ActionErrors();
+ // return errors;
+ // }
+ }
+]]></programlisting>
+
+<itemizedlist>
+<listitem><para>Select <emphasis><property moreinfo="none">File > Save All </property></emphasis>from the menu bar</para></listitem>
+<listitem><para>Reload the application into JBoss AS by clicking on the "Change Time Stamp" icon (a finger pointing with a little star) in the toolbar</para></listitem>
+<listitem><para>Run the application</para></listitem>
+<listitem><para>In the browser window, click on the "Say Hello!" button without having entered any name in the form</para></listitem>
+</itemizedlist>
+<para>The error message should appear in a refreshed version of the form.</para>
+</section>
+
+</chapter>
+
+<chapter id="relevant_resources" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_tutorial/en/modules/relevant_resources.xml" xreflabel="relevant_resources">
+ <?dbhtml filename="relevant_resources.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Struts</keyword>
+ <keyword>Struts Application</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Other Relevant Resources on the topic</title>
+
+ <para>Our reference: <ulink url="../../struts_tools_ref_guide/html_single/index.html">Struts Tools Reference Guide</ulink></para>
+ <para>Apache Struts: <ulink url="http://struts.apache.org/">Struts Technology</ulink></para>
+ <para>Struts 2: <ulink url="http://struts.apache.org/2.x/">Apache Struts 2</ulink></para>
+ <para>Get Started: <ulink url="http://struts.apache.org/2.x/docs/home.html">Struts Getting
+ Started</ulink></para>
+ <para>Struts on IBM: <ulink url="http://www.ibm.com/developerworks/library/j-struts/">Struts -
+ An open-source MVC implementation</ulink></para>
+ <para>FAQ: <ulink url="http://struts.apache.org/2.x/docs/faqs.html">Struts FAQ</ulink></para>
+ <para>Download: <ulink url="http://struts.apache.org/download.cgi#struts206">Release of Apache
+ Struts</ulink></para>
+
+ <para>Thus, this tutorial should help you to execute the hole development circle for building a
+ sample Struts-based Web application using <property moreinfo="none">JBoss Tools</property> bundle of Eclipse
+ plugins starting from organizing a new Struts project and ending with the running and
+ deploying it onto the <property moreinfo="none">JBoss Server</property>.</para>
+
+ <para>To find out all the features of <property moreinfo="none">JBoss Tools</property> for working with Struts
+ refer to our <ulink url="../../struts_tools_ref_guide/html_single/index.html">Struts Tools Reference Guide</ulink>. If you
+ still have questions you are always welcome on <ulink url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201">JBoss
+ Tools Forum</ulink>.</para>
+</chapter>
+
+
+
+</book>
15 years, 5 months
JBoss Tools SVN: r15212 - branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en.
by jbosstools-commits@lists.jboss.org
Author: smukhina
Date: 2009-05-11 12:43:34 -0400 (Mon, 11 May 2009)
New Revision: 15212
Added:
branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/master_output.xml
Removed:
branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/master_output.xml
Log:
https://jira.jboss.org/jira/browse/JBDS-717 merged changes from trunk are added to the corresponding branch
Deleted: branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/master_output.xml
===================================================================
--- branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/master_output.xml 2009-05-11 16:42:46 UTC (rev 15211)
+++ branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/master_output.xml 2009-05-11 16:43:34 UTC (rev 15212)
@@ -1,1262 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-"http://www.docbook.org/xml/4.3/docbookx.dtd"
-
-[
-<!ENTITY introduction SYSTEM "modules/introduction.xml">
-<!ENTITY projects SYSTEM "modules/projects.xml">
-<!ENTITY editors SYSTEM "modules/editors.xml">
-<!ENTITY modules SYSTEM "modules/modules.xml">
-<!ENTITY code_generation SYSTEM "modules/code_generation.xml">
-<!ENTITY config_file_debugger SYSTEM "modules/config_file_debugger.xml">
-<!ENTITY page_links_recognizer SYSTEM "modules/page_links_recognizer.xml">
-<!ENTITY project_verification SYSTEM "modules/project_verification.xml">
-<!ENTITY rel_resources_links SYSTEM "modules/rel_resources_links.xml">
-
-<!ENTITY seamlink "../../seam/html_single/index.html">
-<!ENTITY aslink "../../as/html_single/index.html">
-<!ENTITY esblink "../../esb_ref_guide/html_single/index.html">
-<!ENTITY gsglink "../../GettingStartedGuide/html_single/index.html">
-<!ENTITY hibernatelink "../../hibernatetools/html_single/index.html">
-<!ENTITY jbpmlink "../../jbpm/html_single/index.html">
-<!ENTITY jsflink "../../jsf/html_single/index.html">
-<!ENTITY jsfreflink "../../jsf_tools_ref_guide/html_single/index.html">
-<!ENTITY jsftutoriallink "../../jsf_tools_tutorial/html_single/index.html">
-<!ENTITY strutsreflink "../../struts_tools_ref_guide/html_single/index.html">
-<!ENTITY strutstutoriallink "../../struts_tools_tutorial/html_single/index.html">
-<!ENTITY migrationlink "../../Exadel-migration/html_single/index.html">
-
-]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff">
- <bookinfo>
- <title>Struts Tools Reference Guide</title>
-
- <author><firstname>Anatoly</firstname><surname>Fedosik</surname></author>
- <author><firstname>Olga</firstname><surname>Chikvina</surname></author>
- <author><firstname>Svetlana</firstname><surname>Mukhina</surname><email>smukhina(a)exadel.com</email></author>
-
- <pubdate>April 2008</pubdate>
- <copyright>
- <year>2007</year>
- <year><diffmk:wrapper diffmk:change="changed">2009</diffmk:wrapper></year>
- <holder><diffmk:wrapper diffmk:change="changed">JBoss, a division of Red Hat</diffmk:wrapper></holder>
- </copyright>
- <releaseinfo><diffmk:wrapper diffmk:change="changed">
- Version: 3.0.0.GA
- </diffmk:wrapper></releaseinfo>
-
-<abstract>
- <title></title>
- <para>
- <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/struts_tools_ref_gui...">PDF version</ulink>
- </para>
-</abstract>
-
-
- </bookinfo>
-
- <toc></toc>
-
-
-<chapter id="intoduction" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/introduction.xml">
- <?dbhtml filename="introduction.html"?>
-
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Developer Studio</keyword>
- <keyword>Eclipse</keyword>
- <keyword>Java</keyword>
- <keyword>JBoss</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Introduction</title>
-
- <para>If you prefer to develop web applications using Struts technology JBoss Tools also meet
- your needs. The professional developer toolset provides all necessary editors and wizards
- for creating Struts resources that enhances the process of building high-quality web
- applications.</para>
- <note>
- <title>Note:</title>
- <para>Note that JBoss Tools support the Struts 1.1, 1.2.x versions.</para>
- </note>
-
- <para>In this guide you will learn how to take advantage of Struts support that <property moreinfo="none">JBoss Tools</property>
- provide.</para>
-
- <section id="struts_key_features">
- <title>Key Features of Struts Tools</title>
-
- <para>For a start, we propose you to look through the table of main features of Struts
- Tools:</para>
-
- <table>
-
- <title>Key Functionality for Struts Tools</title>
- <tgroup cols="3">
-
- <colspec align="left" colnum="1" colwidth="2*"></colspec>
- <colspec colnum="2" colwidth="4*"></colspec>
- <colspec align="left" colnum="3" colwidth="2*"></colspec>
-
- <thead>
- <row>
- <entry>Feature</entry>
- <entry>Benefit</entry>
- <entry>Chapter</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry><para>Struts Support</para></entry>
- <entry><para>Step-by-step wizards for creating a new struts project with a number
- of predefined templates, importing existing ones and adding struts
- capabilities to non-struts web projects.</para></entry>
- <entry>
- <link linkend="projects">struts support</link>
- </entry>
- </row>
-
- <row>
- <entry><para>Support for Struts Configuration File</para></entry>
- <entry><para>Working on file using three modes: diagram, tree and source.
- Synchronization between the modes and full control over the code. Easy
- moving around the diagram using the Diagram Navigator. Working with
- struts projects that have multiple modules. Possibility to use Struts
- configuration file debugger allowing to set break points on struts
- diagram and then launch the server in debug mode.</para></entry>
- <entry>
- <link linkend="struts_config_editor">graphical editor for struts</link>
- <link linkend="config_file_debugger">configuration file debugger</link>
- </entry>
- </row>
-
- <row>
- <entry><para>Support for Struts modules</para></entry>
- <entry><para>A Struts module (struts-config.xml) is automatically created while
- creating a new project. There is also possibility to add new ones or edit
- already existing modules in your existing project or while importing Struts project.</para></entry>
- <entry>
- <link linkend="modules">modules</link>
- </entry>
- </row>
-
- <row>
- <entry><para>Verification and Validation</para></entry>
- <entry><para>All occuring errors will be immediately reported by verification
- feature, no matter in what view you are working. Constant validation and
- errors checking allows to catch many of the errors during development
- process that significantly reduces development time.</para></entry>
- <entry>
- <link linkend="project_verification">verification and validation</link>
- </entry>
-
- </row>
- </tbody>
- </tgroup>
- </table>
-
- </section>
-
- <section>
- <title>Other relevant resources on the topic</title>
-
- <para>All JBoss Developer Studio/JBoss Tools documentation you can find <ulink url="http://docs.jboss.org/tools/">here</ulink>.</para>
- <para>The latest documentation builds are available <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">here</ulink>.</para>
-
- </section>
-
-</chapter>
-
-
-<chapter id="projects" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/projects.xml">
- <?dbhtml filename="projects.html"?>
-
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Developer Studio</keyword>
- <keyword>Eclipse</keyword>
- <keyword>Java</keyword>
- <keyword>JBoss</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Projects</title>
-
- <para>JBoss Tools provide the following functionality when working with Struts:</para>
-
- <itemizedlist>
- <listitem>
- <para>Create new <property moreinfo="none">Struts projects</property></para>
- </listitem>
- <listitem>
- <para>Import (open) existing Struts projects. You can import any project
- structure</para>
- </listitem>
- <listitem>
- <para>Add <property moreinfo="none">Struts capabilities</property> to any existing Eclipse
- project</para>
- </listitem>
- <listitem>
- <para>Import and add Struts capabilities to any existing project created outside
- Eclipse.</para>
- </listitem>
- </itemizedlist>
- <para>Now, we'll focus on all these points more fully.</para>
-
- <section id="CreatingANewStrutsProjec745t">
-
- <title>Creating a New Struts Project</title>
-
-
- <para>JBoss Tools provides a New Struts Project Wizard that radically simplifies the process
- for getting started with a new Struts project. You just need to follow these steps:</para>
- <itemizedlist>
- <listitem>
- <para>Select<emphasis>
- <property moreinfo="none">File > New > Project...</property>
- </emphasis> from the menu bar. Then, select <emphasis>
- <property moreinfo="none">JBoss Tools Web > Struts > Struts Project</property>
- </emphasis> in this dialog box. Click <emphasis>
- <property moreinfo="none">Next</property>: </emphasis></para>
- </listitem>
- </itemizedlist>
- <figure float="0">
- <title>Selecting Struts Wizard</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_2.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <itemizedlist>
- <listitem>
- <para>On this form, provide the <property moreinfo="none">Project Name</property>. You can also
- select where to create the project or use the default path.</para>
- <para>Next to <property moreinfo="none">Struts Environment</property> set which Struts version to
- use.</para>
- </listitem>
- </itemizedlist>
-
- <figure float="0">
- <title>Creating Struts Project</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_3.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <tip>
- <title>Tip:</title>
- <para>Don't put spaces in project names since some OS could experience problems
- with their processing and searching these files.</para>
- </tip>
-
- <para>You can select the KickStart template, then the project created will include a simple
- Hello World type application that is ready to run.</para>
-
- <figure float="0">
- <title>Choosing Struts Template </title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_3_1.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <itemizedlist>
- <listitem>
- <para>Next, you register this application with the current servlet container defined
- for your workspace (JBoss AS, by default) in order to allow you to test your
- application more easily while still developing it. A new entry will be added in
- the servlet container configuration file to enable running the application
- in-place (called null deployment or link deployment). Uncheck the <emphasis role="italic">
- <property moreinfo="none">"Target Server"</property>
- </emphasis> check box if for some reason you don't want to register
- your application at this point.</para>
- </listitem>
- </itemizedlist>
- <figure float="0">
- <title>Registering The Project at Server</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_4.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <itemizedlist>
- <listitem>
- <para>On the next form, you can select the TLD files to include in this
- project:</para>
- </listitem>
- </itemizedlist>
- <figure float="0">
- <title>Selecting Tag Libraries</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_5.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>After the project is created, you should have the following project structure (if you
- used the KickStart template):</para>
-
- <figure float="0">
- <title>Project Structure</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_6.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <tip>
- <title>Tip:</title>
- <para>If you want to hide the jar files from Web App Libraries in view, select the
- down-pointing arrow in the upper right corner, select
- <emphasis>Filters...</emphasis>, check the box next to Name filter patterns
- (matching names will be hidden), and type *.jar into the field. Then, click OK.
- </para>
- </tip>
- </section>
- <section id="ImportingAnExistingStrutsProjectWithAnyStructure9653">
-
- <title>Importing an Existing Struts Project with Any Structure</title>
-
- <para>For detailed information on migration projects to JBoss Developer Studio see <ulink url="../../Exadel-migration/html_single/index.html">Migration Guide</ulink>.</para>
-
- </section>
- <section id="AddingStrutsCapabilityToAnExistingWebApplication532">
-
- <title>Adding Struts Capability to an Existing Web Application</title>
-
- <para>Here, we'll consider how to add Struts functionality (Struts libraries, tag
- libraries and a Struts configuration file) to any existing Web application project in
- your Eclipse workspace.</para>
-
- <para>By adding a Struts Nature to your project, you can now edit files using JBoss Tools
- editors, such as the <link linkend="struts_config_editor">Struts configuration
- editor</link> and the JBoss Tools JSP editor. To take advantage of this just right-click
- the project and select <emphasis>
- <property moreinfo="none">JBoss Tools > Add Struts Capabilities</property>
- </emphasis> from the context menu. This will start the process of adding all necessary
- libraries and files to make a Web Struts project from your one.</para>
-
- <figure float="0">
- <title>Adding Struts Capabilities</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_7.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>In the wizard you should point to location of your deployment descriptor file web.xml
- and name of the project.</para>
-
- <figure float="0">
- <title>Choosing Project Location</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_8.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para>After hitting <emphasis>
- <property moreinfo="none">Next</property>, </emphasis> you will see the following screen. This
- screen simply means that you need to add at least one Struts module to your project to
- make this project a Struts project. Adding a Struts module means that a new
- struts-config.xml will be added to your project and registered in the web.xml file. In
- addition, all required Struts libraries will be added. To add a Struts module, select
- the <emphasis>
- <property moreinfo="none">Add Struts Support</property>
- </emphasis> button.</para>
- <figure float="0">
- <title>Project Modules</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_9.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Here you can select what Struts <property moreinfo="none">Version</property>, <property moreinfo="none">Servlet
- Class</property>, <property moreinfo="none">URL Pattern</property> and <property moreinfo="none">TLD</property>s to add
- to this project.</para>
-
- <figure float="0">
- <title>Selecting Struts Support Options</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_10.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>When done, you will see the default Struts module configuration information. See how
- to Edit <link linkend="modules">Struts modules</link>.</para>
-
- <figure float="0">
- <title>Project Configuration Information</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_11.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>On the last screen you can set the different folders for your project as well as
- register this application with a servlet container. If you want the libraries (.jar
- files) will be automatically added to your project, click on the checkbox <emphasis>
- <property moreinfo="none">Add Libraries</property>.</emphasis></para>
-
- <figure float="0">
- <title>Registering the Project at Server</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_12.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>When done, you can open end edit the struts-config.xml file using usefull Struts
- configuration file editor provided by JBDS. (The Struts configuration is shown below in
- the Tree viewer).</para>
-
- <figure float="0">
- <title>Struts-config.xml File</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_13.png" scale="75"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
-
-</chapter>
-
-
-<chapter id="editors" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/editors.xml">
- <?dbhtml filename="editors.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Developer Studio</keyword>
- <keyword>Eclipse</keyword>
- <keyword>Struts Tools</keyword>
- <keyword>Java</keyword>
- <keyword>JBoss</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Editors</title>
- <para>In this chapter we'll introduce you to featured graphical editors for specific
- Struts files such as Struts Configuration files, Tiles files and Struts Validation files.</para>
- <section id="struts_config_editor">
-
- <title>Graphical Editor for Struts Configuration Files</title>
- <para>First, let's dwell on the Struts Configuration file editor.</para>
- <para>This editor has three views with different representation of <emphasis>
- <property moreinfo="none">struts-config.xml</property>: </emphasis>Diagram, Tree and Source. The
- views can be selected via the tabs at the bottom of the editor. Any changes made in one
- view are immediately visible when you switch to any other view.</para>
-
- <para>Now, we'll consider every view in more detail.</para>
- <section id="StrutsDiagramMode453">
-
- <title>Diagram View</title>
-
- <para>The Diagram view graphically displays the Web flow of the application defined in
- the Struts configuration file.</para>
-
- <figure float="0">
- <title>Diagram View</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_14.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>The Diagram view allows to edit navigation in your Struts application. Just by
- right-clicking anywhere on the diagram, you can use a context menu to create the
- building blocks of a Struts application:</para>
- <itemizedlist>
- <listitem>
- <para>Actions</para>
- </listitem>
- <listitem>
- <para>Global forwards</para>
- </listitem>
- <listitem>
- <para>Global exceptions</para>
- </listitem>
- <listitem>
- <para>JSP Pages</para>
- </listitem>
- </itemizedlist>
-
- <figure float="0">
- <title>Diagram Context Menu</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_15.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Along the upper-left side of the editor is a stack of seven icons for changing the
- behavior of the cursor in the diagram. </para>
-
- <figure float="0">
- <title>Editor Icons</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_16.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>The first icon switches to the default regular selection cursor, the second to the
- marquee selection cursor and the third to the new connection cursor. The last four
- icons switch the cursor to an insert cursor for each type of Struts build block
- listed above (and in the order listed).</para>
-
- <para>For instance, clicking on the first of these four icons (the one with the gears)
- will switch the cursor to insert actions. Clicking anywhere in the diagram with this
- cursor has the same effect as right-click and selecting <emphasis>
- <property moreinfo="none">Add > Action...</property>
- </emphasis> from the context menu with the regular cursor active. It's just
- more efficient to use this cursor if you're adding more than one action at
- once.</para>
-
-
- </section>
- <section id="StrutsTreeMode42">
-
- <title>Tree View</title>
-
- <para>The Tree view represents the different elements of the Struts application that are
- organized into functional categories on the left-hand side and a form for editing
- the properties of currently selected items on the right-hand side.</para>
-
- <figure float="0">
- <title>Tree View</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_17.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>You can also right-click on any node in the category tree and perform appropriate
- operations through a context menu. For instance, by right-clicking on the
- action-mappings category node, you can add new actions to the application.</para>
-
- <figure float="0">
- <title>Tree Context Menu</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_18.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section id="StrutsSourceMode9655">
-
- <title>Source View</title>
-
- <para>In the Source view, you have complete editing control of the underlying XML
- coding.</para>
-
- <figure float="0">
- <title>Source View</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_19.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>When working in Source view, you always have all the following features available:</para>
- <itemizedlist>
- <listitem>
- <para>Content Assist</para>
- </listitem>
- <listitem>
- <para>Open On Selection</para>
- </listitem>
- <listitem>
- <para>File Folding</para>
- </listitem>
- </itemizedlist>
- <para>You can take advantage of <ulink url="../../jsf/html_single/index.html#CodeAssistAndDynamicCodeAssist42BasedOnProjectData">code assist</ulink>.</para>
- <figure float="0">
- <title>Code Assist</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_20.png" scale="85"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>The editor will also immediately flag any errors.</para>
-
- <figure float="0">
- <title>Errors in Source View</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_21.png" scale="85"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Finally, you can use the Outline view with the editor to easily navigate through
- the file.</para>
-
- <figure float="0">
- <title>Outline View</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_22.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Find more information about editor features <ulink url="../../jsf/html_single/index.html#editors_features">here</ulink>.</para>
- </section>
- </section>
-
- <section id="GraphicalEditorForTilesFiles132">
-
- <title>Graphical Editor for Tiles Files</title>
- <para>Here, you'll know how to make use of the special graphical editor for Tiles configuration files.</para>
- <para>The editor has three main views: Tree, Diagram and Source.
- The views can be selected via the tabs at the bottom of the editor. Any changes made in
- one view are immediately visible when you switch to any other view.</para>
-
- <para>Before we consider each view of the editor, let's look at the way of creating new Tiles files.</para>
- <section id="CreateNewTilesFile1422">
-
- <title>Create New Tiles File</title>
-
- <para>To create new Tiles files, right click any folder and select <emphasis>
- <property moreinfo="none">New > Tiles File</property>. </emphasis></para>
- <figure float="0">
- <title>Creating a New Tiles File</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_23.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section id="StrutsTreeView896">
-
- <title>Tree View</title>
-
- <para>The Tree view represents the different elements of the Tiles file that are
- organized into functional categories on the left-hand side and a form for editing
- the properties of currently selected items on the right-hand side.</para>
- <figure float="0">
- <title>Tree View</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_24.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>To edit the file, simply right click any node and select among the available
- actions.</para>
- <figure float="0">
- <title>Editing in Tiles Editor</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_25.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section id="StrutsDiagramView4643">
-
- <title>Diagram View</title>
-
- <para>The Diagram view allows you to create complex Tiles files in the form of a
- diagram.</para>
- <figure float="0">
- <title>Diagram Mode</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_26.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>To create new definitions, simply right click anywhere in the diagram.</para>
- <figure float="0">
- <title>Creating New Definition</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_27.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>You can also use the Diagram toolbar to make editing easier.</para>
- <figure float="0">
- <title>Diagram Toolbar</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_28.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para> It contains four icons for changing the cursor state. The first one is the
- default cursor state for selecting existing nodes. The second icon is marquee
- selector. The third is used for creating new connections and the last one is for
- adding definition template to the content.</para>
- </section>
- <section id="StrutsSource75">
-
- <title>Source</title>
-
- <para>The other view of the <property moreinfo="none">Tiles editor</property> is the Source view that
- gives you full control over the source. Any changes here will immediately appear in
- other modes when you switch to them.</para>
-
- <para>When working in Source view, you always have all following features available:</para>
- <itemizedlist>
- <listitem>
- <para>Content Assist</para>
- </listitem>
- <listitem>
- <para>Open On Selection</para>
- </listitem>
- </itemizedlist>
-
- <figure float="0">
- <title>Source View</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_29.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para><ulink url="../../jsf/html_single/index.html#CodeAssistAndDynamicCodeAssist42BasedOnProjectData">Code
- assist</ulink> is available in the Source mode.</para>
- <figure float="0">
- <title>Code Assist</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_30.png" scale="85"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para>Any errors are immediately reported as shown below:</para>
- <figure float="0">
- <title>Errors Reporting</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_31.png" scale="75"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>You can also use the Outline view together with the editor's Source mode.
- It provides an easier navigation through the file.</para>
- <figure float="0">
- <title>Outline View</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_32.png" scale="85"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- </section>
-
- <section id="GraphicalEditorForStrutsValidationFiles86">
-
- <title>Graphical Editor for Struts Validation Files</title>
-
- <para>Providing full support for development Struts applications JBoss Tools comes with a
- visual validation editor. To open the editor double-click on the validation file or if you don't have it create a new one.</para>
-
- <para>To create a new validation file, right click any folder in
- Project Explorer and select <emphasis>
- <property moreinfo="none">File > New > Other...</property>
- </emphasis>from the context menu and then <emphasis>
- <property moreinfo="none">JBoss Tools Web > Struts > Validation File</property>. </emphasis></para>
- <figure float="0">
- <title>Creating New Validation File</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_33.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>The validation editor works with five modes: Formsets, Validators, Constants and
- standard Tree and Source that you can easily switch over using tabs at the bottom of the
- editor.</para>
- <para>The Formsets view shows forms and their elements on the left side and the dialogue for
- defining their validation rules on the right side.</para>
- <figure float="0">
- <title>Formsets View</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_34.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>The Constants view let you set constant values for your validation rules.</para>
- <figure float="0">
- <title>Constansts View</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_35.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>The validation file can also be viewed in a Tree view.</para>
- <figure float="0">
- <title>Tree View</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_36.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>At any point you have full control over the source by switching to the Source view.
- Any editing in this view will immediately be available in other views of the editor.</para>
- <figure float="0">
- <title>Source View</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_37.png" scale="85"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>You can also open your own custom or Struts-standard <emphasis>
- <property moreinfo="none">validation-rules.xml</property>
- </emphasis> file.</para>
- <para>The Validators view shows the validation rules for a selected validator. You can of
- course add your own rules.</para>
- <figure float="0">
- <title>Validators View</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_38.png" scale="75"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para>Here are the validation rules shown in the Source mode.</para>
- <figure float="0">
- <title>Validation Rules</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_39.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
-</chapter>
-
-
-<chapter id="modules" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/modules.xml">
- <?dbhtml filename="modules.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Developer Studio</keyword>
- <keyword>Eclipse</keyword>
- <keyword>Struts Tools</keyword>
- <keyword>Java</keyword>
- <keyword>JBoss</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Modules</title>
-
- <para>JBoss Tools support working with Struts projects that have
- multiple modules. You can easily do the following:</para>
- <itemizedlist>
- <listitem>
- <para>Add new modules</para>
- </listitem>
- <listitem>
- <para>Edit modules for an existing project or during Struts project
- import</para>
- </listitem>
- </itemizedlist>
- <para>Now, let's discuss this functionality in more detail.</para>
- <section id="WhenImportingAStrutsProject432">
-
- <title>When Importing a Struts Project</title>
-
- <para>During Struts project import, if the project has multiple modules, you
- will see a screen with all existing modules. You can select each
- module and edit its details.</para>
-
- <figure float="0">
- <title>Configuring Project Modules</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_40.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section id="EditingModulesInAnExistingProject1">
-
- <title>Editing Modules in an Existing Project</title>
- <para>To edit modules in an existing project, right click the project and
- select <emphasis>
- <property moreinfo="none">JBoss Tools > Modules Configuration</property>.
- </emphasis></para>
- <figure float="0">
- <title>Choosing Modules Configuration</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_41.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para>You will see the same screen as above where you will be able to select
- a module and edit its details.</para>
- <figure float="0">
- <title>Modules Configuration</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_42.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section id="AddingNewModules1">
-
- <title>Adding New Modules</title>
-
- <para>Adding a new module is very simple. First switch to Web Project view.
- Expand your project to the Configuration folder. Under that folder
- you should see the current modules. Right click on Configuration and
- select <emphasis>
- <property moreinfo="none">New > Struts Config</property>. </emphasis></para>
- <figure float="0">
- <title>Adding New Modules</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_43.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para>You will see the screen below. You can specify a new module name and
- also add the new Struts configuration file to web.xml file.</para>
- <figure float="0">
- <title>Adding New Modules</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_44.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
-</chapter>
-
-
-<chapter id="code_generation" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/code_generation.xml">
- <?dbhtml filename="code_generation.html"?>
-
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Developer Studio</keyword>
- <keyword>Eclipse</keyword>
- <keyword>Struts Tools</keyword>
- <keyword>Java</keyword>
- <keyword>JBoss</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Code Generation</title>
-
- <para>JBoss Tools comes with a <property moreinfo="none">code generation</property>
- feature. You can generate stub code for Struts Actions, FormBeans, Forwards
- and Exceptions.</para>
-
- <para>The code generation that JBoss tooling provides is based on Velocity templates
- which can be modified for your use. The templates are located at <emphasis>
- <property moreinfo="none"> {JBossStudioHome} > templates >
- codegeneration</property>. </emphasis></para>
-
- <para>There are a number of ways to invoke code generation. One is simply
- right-clicking the Struts diagram and selecting <emphasis>
- <property moreinfo="none">Generate Java Code....</property>
- </emphasis></para>
-
- <figure float="0">
- <title>Selecting Generate Java Code</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_45.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>On this screen you can select for which elements to generate code. If you
- select Next you will be able to specify more options for each of the
- categories you selected.</para>
-
- <figure float="0">
- <title>Generate - Step 1</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_46.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <tip>
- <title>Tip:</title>
- <para>Please be careful not to override your existing files.</para>
- </tip>
-
- <para>When generation is complete, a result window will appear letting you know how
- many classes were generated:</para>
-
- <figure float="0">
- <title>Generation Finished</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_47.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>You don't always have to generate code for all elements at once. You
- can invoke generation for just an individual Struts artifact as well.
- Right-click an element on the diagram of the Struts configuration file and
- select <emphasis>
- <property moreinfo="none">Generate Java Code...</property>
- </emphasis> from the context menu.</para>
-
- <figure float="0">
- <title>Generation For Individual Struts Artifact</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_48.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>The same can be done from within the Tree viewer for the editor of the Struts
- configuration file.</para>
-
- <figure float="0">
- <title>Generation in Struts Config Editor</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_49.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-</chapter>
-
-<chapter id="config_file_debugger" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/config_file_debugger.xml">
- <?dbhtml filename="config_file_debugger.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Developer Studio</keyword>
- <keyword>Eclipse</keyword>
- <keyword>Struts Tools</keyword>
- <keyword>Java</keyword>
- <keyword>JBoss</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Struts Configuration File Debugger</title>
-
- <para>JBoss Tools come with <property moreinfo="none">Struts configuration file
- debugger</property>. It allows you to set break points on Struts diagram and
- then simply launch the server in debug mode.</para>
-
- <para>Simply right click an Action or a page and select Add <emphasis>
- <property moreinfo="none">Breakpoint</property>. </emphasis></para>
- <figure float="0">
- <title>Adding Breakpoint</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_50.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-</chapter>
-
-<chapter id="page_links_recognizer" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/page_links_recognizer.xml">
- <?dbhtml filename="page_links_recognizer.html"?>
-
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Developer Studio</keyword>
- <keyword>Eclipse</keyword>
- <keyword>Java</keyword>
- <keyword>JBoss</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Customizable Page Links Recognizer</title>
-
- <para><property moreinfo="none">Custom page links</property> allow you to define custom Struts page
- links that will be recognizable in the Struts application diagram. You can
- define these links by selecting <emphasis>
- <property moreinfo="none">Window > Preferences</property>
- </emphasis> from the menu bar and then selecting <emphasis>
- <property moreinfo="none">JBoss Tools > Web > Struts > Customization</property>
- </emphasis> from the Preferences dialog box.</para>
- <figure float="0">
- <title>Customization Panel</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_51.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-</chapter>
-
-<chapter id="project_verification" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/project_verification.xml">
- <?dbhtml filename="project_verification.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Developer Studio</keyword>
- <keyword>Eclipse</keyword>
- <keyword>Struts Tools</keyword>
- <keyword>Java</keyword>
- <keyword>JBoss</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Struts Project Verification</title>
-
- <para>In this section we'll consider one more functionality that JBoss Tools provide for Struts
- projects, namely adjusting projects verification.</para>
-
- <para>To configure Struts project verification select <emphasis>
- <property moreinfo="none">Window > Preferences</property>
- </emphasis> from the menu bar, select <emphasis>
- <property moreinfo="none">JBoss Tools > Web > Verification</property>
- </emphasis> from the Preferences dialog box and then expand the
- Struts Rules node.</para>
- <figure float="0">
- <title>Struts Rules</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/verif_valid/verif_valid_8.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para>Suppose you are working in the Source viewer for a Struts
- configuration file as shown below:</para>
- <figure float="0">
- <title>Struts Configuration File</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/verif_valid/verif_valid_9.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para>While typing a class name or entering it from the graphical editor,
- you might make a minor typo (like <emphasis role="italic">
- <property moreinfo="none">"sample.GreetingAction1"</property>
- </emphasis> instead of <emphasis role="italic">
- <property moreinfo="none">"sample.GreetingAction"</property>
- </emphasis>). After saving the file,
- <property moreinfo="none">verification</property> checks to make sure everything is
- correct and finds the error below:</para>
- <figure float="0">
- <title>Error Reporting</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/verif_valid/verif_valid_10.png" scale="75"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para>Notice that the Package Explorer View shows a marked folder and a
- marked file where the error is.</para>
- <para>You can place the cursor over the line with the error to view a
- detailed error message:</para>
- <figure float="0">
- <title>Error Message</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/verif_valid/verif_valid_11.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para>The verification also checks to make sure you have specified the
- correct JSP page for the forward:</para>
- <figure float="0">
- <title>JSP Page Verification</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/verif_valid/verif_valid_12.png" scale="75"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para>Once you place the cursor over the line, you can see the error
- message:</para>
- <figure float="0">
- <title>Error Message</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/verif_valid/verif_valid_13.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para>You can always invoke the verification by switching to the Diagram
- viewer, right-clicking and selecting <emphasis>
- <property moreinfo="none">Verify</property>
- </emphasis> from the context menu:</para>
- <figure float="0">
- <title>Verify Command</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/verif_valid/verif_valid_14.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-</chapter>
-
-<chapter id="rel_resources_links" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/rel_resources_links.xml">
- <?dbhtml filename="rel_resources_links.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Developer Studio</keyword>
- <keyword>Eclipse</keyword>
- <keyword>Struts Tools</keyword>
- <keyword>Java</keyword>
- <keyword>JBoss</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Relevant Resources Links</title>
-
- <para>Find out necessary information on <ulink url="http://struts.apache.org/">Struts
- technology</ulink> if you don't know enough.</para>
-
- <para>In summary, this reference should help you to get familiar with those parts of
- <property moreinfo="none">JBoss Tools</property> which are meant for development with Struts
- technology. If you've carefully gone through the document, you should know
- now how to create/import Struts project or enable Struts capabilities for an
- existing web project as well as organize and edit all necessary staff for your
- Struts application using a set of views and editors provided by <property moreinfo="none">JBoss
- Tools</property>.</para>
-
- <para>If you'd like to contribute your feedback is always appreciated. You can
- leave your questions and suggestions on our <ulink url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201">Forum</ulink>.</para>
-</chapter>
-
-</book>
Copied: branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/master_output.xml (from rev 15128, trunk/struts/docs/struts_tools_ref_guide/en/master_output.xml)
===================================================================
--- branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/master_output.xml (rev 0)
+++ branches/jbosstools-3.0.x/struts/docs/struts_tools_ref_guide/en/master_output.xml 2009-05-11 16:43:34 UTC (rev 15212)
@@ -0,0 +1,1263 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+"http://www.docbook.org/xml/4.3/docbookx.dtd"
+
+[
+<!ENTITY introduction SYSTEM "modules/introduction.xml">
+<!ENTITY projects SYSTEM "modules/projects.xml">
+<!ENTITY editors SYSTEM "modules/editors.xml">
+<!ENTITY modules SYSTEM "modules/modules.xml">
+<!ENTITY code_generation SYSTEM "modules/code_generation.xml">
+<!ENTITY config_file_debugger SYSTEM "modules/config_file_debugger.xml">
+<!ENTITY page_links_recognizer SYSTEM "modules/page_links_recognizer.xml">
+<!ENTITY project_verification SYSTEM "modules/project_verification.xml">
+<!ENTITY rel_resources_links SYSTEM "modules/rel_resources_links.xml">
+
+<!ENTITY seamlink "../../seam/html_single/index.html">
+<!ENTITY aslink "../../as/html_single/index.html">
+<!ENTITY esblink "../../esb_ref_guide/html_single/index.html">
+<!ENTITY gsglink "../../GettingStartedGuide/html_single/index.html">
+<!ENTITY hibernatelink "../../hibernatetools/html_single/index.html">
+<!ENTITY jbpmlink "../../jbpm/html_single/index.html">
+<!ENTITY jsflink "../../jsf/html_single/index.html">
+<!ENTITY jsfreflink "../../jsf_tools_ref_guide/html_single/index.html">
+<!ENTITY jsftutoriallink "../../jsf_tools_tutorial/html_single/index.html">
+<!ENTITY strutsreflink "../../struts_tools_ref_guide/html_single/index.html">
+<!ENTITY strutstutoriallink "../../struts_tools_tutorial/html_single/index.html">
+<!ENTITY migrationlink "../../Exadel-migration/html_single/index.html">
+
+]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff">
+ <bookinfo>
+ <title>Struts Tools Reference Guide</title>
+
+ <author><firstname>Anatoly</firstname><surname>Fedosik</surname></author>
+ <author><firstname>Olga</firstname><surname>Chikvina</surname></author>
+ <author><firstname>Svetlana</firstname><surname>Mukhina</surname><email>smukhina(a)exadel.com</email></author>
+
+ <pubdate>April 2008</pubdate>
+ <copyright>
+ <year>2007</year>
+ <year>2009</year>
+ <holder>JBoss, a division of Red Hat</holder>
+ </copyright>
+ <releaseinfo>
+ Version: 3.0.0.GA
+ </releaseinfo>
+
+<abstract>
+ <title></title>
+ <para>
+ <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/struts_tools_ref_gui...">PDF version</ulink>
+ </para>
+</abstract>
+
+
+ </bookinfo>
+
+ <toc></toc>
+
+
+<chapter id="intoduction" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/introduction.xml">
+ <?dbhtml filename="introduction.html"?>
+
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>Eclipse</keyword>
+ <keyword>Java</keyword>
+ <keyword>JBoss</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Introduction</title>
+
+ <para>If you prefer to develop web applications using Struts technology JBoss Tools also meet
+ your needs. The professional developer toolset provides all necessary editors and wizards
+ for creating Struts resources that enhances the process of building high-quality web
+ applications.</para>
+ <note>
+ <title>Note:</title>
+ <para>Note that JBoss Tools support the Struts 1.1, 1.2.x versions.</para>
+ </note>
+
+ <para>In this guide you will learn how to take advantage of Struts support that <property moreinfo="none">JBoss Tools</property>
+ provide.</para>
+
+ <section id="struts_key_features">
+ <title>Key Features of Struts Tools</title>
+
+ <para>For a start, we propose you to look through the table of main features of Struts
+ Tools:</para>
+
+ <table>
+
+ <title>Key Functionality for Struts Tools</title>
+ <tgroup cols="3">
+
+ <colspec align="left" colnum="1" colwidth="2*"></colspec>
+ <colspec colnum="2" colwidth="4*"></colspec>
+ <colspec align="left" colnum="3" colwidth="2*"></colspec>
+
+ <thead>
+ <row>
+ <entry>Feature</entry>
+ <entry>Benefit</entry>
+ <entry>Chapter</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><para>Struts Support</para></entry>
+ <entry><para>Step-by-step wizards for creating a new struts project with a number
+ of predefined templates, importing existing ones and adding struts
+ capabilities to non-struts web projects.</para></entry>
+ <entry>
+ <link linkend="projects">struts support</link>
+ </entry>
+ </row>
+
+ <row>
+ <entry><para>Support for Struts Configuration File</para></entry>
+ <entry><para>Working on file using three modes: diagram, tree and source.
+ Synchronization between the modes and full control over the code. Easy
+ moving around the diagram using the Diagram Navigator. Working with
+ struts projects that have multiple modules. Possibility to use Struts
+ configuration file debugger allowing to set break points on struts
+ diagram and then launch the server in debug mode.</para></entry>
+ <entry>
+ <link linkend="struts_config_editor">graphical editor for struts</link>
+ <link linkend="config_file_debugger">configuration file debugger</link>
+ </entry>
+ </row>
+
+ <row>
+ <entry><para>Support for Struts modules</para></entry>
+ <entry><para>A Struts module (struts-config.xml) is automatically created while
+ creating a new project. There is also possibility to add new ones or edit
+ already existing modules in your existing project or while importing Struts project.</para></entry>
+ <entry>
+ <link linkend="modules">modules</link>
+ </entry>
+ </row>
+
+ <row>
+ <entry><para>Verification and Validation</para></entry>
+ <entry><para><diffmk:wrapper diffmk:change="changed">All occurring errors will be immediately reported by verification
+ feature, no matter in what view you are working. Constant validation and
+ errors checking allows to catch many of the errors during development
+ process that significantly reduces development time.</diffmk:wrapper></para></entry>
+ <entry>
+ <link linkend="project_verification">verification and validation</link>
+ </entry>
+
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+ </section>
+
+ <section>
+ <title>Other relevant resources on the topic</title>
+
+ <para>All JBoss Developer Studio/JBoss Tools documentation you can find <ulink url="http://docs.jboss.org/tools/">here</ulink>.</para>
+ <para>The latest documentation builds are available <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">here</ulink>.</para>
+
+ </section>
+
+</chapter>
+
+
+<chapter id="projects" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/projects.xml">
+ <?dbhtml filename="projects.html"?>
+
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>Eclipse</keyword>
+ <keyword>Java</keyword>
+ <keyword>JBoss</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Projects</title>
+
+ <para>JBoss Tools provide the following functionality when working with Struts:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Create new <property moreinfo="none">Struts projects</property></para>
+ </listitem>
+ <listitem>
+ <para>Import (open) existing Struts projects. You can import any project
+ structure</para>
+ </listitem>
+ <listitem>
+ <para>Add <property moreinfo="none">Struts capabilities</property> to any existing Eclipse
+ project</para>
+ </listitem>
+ <listitem>
+ <para>Import and add Struts capabilities to any existing project created outside
+ Eclipse.</para>
+ </listitem>
+ </itemizedlist>
+ <para>Now, we'll focus on all these points more fully.</para>
+
+ <section id="CreatingANewStrutsProjec745t">
+
+ <title>Creating a New Struts Project</title>
+
+
+ <para>JBoss Tools provides a New Struts Project Wizard that radically simplifies the process
+ for getting started with a new Struts project. You just need to follow these steps:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Select<emphasis>
+ <property moreinfo="none">File > New > Project...</property>
+ </emphasis> from the menu bar. Then, select <emphasis>
+ <property moreinfo="none">JBoss Tools Web > Struts > Struts Project</property>
+ </emphasis> in this dialog box. Click <emphasis>
+ <property moreinfo="none">Next</property>: </emphasis></para>
+ </listitem>
+ </itemizedlist>
+ <figure float="0">
+ <title>Selecting Struts Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_2.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>On this form, provide the <property moreinfo="none">Project Name</property>. You can also
+ select where to create the project or use the default path.</para>
+ <para>Next to <property moreinfo="none">Struts Environment</property> set which Struts version to
+ use.</para>
+ </listitem>
+ </itemizedlist>
+
+ <figure float="0">
+ <title>Creating Struts Project</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_3.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <tip>
+ <title>Tip:</title>
+ <para>Don't put spaces in project names since some OS could experience problems
+ with their processing and searching these files.</para>
+ </tip>
+
+ <para>You can select the KickStart template, then the project created will include a simple
+ Hello World type application that is ready to run.</para>
+
+ <figure float="0">
+ <title>Choosing Struts Template </title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_3_1.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <itemizedlist>
+ <listitem>
+ <para>Next, you register this application with the current servlet container defined
+ for your workspace (JBoss AS, by default) in order to allow you to test your
+ application more easily while still developing it. A new entry will be added in
+ the servlet container configuration file to enable running the application
+ in-place (called null deployment or link deployment). Uncheck the <emphasis role="italic">
+ <property moreinfo="none">"Target Server"</property>
+ </emphasis> check box if for some reason you don't want to register
+ your application at this point.</para>
+ </listitem>
+ </itemizedlist>
+ <figure float="0">
+ <title>Registering The Project at Server</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_4.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>On the next form, you can select the TLD files to include in this
+ project:</para>
+ </listitem>
+ </itemizedlist>
+ <figure float="0">
+ <title>Selecting Tag Libraries</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_5.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>After the project is created, you should have the following project structure (if you
+ used the KickStart template):</para>
+
+ <figure float="0">
+ <title>Project Structure</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_6.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <tip>
+ <title>Tip:</title>
+ <para>If you want to hide the jar files from Web App Libraries in view, select the
+ down-pointing arrow in the upper right corner, select
+ <emphasis>Filters...</emphasis>, check the box next to Name filter patterns
+ (matching names will be hidden), and type *.jar into the field. Then, click OK.
+ </para>
+ </tip>
+ </section>
+ <section id="ImportingAnExistingStrutsProjectWithAnyStructure9653">
+
+ <title>Importing an Existing Struts Project with Any Structure</title>
+
+ <para>For detailed information on migration projects to JBoss Developer Studio see <ulink url="../../Exadel-migration/html_single/index.html">Migration Guide</ulink>.</para>
+
+ </section>
+ <section id="AddingStrutsCapabilityToAnExistingWebApplication532">
+
+ <title>Adding Struts Capability to an Existing Web Application</title>
+
+ <para>Here, we'll consider how to add Struts functionality (Struts libraries, tag
+ libraries and a Struts configuration file) to any existing Web application project in
+ your Eclipse workspace.</para>
+
+ <para>By adding a Struts Nature to your project, you can now edit files using JBoss Tools
+ editors, such as the <link linkend="struts_config_editor">Struts configuration
+ editor</link> and the JBoss Tools JSP editor. To take advantage of this just right-click
+ the project and select <emphasis>
+ <property moreinfo="none">JBoss Tools > Add Struts Capabilities</property>
+ </emphasis> from the context menu. This will start the process of adding all necessary
+ libraries and files to make a Web Struts project from your one.</para>
+
+ <figure float="0">
+ <title>Adding Struts Capabilities</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_7.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>In the wizard you should point to location of your deployment descriptor file web.xml
+ and name of the project.</para>
+
+ <figure float="0">
+ <title>Choosing Project Location</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_8.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>After hitting <emphasis>
+ <property moreinfo="none">Next</property>, </emphasis> you will see the following screen. This
+ screen simply means that you need to add at least one Struts module to your project to
+ make this project a Struts project. Adding a Struts module means that a new
+ struts-config.xml will be added to your project and registered in the web.xml file. In
+ addition, all required Struts libraries will be added. To add a Struts module, select
+ the <emphasis>
+ <property moreinfo="none">Add Struts Support</property>
+ </emphasis> button.</para>
+ <figure float="0">
+ <title>Project Modules</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_9.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Here you can select what Struts <property moreinfo="none">Version</property>, <property moreinfo="none">Servlet
+ Class</property>, <property moreinfo="none">URL Pattern</property> and <property moreinfo="none">TLD</property>s to add
+ to this project.</para>
+
+ <figure float="0">
+ <title>Selecting Struts Support Options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_10.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>When done, you will see the default Struts module configuration information. See how
+ to Edit <link linkend="modules">Struts modules</link>.</para>
+
+ <figure float="0">
+ <title>Project Configuration Information</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_11.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>On the last screen you can set the different folders for your project as well as
+ register this application with a servlet container. If you want the libraries (.jar
+ files) will be automatically added to your project, click on the checkbox <emphasis>
+ <property moreinfo="none">Add Libraries</property>.</emphasis></para>
+
+ <figure float="0">
+ <title>Registering the Project at Server</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_12.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="changed">When done, you can open end edit the struts-config.xml file using useful Struts
+ configuration file editor provided by JBDS. (The Struts configuration is shown below in
+ the Tree viewer).</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title>Struts-config.xml File</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_13.png" scale="75"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+
+</chapter>
+
+
+<chapter id="editors" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/editors.xml">
+ <?dbhtml filename="editors.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>Eclipse</keyword>
+ <keyword>Struts Tools</keyword>
+ <keyword>Java</keyword>
+ <keyword>JBoss</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Editors</title>
+ <para>In this chapter we'll introduce you to featured graphical editors for specific
+ Struts files such as Struts Configuration files, Tiles files and Struts Validation files.</para>
+ <section id="struts_config_editor">
+
+ <title>Graphical Editor for Struts Configuration Files</title>
+ <para>First, let's dwell on the Struts Configuration file editor.</para>
+ <para>This editor has three views with different representation of <emphasis>
+ <property moreinfo="none">struts-config.xml</property>: </emphasis>Diagram, Tree and Source. The
+ views can be selected via the tabs at the bottom of the editor. Any changes made in one
+ view are immediately visible when you switch to any other view.</para>
+
+ <para>Now, we'll consider every view in more detail.</para>
+ <section id="StrutsDiagramMode453">
+
+ <title>Diagram View</title>
+
+ <para>The Diagram view graphically displays the Web flow of the application defined in
+ the Struts configuration file.</para>
+
+ <figure float="0">
+ <title>Diagram View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_14.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The Diagram view allows to edit navigation in your Struts application. Just by
+ right-clicking anywhere on the diagram, you can use a context menu to create the
+ building blocks of a Struts application:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Actions</para>
+ </listitem>
+ <listitem>
+ <para>Global forwards</para>
+ </listitem>
+ <listitem>
+ <para>Global exceptions</para>
+ </listitem>
+ <listitem>
+ <para>JSP Pages</para>
+ </listitem>
+ </itemizedlist>
+
+ <figure float="0">
+ <title>Diagram Context Menu</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_15.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Along the upper-left side of the editor is a stack of seven icons for changing the
+ behavior of the cursor in the diagram. </para>
+
+ <figure float="0">
+ <title>Editor Icons</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_16.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The first icon switches to the default regular selection cursor, the second to the
+ marquee selection cursor and the third to the new connection cursor. The last four
+ icons switch the cursor to an insert cursor for each type of Struts build block
+ listed above (and in the order listed).</para>
+
+ <para>For instance, clicking on the first of these four icons (the one with the gears)
+ will switch the cursor to insert actions. Clicking anywhere in the diagram with this
+ cursor has the same effect as right-click and selecting <emphasis>
+ <property moreinfo="none">Add > Action...</property>
+ </emphasis> from the context menu with the regular cursor active. It's just
+ more efficient to use this cursor if you're adding more than one action at
+ once.</para>
+
+
+ </section>
+ <section id="StrutsTreeMode42">
+
+ <title>Tree View</title>
+
+ <para>The Tree view represents the different elements of the Struts application that are
+ organized into functional categories on the left-hand side and a form for editing
+ the properties of currently selected items on the right-hand side.</para>
+
+ <figure float="0">
+ <title>Tree View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_17.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>You can also right-click on any node in the category tree and perform appropriate
+ operations through a context menu. For instance, by right-clicking on the
+ action-mappings category node, you can add new actions to the application.</para>
+
+ <figure float="0">
+ <title>Tree Context Menu</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_18.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="StrutsSourceMode9655">
+
+ <title>Source View</title>
+
+ <para>In the Source view, you have complete editing control of the underlying XML
+ coding.</para>
+
+ <figure float="0">
+ <title>Source View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_19.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>When working in Source view, you always have all the following features available:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Content Assist</para>
+ </listitem>
+ <listitem>
+ <para>Open On Selection</para>
+ </listitem>
+ <listitem>
+ <para>File Folding</para>
+ </listitem>
+ </itemizedlist>
+ <para>You can take advantage of <ulink url="../../jsf/html_single/index.html#CodeAssistAndDynamicCodeAssist42BasedOnProjectData">code assist</ulink>.</para>
+ <figure float="0">
+ <title>Code Assist</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_20.png" scale="85"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The editor will also immediately flag any errors.</para>
+
+ <figure float="0">
+ <title>Errors in Source View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_21.png" scale="85"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Finally, you can use the Outline view with the editor to easily navigate through
+ the file.</para>
+
+ <figure float="0">
+ <title>Outline View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_22.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Find more information about editor features <ulink url="../../jsf/html_single/index.html#editors_features">here</ulink>.</para>
+ </section>
+ </section>
+
+ <section id="GraphicalEditorForTilesFiles132">
+
+ <title>Graphical Editor for Tiles Files</title>
+ <para>Here, you'll know how to make use of the special graphical editor for Tiles configuration files.</para>
+ <para>The editor has three main views: Tree, Diagram and Source.
+ The views can be selected via the tabs at the bottom of the editor. Any changes made in
+ one view are immediately visible when you switch to any other view.</para>
+
+ <para>Before we consider each view of the editor, let's look at the way of creating new Tiles files.</para>
+ <section id="CreateNewTilesFile1422">
+
+ <title>Create New Tiles File</title>
+
+ <para>To create new Tiles files, right click any folder and select <emphasis>
+ <property moreinfo="none">New > Tiles File</property>. </emphasis></para>
+ <figure float="0">
+ <title>Creating a New Tiles File</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_23.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="StrutsTreeView896">
+
+ <title>Tree View</title>
+
+ <para>The Tree view represents the different elements of the Tiles file that are
+ organized into functional categories on the left-hand side and a form for editing
+ the properties of currently selected items on the right-hand side.</para>
+ <figure float="0">
+ <title>Tree View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_24.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>To edit the file, simply right click any node and select among the available
+ actions.</para>
+ <figure float="0">
+ <title>Editing in Tiles Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_25.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="StrutsDiagramView4643">
+
+ <title>Diagram View</title>
+
+ <para>The Diagram view allows you to create complex Tiles files in the form of a
+ diagram.</para>
+ <figure float="0">
+ <title>Diagram Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_26.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>To create new definitions, simply right click anywhere in the diagram.</para>
+ <figure float="0">
+ <title>Creating New Definition</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_27.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>You can also use the Diagram toolbar to make editing easier.</para>
+ <figure float="0">
+ <title>Diagram Toolbar</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_28.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para> It contains four icons for changing the cursor state. The first one is the
+ default cursor state for selecting existing nodes. The second icon is marquee
+ selector. The third is used for creating new connections and the last one is for
+ adding definition template to the content.</para>
+ </section>
+ <section id="StrutsSource75">
+
+ <title>Source</title>
+
+ <para>The other view of the <property moreinfo="none">Tiles editor</property> is the Source view that
+ gives you full control over the source. Any changes here will immediately appear in
+ other modes when you switch to them.</para>
+
+ <para>When working in Source view, you always have all following features available:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Content Assist</para>
+ </listitem>
+ <listitem>
+ <para>Open On Selection</para>
+ </listitem>
+ </itemizedlist>
+
+ <figure float="0">
+ <title>Source View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_29.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para><ulink url="../../jsf/html_single/index.html#CodeAssistAndDynamicCodeAssist42BasedOnProjectData">Code
+ assist</ulink> is available in the Source mode.</para>
+ <figure float="0">
+ <title>Code Assist</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_30.png" scale="85"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Any errors are immediately reported as shown below:</para>
+ <figure float="0">
+ <title>Errors Reporting</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_31.png" scale="75"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>You can also use the Outline view together with the editor's Source mode.
+ It provides an easier navigation through the file.</para>
+ <figure float="0">
+ <title>Outline View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_32.png" scale="85"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ </section>
+
+ <section id="GraphicalEditorForStrutsValidationFiles86">
+
+ <title>Graphical Editor for Struts Validation Files</title>
+
+ <para>Providing full support for development Struts applications JBoss Tools comes with a
+ visual validation editor. To open the editor double-click on the validation file or if you don't have it create a new one.</para>
+
+ <para>To create a new validation file, right click any folder in
+ Project Explorer and select <emphasis>
+ <property moreinfo="none">File > New > Other...</property>
+ </emphasis>from the context menu and then <emphasis>
+ <property moreinfo="none">JBoss Tools Web > Struts > Validation File</property>. </emphasis></para>
+ <figure float="0">
+ <title>Creating New Validation File</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_33.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The validation editor works with five modes: Formsets, Validators, Constants and
+ standard Tree and Source that you can easily switch over using tabs at the bottom of the
+ editor.</para>
+ <para>The Formsets view shows forms and their elements on the left side and the dialogue for
+ defining their validation rules on the right side.</para>
+ <figure float="0">
+ <title>Formsets View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_34.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The Constants view let you set constant values for your validation rules.</para>
+ <figure float="0">
+ <title>Constansts View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_35.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The validation file can also be viewed in a Tree view.</para>
+ <figure float="0">
+ <title>Tree View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_36.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>At any point you have full control over the source by switching to the Source view.
+ Any editing in this view will immediately be available in other views of the editor.</para>
+ <figure float="0">
+ <title>Source View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_37.png" scale="85"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>You can also open your own custom or Struts-standard <emphasis>
+ <property moreinfo="none">validation-rules.xml</property>
+ </emphasis> file.</para>
+ <para>The Validators view shows the validation rules for a selected validator. You can of
+ course add your own rules.</para>
+ <figure float="0">
+ <title>Validators View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_38.png" scale="75"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Here are the validation rules shown in the Source mode.</para>
+ <figure float="0">
+ <title>Validation Rules</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_39.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+</chapter>
+
+
+<chapter id="modules" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/modules.xml">
+ <?dbhtml filename="modules.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>Eclipse</keyword>
+ <keyword>Struts Tools</keyword>
+ <keyword>Java</keyword>
+ <keyword>JBoss</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Modules</title>
+
+ <para>JBoss Tools support working with Struts projects that have
+ multiple modules. You can easily do the following:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Add new modules</para>
+ </listitem>
+ <listitem>
+ <para>Edit modules for an existing project or during Struts project
+ import</para>
+ </listitem>
+ </itemizedlist>
+ <para>Now, let's discuss this functionality in more detail.</para>
+ <section id="WhenImportingAStrutsProject432">
+
+ <title>When Importing a Struts Project</title>
+
+ <para>During Struts project import, if the project has multiple modules, you
+ will see a screen with all existing modules. You can select each
+ module and edit its details.</para>
+
+ <figure float="0">
+ <title>Configuring Project Modules</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_40.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="EditingModulesInAnExistingProject1">
+
+ <title>Editing Modules in an Existing Project</title>
+ <para>To edit modules in an existing project, right click the project and
+ select <emphasis>
+ <property moreinfo="none">JBoss Tools > Modules Configuration</property>.
+ </emphasis></para>
+ <figure float="0">
+ <title>Choosing Modules Configuration</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_41.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>You will see the same screen as above where you will be able to select
+ a module and edit its details.</para>
+ <figure float="0">
+ <title>Modules Configuration</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_42.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="AddingNewModules1">
+
+ <title>Adding New Modules</title>
+
+ <para>Adding a new module is very simple. First switch to Web Project view.
+ Expand your project to the Configuration folder. Under that folder
+ you should see the current modules. Right click on Configuration and
+ select <emphasis>
+ <property moreinfo="none">New > Struts Config</property>. </emphasis></para>
+ <figure float="0">
+ <title>Adding New Modules</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_43.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>You will see the screen below. You can specify a new module name and
+ also add the new Struts configuration file to web.xml file.</para>
+ <figure float="0">
+ <title>Adding New Modules</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_44.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+</chapter>
+
+
+<chapter id="code_generation" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/code_generation.xml">
+ <?dbhtml filename="code_generation.html"?>
+
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>Eclipse</keyword>
+ <keyword>Struts Tools</keyword>
+ <keyword>Java</keyword>
+ <keyword>JBoss</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Code Generation</title>
+
+ <para>JBoss Tools comes with a <property moreinfo="none">code generation</property>
+ feature. You can generate stub code for Struts Actions, FormBeans, Forwards
+ and Exceptions.</para>
+
+ <para>The code generation that JBoss tooling provides is based on Velocity templates
+ which can be modified for your use. The templates are located at <emphasis>
+ <property moreinfo="none"> {JBossStudioHome} > templates >
+ codegeneration</property>. </emphasis></para>
+
+ <para>There are a number of ways to invoke code generation. One is simply
+ right-clicking the Struts diagram and selecting <emphasis>
+ <property moreinfo="none">Generate Java Code....</property>
+ </emphasis></para>
+
+ <figure float="0">
+ <title>Selecting Generate Java Code</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_45.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>On this screen you can select for which elements to generate code. If you
+ select Next you will be able to specify more options for each of the
+ categories you selected.</para>
+
+ <figure float="0">
+ <title>Generate - Step 1</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_46.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <tip>
+ <title>Tip:</title>
+ <para>Please be careful not to override your existing files.</para>
+ </tip>
+
+ <para>When generation is complete, a result window will appear letting you know how
+ many classes were generated:</para>
+
+ <figure float="0">
+ <title>Generation Finished</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_47.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>You don't always have to generate code for all elements at once. You
+ can invoke generation for just an individual Struts artifact as well.
+ Right-click an element on the diagram of the Struts configuration file and
+ select <emphasis>
+ <property moreinfo="none">Generate Java Code...</property>
+ </emphasis> from the context menu.</para>
+
+ <figure float="0">
+ <title>Generation For Individual Struts Artifact</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_48.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The same can be done from within the Tree viewer for the editor of the Struts
+ configuration file.</para>
+
+ <figure float="0">
+ <title>Generation in Struts Config Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_49.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+</chapter>
+
+<chapter id="config_file_debugger" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/config_file_debugger.xml">
+ <?dbhtml filename="config_file_debugger.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>Eclipse</keyword>
+ <keyword>Struts Tools</keyword>
+ <keyword>Java</keyword>
+ <keyword>JBoss</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Struts Configuration File Debugger</title>
+
+ <para>JBoss Tools come with <property moreinfo="none">Struts configuration file
+ debugger</property>. It allows you to set break points on Struts diagram and
+ then simply launch the server in debug mode.</para>
+
+ <para>Simply right click an Action or a page and select Add <emphasis>
+ <property moreinfo="none">Breakpoint</property>. </emphasis></para>
+ <figure float="0">
+ <title>Adding Breakpoint</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_50.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+</chapter>
+
+<chapter id="page_links_recognizer" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/page_links_recognizer.xml">
+ <?dbhtml filename="page_links_recognizer.html"?>
+
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>Eclipse</keyword>
+ <keyword>Java</keyword>
+ <keyword>JBoss</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Customizable Page Links Recognizer</title>
+
+ <para><property moreinfo="none">Custom page links</property> allow you to define custom Struts page
+ links that will be recognizable in the Struts application diagram. You can
+ define these links by selecting <emphasis>
+ <property moreinfo="none">Window > Preferences</property>
+ </emphasis> from the menu bar and then selecting <emphasis>
+ <property moreinfo="none">JBoss Tools > Web > Struts > Customization</property>
+ </emphasis> from the Preferences dialog box.</para>
+ <figure float="0">
+ <title>Customization Panel</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_51.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+</chapter>
+
+<chapter id="project_verification" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/project_verification.xml">
+ <?dbhtml filename="project_verification.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>Eclipse</keyword>
+ <keyword>Struts Tools</keyword>
+ <keyword>Java</keyword>
+ <keyword>JBoss</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Struts Project Verification</title>
+
+ <para>In this section we'll consider one more functionality that JBoss Tools provide for Struts
+ projects, namely adjusting projects verification.</para>
+
+ <para>To configure Struts project verification select <emphasis>
+ <property moreinfo="none">Window > Preferences</property>
+ </emphasis> from the menu bar, select <emphasis>
+ <property moreinfo="none">JBoss Tools > Web > Verification</property>
+ </emphasis> from the Preferences dialog box and then expand the
+ Struts Rules node.</para>
+ <figure float="0">
+ <title>Struts Rules</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/verif_valid/verif_valid_8.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Suppose you are working in the Source viewer for a Struts
+ configuration file as shown below:</para>
+ <figure float="0">
+ <title>Struts Configuration File</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/verif_valid/verif_valid_9.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>While typing a class name or entering it from the graphical editor,
+ you might make a minor typo (like <emphasis role="italic">
+ <property moreinfo="none">"sample.GreetingAction1"</property>
+ </emphasis> instead of <emphasis role="italic">
+ <property moreinfo="none">"sample.GreetingAction"</property>
+ </emphasis>). After saving the file,
+ <property moreinfo="none">verification</property> checks to make sure everything is
+ correct and finds the error below:</para>
+ <figure float="0">
+ <title>Error Reporting</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/verif_valid/verif_valid_10.png" scale="75"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Notice that the Package Explorer View shows a marked folder and a
+ marked file where the error is.</para>
+ <para>You can place the cursor over the line with the error to view a
+ detailed error message:</para>
+ <figure float="0">
+ <title>Error Message</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/verif_valid/verif_valid_11.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>The verification also checks to make sure you have specified the
+ correct JSP page for the forward:</para>
+ <figure float="0">
+ <title>JSP Page Verification</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/verif_valid/verif_valid_12.png" scale="75"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Once you place the cursor over the line, you can see the error
+ message:</para>
+ <figure float="0">
+ <title>Error Message</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/verif_valid/verif_valid_13.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>You can always invoke the verification by switching to the Diagram
+ viewer, right-clicking and selecting <emphasis>
+ <property moreinfo="none">Verify</property>
+ </emphasis> from the context menu:</para>
+ <figure float="0">
+ <title>Verify Command</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/verif_valid/verif_valid_14.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+</chapter>
+
+<chapter id="rel_resources_links" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_ref_guide/en/modules/rel_resources_links.xml">
+ <?dbhtml filename="rel_resources_links.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>Eclipse</keyword>
+ <keyword>Struts Tools</keyword>
+ <keyword>Java</keyword>
+ <keyword>JBoss</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Relevant Resources Links</title>
+
+ <para>Find out necessary information on <ulink url="http://struts.apache.org/">Struts
+ technology</ulink> if you don't know enough.</para>
+
+ <para>In summary, this reference should help you to get familiar with those parts of
+ <property moreinfo="none">JBoss Tools</property> which are meant for development with Struts
+ technology. If you've carefully gone through the document, you should know
+ now how to create/import Struts project or enable Struts capabilities for an
+ existing web project as well as organize and edit all necessary staff for your
+ Struts application using a set of views and editors provided by <property moreinfo="none">JBoss
+ Tools</property>.</para>
+
+ <para>If you'd like to contribute your feedback is always appreciated. You can
+ leave your questions and suggestions on our <ulink url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201">Forum</ulink>.</para>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">We hope, this guide helped you to get started with the JBoss Struts Tools. Besides, for additional information you are welcome on </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201"><diffmk:wrapper diffmk:change="added">JBoss forum</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
+</chapter>
+
+</book>
15 years, 5 months
JBoss Tools SVN: r15211 - in branches/jbosstools-3.0.x/smooks/docs/reference: en/images/config_page and 3 other directories.
by jbosstools-commits@lists.jboss.org
Author: smukhina
Date: 2009-05-11 12:42:46 -0400 (Mon, 11 May 2009)
New Revision: 15211
Modified:
branches/jbosstools-3.0.x/smooks/docs/reference/en/images/config_page/config_page1.png
branches/jbosstools-3.0.x/smooks/docs/reference/en/images/config_page/config_page2.png
branches/jbosstools-3.0.x/smooks/docs/reference/en/images/graph_editor/graph_editor1.png
branches/jbosstools-3.0.x/smooks/docs/reference/en/images/quick_start/quick_start4.png
branches/jbosstools-3.0.x/smooks/docs/reference/en/images/quick_start/quick_start5.png
branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/introduction.xml
branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/quick_start.xml
branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/smooksformeditor_configurationpage.xml
branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/smooksformeditor_graphicalpage.xml
branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/smooksformeditor_sourcepage.xml
branches/jbosstools-3.0.x/smooks/docs/reference/pom.xml
Log:
https://jira.jboss.org/jira/browse/JBDS-717 merged changes from trunk are added to the corresponding branch
Modified: branches/jbosstools-3.0.x/smooks/docs/reference/en/images/config_page/config_page1.png
===================================================================
(Binary files differ)
Modified: branches/jbosstools-3.0.x/smooks/docs/reference/en/images/config_page/config_page2.png
===================================================================
(Binary files differ)
Modified: branches/jbosstools-3.0.x/smooks/docs/reference/en/images/graph_editor/graph_editor1.png
===================================================================
(Binary files differ)
Modified: branches/jbosstools-3.0.x/smooks/docs/reference/en/images/quick_start/quick_start4.png
===================================================================
(Binary files differ)
Modified: branches/jbosstools-3.0.x/smooks/docs/reference/en/images/quick_start/quick_start5.png
===================================================================
(Binary files differ)
Modified: branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/introduction.xml
===================================================================
--- branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/introduction.xml 2009-05-11 16:42:22 UTC (rev 15210)
+++ branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/introduction.xml 2009-05-11 16:42:46 UTC (rev 15211)
@@ -9,6 +9,7 @@
</keywordset>
</chapterinfo>
<title>Introduction</title>
+ <para>This chapter give you a short introduction to Smooks, Smooks tools and its installation</para>
<section>
<title>What is Smooks?</title>
@@ -58,12 +59,12 @@
url="http://www.smooks.org">Smooks official site</ulink>.</para>
</section>
<section>
- <title>What is Smooks dev tools?</title>
+ <title>What is Smooks Tools?</title>
- <para>Smooks dev tools is a set of graphical tools for editing Smooks configuration file
- base on Eclipse.</para>
+ <para>Smooks tools is a set of graphical tools for editing Smooks configuration file
+ based on Eclipse.</para>
<figure>
- <title>Smooks form editor</title>
+ <title>Smooks Form editor</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/introduction/introduction2.png" scale="90"/>
@@ -74,13 +75,16 @@
<section>
<title>How to install Smooks dev tools?</title>
- <para> The Smooks dev tools was included by the <property>JBoss Tools</property> since 3.0.0
+ <para> The Smooks tools was included by the <property>JBoss Tools</property> since 3.0.0
Beta1 version. You can download the <property>JBoss Tools</property> from <ulink
- url="http://www.jboss.org/tools/download/index.html">here</ulink>.</para>
- <para> Smooks dev tools (<property>JBoss Tools</property>) run with the latest Eclipse and
+ url="http://www.jboss.org/tools/download/index.html">JBoss download site</ulink>.</para>
+ <para> Smooks tools (<property>JBoss Tools</property>) run with the latest Eclipse and
other required plug-ins (GEF, EMF, etc.).</para>
- <para> You should download the latest IDE for Java EE developers from this <ulink
- url="http://www.eclipse.org/downloads/">site</ulink>. It contains many plug-ins (
- GEF, EMF, etc. ) required by Smooks dev tools. </para>
+ <para> You should download the latest IDE for Java EE developers from <ulink
+ url="http://www.eclipse.org/downloads/"> Eclipse site</ulink>. It contains many plug-ins (
+ GEF, EMF, etc. ) required by Smooks dev tools. </para>
+
+ <para>Now let's progress to more advanced topics.</para>
</section>
+
</chapter>
Modified: branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/quick_start.xml
===================================================================
--- branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/quick_start.xml 2009-05-11 16:42:22 UTC (rev 15210)
+++ branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/quick_start.xml 2009-05-11 16:42:46 UTC (rev 15211)
@@ -12,7 +12,7 @@
<title>Quick Start</title>
<para> This "Quick Start" will show how to use the <property>Smooks tools</property> to create/edit the Smooks
configuration file for Java2Java data transformation.</para>
- <para> This chapter should give you a brief understanding of the <property>Smooks dev tools</property>.</para>
+ <para> This chapter gives you a brief understanding of the <property>Smooks tools</property>.</para>
<section>
<title>Download Smooks Java-to-Java Example</title>
<para> Visit <ulink
@@ -21,14 +21,14 @@
<tip>
<title>Tip:</title>
- <para> The example project is base on Maven, you suggest you to create a new eclipse
- Java project and copy the example code and .jar files from the example project paste
+ <para> The example project is based on Maven, we suggest you to create a new eclipse
+ Java project, copy the example code and .jar files from the example project and paste
them into the eclipse Java project. </para>
</tip>
</section>
<section>
<title>Smooks Configuration File Wizard</title>
- <para>Select the Smooks Java-to-Java example project what you created and right-click,
+ <para>Select the Smooks Java-to-Java example project that you created and right-click,
select the menu <emphasis><property>New > Other</property>,</emphasis> then find
<emphasis><property>Smooks > Smooks Configuration File</property>.</emphasis>
Click the <emphasis>
@@ -141,7 +141,7 @@
</entry>
<entry>
<para>If there are any errors when you are editing the file, the
- Problems area will display them</para>
+ Problems area displays them</para>
</entry>
</row>
@@ -150,7 +150,7 @@
<para>Source data tree</para>
</entry>
<entry>
- <para>The tree will display the structure of transformed source
+ <para>The tree displays a structure of the transformed source
data</para>
</entry>
</row>
@@ -160,7 +160,7 @@
<para>Target data tree</para>
</entry>
<entry>
- <para>The tree will display the structure of transformed target
+ <para>The tree displays a structure of the transformed target
data</para>
</entry>
</row>
@@ -180,7 +180,7 @@
</entry>
<entry>
<para>Click the link, and <link linkend="graphicaleditor_datalink"
- >Data Selection wizard</link> will be opened helping you to
+ >Data Selection wizard</link> is opened helping you to
choose the source/target data</para>
</entry>
</row>
@@ -209,11 +209,11 @@
</listitem>
</itemizedlist>
- <para>After clicking the link the <property>Data Type Selection wizard</property> will be
+ <para>After clicking the link the <property>Data Type Selection wizard</property> is
opened, and there are two data types on the list: Java and XML.</para>
<note>
<title>Note</title>
- <para> There will be more and more data types on the list as the development went on.
+ <para> There will become more and more data types on the list as the development goes on.
</para>
</note>
@@ -242,7 +242,7 @@
<para>When you select all the necessary java classes, click <emphasis>
<property>Finish</property>
- </emphasis> and the structure of the java class will be displayed on the source/target
+ </emphasis> and the structure of the java class is displayed on the source/target
data tree.</para>
<figure>
<title>Displaying the Structure of the Transformed Data</title>
@@ -323,13 +323,13 @@
</figure>
<para> Please, click <emphasis>
<property>Yes</property>
- </emphasis> to connect the root node. If you don't do that, this dialog will be
+ </emphasis> to connect the root node. If you don't do that, this dialog is
opened again when you connect other nodes.</para>
<note>
<title>Note:</title>
- <para>Please, remember that: The root nodes of the source data and target data *MUST* be
+ <para>Please, remember that the root nodes of the source data and target data *MUST* be
connected.</para>
- <para>This rule is not only for Java-to-Java, but the same is also relevant for
+ <para>This rule is not only for Java-to-Java, but also is relevant for
XML-to-Java </para>
</note>
<para> Now let's do the same operation with the <emphasis>
@@ -349,7 +349,7 @@
<property>"price"</property>
</emphasis> and drag it onto the <emphasis>
<property>"unitPrice"</property>
- </emphasis> of the other side tree viewer. The Problems area will show an
+ </emphasis> of the other side tree viewer. The Problems area shows an
error:</para>
<figure>
<title>Connection Error 1</title>
@@ -417,7 +417,7 @@
</imageobject>
</mediaobject>
</figure>
- <para>Now, you should save the file and the <property>Smooks tools</property> will generate the correct
+ <para>Now, you should save the file and the <property>Smooks tools</property> generate the correct
configuration file content.</para>
<para>OK, let run the test class: <property>example.Main</property>. (Please, make sure that the Smooks engine
loads the correct configuration file).</para>
Modified: branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/smooksformeditor_configurationpage.xml
===================================================================
--- branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/smooksformeditor_configurationpage.xml 2009-05-11 16:42:22 UTC (rev 15210)
+++ branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/smooksformeditor_configurationpage.xml 2009-05-11 16:42:46 UTC (rev 15211)
@@ -9,7 +9,8 @@
</keywordset>
</chapterinfo>
<title>Smooks Configuration Editor Page</title>
- <para> Smooks Configuration Editor Page is one tab of the <property>Smooks Editor</property>. </para>
+ <para>In this section you will explore the details of Smooks Configuration Editor usage</para>
+ <para><property>Smooks Configuration Editor</property> is one tab of the <property>Smooks Editor</property>. </para>
<figure>
<title>Graphical Editor</title>
<mediaobject>
@@ -20,9 +21,9 @@
</figure>
<para> You can add/edit/remove the <link linkend="configurationpage_datedecoder">Date
- Decoder</link> on the Сonfiguration page of the <property>Smooks Editor</property>. </para>
- <para> The configuration also edit the <link linkend="configurationpage_parsetype">Smooks parse
- type</link> and manage the <link linkend="configurationpage_importfile">Import
+ Decoder</link> on the Configuration page of the <property>Smooks Editor</property>. </para>
+ <para> The configuration editor also edits the <link linkend="configurationpage_parsetype">Smooks parse
+ type</link> and manages the <link linkend="configurationpage_importfile">Import
Files</link>.</para>
<section id="configurationpage_parsetype">
@@ -40,7 +41,7 @@
</imageobject>
</mediaobject>
</figure>
- <para> Select the radio button to change the Smooks parse type. </para>
+ <para>Select the needed radio button to change the Smooks parse type. </para>
</section>
<section id="configurationpage_importfile">
@@ -49,17 +50,8 @@
<property>Other Configurations</property>
</emphasis> section, there is an <emphasis>
<property>Import Files</property>
- </emphasis> list under the Smooks parse type buttons.</para>
+ </emphasis> list under the Smooks parse type buttons (see the figure above).</para>
- <figure>
- <title>Import File</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/config_page/config_page2.png" scale="90"/>
- </imageobject>
- </mediaobject>
- </figure>
-
<para>There are three buttons on the right side of the <emphasis>
<property>File Import</property>
</emphasis> list. You can click those to add/edit/remove the import files.</para>
@@ -67,9 +59,9 @@
<tip>
<title>Tip:</title>
- <para> If the import file dosen't exist, the image of the import file will change to
+ <para> If the import file doesn&t exist, the image of the import file is changed to
"Error Image". If you double-click the import file in the Import File list, the file
- will be open with a new default editor. </para>
+ is opened with a new default editor. </para>
</tip>
</section>
@@ -106,16 +98,16 @@
<itemizedlist>
<listitem>
- <para>locale-language</para>
-
+ <para>Format</para>
</listitem>
-
+
<listitem>
- <para>format</para>
+ <para>Locale-Language</para>
+
</listitem>
<listitem>
- <para>locale-country</para>
+ <para>Locale-Country</para>
</listitem>
</itemizedlist>
@@ -128,15 +120,16 @@
<title>Date Decoder Detail Page</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/config_page/config_page5.png" scale="90"/>
+ <imagedata fileref="images/config_page/config_page1.png" scale="90"/>
</imageobject>
</mediaobject>
</figure>
<para> When you defined a new <emphasis>
- <property>Date Decoder</property></emphasis>, they can use the <link
- linkend="graphicalpage_propertiesview">JavaBean Properties</link> GUI to set the
- them to be the "Java type".</para>
+ <property>Date Decoder</property></emphasis>, then you can use the <link
+ linkend="graphicalpage_propertiesview">JavaBean Properties</link> GUI to set
+ it to be the "Java type".</para>
+ <para>Now when we've learnt Smooks Configuration Editor Page, let's have a look at one more Smooks Editor Page - Smooks Source Editor Page and investigate its functionality</para>
<!--
<para> The XML fragment generated by Smooks tools for the "Date
Modified: branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/smooksformeditor_graphicalpage.xml
===================================================================
--- branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/smooksformeditor_graphicalpage.xml 2009-05-11 16:42:22 UTC (rev 15210)
+++ branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/smooksformeditor_graphicalpage.xml 2009-05-11 16:42:46 UTC (rev 15211)
@@ -9,7 +9,7 @@
</keywordset>
</chapterinfo>
<title>Smooks Graphical Editor Page</title>
-
+ <para>This chapter is packed with useful information about Smooks Graphical Editor Page usage</para>
<para>Smooks Graphical Editor page is one tab of the <property>Smooks Editor</property>.</para>
<figure>
<title>Graphical Editor</title>
@@ -22,18 +22,37 @@
<para> This <property>Graphical editor</property> allows you to perform drug/drop operations
with the nodes of transform data to map the source data to target data. </para>
- <para> When you save the changes in the Graphical editor the correct Smooks Configuration file
- content will be generated. </para>
+ <para> When you save the changes in the <property>Graphical editor</property> the correct Smooks
+ Configuration file content is generated. </para>
+
+ <para>To adjust the properties of the connection lines in the editor, you should use the <link
+ linkend="graphicalpage_propertiesview">Properties view</link> (activate it by following
+ to <emphasis>
+ <property>Window > Show View > Other > General > Properties</property>).</emphasis></para>
+
+ <para>For example, if you defined a date decoder in the <link
+ linkend="configurationpage_datedecoder">Smooks Configuration Editor</link>, in the <property>Properties view</property> you can
+ select it as a Mapping type for the "Date" type element.</para>
+
+ <figure>
+ <title>Browsing Custom Type for the Date Type Element</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/graph_editor/graph_editor1a.png" scale="90"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
<section>
<title>Introducing the areas of graphical editor</title>
- <para>Information on the topic could be found in the <link linkend="quickstart_formeditor">Quick Start/Smooks Editor</link> section.</para>
+ <para>Information on the topic could be found in the <link linkend="quickstart_formeditor"
+ >Quick Start/Smooks Editor</link> section.</para>
</section>
<section>
<title>Load Source/Target Data</title>
- <para> Click the links under the data view, the <property>Data Type Selection wizard</property> page will be
- shown.</para>
+ <para> Click the links under the data view, the <property>Data Type Selection
+ wizard</property> page will be shown.</para>
<figure>
<title>Data Type Selection Wizard Page</title>
<mediaobject>
@@ -77,7 +96,7 @@
</figure>
<para> When you finish the data selection (file path selection), click
- <emphasis><property>Finish</property>,</emphasis> the data view will display the
+ <emphasis><property>Finish</property>,</emphasis> the data view displays the
selected data structure.</para>
</section>
<section>
@@ -93,8 +112,8 @@
file content with "Mapping Logic". If there are any errors of the configuration file
content, error messages are shown in the <link linkend="quickstart_formeditor">Problems
area</link>.</para>
- <para> Please, read the <link linkend="quickstart_mapping">Quick Start/Mapping</link> section to
- find how to fix the errors.</para>
+ <para> Please, read the <link linkend="quickstart_mapping">Quick Start/Mapping</link>
+ section to find how to fix the errors.</para>
</section>
<section id="graphicalpage_propertiesview">
<title>Properties View</title>
@@ -104,8 +123,8 @@
<para>Navigate to <emphasis><property>Window > Show View > Other >
Properties</property>,</emphasis> to open the <property>Properties
view</property>.</para>
- <para> When you select on the connection lines, the <property>Properties view</property>
- will show a set of section GUI for editing the properties of the connection line.</para>
+ <para> When you select the connection line, the <property>Properties view</property> will
+ show a set of section GUI for editing its properties.</para>
<tip>
<title>Tip:</title>
@@ -119,7 +138,7 @@
"Java", the XML Properties section GUI isn't
displayed.</para>
<para>It means that if the source/target data type of the selected connection line is
- different, the <property>Properties view</property> shows different GUI.</para>
+ different, the <property>Properties view</property> shows a different GUI.</para>
</tip>
<figure>
<title>JavaBean Properties Section</title>
@@ -147,5 +166,7 @@
</imageobject>
</mediaobject>
</figure>
+
+ <para>To discover about other Editor pages, read the next chapters</para>
</section>
</chapter>
Modified: branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/smooksformeditor_sourcepage.xml
===================================================================
--- branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/smooksformeditor_sourcepage.xml 2009-05-11 16:42:22 UTC (rev 15210)
+++ branches/jbosstools-3.0.x/smooks/docs/reference/en/modules/smooksformeditor_sourcepage.xml 2009-05-11 16:42:46 UTC (rev 15211)
@@ -9,6 +9,7 @@
</keywordset>
</chapterinfo>
<title>Smooks Source Editor Page</title>
+ <para>This section provides information about Smooks Source Editor Page</para>
<section>
<title>XML Source Editor</title>
<para>You can use this editor to edit the Smooks Configuration file directly. </para>
@@ -25,7 +26,7 @@
<title>Error Messages GUI</title>
<para>If the <property>Smooks tools</property> can't understand the configuration
file or the configuration file is illegal (XML structure isn't right for Smooks
- Configuration file, etc.), the error will be underlined.</para>
+ Configuration file, etc.), the error is underlined.</para>
<figure>
<title>Graphical Editor</title>
<mediaobject>
@@ -41,6 +42,7 @@
<para> You can't edit the configuration file with other editors until file becomes
valid. </para>
</note-->
-
+ <para>We hope, our guide will help you to get started with JBoss Smooks Tools. Besides, for additional information you are welcome on <ulink
+ url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201">JBoss forum</ulink>.</para>
</section>
</chapter>
Modified: branches/jbosstools-3.0.x/smooks/docs/reference/pom.xml
===================================================================
--- branches/jbosstools-3.0.x/smooks/docs/reference/pom.xml 2009-05-11 16:42:22 UTC (rev 15210)
+++ branches/jbosstools-3.0.x/smooks/docs/reference/pom.xml 2009-05-11 16:42:46 UTC (rev 15211)
@@ -86,6 +86,11 @@
<version>1.1.0</version>
<type>jdocbook-style</type>
</dependency>
+ <dependency>
+ <groupId>org.apache.xmlgraphics</groupId>
+ <artifactId>fop</artifactId>
+ <version>0.95</version>
+ </dependency>
</dependencies>
<configuration>
15 years, 5 months
JBoss Tools SVN: r15210 - branches/jbosstools-3.0.x/smooks/docs/reference/en/images/graph_editor.
by jbosstools-commits@lists.jboss.org
Author: smukhina
Date: 2009-05-11 12:42:22 -0400 (Mon, 11 May 2009)
New Revision: 15210
Added:
branches/jbosstools-3.0.x/smooks/docs/reference/en/images/graph_editor/graph_editor1a.png
Log:
https://jira.jboss.org/jira/browse/JBDS-717 merged changes from trunk are added to the corresponding branch
Copied: branches/jbosstools-3.0.x/smooks/docs/reference/en/images/graph_editor/graph_editor1a.png (from rev 15128, trunk/smooks/docs/reference/en/images/graph_editor/graph_editor1a.png)
===================================================================
(Binary files differ)
15 years, 5 months
JBoss Tools SVN: r15209 - branches/jbosstools-3.0.x/smooks/docs/reference/en.
by jbosstools-commits@lists.jboss.org
Author: smukhina
Date: 2009-05-11 12:42:15 -0400 (Mon, 11 May 2009)
New Revision: 15209
Added:
branches/jbosstools-3.0.x/smooks/docs/reference/en/master_output.xml
Removed:
branches/jbosstools-3.0.x/smooks/docs/reference/en/master_output.xml
Log:
https://jira.jboss.org/jira/browse/JBDS-717 merged changes from trunk are added to the corresponding branch
Deleted: branches/jbosstools-3.0.x/smooks/docs/reference/en/master_output.xml
===================================================================
--- branches/jbosstools-3.0.x/smooks/docs/reference/en/master_output.xml 2009-05-11 16:41:39 UTC (rev 15208)
+++ branches/jbosstools-3.0.x/smooks/docs/reference/en/master_output.xml 2009-05-11 16:42:15 UTC (rev 15209)
@@ -1,905 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-"http://www.docbook.org/xml/4.3/docbookx.dtd"
-
-[
-<!ENTITY introduction SYSTEM "modules/introduction.xml">
-<!ENTITY quickstart SYSTEM "modules/quick_start.xml">
-<!ENTITY smooksformeditor_graphicaltab SYSTEM "modules/smooksformeditor_graphicalpage.xml">
-<!ENTITY smooksformeditor_configurationtab SYSTEM "modules/smooksformeditor_configurationpage.xml">
-<!ENTITY smooksformeditor_sourcetab SYSTEM "modules/smooksformeditor_sourcepage.xml">
-]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff">
-
- <bookinfo>
-
- <title>Smooks Dev Tools Reference Guide</title>
- <author>
- <firstname>Xue(Dart)</firstname>
- <surname>Peng</surname>
- </author>
-
- <pubdate>November 2008</pubdate>
- <copyright>
- <year>2008</year>
- <holder>JBoss, a division of Red Hat Inc.</holder>
- </copyright>
- <releaseinfo><diffmk:wrapper diffmk:change="changed">
- Version: 1.0.0.CR1
- </diffmk:wrapper></releaseinfo>
-
- <abstract>
- <title></title>
- <para>
- <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/smooks/pdf/Smooks_Re...">PDF version</ulink>
- </para>
- </abstract>
-
-
- </bookinfo>
- <toc></toc>
-
-<chapter id="introduction" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/smooks/docs/reference/en/modules/introduction.xml">
- <?dbhtml filename="introduction.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Tools</keyword>
- <keyword>Smooks</keyword>
- <keyword>JBDS</keyword>
- </keywordset>
- </chapterinfo>
- <title>Introduction</title>
- <section diffmk:change="added">
- <title>What is Smooks?</title>
-
- <para><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Smooks</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> is a Java Framework/Engine for processing XML and non XML
- data (CSV, EDI, Java, JSON etc).</diffmk:wrapper></para>
- <para></para>
- <para>
- <orderedlist continuation="restarts" inheritnum="inherit" numeration="upperroman">
- <listitem>
- <para><emphasis diffmk:change="added" role="bold"><diffmk:wrapper diffmk:change="added">Transformation</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added">: Perform a wide range of
- Data Transforms. Supports many different Source and Result types
- -XML/CSV/EDI/Java/JSON to XML/CSV/EDI/Java/JSON.</diffmk:wrapper></para>
- </listitem>
- <listitem>
- <para><emphasis diffmk:change="added" role="bold"><diffmk:wrapper diffmk:change="added">Java Binding</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added">: Bind into a Java Object
- Model from any data source (CSV, EDI, XML, Java, JSON etc). </diffmk:wrapper></para>
- </listitem>
-
- <listitem>
- <para><emphasis diffmk:change="added" role="bold"><diffmk:wrapper diffmk:change="added">Huge Message Processing</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added">: Process huge
- messages (GBs) - Split, Transform and Route message fragments to JMS, File,
- Database etc destinations. Route multiple message formats to multiple
- destinations in a single pass over a message. </diffmk:wrapper></para>
- </listitem>
-
- <listitem>
- <para><emphasis diffmk:change="added" role="bold"><diffmk:wrapper diffmk:change="added">Message Enrichment</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added">: Enrich a message with
- data from a Database, or other Datasources. </diffmk:wrapper></para>
- </listitem>
-
- <listitem>
- <para><emphasis diffmk:change="added" role="bold"><diffmk:wrapper diffmk:change="added">Combine</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added">: Combine the above features in
- different ways e.g. add Message Enrichment as part of a Splitting and
- Routing process. </diffmk:wrapper></para>
- </listitem>
- </orderedlist>
- </para>
- <figure float="0">
- <title>Smooks</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/introduction/introduction1.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para><diffmk:wrapper diffmk:change="added"> For More informations about </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Smooks</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, please visit </diffmk:wrapper><ulink url="http://www.smooks.org">Smooks official site</ulink><diffmk:wrapper diffmk:change="changed">.</diffmk:wrapper></para>
- </section>
- <section diffmk:change="added">
- <title>What is Smooks dev tools?</title>
-
- <para><diffmk:wrapper diffmk:change="changed">Smooks dev tools is a set of graphical tools for editing Smooks configuration file
- base on Eclipse.</diffmk:wrapper></para>
- <figure float="0">
- <title>Smooks form editor</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/introduction/introduction2.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section diffmk:change="added">
- <title>How to install Smooks dev tools?</title>
-
- <para><diffmk:wrapper diffmk:change="added"> The Smooks dev tools was included by the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> since 3.0.0
- Beta1 version. You can download the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> from </diffmk:wrapper><ulink url="http://www.jboss.org/tools/download/index.html"><diffmk:wrapper diffmk:change="changed">here</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="changed">.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="added"> Smooks dev tools (</diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">) run with the latest Eclipse and
- other required plug-ins (GEF, EMF, etc.).</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="changed"> You should download the latest IDE for Java EE developers from this </diffmk:wrapper><ulink url="http://www.eclipse.org/downloads/"><diffmk:wrapper diffmk:change="changed">site</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="changed">. It contains many plug-ins (
- GEF, EMF, etc. ) required by Smooks dev tools. </diffmk:wrapper></para>
- </section>
-</chapter>
-
-
-<chapter id="quickstart" role="updated" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/smooks/docs/reference/en/modules/quick_start.xml" xreflabel="Quick Start">
- <?dbhtml filename="quick_start.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Tools</keyword>
- <keyword>Smooks</keyword>
- <keyword>JBDS</keyword>
- <keyword>java</keyword>
- </keywordset>
- </chapterinfo>
- <title>Quick Start</title>
- <para><diffmk:wrapper diffmk:change="added"> This "Quick Start" will show how to use the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Smooks tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> to create/edit the Smooks
- configuration file for Java2Java data transformation.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="added"> This chapter should give you a brief understanding of the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Smooks dev tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
- <section>
- <title><diffmk:wrapper diffmk:change="changed">Download Smooks Java-to-Java Example</diffmk:wrapper></title>
- <para><diffmk:wrapper diffmk:change="changed"> Visit </diffmk:wrapper><ulink url="http://www.smooks.org/documentation/documentation-smooks-1-1-x/examples/e...">here</ulink><diffmk:wrapper diffmk:change="changed"> to download the "java-to-java" example project. </diffmk:wrapper></para>
- <tip>
- <title>Tip:</title>
-
- <para><diffmk:wrapper diffmk:change="changed"> The example project is base on Maven, you suggest you to create a new eclipse
- Java project and copy the example code and .jar files from the example project paste
- them into the eclipse Java project. </diffmk:wrapper></para>
- </tip>
- </section>
- <section>
- <title><diffmk:wrapper diffmk:change="changed">Smooks Configuration File Wizard</diffmk:wrapper></title>
- <para><diffmk:wrapper diffmk:change="added">Select the Smooks Java-to-Java example project what you created and right-click,
- select the menu </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">New > Other</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">,</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> then find
- </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Smooks > Smooks Configuration File</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added">
- Click the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Next</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> button. </diffmk:wrapper></para>
- <figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Selecting Smooks Configuration File Wizard</diffmk:wrapper></title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/quick_start/quick_start1.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para><diffmk:wrapper diffmk:change="added">The first wizard page is a file path creation page. Select the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">src</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> folder to be the files container, and input the name
- </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">newConfig.smooks</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> Click
- </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Next</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para>
- <figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Choosing the configuration file container and the file name</diffmk:wrapper></title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/quick_start/quick_start2.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para>The second wizard page is a transform data type choose page.</para>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added"> As the quick start introduces how to create/edit the Java-to-Java Smooks
- configuration file, let's select the</diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Java-to-Java</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> type as the source/target transform data type. </diffmk:wrapper></para>
-
- <figure diffmk:change="added" float="0">
- <title><diffmk:wrapper diffmk:change="changed">Selecting Data Type</diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/quick_start/quick_start3.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para><diffmk:wrapper diffmk:change="added">On the next page you are prompted to choose the source data for transformation.
- Let's select the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Order</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> class from the example project as
- the source JavaBean class.</diffmk:wrapper></para>
-
- <figure diffmk:change="added" float="0">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Selecting the Source Data</diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/quick_start/quick_start4.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Then the wizard page asks you to choose the target data for transformation. We select
- the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">ListOrder</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> class as the target JavaBean class.</diffmk:wrapper></para>
- <figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Selecting the Target Data</diffmk:wrapper></title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/quick_start/quick_start5.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para diffmk:change="added"></para>
-
- <tip diffmk:change="added">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Tip:</diffmk:wrapper></title>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You can omit two these steps and just press
- </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> This will open the empty
- Smooks Configuration file. It's possible to </diffmk:wrapper><link diffmk:change="added" linkend="graphicaleditor_datalink"><diffmk:wrapper diffmk:change="added">select source/target data</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added"> afterwards
- in the Smooks Graph editor.</diffmk:wrapper></para>
- </tip>
- </section>
- <section id="quickstart_formeditor">
- <title><diffmk:wrapper diffmk:change="changed">Smooks Editor</diffmk:wrapper></title>
-
- <para><diffmk:wrapper diffmk:change="added">When all the wizard steps are passed, a new Smooks Configuration file is created and
- the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Smooks Editor</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> will be opened automatically:</diffmk:wrapper></para>
- <figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Smooks Editor</diffmk:wrapper></title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/quick_start/quick_start6.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para><diffmk:wrapper diffmk:change="added"> This editor contains several parts: </diffmk:wrapper><table diffmk:change="added">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">The Smooks Editor Parts</diffmk:wrapper></title>
- <tgroup cols="2" diffmk:change="added">
-
- <colspec align="left" colnum="1" colwidth="1*" diffmk:change="added"></colspec>
- <colspec colnum="2" colwidth="5*" diffmk:change="added"></colspec>
-
- <thead diffmk:change="added">
- <row diffmk:change="added">
- <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Editor feature</diffmk:wrapper></entry>
- <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Functionality</diffmk:wrapper></entry>
- </row>
- </thead>
-
- <tbody diffmk:change="added">
-
- <row diffmk:change="added">
- <entry diffmk:change="added">
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Problems area</diffmk:wrapper></para>
- </entry>
- <entry diffmk:change="added">
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">If there are any errors when you are editing the file, the
- Problems area will display them</diffmk:wrapper></para>
- </entry>
- </row>
-
- <row diffmk:change="added">
- <entry diffmk:change="added">
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Source data tree</diffmk:wrapper></para>
- </entry>
- <entry diffmk:change="added">
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The tree will display the structure of transformed source
- data</diffmk:wrapper></para>
- </entry>
- </row>
-
- <row diffmk:change="added">
- <entry diffmk:change="added">
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Target data tree</diffmk:wrapper></para>
- </entry>
- <entry diffmk:change="added">
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The tree will display the structure of transformed target
- data</diffmk:wrapper></para>
- </entry>
- </row>
-
- <row diffmk:change="added">
- <entry diffmk:change="added">
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Mapping graphical area</diffmk:wrapper></para>
- </entry>
- <entry diffmk:change="added">
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Show the data mapping connection lines</diffmk:wrapper></para>
- </entry>
- </row>
-
- <row diffmk:change="added">
- <entry diffmk:change="added">
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Source/Target data selection links</diffmk:wrapper></para>
- </entry>
- <entry diffmk:change="added">
- <para><diffmk:wrapper diffmk:change="changed">Click the link, and </diffmk:wrapper><link linkend="graphicaleditor_datalink"><diffmk:wrapper diffmk:change="changed">Data Selection wizard</diffmk:wrapper></link><diffmk:wrapper diffmk:change="changed"> will be opened helping you to
- choose the source/target data</diffmk:wrapper></para>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- </para>
- </section>
-
- <section id="graphicaleditor_datalink">
- <title><diffmk:wrapper diffmk:change="changed">Choosing the Source/Target Data</diffmk:wrapper></title>
-
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">To choose the transform data you should make use of the data selection links:</diffmk:wrapper></para>
-
- <itemizedlist diffmk:change="added">
- <listitem diffmk:change="added">
- <para diffmk:change="added"><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Source Select</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> for selecting source data</diffmk:wrapper></para>
- </listitem>
-
- <listitem diffmk:change="added">
- <para diffmk:change="added"><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Target Select</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> for selecting target data</diffmk:wrapper></para>
- </listitem>
- </itemizedlist>
-
- <para><diffmk:wrapper diffmk:change="added">After clicking the link the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Data Type Selection wizard</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> will be
- opened, and there are two data types on the list: Java and XML.</diffmk:wrapper></para>
- <note diffmk:change="added">
- <title>Note</title>
- <para><diffmk:wrapper diffmk:change="changed"> There will be more and more data types on the list as the development went on.
- </diffmk:wrapper></para>
- </note>
-
- <figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Data Type Wizard</diffmk:wrapper></title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/quick_start/quick_start7.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para><diffmk:wrapper diffmk:change="added">Select the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Java</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> data type and click </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Next</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">,</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> you will
- see the JavaBean class selection page:</diffmk:wrapper></para>
-
- <figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">JavaBean Data Selection</diffmk:wrapper></title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/quick_start/quick_start8.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para><diffmk:wrapper diffmk:change="added">When you select all the necessary java classes, click </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> and the structure of the java class will be displayed on the source/target
- data tree.</diffmk:wrapper></para>
- <figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Displaying the Structure of the Transformed Data</diffmk:wrapper></title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/quick_start/quick_start9.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
-
- <section id="quickstart_mapping">
- <title>Mapping</title>
-
- <para><diffmk:wrapper diffmk:change="changed"> As you see, the source/target data tree displays the structure of the java class. </diffmk:wrapper></para>
- <para>How to map it?</para>
-
- <para><diffmk:wrapper diffmk:change="added">First, you should know what to transform:</diffmk:wrapper></para>
-
- <orderedlist continuation="restarts" inheritnum="inherit" numeration="loweralpha">
- <listitem>
- <para><diffmk:wrapper diffmk:change="added">Bind the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"customerName"</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> property of the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Order#header</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> to the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"customerName"</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> property of </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">LineOrder</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
- </listitem>
- <listitem>
- <para><diffmk:wrapper diffmk:change="added">Bind the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"customerNumber"</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> property of the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Order#header</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> to the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"customerId"</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> property of </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">LineOrder</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
- </listitem>
- <listitem>
- <para><diffmk:wrapper diffmk:change="added">Bind the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"price"</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> property of the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">OrderItem</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> to the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"unitPrice"</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> property of </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">LineItem</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
- </listitem>
- <listitem>
- <para><diffmk:wrapper diffmk:change="added">Bind the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"productId"</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> property of the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">OrderItem</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> to the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"productCode"</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> property of </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">LineItem</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
- </listitem>
- <listitem>
- <para><diffmk:wrapper diffmk:change="added">Bind the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"quantity"</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> property of the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">OrderItem</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> to the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"unitQuantity"</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> property of </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">LineItem</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
- </listitem>
- </orderedlist>
-
- <para><diffmk:wrapper diffmk:change="changed"> Make sense?</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="added"> OK, let's select the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"customerName"</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> item of the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"header"</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> item on the source data tree and start to drag it. When the drag item
- crosses the Mapping graphical area, you will see a connection line. Drop the item onto
- the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"customerName"</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> of the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">LineOrder</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> on the target data
- view.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="changed"> Now a dialog is opened asking you to connect the root node:</diffmk:wrapper></para>
-
- <figure float="0">
- <title>Dialog Asking You to Connect to the Root Nodes</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/quick_start/quick_start10.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para><diffmk:wrapper diffmk:change="added"> Please, click </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Yes</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> to connect the root node. If you don't do that, this dialog will be
- opened again when you connect other nodes.</diffmk:wrapper></para>
- <note diffmk:change="added">
- <title><diffmk:wrapper diffmk:change="changed">Note:</diffmk:wrapper></title>
- <para><diffmk:wrapper diffmk:change="changed">Please, remember that: The root nodes of the source data and target data *MUST* be
- connected.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="changed">This rule is not only for Java-to-Java, but the same is also relevant for
- XML-to-Java </diffmk:wrapper></para>
- </note>
- <para><diffmk:wrapper diffmk:change="added"> Now let's do the same operation with the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"customerNumber"</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">,</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> that is what you
- should see:</diffmk:wrapper></para>
- <figure float="0">
- <title>Correctly Mapping Editor</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/quick_start/quick_start11.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para><diffmk:wrapper diffmk:change="added">Next, you are going to bind the properties of the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">OrderItem</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> to
- the properties of the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">LineItem</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="added">Select the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"price"</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> and drag it onto the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"unitPrice"</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> of the other side tree viewer. The Problems area will show an
- error:</diffmk:wrapper></para>
- <figure float="0">
- <title>Connection Error 1</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/quick_start/quick_start12.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para><diffmk:wrapper diffmk:change="changed">How to deal with the error?</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="added">Please click the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Fix it</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> link, a menu is popped-up with several
- resolve methods on it.</diffmk:wrapper></para>
- <figure diffmk:change="added" float="0">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Fixing the Connection Error</diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/quick_start/quick_start13.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para><diffmk:wrapper diffmk:change="added"> Select the first resolve method: </diffmk:wrapper><emphasis diffmk:change="added"><diffmk:wrapper diffmk:change="added">
- 'Connect the "OrderItem" to the
- "LineItem" '.</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> As the result the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"OrderItem"</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> is connected with
- the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"LineItem"</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para>
- <para><diffmk:wrapper diffmk:change="changed">But the notify message area still shows some other errors:</diffmk:wrapper></para>
- <figure float="0">
- <title>Connection Error 2</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/quick_start/quick_start14.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para><diffmk:wrapper diffmk:change="added">OK, let's deal with the fire error. Click the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Fix it</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> link and
- select the first resolve method. The </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"orderItems"</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> is connected with
- the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"lineItems"</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para>
-
- <tip>
- <title><diffmk:wrapper diffmk:change="changed">Tip:</diffmk:wrapper></title>
- <para><diffmk:wrapper diffmk:change="changed"> Why does the error occur?</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="changed"> You will find that, if you only connect the property node without connecting the
- parent node of the property, the "connection error" occurs.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="changed">The connection of the "price-to-unitPrice" is the
- "Binding Connection", but it needs an "Instance Creation
- Connection" - the connection of the
- "OrderItem-to-LineItem".</diffmk:wrapper></para>
- </tip>
- <para><diffmk:wrapper diffmk:change="added"> After that, connect </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"quantity"</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> to the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"unitQuantity"</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> and </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"productId"</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> to the
- </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"productCode"</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">:</diffmk:wrapper></emphasis></para>
- <figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Complete Mapping</diffmk:wrapper></title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/quick_start/quick_start15.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para><diffmk:wrapper diffmk:change="added">Now, you should save the file and the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Smooks tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> will generate the correct
- configuration file content.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="added">OK, let run the test class: </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">example.Main</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">. (Please, make sure that the Smooks engine
- loads the correct configuration file).</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="changed">Success!</diffmk:wrapper></para>
- </section>
-</chapter>
-
-
-<chapter id="smooksformeditor_graphicaltab" role="updated" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/smooks/docs/reference/en/modules/smooksformeditor_graphicalpage.xml" xreflabel="Smooks Graphical Editor Page">
- <?dbhtml filename="smooks_form_editor_graphicaltab.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Tools</keyword>
- <keyword>Smooks</keyword>
- <keyword>JBDS</keyword>
- </keywordset>
- </chapterinfo>
- <title>Smooks Graphical Editor Page</title>
-
- <para><diffmk:wrapper diffmk:change="added">Smooks Graphical Editor page is one tab of the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Smooks Editor</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
- <figure float="0">
- <title>Graphical Editor</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/graph_editor/graph_editor1.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para><diffmk:wrapper diffmk:change="added"> This </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Graphical editor</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> allows you to perform drug/drop operations
- with the nodes of transform data to map the source data to target data. </diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="changed"> When you save the changes in the Graphical editor the correct Smooks Configuration file
- content will be generated. </diffmk:wrapper></para>
- <section>
-
- <title><diffmk:wrapper diffmk:change="changed">Introducing the areas of graphical editor</diffmk:wrapper></title>
- <para><diffmk:wrapper diffmk:change="changed">Information on the topic could be found in the </diffmk:wrapper><link linkend="quickstart_formeditor"><diffmk:wrapper diffmk:change="changed">Quick Start/Smooks Editor</diffmk:wrapper></link><diffmk:wrapper diffmk:change="changed"> section.</diffmk:wrapper></para>
- </section>
- <section>
-
- <title><diffmk:wrapper diffmk:change="changed">Load Source/Target Data</diffmk:wrapper></title>
- <para><diffmk:wrapper diffmk:change="added"> Click the links under the data view, the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Data Type Selection wizard</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> page will be
- shown.</diffmk:wrapper></para>
- <figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Data Type Selection Wizard Page</diffmk:wrapper></title>
- <mediaobject>
- <imageobject>
-
- <imagedata fileref="images/graph_editor/graph_editor2.png" scale="90"/>
-
- </imageobject>
- </mediaobject>
- </figure>
-
- <para><diffmk:wrapper diffmk:change="added"> There are sets of transform data type on the wizard page, select one type and click
- </diffmk:wrapper><emphasis diffmk:change="added"><property moreinfo="none">Next</property><diffmk:wrapper diffmk:change="added">,</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> the data source selection wizard
- page will be shown.</diffmk:wrapper></para>
-
- <tip>
- <title><diffmk:wrapper diffmk:change="changed">Note:</diffmk:wrapper></title>
- <para><diffmk:wrapper diffmk:change="changed">For different data type, the Data source selection wizard are different too.
- </diffmk:wrapper></para>
- </tip>
- <figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Java Data Source Selection Wizard Page</diffmk:wrapper></title>
- <mediaobject>
- <imageobject>
-
- <imagedata fileref="images/graph_editor/graph_editor3.png" scale="90"/>
-
- </imageobject>
- </mediaobject>
- </figure>
-
- <figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">XML File Path Selection Wizard Page</diffmk:wrapper></title>
- <mediaobject>
- <imageobject>
-
- <imagedata fileref="images/graph_editor/graph_editor4.png" scale="90"/>
-
- </imageobject>
- </mediaobject>
- </figure>
-
- <para><diffmk:wrapper diffmk:change="added"> When you finish the data selection (file path selection), click
- </diffmk:wrapper><emphasis diffmk:change="added"><property moreinfo="none">Finish</property><diffmk:wrapper diffmk:change="added">,</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> the data view will display the
- selected data structure.</diffmk:wrapper></para>
- </section>
- <section>
-
- <title><diffmk:wrapper diffmk:change="changed">Using Graphical Editor for Mapping</diffmk:wrapper></title>
- <para><diffmk:wrapper diffmk:change="changed">To get information on the topic please, read the </diffmk:wrapper><link linkend="quickstart_mapping"><diffmk:wrapper diffmk:change="changed">Quick Start/Mapping</diffmk:wrapper></link><diffmk:wrapper diffmk:change="changed"> section. </diffmk:wrapper></para>
- </section>
- <section>
-
- <title><diffmk:wrapper diffmk:change="changed">Error Messages</diffmk:wrapper></title>
- <para><diffmk:wrapper diffmk:change="added">When you do any mapping operations, the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Smooks tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> validate the
- file content with "Mapping Logic". If there are any errors of the configuration file
- content, error messages are shown in the </diffmk:wrapper><link linkend="quickstart_formeditor"><diffmk:wrapper diffmk:change="changed">Problems
- area</diffmk:wrapper></link><diffmk:wrapper diffmk:change="changed">.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="changed"> Please, read the </diffmk:wrapper><link linkend="quickstart_mapping"><diffmk:wrapper diffmk:change="changed">Quick Start/Mapping</diffmk:wrapper></link><diffmk:wrapper diffmk:change="changed"> section to
- find how to fix the errors.</diffmk:wrapper></para>
- </section>
- <section id="graphicalpage_propertiesview">
- <title><diffmk:wrapper diffmk:change="changed">Properties View</diffmk:wrapper></title>
-
- <para><diffmk:wrapper diffmk:change="added"> You can edit the properties of the connection lines with the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Properties
- view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="added">Navigate to </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Window > Show View > Other >
- Properties</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">,</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> to open the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Properties
- view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="added"> When you select on the connection lines, the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Properties view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">
- will show a set of section GUI for editing the properties of the connection line.</diffmk:wrapper></para>
- <tip>
-
- <title><diffmk:wrapper diffmk:change="changed">Tip:</diffmk:wrapper></title>
- <para><diffmk:wrapper diffmk:change="added">This GUI on the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Properties view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> is displayed when the Smooks
- Graphical editor is active, if not, the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Properties view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">
- displays empty GUI.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="added">If the source data type of the selected connection line is
- "XML", the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Properties view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> shows an XML
- Properties section GUI.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="changed">But if the source data type of the selected connection line is
- "Java", the XML Properties section GUI isn't
- displayed.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="added">It means that if the source/target data type of the selected connection line is
- different, the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Properties view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> shows different GUI.</diffmk:wrapper></para>
- </tip>
- <figure float="0">
- <title>JavaBean Properties Section</title>
- <mediaobject>
- <imageobject>
-
- <imagedata fileref="images/graph_editor/graph_editor5.png" scale="90"/>
-
- </imageobject>
- </mediaobject>
- </figure>
- <figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">XML Properties Section</diffmk:wrapper></title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/graph_editor/graph_editor6.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Mapping Properties Section</diffmk:wrapper></title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/graph_editor/graph_editor7.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
-
-
-
-</chapter>
-<chapter id="smooksformeditor_configurationtab" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/smooks/docs/reference/en/modules/smooksformeditor_configurationpage.xml" xreflabel="Smooks Configuration Editor Page">
- <?dbhtml filename="smooks_form_editor_configurationtab.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Tools</keyword>
- <keyword>Smooks</keyword>
- <keyword>JBDS</keyword>
- </keywordset>
- </chapterinfo>
- <title>Smooks Configuration Editor Page</title>
- <para><diffmk:wrapper diffmk:change="added"> Smooks Configuration Editor Page is one tab of the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Smooks Editor</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">. </diffmk:wrapper></para>
- <figure float="0">
- <title>Graphical Editor</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/config_page/config_page1.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para><diffmk:wrapper diffmk:change="changed"> You can add/edit/remove the </diffmk:wrapper><link linkend="configurationpage_datedecoder"><diffmk:wrapper diffmk:change="changed">Date
- Decoder</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added"> on the Сonfiguration page of the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Smooks Editor</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">. </diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="changed"> The configuration also edit the </diffmk:wrapper><link linkend="configurationpage_parsetype"><diffmk:wrapper diffmk:change="changed">Smooks parse
- type</diffmk:wrapper></link><diffmk:wrapper diffmk:change="changed"> and manage the </diffmk:wrapper><link linkend="configurationpage_importfile"><diffmk:wrapper diffmk:change="changed">Import
- Files</diffmk:wrapper></link><diffmk:wrapper diffmk:change="changed">.</diffmk:wrapper></para>
-
- <section id="configurationpage_parsetype">
-
- <title><diffmk:wrapper diffmk:change="changed">Smooks Parse Type</diffmk:wrapper></title>
- <para><diffmk:wrapper diffmk:change="added">Open the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Other Configurations</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> section, we will see there is a set of radio buttons:</diffmk:wrapper></para>
-
- <figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Smooks Parse Types</diffmk:wrapper></title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/config_page/config_page2.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para><diffmk:wrapper diffmk:change="changed"> Select the radio button to change the Smooks parse type. </diffmk:wrapper></para>
- </section>
- <section id="configurationpage_importfile">
-
- <title><diffmk:wrapper diffmk:change="changed">Import File</diffmk:wrapper></title>
- <para><diffmk:wrapper diffmk:change="added"> Open the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Other Configurations</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> section, there is an </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Import Files</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> list under the Smooks parse type buttons.</diffmk:wrapper></para>
-
- <figure float="0">
- <title>Import File</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/config_page/config_page2.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para><diffmk:wrapper diffmk:change="added">There are three buttons on the right side of the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">File Import</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> list. You can click those to add/edit/remove the import files.</diffmk:wrapper></para>
-
- <tip>
-
- <title><diffmk:wrapper diffmk:change="changed">Tip:</diffmk:wrapper></title>
- <para><diffmk:wrapper diffmk:change="changed"> If the import file dosen't exist, the image of the import file will change to
- "Error Image". If you double-click the import file in the Import File list, the file
- will be open with a new default editor. </diffmk:wrapper></para>
-
- </tip>
- </section>
- <section id="configurationpage_datedecoder">
- <title>Date Decoder Detail Page</title>
-
- <para><diffmk:wrapper diffmk:change="changed">Date Decoder is a resourceConfig element in the Smooks configuration file. It
- describes how to transform the "Date" type.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="added"> Click the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">New</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> button to open the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">New Resource Type wizard</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">
- dialog.</diffmk:wrapper></para>
- <figure float="0">
- <title>Resource Type Selection Wizard</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/config_page/config_page4.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para><diffmk:wrapper diffmk:change="added">There are several resource type on the list. Select the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Date Decoder</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> and click the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> button, a new </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Date Decoder</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> item was added and shown on the resource type list.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="added"> There are several parameters in the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Date Decoder</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> resourceConfig element:</diffmk:wrapper></para>
-
- <para>
-
- <itemizedlist diffmk:change="added">
- <listitem>
- <para>locale-language</para>
-
- </listitem>
-
- <listitem>
- <para>format</para>
- </listitem>
-
- <listitem>
- <para>locale-country</para>
-
- </listitem>
- </itemizedlist>
- </para>
-
- <para><diffmk:wrapper diffmk:change="added"> You can modify the parameters of the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Date Decoder</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> item with the left detail page.</diffmk:wrapper></para>
-
- <figure float="0">
- <title>Date Decoder Detail Page</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/config_page/config_page5.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para><diffmk:wrapper diffmk:change="added"> When you defined a new </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Date Decoder</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added">, they can use the </diffmk:wrapper><link linkend="graphicalpage_propertiesview"><diffmk:wrapper diffmk:change="changed">JavaBean Properties</diffmk:wrapper></link><diffmk:wrapper diffmk:change="changed"> GUI to set the
- them to be the "Java type".</diffmk:wrapper></para>
-
- <!--
- <para> The XML fragment generated by Smooks tools for the "Date
- Decoder": </para> <para> <programlisting> <![CDATA[<resource-config
- selector="decoder:DateLong">
- <resource>org.milyn.javabean.decoders.DateDecoder</resource> <param
- name="locale-language">en</param> <param name="format">yyy-MM-dd
- HH:mm:ss</param> <param name="locale-country">IE</param>
- </resource-config>]]> </programlisting> </para>
- -->
- </section>
- <!--
- <section id="configurationpage_documenttype"> <title>Document Type
- Detail Page</title> <para> </para> </section> <section
- id="configurationpage_unhandleresourceconfig"> <title>Unhandle
- ResourceConfig</title> </section>
- -->
-
-
-
-</chapter>
-<chapter id="smooksformeditor_sourcetab" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/smooks/docs/reference/en/modules/smooksformeditor_sourcepage.xml" xreflabel="Smooks Source Editor Page">
- <?dbhtml filename="smooks_form_editor_sourcetab.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Tools</keyword>
- <keyword>Smooks</keyword>
- <keyword>JBDS</keyword>
- </keywordset>
- </chapterinfo>
- <title>Smooks Source Editor Page</title>
- <section>
- <title>XML Source Editor</title>
- <para><diffmk:wrapper diffmk:change="changed">You can use this editor to edit the Smooks Configuration file directly. </diffmk:wrapper></para>
- <figure float="0">
- <title>Graphical Editor</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/source_editor/source_editor1.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section>
- <title>Error Messages GUI</title>
- <para><diffmk:wrapper diffmk:change="added">If the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Smooks tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> can't understand the configuration
- file or the configuration file is illegal (XML structure isn't right for Smooks
- Configuration file, etc.), the error will be underlined.</diffmk:wrapper></para>
- <figure float="0">
- <title>Graphical Editor</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/source_editor/source_editor2.png" scale="90"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <!--note>
- <title>Tip:</title>
- <para> When the error message panel is displayed, other editors ( Graphical Editor,
- Configuration Editor ) are disabled. </para>
- <para> You can't edit the configuration file with other editors until file becomes
- valid. </para>
- </note-->
-
- </section>
-
-
-</chapter>
-</book>
Copied: branches/jbosstools-3.0.x/smooks/docs/reference/en/master_output.xml (from rev 15128, trunk/smooks/docs/reference/en/master_output.xml)
===================================================================
--- branches/jbosstools-3.0.x/smooks/docs/reference/en/master_output.xml (rev 0)
+++ branches/jbosstools-3.0.x/smooks/docs/reference/en/master_output.xml 2009-05-11 16:42:15 UTC (rev 15209)
@@ -0,0 +1,918 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+"http://www.docbook.org/xml/4.3/docbookx.dtd"
+
+[
+<!ENTITY introduction SYSTEM "modules/introduction.xml">
+<!ENTITY quickstart SYSTEM "modules/quick_start.xml">
+<!ENTITY smooksformeditor_graphicaltab SYSTEM "modules/smooksformeditor_graphicalpage.xml">
+<!ENTITY smooksformeditor_configurationtab SYSTEM "modules/smooksformeditor_configurationpage.xml">
+<!ENTITY smooksformeditor_sourcetab SYSTEM "modules/smooksformeditor_sourcepage.xml">
+]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff">
+
+ <bookinfo>
+
+ <title>Smooks Dev Tools Reference Guide</title>
+ <author>
+ <firstname>Xue(Dart)</firstname>
+ <surname>Peng</surname>
+ </author>
+
+ <pubdate>November 2008</pubdate>
+ <copyright>
+ <year>2009</year>
+ <holder>JBoss, a division of Red Hat</holder>
+ </copyright>
+ <releaseinfo>
+ Version: 1.0.0.GA
+ </releaseinfo>
+
+ <abstract>
+ <title></title>
+ <para>
+ <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/smooks/pdf/Smooks_Re...">PDF version</ulink>
+ </para>
+ </abstract>
+
+
+ </bookinfo>
+ <toc></toc>
+
+<chapter id="introduction" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/smooks/docs/reference/en/modules/introduction.xml">
+ <?dbhtml filename="introduction.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Smooks</keyword>
+ <keyword>JBDS</keyword>
+ </keywordset>
+ </chapterinfo>
+ <title>Introduction</title>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">This chapter give you a short introduction to Smooks, Smooks tools and its installation</diffmk:wrapper></para>
+ <section>
+ <title>What is Smooks?</title>
+
+ <para><property moreinfo="none">Smooks</property> is a Java Framework/Engine for processing XML and non XML
+ data (CSV, EDI, Java, JSON etc).</para>
+ <para></para>
+ <para>
+ <orderedlist continuation="restarts" inheritnum="inherit" numeration="upperroman">
+ <listitem>
+ <para><emphasis role="bold">Transformation</emphasis>: Perform a wide range of
+ Data Transforms. Supports many different Source and Result types
+ -XML/CSV/EDI/Java/JSON to XML/CSV/EDI/Java/JSON.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Java Binding</emphasis>: Bind into a Java Object
+ Model from any data source (CSV, EDI, XML, Java, JSON etc). </para>
+ </listitem>
+
+ <listitem>
+ <para><emphasis role="bold">Huge Message Processing</emphasis>: Process huge
+ messages (GBs) - Split, Transform and Route message fragments to JMS, File,
+ Database etc destinations. Route multiple message formats to multiple
+ destinations in a single pass over a message. </para>
+ </listitem>
+
+ <listitem>
+ <para><emphasis role="bold">Message Enrichment</emphasis>: Enrich a message with
+ data from a Database, or other Datasources. </para>
+ </listitem>
+
+ <listitem>
+ <para><emphasis role="bold">Combine</emphasis>: Combine the above features in
+ different ways e.g. add Message Enrichment as part of a Splitting and
+ Routing process. </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ <figure float="0">
+ <title>Smooks</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/introduction/introduction1.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para> For More informations about <property moreinfo="none">Smooks</property>, please visit <ulink url="http://www.smooks.org">Smooks official site</ulink>.</para>
+ </section>
+ <section>
+ <title><diffmk:wrapper diffmk:change="changed">What is Smooks Tools?</diffmk:wrapper></title>
+
+ <para><diffmk:wrapper diffmk:change="changed">Smooks tools is a set of graphical tools for editing Smooks configuration file
+ based on Eclipse.</diffmk:wrapper></para>
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Smooks Form editor</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/introduction/introduction2.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section>
+ <title>How to install Smooks dev tools?</title>
+
+ <para><diffmk:wrapper diffmk:change="changed"> The Smooks tools was included by the </diffmk:wrapper><property moreinfo="none">JBoss Tools</property> since 3.0.0
+ Beta1 version. You can download the <property moreinfo="none">JBoss Tools</property> from <ulink url="http://www.jboss.org/tools/download/index.html"><diffmk:wrapper diffmk:change="changed">JBoss download site</diffmk:wrapper></ulink>.</para>
+ <para><diffmk:wrapper diffmk:change="changed"> Smooks tools (</diffmk:wrapper><property moreinfo="none">JBoss Tools</property>) run with the latest Eclipse and
+ other required plug-ins (GEF, EMF, etc.).</para>
+ <para><diffmk:wrapper diffmk:change="changed"> You should download the latest IDE for Java EE developers from </diffmk:wrapper><ulink url="http://www.eclipse.org/downloads/"><diffmk:wrapper diffmk:change="changed"> Eclipse site</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">. It contains many plug-ins (
+ GEF, EMF, etc. ) required by Smooks dev tools. </diffmk:wrapper></para>
+
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Now let's progress to more advanced topics.</diffmk:wrapper></para>
+ </section>
+
+</chapter>
+
+
+<chapter id="quickstart" role="updated" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/smooks/docs/reference/en/modules/quick_start.xml" xreflabel="Quick Start">
+ <?dbhtml filename="quick_start.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Smooks</keyword>
+ <keyword>JBDS</keyword>
+ <keyword>java</keyword>
+ </keywordset>
+ </chapterinfo>
+ <title>Quick Start</title>
+ <para> This "Quick Start" will show how to use the <property moreinfo="none">Smooks tools</property> to create/edit the Smooks
+ configuration file for Java2Java data transformation.</para>
+ <para><diffmk:wrapper diffmk:change="changed"> This chapter gives you a brief understanding of the </diffmk:wrapper><property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Smooks tools</diffmk:wrapper></property>.</para>
+ <section>
+ <title>Download Smooks Java-to-Java Example</title>
+ <para> Visit <ulink url="http://www.smooks.org/documentation/documentation-smooks-1-1-x/examples/e...">here</ulink> to download the "java-to-java" example project. </para>
+ <tip>
+ <title>Tip:</title>
+
+ <para><diffmk:wrapper diffmk:change="changed"> The example project is based on Maven, we suggest you to create a new eclipse
+ Java project, copy the example code and .jar files from the example project and paste
+ them into the eclipse Java project. </diffmk:wrapper></para>
+ </tip>
+ </section>
+ <section>
+ <title>Smooks Configuration File Wizard</title>
+ <para><diffmk:wrapper diffmk:change="changed">Select the Smooks Java-to-Java example project that you created and right-click,
+ select the menu </diffmk:wrapper><emphasis><property moreinfo="none">New > Other</property>,</emphasis> then find
+ <emphasis><property moreinfo="none">Smooks > Smooks Configuration File</property>.</emphasis>
+ Click the <emphasis>
+ <property moreinfo="none">Next</property>
+ </emphasis> button. </para>
+ <figure float="0">
+ <title>Selecting Smooks Configuration File Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start1.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>The first wizard page is a file path creation page. Select the <emphasis>
+ <property moreinfo="none">src</property>
+ </emphasis> folder to be the files container, and input the name
+ <emphasis><property moreinfo="none">newConfig.smooks</property>.</emphasis> Click
+ <emphasis><property moreinfo="none">Next</property>.</emphasis></para>
+ <figure float="0">
+ <title>Choosing the configuration file container and the file name</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start2.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>The second wizard page is a transform data type choose page.</para>
+ <para> As the quick start introduces how to create/edit the Java-to-Java Smooks
+ configuration file, let's select the<emphasis>
+ <property moreinfo="none">Java-to-Java</property>
+ </emphasis> type as the source/target transform data type. </para>
+
+ <figure float="0">
+ <title>Selecting Data Type</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start3.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>On the next page you are prompted to choose the source data for transformation.
+ Let's select the <property moreinfo="none">Order</property> class from the example project as
+ the source JavaBean class.</para>
+
+ <figure float="0">
+ <title>Selecting the Source Data</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start4.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Then the wizard page asks you to choose the target data for transformation. We select
+ the <property moreinfo="none">ListOrder</property> class as the target JavaBean class.</para>
+ <figure float="0">
+ <title>Selecting the Target Data</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start5.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para></para>
+
+ <tip>
+ <title>Tip:</title>
+ <para>You can omit two these steps and just press
+ <emphasis><property moreinfo="none">Finish</property>.</emphasis> This will open the empty
+ Smooks Configuration file. It's possible to <link linkend="graphicaleditor_datalink">select source/target data</link> afterwards
+ in the Smooks Graph editor.</para>
+ </tip>
+ </section>
+ <section id="quickstart_formeditor">
+ <title>Smooks Editor</title>
+
+ <para>When all the wizard steps are passed, a new Smooks Configuration file is created and
+ the <property moreinfo="none">Smooks Editor</property> will be opened automatically:</para>
+ <figure float="0">
+ <title>Smooks Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start6.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para> This editor contains several parts: <table>
+ <title>The Smooks Editor Parts</title>
+ <tgroup cols="2">
+
+ <colspec align="left" colnum="1" colwidth="1*"></colspec>
+ <colspec colnum="2" colwidth="5*"></colspec>
+
+ <thead>
+ <row>
+ <entry>Editor feature</entry>
+ <entry>Functionality</entry>
+ </row>
+ </thead>
+
+ <tbody>
+
+ <row>
+ <entry>
+ <para>Problems area</para>
+ </entry>
+ <entry>
+ <para><diffmk:wrapper diffmk:change="changed">If there are any errors when you are editing the file, the
+ Problems area displays them</diffmk:wrapper></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <para>Source data tree</para>
+ </entry>
+ <entry>
+ <para><diffmk:wrapper diffmk:change="changed">The tree displays a structure of the transformed source
+ data</diffmk:wrapper></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <para>Target data tree</para>
+ </entry>
+ <entry>
+ <para><diffmk:wrapper diffmk:change="changed">The tree displays a structure of the transformed target
+ data</diffmk:wrapper></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <para>Mapping graphical area</para>
+ </entry>
+ <entry>
+ <para>Show the data mapping connection lines</para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <para>Source/Target data selection links</para>
+ </entry>
+ <entry>
+ <para>Click the link, and <link linkend="graphicaleditor_datalink">Data Selection wizard</link><diffmk:wrapper diffmk:change="changed"> is opened helping you to
+ choose the source/target data</diffmk:wrapper></para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+ </section>
+
+ <section id="graphicaleditor_datalink">
+ <title>Choosing the Source/Target Data</title>
+
+ <para>To choose the transform data you should make use of the data selection links:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para><emphasis>
+ <property moreinfo="none">Source Select</property>
+ </emphasis> for selecting source data</para>
+ </listitem>
+
+ <listitem>
+ <para><emphasis>
+ <property moreinfo="none">Target Select</property>
+ </emphasis> for selecting target data</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>After clicking the link the <property moreinfo="none">Data Type Selection wizard</property><diffmk:wrapper diffmk:change="changed"> is
+ opened, and there are two data types on the list: Java and XML.</diffmk:wrapper></para>
+ <note>
+ <title>Note</title>
+ <para><diffmk:wrapper diffmk:change="changed"> There will become more and more data types on the list as the development goes on.
+ </diffmk:wrapper></para>
+ </note>
+
+ <figure float="0">
+ <title>Data Type Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start7.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Select the <emphasis>
+ <property moreinfo="none">Java</property>
+ </emphasis> data type and click <emphasis><property moreinfo="none">Next</property>,</emphasis> you will
+ see the JavaBean class selection page:</para>
+
+ <figure float="0">
+ <title>JavaBean Data Selection</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start8.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>When you select all the necessary java classes, click <emphasis>
+ <property moreinfo="none">Finish</property>
+ </emphasis><diffmk:wrapper diffmk:change="changed"> and the structure of the java class is displayed on the source/target
+ data tree.</diffmk:wrapper></para>
+ <figure float="0">
+ <title>Displaying the Structure of the Transformed Data</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start9.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+
+ <section id="quickstart_mapping">
+ <title>Mapping</title>
+
+ <para> As you see, the source/target data tree displays the structure of the java class. </para>
+ <para>How to map it?</para>
+
+ <para>First, you should know what to transform:</para>
+
+ <orderedlist continuation="restarts" inheritnum="inherit" numeration="loweralpha">
+ <listitem>
+ <para>Bind the <emphasis>
+ <property moreinfo="none">"customerName"</property>
+ </emphasis> property of the <property moreinfo="none">Order#header</property> to the <emphasis>
+ <property moreinfo="none">"customerName"</property>
+ </emphasis> property of <property moreinfo="none">LineOrder</property>.</para>
+ </listitem>
+ <listitem>
+ <para>Bind the <emphasis>
+ <property moreinfo="none">"customerNumber"</property>
+ </emphasis> property of the <property moreinfo="none">Order#header</property> to the <emphasis>
+ <property moreinfo="none">"customerId"</property>
+ </emphasis> property of <property moreinfo="none">LineOrder</property>.</para>
+ </listitem>
+ <listitem>
+ <para>Bind the <emphasis>
+ <property moreinfo="none">"price"</property>
+ </emphasis> property of the <property moreinfo="none">OrderItem</property> to the <emphasis>
+ <property moreinfo="none">"unitPrice"</property>
+ </emphasis> property of <property moreinfo="none">LineItem</property>.</para>
+ </listitem>
+ <listitem>
+ <para>Bind the <emphasis>
+ <property moreinfo="none">"productId"</property>
+ </emphasis> property of the <property moreinfo="none">OrderItem</property> to the <emphasis>
+ <property moreinfo="none">"productCode"</property>
+ </emphasis> property of <property moreinfo="none">LineItem</property>.</para>
+ </listitem>
+ <listitem>
+ <para>Bind the <emphasis>
+ <property moreinfo="none">"quantity"</property>
+ </emphasis> property of the <property moreinfo="none">OrderItem</property> to the <emphasis>
+ <property moreinfo="none">"unitQuantity"</property>
+ </emphasis> property of <property moreinfo="none">LineItem</property>.</para>
+ </listitem>
+ </orderedlist>
+
+ <para> Make sense?</para>
+ <para> OK, let's select the <emphasis>
+ <property moreinfo="none">"customerName"</property>
+ </emphasis> item of the <emphasis>
+ <property moreinfo="none">"header"</property>
+ </emphasis> item on the source data tree and start to drag it. When the drag item
+ crosses the Mapping graphical area, you will see a connection line. Drop the item onto
+ the <emphasis>
+ <property moreinfo="none">"customerName"</property>
+ </emphasis> of the <property moreinfo="none">LineOrder</property> on the target data
+ view.</para>
+ <para> Now a dialog is opened asking you to connect the root node:</para>
+
+ <figure float="0">
+ <title>Dialog Asking You to Connect to the Root Nodes</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start10.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para> Please, click <emphasis>
+ <property moreinfo="none">Yes</property>
+ </emphasis><diffmk:wrapper diffmk:change="changed"> to connect the root node. If you don't do that, this dialog is
+ opened again when you connect other nodes.</diffmk:wrapper></para>
+ <note>
+ <title>Note:</title>
+ <para><diffmk:wrapper diffmk:change="changed">Please, remember that the root nodes of the source data and target data *MUST* be
+ connected.</diffmk:wrapper></para>
+ <para><diffmk:wrapper diffmk:change="changed">This rule is not only for Java-to-Java, but also is relevant for
+ XML-to-Java </diffmk:wrapper></para>
+ </note>
+ <para> Now let's do the same operation with the <emphasis>
+ <property moreinfo="none">"customerNumber"</property>,</emphasis> that is what you
+ should see:</para>
+ <figure float="0">
+ <title>Correctly Mapping Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start11.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Next, you are going to bind the properties of the <property moreinfo="none">OrderItem</property> to
+ the properties of the <property moreinfo="none">LineItem</property>.</para>
+ <para>Select the <emphasis>
+ <property moreinfo="none">"price"</property>
+ </emphasis> and drag it onto the <emphasis>
+ <property moreinfo="none">"unitPrice"</property>
+ </emphasis><diffmk:wrapper diffmk:change="changed"> of the other side tree viewer. The Problems area shows an
+ error:</diffmk:wrapper></para>
+ <figure float="0">
+ <title>Connection Error 1</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start12.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>How to deal with the error?</para>
+ <para>Please click the <emphasis>
+ <property moreinfo="none">Fix it</property></emphasis> link, a menu is popped-up with several
+ resolve methods on it.</para>
+ <figure float="0">
+ <title>Fixing the Connection Error</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start13.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para> Select the first resolve method: <emphasis>
+ 'Connect the "OrderItem" to the
+ "LineItem" '.</emphasis> As the result the <emphasis>
+ <property moreinfo="none">"OrderItem"</property></emphasis> is connected with
+ the <emphasis>
+ <property moreinfo="none">"LineItem"</property>.</emphasis></para>
+ <para>But the notify message area still shows some other errors:</para>
+ <figure float="0">
+ <title>Connection Error 2</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start14.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>OK, let's deal with the fire error. Click the <emphasis>
+ <property moreinfo="none">Fix it</property></emphasis> link and
+ select the first resolve method. The <emphasis>
+ <property moreinfo="none">"orderItems"</property></emphasis> is connected with
+ the <emphasis>
+ <property moreinfo="none">"lineItems"</property>.</emphasis></para>
+
+ <tip>
+ <title>Tip:</title>
+ <para> Why does the error occur?</para>
+ <para> You will find that, if you only connect the property node without connecting the
+ parent node of the property, the "connection error" occurs.</para>
+ <para>The connection of the "price-to-unitPrice" is the
+ "Binding Connection", but it needs an "Instance Creation
+ Connection" - the connection of the
+ "OrderItem-to-LineItem".</para>
+ </tip>
+ <para> After that, connect <emphasis>
+ <property moreinfo="none">"quantity"</property></emphasis> to the <emphasis>
+ <property moreinfo="none">"unitQuantity"</property></emphasis> and <emphasis>
+ <property moreinfo="none">"productId"</property></emphasis> to the
+ <emphasis>
+ <property moreinfo="none">"productCode"</property>:</emphasis></para>
+ <figure float="0">
+ <title>Complete Mapping</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start15.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Now, you should save the file and the <property moreinfo="none">Smooks tools</property><diffmk:wrapper diffmk:change="changed"> generate the correct
+ configuration file content.</diffmk:wrapper></para>
+ <para>OK, let run the test class: <property moreinfo="none">example.Main</property>. (Please, make sure that the Smooks engine
+ loads the correct configuration file).</para>
+ <para>Success!</para>
+ </section>
+</chapter>
+
+
+<chapter id="smooksformeditor_graphicaltab" role="updated" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/smooks/docs/reference/en/modules/smooksformeditor_graphicalpage.xml" xreflabel="Smooks Graphical Editor Page">
+ <?dbhtml filename="smooks_form_editor_graphicaltab.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Smooks</keyword>
+ <keyword>JBDS</keyword>
+ </keywordset>
+ </chapterinfo>
+ <title>Smooks Graphical Editor Page</title>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">This chapter is packed with useful information about Smooks Graphical Editor Page usage</diffmk:wrapper></para>
+ <para>Smooks Graphical Editor page is one tab of the <property moreinfo="none">Smooks Editor</property>.</para>
+ <figure float="0">
+ <title>Graphical Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/graph_editor/graph_editor1.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para> This <property moreinfo="none">Graphical editor</property> allows you to perform drug/drop operations
+ with the nodes of transform data to map the source data to target data. </para>
+ <para><diffmk:wrapper diffmk:change="added"> When you save the changes in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Graphical editor</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> the correct Smooks
+ Configuration file content is generated. </diffmk:wrapper></para>
+
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">To adjust the properties of the connection lines in the editor, you should use the </diffmk:wrapper><link diffmk:change="added" linkend="graphicalpage_propertiesview"><diffmk:wrapper diffmk:change="added">Properties view</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added"> (activate it by following
+ to </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Window > Show View > Other > General > Properties</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">).</diffmk:wrapper></emphasis></para>
+
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">For example, if you defined a date decoder in the </diffmk:wrapper><link diffmk:change="added" linkend="configurationpage_datedecoder"><diffmk:wrapper diffmk:change="added">Smooks Configuration Editor</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added">, in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Properties view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> you can
+ select it as a Mapping type for the "Date" type element.</diffmk:wrapper></para>
+
+ <figure diffmk:change="added" float="0">
+ <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Browsing Custom Type for the Date Type Element</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added" fileref="images/graph_editor/graph_editor1a.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <section>
+
+ <title>Introducing the areas of graphical editor</title>
+ <para>Information on the topic could be found in the <link linkend="quickstart_formeditor">Quick Start/Smooks Editor</link> section.</para>
+ </section>
+ <section>
+
+ <title>Load Source/Target Data</title>
+ <para> Click the links under the data view, the <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Data Type Selection
+ wizard</diffmk:wrapper></property><diffmk:wrapper diffmk:change="changed"> page will be shown.</diffmk:wrapper></para>
+ <figure float="0">
+ <title>Data Type Selection Wizard Page</title>
+ <mediaobject>
+ <imageobject>
+
+ <imagedata fileref="images/graph_editor/graph_editor2.png" scale="90"></imagedata>
+
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para> There are sets of transform data type on the wizard page, select one type and click
+ <emphasis><property moreinfo="none">Next</property>,</emphasis> the data source selection wizard
+ page will be shown.</para>
+
+ <tip>
+ <title>Note:</title>
+ <para>For different data type, the Data source selection wizard are different too.
+ </para>
+ </tip>
+ <figure float="0">
+ <title>Java Data Source Selection Wizard Page</title>
+ <mediaobject>
+ <imageobject>
+
+ <imagedata fileref="images/graph_editor/graph_editor3.png" scale="90"></imagedata>
+
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <figure float="0">
+ <title>XML File Path Selection Wizard Page</title>
+ <mediaobject>
+ <imageobject>
+
+ <imagedata fileref="images/graph_editor/graph_editor4.png" scale="90"></imagedata>
+
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para> When you finish the data selection (file path selection), click
+ <emphasis><property moreinfo="none">Finish</property>,</emphasis><diffmk:wrapper diffmk:change="changed"> the data view displays the
+ selected data structure.</diffmk:wrapper></para>
+ </section>
+ <section>
+
+ <title>Using Graphical Editor for Mapping</title>
+ <para>To get information on the topic please, read the <link linkend="quickstart_mapping">Quick Start/Mapping</link> section. </para>
+ </section>
+ <section>
+
+ <title>Error Messages</title>
+ <para>When you do any mapping operations, the <property moreinfo="none">Smooks tools</property> validate the
+ file content with "Mapping Logic". If there are any errors of the configuration file
+ content, error messages are shown in the <link linkend="quickstart_formeditor">Problems
+ area</link>.</para>
+ <para> Please, read the <link linkend="quickstart_mapping">Quick Start/Mapping</link><diffmk:wrapper diffmk:change="changed">
+ section to find how to fix the errors.</diffmk:wrapper></para>
+ </section>
+ <section id="graphicalpage_propertiesview">
+ <title>Properties View</title>
+
+ <para> You can edit the properties of the connection lines with the <property moreinfo="none">Properties
+ view</property>.</para>
+ <para>Navigate to <emphasis><property moreinfo="none">Window > Show View > Other >
+ Properties</property>,</emphasis> to open the <property moreinfo="none">Properties
+ view</property>.</para>
+ <para><diffmk:wrapper diffmk:change="changed"> When you select the connection line, the </diffmk:wrapper><property moreinfo="none">Properties view</property><diffmk:wrapper diffmk:change="changed"> will
+ show a set of section GUI for editing its properties.</diffmk:wrapper></para>
+ <tip>
+
+ <title>Tip:</title>
+ <para>This GUI on the <property moreinfo="none">Properties view</property> is displayed when the Smooks
+ Graphical editor is active, if not, the <property moreinfo="none">Properties view</property>
+ displays empty GUI.</para>
+ <para>If the source data type of the selected connection line is
+ "XML", the <property moreinfo="none">Properties view</property> shows an XML
+ Properties section GUI.</para>
+ <para>But if the source data type of the selected connection line is
+ "Java", the XML Properties section GUI isn't
+ displayed.</para>
+ <para>It means that if the source/target data type of the selected connection line is
+ different, the <property moreinfo="none">Properties view</property><diffmk:wrapper diffmk:change="changed"> shows a different GUI.</diffmk:wrapper></para>
+ </tip>
+ <figure float="0">
+ <title>JavaBean Properties Section</title>
+ <mediaobject>
+ <imageobject>
+
+ <imagedata fileref="images/graph_editor/graph_editor5.png" scale="90"></imagedata>
+
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <figure float="0">
+ <title>XML Properties Section</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/graph_editor/graph_editor6.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <figure float="0">
+ <title>Mapping Properties Section</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/graph_editor/graph_editor7.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">To discover about other Editor pages, read the next chapters</diffmk:wrapper></para>
+ </section>
+</chapter>
+
+
+<chapter id="smooksformeditor_configurationtab" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/smooks/docs/reference/en/modules/smooksformeditor_configurationpage.xml" xreflabel="Smooks Configuration Editor Page">
+ <?dbhtml filename="smooks_form_editor_configurationtab.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Smooks</keyword>
+ <keyword>JBDS</keyword>
+ </keywordset>
+ </chapterinfo>
+ <title>Smooks Configuration Editor Page</title>
+ <para><diffmk:wrapper diffmk:change="added">In this section you will explore the details of Smooks Configuration Editor usage</diffmk:wrapper></para>
+ <para diffmk:change="added"><property moreinfo="none"><diffmk:wrapper diffmk:change="added">Smooks Configuration Editor</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> is one tab of the </diffmk:wrapper><property diffmk:change="added" moreinfo="none">Smooks Editor</property>. </para>
+ <figure float="0">
+ <title>Graphical Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/config_page/config_page1.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para> You can add/edit/remove the <link linkend="configurationpage_datedecoder">Date
+ Decoder</link><diffmk:wrapper diffmk:change="changed"> on the Configuration page of the </diffmk:wrapper><property moreinfo="none">Smooks Editor</property>. </para>
+ <para><diffmk:wrapper diffmk:change="changed"> The configuration editor also edits the </diffmk:wrapper><link linkend="configurationpage_parsetype">Smooks parse
+ type</link><diffmk:wrapper diffmk:change="changed"> and manages the </diffmk:wrapper><link linkend="configurationpage_importfile">Import
+ Files</link>.</para>
+
+ <section id="configurationpage_parsetype">
+
+ <title>Smooks Parse Type</title>
+ <para>Open the <emphasis>
+ <property moreinfo="none">Other Configurations</property>
+ </emphasis> section, we will see there is a set of radio buttons:</para>
+
+ <figure float="0">
+ <title>Smooks Parse Types</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/config_page/config_page2.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para><diffmk:wrapper diffmk:change="changed">Select the needed radio button to change the Smooks parse type. </diffmk:wrapper></para>
+ </section>
+ <section id="configurationpage_importfile">
+
+ <title>Import File</title>
+ <para> Open the <emphasis>
+ <property moreinfo="none">Other Configurations</property>
+ </emphasis> section, there is an <emphasis>
+ <property moreinfo="none">Import Files</property>
+ </emphasis><diffmk:wrapper diffmk:change="changed"> list under the Smooks parse type buttons (see the figure above).</diffmk:wrapper></para>
+
+ <para>There are three buttons on the right side of the <emphasis>
+ <property moreinfo="none">File Import</property>
+ </emphasis> list. You can click those to add/edit/remove the import files.</para>
+
+ <tip>
+
+ <title>Tip:</title>
+ <para><diffmk:wrapper diffmk:change="changed"> If the import file doesn&t exist, the image of the import file is changed to
+ "Error Image". If you double-click the import file in the Import File list, the file
+ is opened with a new default editor. </diffmk:wrapper></para>
+
+ </tip>
+ </section>
+ <section id="configurationpage_datedecoder">
+ <title>Date Decoder Detail Page</title>
+
+ <para>Date Decoder is a resourceConfig element in the Smooks configuration file. It
+ describes how to transform the "Date" type.</para>
+ <para> Click the <emphasis>
+ <property moreinfo="none">New</property>
+ </emphasis> button to open the <property moreinfo="none">New Resource Type wizard</property>
+ dialog.</para>
+ <figure float="0">
+ <title>Resource Type Selection Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/config_page/config_page4.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>There are several resource type on the list. Select the <emphasis>
+ <property moreinfo="none">Date Decoder</property>
+ </emphasis> and click the <emphasis>
+ <property moreinfo="none">Finish</property>
+ </emphasis> button, a new <emphasis>
+ <property moreinfo="none">Date Decoder</property>
+ </emphasis> item was added and shown on the resource type list.</para>
+ <para> There are several parameters in the <emphasis>
+ <property moreinfo="none">Date Decoder</property>
+ </emphasis> resourceConfig element:</para>
+
+ <para>
+
+ <itemizedlist>
+ <listitem>
+ <para><diffmk:wrapper diffmk:change="changed">Format</diffmk:wrapper></para>
+ </listitem>
+
+ <listitem>
+ <para><diffmk:wrapper diffmk:change="changed">Locale-Language</diffmk:wrapper></para>
+
+ </listitem>
+
+ <listitem>
+ <para><diffmk:wrapper diffmk:change="changed">Locale-Country</diffmk:wrapper></para>
+
+ </listitem>
+ </itemizedlist>
+ </para>
+
+ <para> You can modify the parameters of the <emphasis>
+ <property moreinfo="none">Date Decoder</property></emphasis> item with the left detail page.</para>
+
+ <figure float="0">
+ <title>Date Decoder Detail Page</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/config_page/config_page1.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para> When you defined a new <emphasis>
+ <property moreinfo="none">Date Decoder</property></emphasis><diffmk:wrapper diffmk:change="changed">, then you can use the </diffmk:wrapper><link linkend="graphicalpage_propertiesview">JavaBean Properties</link><diffmk:wrapper diffmk:change="changed"> GUI to set
+ it to be the "Java type".</diffmk:wrapper></para>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Now when we've learnt Smooks Configuration Editor Page, let's have a look at one more Smooks Editor Page - Smooks Source Editor Page and investigate its functionality</diffmk:wrapper></para>
+
+ <!--
+ <para> The XML fragment generated by Smooks tools for the "Date
+ Decoder": </para> <para> <programlisting> <![CDATA[<resource-config
+ selector="decoder:DateLong">
+ <resource>org.milyn.javabean.decoders.DateDecoder</resource> <param
+ name="locale-language">en</param> <param name="format">yyy-MM-dd
+ HH:mm:ss</param> <param name="locale-country">IE</param>
+ </resource-config>]]> </programlisting> </para>
+ -->
+ </section>
+ <!--
+ <section id="configurationpage_documenttype"> <title>Document Type
+ Detail Page</title> <para> </para> </section> <section
+ id="configurationpage_unhandleresourceconfig"> <title>Unhandle
+ ResourceConfig</title> </section>
+ -->
+</chapter>
+
+
+<chapter id="smooksformeditor_sourcetab" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/smooks/docs/reference/en/modules/smooksformeditor_sourcepage.xml" xreflabel="Smooks Source Editor Page">
+ <?dbhtml filename="smooks_form_editor_sourcetab.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Smooks</keyword>
+ <keyword>JBDS</keyword>
+ </keywordset>
+ </chapterinfo>
+ <title>Smooks Source Editor Page</title>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">This section provides information about Smooks Source Editor Page</diffmk:wrapper></para>
+ <section>
+ <title>XML Source Editor</title>
+ <para>You can use this editor to edit the Smooks Configuration file directly. </para>
+ <figure float="0">
+ <title>Graphical Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/source_editor/source_editor1.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section>
+ <title>Error Messages GUI</title>
+ <para>If the <property moreinfo="none">Smooks tools</property><diffmk:wrapper diffmk:change="changed"> can't understand the configuration
+ file or the configuration file is illegal (XML structure isn't right for Smooks
+ Configuration file, etc.), the error is underlined.</diffmk:wrapper></para>
+ <figure float="0">
+ <title>Graphical Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/source_editor/source_editor2.png" scale="90"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <!--note>
+ <title>Tip:</title>
+ <para> When the error message panel is displayed, other editors ( Graphical Editor,
+ Configuration Editor ) are disabled. </para>
+ <para> You can't edit the configuration file with other editors until file becomes
+ valid. </para>
+ </note-->
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">We hope, our guide will help you to get started with JBoss Smooks Tools. Besides, for additional information you are welcome on </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201"><diffmk:wrapper diffmk:change="added">JBoss forum</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
+ </section>
+</chapter>
+
+</book>
15 years, 5 months
JBoss Tools SVN: r15208 - in branches/jbosstools-3.0.x/seam/docs/reference: en and 2 other directories.
by jbosstools-commits@lists.jboss.org
Author: smukhina
Date: 2009-05-11 12:41:39 -0400 (Mon, 11 May 2009)
New Revision: 15208
Modified:
branches/jbosstools-3.0.x/seam/docs/reference/en/images/seam_editors/seam_editors_4.png
branches/jbosstools-3.0.x/seam/docs/reference/en/master.xml
branches/jbosstools-3.0.x/seam/docs/reference/en/modules/business_application.xml
branches/jbosstools-3.0.x/seam/docs/reference/en/modules/directory_structure.xml
branches/jbosstools-3.0.x/seam/docs/reference/en/modules/intro.xml
branches/jbosstools-3.0.x/seam/docs/reference/en/modules/seam_editors.xml
branches/jbosstools-3.0.x/seam/docs/reference/en/modules/seam_menus_and_actions.xml
branches/jbosstools-3.0.x/seam/docs/reference/en/modules/seam_preferences.xml
branches/jbosstools-3.0.x/seam/docs/reference/en/modules/seam_view.xml
branches/jbosstools-3.0.x/seam/docs/reference/en/modules/testng.xml
branches/jbosstools-3.0.x/seam/docs/reference/pom.xml
Log:
https://jira.jboss.org/jira/browse/JBDS-717 merged changes from trunk are added to the corresponding branch
Modified: branches/jbosstools-3.0.x/seam/docs/reference/en/images/seam_editors/seam_editors_4.png
===================================================================
(Binary files differ)
Modified: branches/jbosstools-3.0.x/seam/docs/reference/en/master.xml
===================================================================
--- branches/jbosstools-3.0.x/seam/docs/reference/en/master.xml 2009-05-11 16:41:23 UTC (rev 15207)
+++ branches/jbosstools-3.0.x/seam/docs/reference/en/master.xml 2009-05-11 16:41:39 UTC (rev 15208)
@@ -16,8 +16,8 @@
<!ENTITY crud_application_walkthrough SYSTEM "modules/crud_application_walkthrough.xml">
<!ENTITY business_application SYSTEM "modules/business_application.xml">
<!ENTITY testng SYSTEM "modules/testng.xml">
+<!ENTITY seam_faq SYSTEM "modules/seam_faq.xml">
-
<!ENTITY seamlink "../../seam/html_single/index.html">
<!ENTITY aslink "../../as/html_single/index.html">
<!ENTITY esblink "../../esb_ref_guide/html_single/index.html">
@@ -39,7 +39,9 @@
<title>Seam Dev Tools Reference Guide</title>
<author><firstname>Anatoly</firstname><surname>Fedosik</surname></author>
<author><firstname>Olga</firstname><surname>Chikvina</surname></author>
- <author><firstname>Svetlana</firstname><surname>Mukhina</surname><email>smukhina(a)exadel.com</email></author>
+ <author><firstname>Michael</firstname><surname>Sorokin</surname></author>
+
+ <author><firstname>Svetlana</firstname><surname>Mukhina</surname><email>smukhina(a)exadel.com</email></author>
<pubdate>April 2008</pubdate>
<copyright>
@@ -48,7 +50,7 @@
<holder>JBoss, a division of Red Hat</holder>
</copyright>
<releaseinfo>
- Version: 3.0.0.GA
+ Version: 3.0.1.GA
</releaseinfo>
<abstract>
@@ -75,6 +77,7 @@
&crud_database_application;
&crud_application_walkthrough;
&testng;
+&seam_faq;
<!-- TODO: drools used in this section is not available for eclipse .3.3 &business_application; -->
</book>
Modified: branches/jbosstools-3.0.x/seam/docs/reference/en/modules/business_application.xml
===================================================================
--- branches/jbosstools-3.0.x/seam/docs/reference/en/modules/business_application.xml 2009-05-11 16:41:23 UTC (rev 15207)
+++ branches/jbosstools-3.0.x/seam/docs/reference/en/modules/business_application.xml 2009-05-11 16:41:39 UTC (rev 15208)
@@ -291,7 +291,7 @@
<orderedlist continuation="continues">
<listitem>Double click on action1 to bring up the wizard. Select Handler on the left and enter
com.mydomain.EclipseCon.process. CheckInventoryAction as the class and bean as the type as shown
- below. You can can also search for the class by clicking on the <emphasis>Browse...</emphasis> button.</listitem>
+ below. You can also search for the class by clicking on the <emphasis>Browse...</emphasis> button.</listitem>
</orderedlist>
<figure>
<title>Action Handler</title>
Modified: branches/jbosstools-3.0.x/seam/docs/reference/en/modules/directory_structure.xml
===================================================================
--- branches/jbosstools-3.0.x/seam/docs/reference/en/modules/directory_structure.xml 2009-05-11 16:41:23 UTC (rev 15207)
+++ branches/jbosstools-3.0.x/seam/docs/reference/en/modules/directory_structure.xml 2009-05-11 16:41:39 UTC (rev 15208)
@@ -34,12 +34,12 @@
<para>A WAR project can only use Seam JavaBean and JPA Entity bean components; it cannot use
EJB3 Session beans etc.</para>
- <para>WAR projects are generated to enable Seam 1.2.1 war hotdeploy feature. Classes put
+ <para>WAR projects are generated to enable Seam war hotdeploy feature. Classes put
into <emphasis>
<property>src/action</property>
</emphasis> will be deployed to <emphasis>
<property>WEB-INF/dev</property>
- </emphasis> from which Seam 1.2.1 automatically will perform hotdeploy of new
+ </emphasis> from which Seam automatically will perform hotdeploy of new
components.</para>
<note>
<title>Note:</title>
@@ -82,6 +82,12 @@
about all modules and deploy EAR project into one enterprise application on server to
<property>deploy</property> folder. EAR application keeps <property>ejb</property>
and <property>war</property> modules of the EAR project.</para>
+
+ <note><title>Note:</title>
+ <para>The <property>WAR</property> generated for <property>EARs</property> is now configured to utilize Seam hot-deployment (<emphasis><property>WEB-INF/dev</property></emphasis>) similar to standalone <property>WAR</property> projects.</para>
+
+ </note>
+
</section>
<section id="seam_version_changing">
Modified: branches/jbosstools-3.0.x/seam/docs/reference/en/modules/intro.xml
===================================================================
--- branches/jbosstools-3.0.x/seam/docs/reference/en/modules/intro.xml 2009-05-11 16:41:23 UTC (rev 15207)
+++ branches/jbosstools-3.0.x/seam/docs/reference/en/modules/intro.xml 2009-05-11 16:41:39 UTC (rev 15208)
@@ -39,8 +39,7 @@
<title>Other relevant resources on the topic</title>
<para>The <ulink url="http://seamframework.org/">Seam Framework</ulink> - Next generation enterprise Java development.</para>
- <para>All latest release versions of JBoss Developer Studio/JBoss Tools documentation you can find <ulink url="http://docs.jboss.org/tools/2.1.0.GA/">here</ulink>.</para>
- <para>The latest documentation builds are available <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">here</ulink>.</para>
-
+ <para>All JBoss Developer Studio/JBoss Tools release documentation you can find at<ulink url="http://docs.jboss.org/tools/">http://docs.jboss.org/tools</ulink> in the corresponding release directory.</para>
+ <para>The latest documentation builds are available at <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">http://download.jboss.org/jbosstools/nightly-docs</ulink>.</para>
</section>
</chapter>
Modified: branches/jbosstools-3.0.x/seam/docs/reference/en/modules/seam_editors.xml
===================================================================
--- branches/jbosstools-3.0.x/seam/docs/reference/en/modules/seam_editors.xml 2009-05-11 16:41:23 UTC (rev 15207)
+++ branches/jbosstools-3.0.x/seam/docs/reference/en/modules/seam_editors.xml 2009-05-11 16:41:39 UTC (rev 15208)
@@ -9,15 +9,383 @@
</keywordset>
</chapterinfo>
- <title>Seam Editors Features</title>
+ <title>Seam Editors</title>
+
+
+ <para>This chapter tells about Seam Editors and their features.</para>
+
+ <section>
+ <title>Visual Page Editor</title>
+ <para>Visual Page Editor fits perfectly for authoring view Seam pages. The major features of VPE are listed in <link linkend="SeamEditors">Main Features of Seam Editors</link> </para>
+ <para>You can also read more about Visual Page Editor in <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/jsf/html/editors.htm...">Visual Page Editor</ulink> chapter of "Visual Web Tools Reference Guide".</para>
+ </section>
+
+
+
+
+ <section>
+ <title>Seam Pages Editor</title>
+
+
+ <para>
+ <property>Seam Pages Editor</property> provides a handy way to edit the <property>pages.xml</property> file.
+
+ </para>
+
+ <para>
+ You can edit the pages.xml file in three modes: Graphical, Tree and Source.
+
+ </para>
+ <para>
+ Seam Pages Editor supports synchronization with Package Explorer.This means that while renaming files in the Package Explorer all the changes immediately affect the pages.xml file.
+
+ </para>
+ <section>
+ <title>Graphical Mode</title>
+
+
+ <para>Graphical mode provides you with a set of visual tools to organize your project pageflow, exception handling etc.</para>
+ <figure>
+ <title>Seam Pages Editor: Graphical View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/seam_editors_7.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The Graphical part of the editor has some visual elements. The table below shows graphical representation of the elements and explains their meanings. </para>
+<table>
+ <title>Pages Editor: Graphical View. Visual elements</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Element</entry>
+
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/element_page.png"/>
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry><para>A yellow box with a solid border represents a <code>
+ <page>
+ </code> element.
+ </para></entry>
+ </row>
+ <row>
+ <entry>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/element_param.png"/>
+ </imageobject>
+ </mediaobject></entry>
+ <entry>
+ <para>Pressing on the plus icon (<inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/icon_plus.png"/>
+ </imageobject>
+ </inlinemediaobject>)
+
+
+ on the <code>
+ <page>
+ </code> element reveals a box that lists the parameters for the page.</para>
+ </entry>
+
+ </row>
+
+ <row>
+ <entry> <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/element_page2.png"/>
+ </imageobject>
+ </mediaobject></entry>
+ <entry>
+ <para>A red cross in the upper left corner of the page box indicates that the view-id is not found in the project.</para>
+ </entry>
+ </row>
+
+ <row>
+ <entry><mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/element_page1.png"/>
+ </imageobject>
+ </mediaobject></entry>
+ <entry> <para>
+ A gray box with a dashed border represents a page that has navigation
+ (navigation rule) to but the page is not defined in the page.xml file.
+ </para></entry>
+ </row>
+
+
+ <row>
+ <entry> <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/element_exception.png"/>
+ </imageobject>
+ </mediaobject></entry>
+ <entry> <para>An <code><exception></code> is represented by a blue box with a orange diamond.</para></entry>
+ </row>
+
+
+
+
+
+ </tbody>
+ </tgroup>
+</table>
+
+
+ <para>Pageflow relations are shown with gray arrows, when you select a relationship the arrow is changed to orange. </para>
+
+
+
+ <para>On the lefthand side of the Graphical view of <property>Seam Page Editor</property> you can find a toolbar with a set of icons for the most frequently used commands. </para>
+
+ <table>
+ <title>Pages Editor: Graphical View. Commands Icons</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Icon Image</entry>
+
+ <entry>Command</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/icon_select.png"/>
+ </imageobject>
+ </inlinemediaobject>
+
+ </entry>
+ <entry>Select a page element</entry>
+
+ </row>
+
+ <row>
+ <entry><inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/icon_marquee.png"/>
+ </imageobject>
+ </inlinemediaobject></entry>
+ <entry>Marquee a page item</entry>
+ </row>
+
+
+ <row>
+ <entry>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/icon_new_link.png"/>
+ </imageobject>
+ </inlinemediaobject>
+
+ </entry>
+ <entry>Add a page relationship</entry>
+ </row>
+
+
+ <row>
+ <entry>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/icon_exception.png"/>
+ </imageobject>
+ </inlinemediaobject>
+
+ </entry>
+ <entry>Add an exception rule</entry>
+ </row>
+
+ </tbody>
+ </tgroup>
+ </table>
+
+ <para>Context menus are also available when you click either on an item or a blank space.</para>
+
+
+ <para>A context menu called on a blank space of the diagram provides the following options:</para>
+ <itemizedlist>
+ <listitem><para><emphasis role="bold">Page</emphasis> creates a new page element on the diagram</para></listitem>
+ <listitem><para><emphasis role="bold">Exception</emphasis> creates a new exception element on the diagram</para></listitem>
+ <listitem><para><emphasis role="bold">Auto Layout</emphasis> formats the layout of the diagram automatically</para></listitem>
+ <listitem><para><emphasis role="bold">Select Element</emphasis> calls the <property>Select Element Wizard</property> with a filter to perform a quick search through the <property>pages.xml</property> file </para></listitem>
+ </itemizedlist>
+ <para>Rightclicking on a selected
+ <code><page></code>
+ element calls a context menu where you can choose the following options if you click on the <emphasis role="bold">New</emphasis> menu item: </para>
+
+
+
+ <itemizedlist>
+ <listitem><para><emphasis role="bold">Rule</emphasis> opens the <property>Add Navigation Rule</property> dialog in which you can browse your project for a view page to set the view-id in the navigation rule and specify <emphasis role="bold">render</emphasis> or <emphasis role="bold">redirect</emphasis> navigation options </para></listitem>
+ <listitem><para><emphasis role="bold">Param</emphasis> calls a dialog box where you can define a parameter (using the
+ <code><param></code>
+ tag) for the
+ <code><page></code>
+ element</para></listitem>
+ </itemizedlist>
+
+
+ <section>
+ <title>Seam Pages Diagram Preferences</title>
+
+
+
+ <para>In order to customize the layout of Diagram you can go to
+ <property>Window > Preferences > JBoss Tools > Web > Seam > Editors > Seam Pages Diagram</property>.
+ </para>
+
+ <figure>
+ <title>Preferences of Seam Pages Diagram</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/seam_editors_11.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ </section>
+
+
+ <section>
+ <title>Tree Mode</title>
+
+ <para>Tree Mode provides a wider range of options and way to edit and modify the pages.xml file.</para>
+
+
+
+ <figure>
+ <title>Seam Pages Editor: Tree View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/seam_editors_8.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>
+ In this mode all elements and attributes of the page.xml
+ file can be viewed and edited in a visual, user friendly way.
+ </para>
+
+ </section>
+
+
+ <section>
+ <title>Outline Support for Seam Pages Editor</title>
+
+
+ <para>Seam Pages Editor provides <property>Outline</property> view support.
+ You can explore the pages.xml using Outline view in two modes: <property>Tree</property> ( <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/outline_tree.png"/>
+ </imageobject>
+ </inlinemediaobject> ) and <property>Diagram Navigation</property> ( <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/outline_navigation.png"/>
+ </imageobject>
+ </inlinemediaobject> ).</para>
+
+ <para>
+ The Diagram Navigation mode of Outline view gives a birds-view of the layout to allow quick navigation for large-scale applications.
+ </para>
+
+ <figure>
+ <title>Outline view: Diagram Navigation mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/seam_editors_9.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+
+ <para>The Tree mode shows a tree for every element in the pages.xml file. You can get a quick overview of the whole file. When selecting an element in the Outline view the related element is highlighted in the Graphical, Tree or Source page of Seam Pages Editor.</para>
+
+
+
+ <figure>
+ <title>Outline view: Tree mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/seam_editors_10.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+
+
+
+ </section>
+
+
+
+ </section>
+
+
+
+
+ <section>
+
+
+ <title>Seam Components Editor</title>
+
+ <para>When editing <property>components.xml</property> a structured tree editor is available
+ in addition to pure source editing. It has a graphical view (Tree tab) and source
+ (Source tab).</para>
+
+ <figure>
+ <title>component.xml Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/seam_editors_4.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <note>
+ <title>Note:</title>
+
+ <para>You can view and edit <property>components.xml</property> and other xml files
+ directly in the Project Explorer and Properties sheet without opening the
+ components.xml editor.</para>
+ </note>
+ <figure>
+ <title>component.xml Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/seam_editors_5.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ </section>
+
+
+
+ <section id="SeamEditors">
+ <title>Main Features of Seam Editors</title>
+
<para>In this chapter you will know what Seam Editors features are and how to work with them. </para>
<section id="ContentAssist">
<title>Content Assist</title>
- <para><property>Content Assist</property> (Ctrl + Space) is available when using EL variables in the following file formats:</para>
+ <para><property>Content Assist</property> (Ctrl + Space) is available when using EL expressions in the following file formats:</para>
<itemizedlist>
<listitem>
<para>JSP</para>
@@ -43,13 +411,23 @@
</imageobject>
</mediaobject>
</figure>
-
+ <para> Content Assist is also available for the <emphasis
+ role="italic">
+ <property>"jsfc "</property>
+ </emphasis> attribute, it lets you select from a list of possible attribute values. Whereas, JSF components appear above all other components in the list.</para>
+ <figure>
+ <title>Content Assist for the "jsfc" attribute</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/seam_editors_12.png" scale="70"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
<note>
<title>Note:</title>
<para>To get Code Assist available for an externally generated and imported project,
- don't forget to enable Seam features and configure Seam Settings in <link
- linkend="project_pref">Project Preferences</link>.</para>
+ don't forget to enable Seam features and configure Seam Settings in <link linkend="project_pref">Project Preferences</link>.</para>
</note>
<section id="components_code_assist" role="new">
@@ -81,12 +459,25 @@
</mediaobject>
</figure>
</section>
+
+
</section>
-
+ <section>
+ <title>Content Assist for Page Descriptors</title>
+
+ <para>Content Assist ( CA ) is available for Page Descriptors,
+ <property>.page.xml</property> and <property>page.xml</property> files.
+ Content Assist lets you easily compose a Page Descriptor file by suggesting elements and attributes. The suggestions are context dependent, which means that CA provides only the elements, attributes and in some cases values for the attributes, suitable in a particular place of your Page Descriptor.
+
+ </para>
+ <para>
+ Seam Pages Editor also supports code completion in EL-expressions suggesting you possible bean properties and methods.
+ </para>
+ </section>
<section id="OpenOn">
<title>OpenOn</title>
- <para><property>OpenOn</property> let's you easily navigate through your project without
+ <para><property>OpenOn</property> lets you easily navigate through your project without
using the Package Explorer or Project Explorer. After pressing <emphasis>
<property>Ctrl + left click</property>
</emphasis> (or just F3) you will see a corresponding method or class.</para>
@@ -100,6 +491,20 @@
</mediaobject>
</figure>
+ <para>OpenOn is also supported in Page Descriptors (<property>.page.xml</property> and <property>pages.xml</property>). OpenOn allows you to navigate to Java beans as well as to view pages.
+ You can <property>Ctrl + left click</property> on a bean or on view page file (e.g. XTML file) to navigate to the file you clicked on. </para>
+
+ <figure>
+ <title>OpenOn in .page.xml file</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_editors/seam_editors_2a.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+
+
</section>
<section id="SeamValidation">
@@ -120,6 +525,10 @@
</mediaobject>
</figure>
+ <note>
+ <title>Note:</title>
+ <para>Please note, only files within source path and web content are validated, meaning temporary files or test files are not included.</para>
+ </note>
<para>In the preferences page for Seam Validator you can see and modify the validator
behavior. Go to <emphasis>
@@ -144,38 +553,5 @@
execute all the active WTP validations.</para>
</section>
- <section id="ComponentsEditor" >
- <title>Structured components.xml Editor</title>
-
- <para>When editing <property>components.xml</property> a structured tree editor is available
- in addition to pure source editing. It has a graphical view (Tree tab) and source
- (Source tab).</para>
-
- <figure>
- <title>component.xml Editor</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/seam_editors/seam_editors_4.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <note>
- <title>Note:</title>
-
- <para>You can view and edit <property>components.xml</property> and other xml files
- directly in the Project Explorer and Properties sheet without opening the
- components.xml editor.</para>
- </note>
- <figure>
- <title>component.xml Editor</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/seam_editors/seam_editors_5.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- </section>
-
+</section>
</chapter>
Modified: branches/jbosstools-3.0.x/seam/docs/reference/en/modules/seam_menus_and_actions.xml
===================================================================
--- branches/jbosstools-3.0.x/seam/docs/reference/en/modules/seam_menus_and_actions.xml 2009-05-11 16:41:23 UTC (rev 15207)
+++ branches/jbosstools-3.0.x/seam/docs/reference/en/modules/seam_menus_and_actions.xml 2009-05-11 16:41:39 UTC (rev 15208)
@@ -178,7 +178,7 @@
<title>Find Seam References/Declarations</title>
- <para>To find EL expretions both in <emphasis>
+ <para>To find EL expressions both in <emphasis>
<property>.java</property>
</emphasis> and <emphasis>
<property>.xhtml</property>
Modified: branches/jbosstools-3.0.x/seam/docs/reference/en/modules/seam_preferences.xml
===================================================================
--- branches/jbosstools-3.0.x/seam/docs/reference/en/modules/seam_preferences.xml 2009-05-11 16:41:23 UTC (rev 15207)
+++ branches/jbosstools-3.0.x/seam/docs/reference/en/modules/seam_preferences.xml 2009-05-11 16:41:39 UTC (rev 15208)
@@ -73,9 +73,10 @@
<para>Notice, that in the <emphasis>
<property>Expression language</property>
- </emphasis> section there is now a preference for setting severity of EL
- Syntax. You can select whether the Seam validator displays an error, a warning or just ignore the EL Syntax error.</para>
-
+ </emphasis> section there is now a preference for setting severity of EL Syntax. You
+ can select whether the Seam validator displays an error, a warning or just ignore
+ the EL Syntax error.</para>
+
<figure>
<title>Severity Preference for EL Syntax</title>
<mediaobject>
@@ -86,9 +87,9 @@
</figure>
<para>In the upper right corner of the page there is a <property>Configure Project
- Specific Settings</property> link. Clicking on it you get the form where you can choose a
- project for specific setting. Project specific configuration allows you to have
- different validator settings for each project. Check the <property>Show only
+ Specific Settings</property> link. Clicking on it you get the form where you can
+ choose a project for specific setting. Project specific configuration allows you to
+ have different validator settings for each project. Check the <property>Show only
projects with project specific settings</property> if you want to see the
projects that have been already set. Click on <property>Ok</property>.</para>
@@ -129,7 +130,7 @@
<title>Project Preferences</title>
<para>Once Seam project is created you can modify its settings. Right click on Seam project
- in Project Explorer and select <emphasis><property>Properties > Seam
+ in Project Explorer and select <emphasis><property>Properties > Seam
Settings</property>.</emphasis></para>
<para>This project properties page allows you to have a flexible project layout. It means
that you are not restricted with a specific project structure. You can use the Seam
@@ -185,8 +186,42 @@
</imageobject>
</mediaobject>
</figure>
+ </section>
+ <section id="add_custom_capabilities">
+ <title>Adding Custom Capabilities</title>
+ <para><property>JBoss Tools</property> provides a possibility to add custom capabilities to any Seam project,
+ i.e. add a support of additional frameworks built on top of JSF, such as <itemizedlist>
+ <listitem><para>ADF</para></listitem>
+ <listitem><para>Facelets</para></listitem>
+ <listitem><para>JBoss Rich Faces (versions 3.1, 3.2, 3.3)</para></listitem>
+ </itemizedlist>
+ </para>
+ <para>To enable it, you should call the context menu for a Seam project and select <emphasis><property>JBoss
+ Tools > Add Custom Capabilities</property>.</emphasis> Then check the needed modules and press
+ <emphasis><property>Finish</property>.</emphasis></para>
+
+ <figure>
+ <title>Adding Custom Capabilities to Seam Project</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_preferences/addCustomCapabilities.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The next page displays all the updates that have been made to the project.</para>
+
+ <figure>
+ <title>Adding Custom Capabilities to Seam Project</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_preferences/addCustomCapabilities2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
</section>
</chapter>
Modified: branches/jbosstools-3.0.x/seam/docs/reference/en/modules/seam_view.xml
===================================================================
--- branches/jbosstools-3.0.x/seam/docs/reference/en/modules/seam_view.xml 2009-05-11 16:41:23 UTC (rev 15207)
+++ branches/jbosstools-3.0.x/seam/docs/reference/en/modules/seam_view.xml 2009-05-11 16:41:39 UTC (rev 15208)
@@ -98,7 +98,7 @@
<para>Selecting the <emphasis><property>Seam Components from Referenced Projects</property></emphasis> will hide the components that dependent on other project.</para>
<figure>
- <title>Available Custimozations</title>
+ <title>Available Customizations</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/seam_view/seam_view_7.png"/>
Modified: branches/jbosstools-3.0.x/seam/docs/reference/en/modules/testng.xml
===================================================================
--- branches/jbosstools-3.0.x/seam/docs/reference/en/modules/testng.xml 2009-05-11 16:41:23 UTC (rev 15207)
+++ branches/jbosstools-3.0.x/seam/docs/reference/en/modules/testng.xml 2009-05-11 16:41:39 UTC (rev 15208)
@@ -243,17 +243,7 @@
<para>Thus with Seam tooling you can easily take advantage of TestNG framework. As you can
see, it generates its own TestNG project as a separate module within which you can
- easily monitor the tests execution and their output.</para>
-
- <para>In conclusion, the main goal of this document is to get you know with a full featureset
- that <property>JBoss Tools</property> provides to support Seam development. Thus if you have
- some questions, comments or suggestions on the topic, please fell free to ask in the <ulink
- url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201">JBoss
- Tools Forum</ulink>. You can also influence on how you want to see JBoss Tools docs in
- future leaving your vote on our page <ulink
- url="http://wiki.jboss.org/wiki/JBossToolsDocsFuture"
- >here</ulink>. </para>
-
- <para>A set of movies on Seam tooling is available <ulink url="http://docs.jboss.org/tools/movies">here</ulink>.</para>
+ easily monitor the tests execution and their output.</para>
+
</section>
</chapter>
Modified: branches/jbosstools-3.0.x/seam/docs/reference/pom.xml
===================================================================
--- branches/jbosstools-3.0.x/seam/docs/reference/pom.xml 2009-05-11 16:41:23 UTC (rev 15207)
+++ branches/jbosstools-3.0.x/seam/docs/reference/pom.xml 2009-05-11 16:41:39 UTC (rev 15208)
@@ -77,6 +77,11 @@
<artifactId>jbosstools-docbook-xslt</artifactId>
<version>1.0.0-SNAPSHOT</version>
</dependency>
+ <dependency>
+ <groupId>org.apache.xmlgraphics</groupId>
+ <artifactId>fop</artifactId>
+ <version>0.95</version>
+ </dependency>
</dependencies>
<configuration>
15 years, 5 months
JBoss Tools SVN: r15207 - branches/jbosstools-3.0.x/seam/docs/reference/en/images/seam_preferences.
by jbosstools-commits@lists.jboss.org
Author: smukhina
Date: 2009-05-11 12:41:23 -0400 (Mon, 11 May 2009)
New Revision: 15207
Added:
branches/jbosstools-3.0.x/seam/docs/reference/en/images/seam_preferences/addCustomCapabilities.png
branches/jbosstools-3.0.x/seam/docs/reference/en/images/seam_preferences/addCustomCapabilities2.png
Log:
https://jira.jboss.org/jira/browse/JBDS-717 merged changes from trunk are added to the corresponding branch
Copied: branches/jbosstools-3.0.x/seam/docs/reference/en/images/seam_preferences/addCustomCapabilities.png (from rev 15128, trunk/seam/docs/reference/en/images/seam_preferences/addCustomCapabilities.png)
===================================================================
(Binary files differ)
Copied: branches/jbosstools-3.0.x/seam/docs/reference/en/images/seam_preferences/addCustomCapabilities2.png (from rev 15128, trunk/seam/docs/reference/en/images/seam_preferences/addCustomCapabilities2.png)
===================================================================
(Binary files differ)
15 years, 5 months