Author: afedosik Date: 2007-12-03 10:01:26 -0500 (Mon, 03 Dec 2007) New Revision: 5196 Added: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards10.png trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards11.png trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards12.png trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards13.png trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards14.png trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards15.png trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards16.png trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards17.png trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards7.png trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards8.png trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards9.png Removed: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards3.png trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards6_1.png Modified: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards2.png trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards4.png trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards5.png trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards6.png trunk/seam/docs/reference/en/modules/seam_wizards.xml Log: http://jira.jboss.com/jira/browse/RHDS-289 Seam Wizards chapter update Added: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards10.png =================================================================== (Binary files differ) Property changes on: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards10.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards11.png =================================================================== (Binary files differ) Property changes on: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards11.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards12.png =================================================================== (Binary files differ) Property changes on: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards12.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards13.png =================================================================== (Binary files differ) Property changes on: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards13.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards14.png =================================================================== (Binary files differ) Property changes on: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards14.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards15.png =================================================================== (Binary files differ) Property changes on: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards15.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards16.png =================================================================== (Binary files differ) Property changes on: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards16.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards17.png =================================================================== (Binary files differ) Property changes on: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards17.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Modified: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards2.png =================================================================== (Binary files differ) Deleted: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards3.png =================================================================== (Binary files differ) Modified: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards4.png =================================================================== (Binary files differ) Modified: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards5.png =================================================================== (Binary files differ) Modified: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards6.png =================================================================== (Binary files differ) Deleted: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards6_1.png =================================================================== (Binary files differ) Added: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards7.png =================================================================== (Binary files differ) Property changes on: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards7.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards8.png =================================================================== (Binary files differ) Property changes on: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards8.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards9.png =================================================================== (Binary files differ) Property changes on: trunk/seam/docs/reference/en/images/seam_wizards/seam_wizards9.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Modified: trunk/seam/docs/reference/en/modules/seam_wizards.xml =================================================================== --- trunk/seam/docs/reference/en/modules/seam_wizards.xml 2007-12-03 14:39:35 UTC (rev 5195) +++ trunk/seam/docs/reference/en/modules/seam_wizards.xml 2007-12-03 15:01:26 UTC (rev 5196) @@ -15,10 +15,10 @@ for creating various common Seam components:</para> <itemizedlist> - <listitem><para>Seam Action</para></listitem> - <listitem><para>Seam Form</para></listitem> - <listitem><para>Seam Entity</para></listitem> - <listitem><para>Seam Conversation</para></listitem> + <listitem><para><property>Seam Action</property></para></listitem> + <listitem><para><property>Seam Form</property></para></listitem> + <listitem><para><property>Seam Entity</property></para></listitem> + <listitem><para><property>Seam Conversation</property></para></listitem> </itemizedlist> <para>Go to <emphasis><property>File > New</property></emphasis> and select the component wizard.</para> @@ -33,115 +33,222 @@ </figure> <para>The wizards create multiple resources and place it in the appropriate folders depending on your project structure (WAR or EAR).</para> + <para>Let&apos;s create a WAR project using the New Seam Project wizard.</para> + + <figure> + <title>Seam Project WAR Deployment</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/seam_wizards/seam_wizards2.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>After the project is created you need deploy it on server.</para> + <section id="seam_action"> <title>New Seam Action</title> - + <para>To create a New Seam Action you should select a necessary project, type a name for <property>Seam component</property>, <property>POJO class</property>, - <property>Method</property>, <property>Page</property> and select a <property>Package</property> using <emphasis><property>Browse</property></emphasis> button.</para> - - <para>WAR deployment:</para> - + <property>Method</property>, <property>Page</property> and select a <property>Package</property> using <emphasis><property>Browse</property></emphasis> button.</para> + <figure> <title>New Seam Action Wizard</title> <mediaobject> <imageobject> - <imagedata fileref="images/seam_wizards/seam_wizards2.png"/> + <imagedata fileref="images/seam_wizards/seam_wizards4.png"/> </imageobject> </mediaobject> </figure> - <para>The wizard for EAR deployment differs from WAR in <property>Local interface</property> and <property>Bean</property> fields so you need to fill them in.</para> + <para>You can see the action page in <property>WebContent</property> folder. Click on it to open in JBoss Tools HTML Editor.</para> - <para>EAR deployment:</para> - + <figure> + <title>Action Page in JBoss Tools HTML Editor.</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/seam_wizards/seam_wizards5.png"/> + </imageobject> + </mediaobject> + </figure> + + + <note> + <title>Note:</title> + <para>You don't need to restart the server to see how the action component works. Just use context menu + <emphasis><property>Run As > Run On Server</property>.</emphasis></para> + </note> + + <para>Action component was hot-deployed. Forms and Conversations will work the same way.</para> + <figure> - <title>New Seam Action Wizard</title> + <title>Action Component</title> <mediaobject> <imageobject> - <imagedata fileref="images/seam_wizards/seam_wizards3.png"/> + <imagedata fileref="images/seam_wizards/seam_wizards6.png"/> </imageobject> </mediaobject> </figure> + + </section> <section id="seam_form"> <title>New Seam Form</title> - - <para>To create a New Seam Form you should select a necessary project, type a name for <property>Seam component</property>, <property>POJO class</property>, + + <para>Click on <property>actionMethod</property> in the internal browser and add a form in your project using the New Seam Form wizard + <emphasis><property>File > New > Seam Form</property>.</emphasis></para> + <para>Select a necessary project, type a name for <property>Seam component</property>, <property>POJO class</property>, <property>Method</property>, <property>Page</property> and select a <property>Package</property> using <emphasis><property>Browse</property></emphasis> button.</para> - - <para>WAR deployment:</para> - <figure> <title>New Seam Form Wizard</title> <mediaobject> <imageobject> - <imagedata fileref="images/seam_wizards/seam_wizards4.png"/> + <imagedata fileref="images/seam_wizards/seam_wizards7.png"/> </imageobject> </mediaobject> </figure> + <para>The Form Page was created in <property>WebContent</property> folder.</para> - <para>The wizard for EAR deployment differs from WAR in <property>Local interface</property> and <property>Bean</property> fields so you need to fill them in.</para> - <para>EAR deployment is:</para> - - <figure> - <title>New Seam Form Wizard</title> + <figure> + <title>Form Page in JBoss Tools HTML Editor.</title> <mediaobject> <imageobject> - <imagedata fileref="images/seam_wizards/seam_wizards4_1.png"/> + <imagedata fileref="images/seam_wizards/seam_wizards8.png"/> </imageobject> </mediaobject> </figure> - </section> - <section id="seam_entity"> - <title>New Seam Entity</title> + <para>Deploy the form on server. Right click on Form Page, select <emphasis><property>Run As > Run On Server</property>.</emphasis></para> - <para>To create New Seam Entity you should select a necessary project, type a name for <property>Entity class</property>, select a - <property>Package</property> using <emphasis><property>Browse</property></emphasis> button, type a name for <property>Master Page</property> and <property>Page</property>.</para> - <figure> - <title>New Seam Entity Wizard</title> + <title>Form Component</title> <mediaobject> <imageobject> - <imagedata fileref="images/seam_wizards/seam_wizards5.png"/> + <imagedata fileref="images/seam_wizards/seam_wizards9.png"/> </imageobject> </mediaobject> </figure> - - </section> + + <para>Form component was hot-deployed.</para> + + </section> + <section id="seam_conversation"> <title>New Seam Conversation</title> - <para>To create a New Seam Conversation you should select a necessary project, type a name for <property>Seam component</property>, <property>POJO class</property>, + <para>Enter some value in the text field (e.g. <property>value1</property>) and click on <property>formMethod</property>.</para> + <para>Add a conversation using the New Seam Conversation wizard + <emphasis><property>File > New > Seam Form</property>.</emphasis></para> + <para>You should select a necessary project, type a name for <property>Seam component</property>, <property>POJO class</property>, <property>Method</property>, <property>Page</property> and select a <property>Package</property> using <emphasis><property>Browse</property></emphasis> button.</para> + - <para>WAR deployment:</para> - <figure> <title>New Seam Conversation Wizard</title> <mediaobject> <imageobject> - <imagedata fileref="images/seam_wizards/seam_wizards6.png"/> + <imagedata fileref="images/seam_wizards/seam_wizards10.png"/> </imageobject> </mediaobject> </figure> - <para>The wizard for EAR deployment differs from WAR in <property>Local interface</property> and <property>Bean</property> fields so you need to fill them in.</para> - <para>EAR deployment:</para> + <para>Conversation page was created in <property>WebContent</property> folder.</para> + + <figure> + <title>Conversation Page in JBoss Tools HTML Editor.</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/seam_wizards/seam_wizards11.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Right click on Conversation page, select <emphasis><property>Run As > Run On Server</property>.</emphasis></para> + <figure> - <title>New Seam Conversation Wizard</title> + <title>Conversation Component</title> <mediaobject> <imageobject> - <imagedata fileref="images/seam_wizards/seam_wizards6_1.png"/> + <imagedata fileref="images/seam_wizards/seam_wizards12.png"/> </imageobject> </mediaobject> </figure> + <para>Conversation component was hot-deployed.</para> + <para>Click on <property>Begin</property> and <property>Increment</property> buttons to check the conversation functionality.</para> + </section> + + + <section id="seam_entity"> + <title>New Seam Entity</title> + + <para>Entities cannot be hot-deployed, so we need to stop the server.</para> + <para>Create an Entity using the New Entity wizard <emphasis><property>File > New > Seam Entity</property>.</emphasis> </para> + + <para>You should select a necessary project, type a name for <property>Entity class</property>, select a + <property>Package</property> using <emphasis><property>Browse</property></emphasis> button, type a name for <property>Master Page</property> and <property>Page</property>.</para> + + <figure> + <title>New Seam Entity Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/seam_wizards/seam_wizards13.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>The Master Page and the Entity were created in <property>WebContent</property> folder.</para> + + <figure> + <title>Master Page in JBoss Tools HTML Editor.</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/seam_wizards/seam_wizards14.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>The Entity page is:</para> + + <figure> + <title>Entity Page in JBoss Tools HTML Editor.</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/seam_wizards/seam_wizards15.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Run the Entity page on server. This is what you get:</para> + + <figure> + <title>Customer Page</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/seam_wizards/seam_wizards16.png"/> + </imageobject> + </mediaobject> + </figure> + + </section> + + <para>Let's create two customers <property>c1</property> and <property>c2</property>. Enter the name in the text field and press the <property>Save</property> button. + Customer should be successfully created. Press <property>Done</property>. Do the same for <property>c2</property> customer. The result should be:</para> + + <figure> + <title>Two Customers Are Created</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/seam_wizards/seam_wizards17.png"/> + </imageobject> + </mediaobject> + </figure> + + </chapter>