Author: afedosik Date: 2007-11-20 09:12:23 -0500 (Tue, 20 Nov 2007) New Revision: 4983 Added: trunk/seam/docs/reference/en/images/directory_structure/directory_structure1.png trunk/seam/docs/reference/en/images/directory_structure/directory_structure2.png Modified: trunk/seam/docs/reference/en/modules/creating_new_seam.xml trunk/seam/docs/reference/en/modules/directory_structure.xml trunk/seam/docs/reference/en/modules/generate_entities.xml trunk/seam/docs/reference/en/modules/seam_wizards.xml Log: http://jira.jboss.com/jira/browse/RHDS-289 directory structure info with screens is added Added: trunk/seam/docs/reference/en/images/directory_structure/directory_structure1.png =================================================================== (Binary files differ) Property changes on: trunk/seam/docs/reference/en/images/directory_structure/directory_structure1.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/seam/docs/reference/en/images/directory_structure/directory_structure2.png =================================================================== (Binary files differ) Property changes on: trunk/seam/docs/reference/en/images/directory_structure/directory_structure2.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Modified: trunk/seam/docs/reference/en/modules/creating_new_seam.xml =================================================================== --- trunk/seam/docs/reference/en/modules/creating_new_seam.xml 2007-11-20 13:58:40 UTC (rev 4982) +++ trunk/seam/docs/reference/en/modules/creating_new_seam.xml 2007-11-20 14:12:23 UTC (rev 4983) @@ -16,7 +16,9 @@ <title>Create standalone Seam Web Project</title> <para>You are able to enter a name and a location directory for your new project. Next wizard's sections allows you create runtime and server instances in order - to get started creating, running, and debugging J2EE applications.</para> + to get started creating, running, and debugging J2EE applications.</para> + <para>Seam Web Project wizard has an option for selecting the actual Server (not just WTP runtime) that will be used for the project. This allow the wizard to correctly + identify where the needed datasource and driver libraries need to go.</para> <figure> <title>New Seam Project Wizard</title> Modified: trunk/seam/docs/reference/en/modules/directory_structure.xml =================================================================== --- trunk/seam/docs/reference/en/modules/directory_structure.xml 2007-11-20 13:58:40 UTC (rev 4982) +++ trunk/seam/docs/reference/en/modules/directory_structure.xml 2007-11-20 14:12:23 UTC (rev 4983) @@ -12,13 +12,53 @@ <title>Directory Structure of the Generated Project</title> <para>In this chapter we describe where the Seam wizard put the generated files for both EAR and WAR deployments.</para> - - <section id="EAR"> + <para>The Seam Project wizard generates projects like Eclipse WTP style in order to utilize Eclipse WTP features and to have a correct classpath. To be more precise it generates + one project per artifact.</para> + + <section id="WAR"> + <title>WAR Deployment</title> + + <para>The project layout for WAR projects is:</para> + + <figure> + <title>Project Layout for WAR projects</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/directory_structure/directory_structure1.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>WAR projects are generated to enable Seam 1.2.1 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 components.</para> + <note> + <title>Note:</title> + <para>Because of Eclipse WTP limits the hot deployed classes also existen in <emphasis><property>WEB-INF/classes</property></emphasis>, + but since Seam gives <emphasis><property>WEB-INF/dev</property></emphasis> precedence it will work.</para> + </note> + + <para>Furthermore the Seam Project wizard generates a test project that is setup to run TestNG directly against the proper libraries and server runtime libraries. + When the TestNG plugin is installed you can just run your tests via <emphasis><property>Run As > TestNG Test</property>.</emphasis></para> + + + + </section> + + <section id="EAR"> <title>EAR Deployment</title> + <para>The project layout for EAR projects is:</para> + + <figure> + <title>Project Layout for WAR projects</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/directory_structure/directory_structure2.png"/> + </imageobject> + </mediaobject> + </figure> + + </section> + - <section id="WAR"> - <title>WAR Deployment</title> - </section> - </chapter> Modified: trunk/seam/docs/reference/en/modules/generate_entities.xml =================================================================== --- trunk/seam/docs/reference/en/modules/generate_entities.xml 2007-11-20 13:58:40 UTC (rev 4982) +++ trunk/seam/docs/reference/en/modules/generate_entities.xml 2007-11-20 14:12:23 UTC (rev 4983) @@ -11,4 +11,7 @@ <title>Seam Generate Entities</title> + <para>Generate Entities is available directly from within Eclipse using Hibernate Tools plugin for the standard seam-gen generation.</para> + <para>Generate Entities generates a set of CRUD Seam components and web pages based on existing tables in a database or on existing entities in your application.</para> + </chapter> Modified: trunk/seam/docs/reference/en/modules/seam_wizards.xml =================================================================== --- trunk/seam/docs/reference/en/modules/seam_wizards.xml 2007-11-20 13:58:40 UTC (rev 4982) +++ trunk/seam/docs/reference/en/modules/seam_wizards.xml 2007-11-20 14:12:23 UTC (rev 4983) @@ -11,7 +11,20 @@ <title>Seam Wizards</title> + <para>All the Seam component generations options known from Seam-gen are available as wizards (with sensible auto-defaulting) + 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> + </itemizedlist> + + <para>The wizards creates multiple resources and placed in the apropriate folders dependent on your project structure (WAR or EAR)</para> + <section id="seam_action"> + <title>New Seam Action</title> </section>