[jbosstools-commits] JBoss Tools SVN: r22207 - in trunk/seam/docs/reference/en-US: images/create_new_seam and 1 other directory.

Author: smukhina Date: 2010-05-20 09:38:02 -0400 (Thu, 20 May 2010) New Revision: 22207 Modified: trunk/seam/docs/reference/en-US/creating_new_seam.xml trunk/seam/docs/reference/en-US/images/create_new_seam/create_seam_1.png trunk/seam/docs/reference/en-US/images/create_new_seam/create_seam_11.png trunk/seam/docs/reference/en-US/images/create_new_seam/create_seam_12.png trunk/seam/docs/reference/en-US/images/create_new_seam/create_seam_13.png trunk/seam/docs/reference/en-US/images/create_new_seam/create_seam_20.png trunk/seam/docs/reference/en-US/images/create_new_seam/create_seam_21.png Log: TOOLSDOC-70-Option to specify the project(s) name in the "Seam Web project" wizard. Obsolete pictures were updated and option to specify projects name is added. Modified: trunk/seam/docs/reference/en-US/creating_new_seam.xml =================================================================== --- trunk/seam/docs/reference/en-US/creating_new_seam.xml 2010-05-20 11:40:13 UTC (rev 22206) +++ trunk/seam/docs/reference/en-US/creating_new_seam.xml 2010-05-20 13:38:02 UTC (rev 22207) @@ -1,464 +1,478 @@ -<?xml version="1.0" encoding="UTF-8"?> -<chapter id="create_seam" xreflabel="create_seam" role="updated"> - <?dbhtml filename="create_new_seam.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss Tools</keyword> - <keyword>Seam</keyword> - <keyword>JBDS</keyword> - </keywordset> - </chapterinfo> - <title>Creating a New Seam Project via the New Seam Project wizard</title> - <para>In this chapter we provide you with the necessary steps to start working with Seam - Framework.</para> - <para>At first, we suggest to set the specific Seam perspective that combines a number of - different views and editors needed for work with resources concerned. For that select - <emphasis> - <property>Window > Open Perspective > Other > Seam</property> - </emphasis> or you can also access it through the button in the right top corner.</para> - <figure> - <title>Seam Perspective Icon</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_0.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Also the <emphasis> - <property>Open Web Browser</property></emphasis> action is directly available in the - <property>Seam perspective</property>.</para> - <figure> - <title>Embedded Web Browser Button</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_01.png"/> - </imageobject> - </mediaobject> - </figure> - <section id="standaloneSeam" role="updated"> - <title>Create standalone Seam Web Project</title> - <para>The best way to get started with Seam is to create a simple Seam Project and - experiment with it.</para> - <para>Thus, you should select <emphasis> - <property>File > New > Seam Web Project</property> - </emphasis> to run the <property>New Seam Project</property> wizard. The wizard form - allows you to create runtime and server instances in order to get started creating, - running, and debugging J2EE (only) 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 allows the wizard to identify correctly - where the required datasource and driver libraries need to go.</para> - <para>Let&apos;s get through the wizard step-by-step. First, you should enter a name and a - location directory for your new project.</para> - <figure id="figure_create_seam1"> - <title>New Seam Project Wizard</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_1.png"/> - </imageobject> - </mediaobject> - </figure> - <para>On the figure above you can see the runtime and the server already created.</para> - <para>If you need to create a new runtime, click on the <emphasis> - <property>New...</property> - </emphasis> button in the <property>Target Runtime</property> section. It brings up the - wizard where you can specify a new JBoss Server Runtime environment or the other type of - runtime appropriate for your project configuration. Let's create one more JBoss 4.2 - Runtime. Hence, after choosing it click on <emphasis> - <property>Next</property> - </emphasis> button.</para> - <figure> - <title>Specifying Target Runtime</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_2.png"/> - </imageobject> - </mediaobject> - </figure> - <para>All what you need here is to name runtime, type the path to its install directory or - locate it by using <emphasis> - <property>Browse</property> - </emphasis> button, select a Java Runtime Environment, and select which configuration - you want.</para> - <figure> - <title>Specifying Target Runtime Configurations</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_3.png"/> - </imageobject> - </mediaobject> - </figure> - <para> Clicking on <emphasis> - <property>Finish</property> - </emphasis> returns you to the <link linkend="figure_create_seam1">New Seam Project - wizard page</link>.</para> - <para>The next step is to define a Server by clicking on <emphasis> - <property>New...</property> - </emphasis> button in the <property>Target Server</property> section. In appeared - <property>New Server dialog</property> the last server which matches the runtime - will be selected.</para> - <para>All declared runtimes are listed in the combo-box under the servers view. Here, you - can indicate a server runtime that you need. Click <emphasis> - <property>Add</property> - </emphasis> if you want to add a new Server Runtime.</para> - <figure> - <title>Specifying Target Server</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_4.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Next page allows you to verify the information for a chosen server. Leave everything - as it is and click on <emphasis> - <property>Next</property> - </emphasis>.</para> - <figure> - <title>JBoss Runtime Summary</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_5.png"/> - </imageobject> - </mediaobject> - </figure> - <para>On the last wizard step you can modify your projects to configure them on the - Server.</para> - <figure> - <title>Project Modification for Configuring on the Server</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_6.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Once you have the Target Server defined click on <emphasis> - <property>Finish</property> - </emphasis> button to return to the first page of the <property>New Seam Project - wizard</property>.</para> - <tip> - <title>Tip:</title> - <para>We suggest that you look through the Application Server Manager Guide to - find out more about runtimes and servers.</para> - </tip> - <figure> - <title>Completion of Runtime and Server Configuration</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_7.png"/> - </imageobject> - </mediaobject> - </figure> - <para>The last section on this wizard step is <property>Configuration</property>. Here, you - can select one of the pre-defined project configurations either associated with Seam - 1.2, Seam 2.0 or with Seam 2.1. Furthermore, you can create your own configuration by - pressing the <emphasis> - <property>Modify...</property> - </emphasis> button. It will open the dialog which allows to configure your own set of - facets for adding extra functionality to your project.</para> - <para>Pass to the next section to find out more details on this dialog.</para> - </section> - <section id="projectFacets"> - <title>Selecting the Project Facets</title> - <para>The <property>Project Facets wizard</property> allows you to enable or disable - specific facets which define necessary features for the project. When you switch to this - wizard form, all critical facets are already checked for the chosen - Configuration.</para> - <para>Notice that this page of the wizard also allows you to set the necessary version for - any facet. </para> - <figure> - <title>Project Facets Selection</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_8.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Moreover, here you can specify your own preset of selected facets by checking needed - ones in project facets window and clicking on <emphasis> - <property>Save</property> - </emphasis> button.</para> - <figure> - <title>Specifying Custom Facet Preset</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_15.png"/> - </imageobject> - </mediaobject> - </figure> - <para>To see all available Server runtimes click on <property>Runtimes</property> tab on the - left. You can create a new one using the <emphasis> - <property>New</property> - </emphasis> button. If more than one runtime is checked here, the <emphasis> - <property>Make Primary</property> - </emphasis> button won&apos;t be dimmed yet. Thus, you can make use of it to mark - primary runtime.</para> - <figure> - <title>Setting Runtime</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_16.png"/> - </imageobject> - </mediaobject> - </figure> - <para><emphasis> - <property>Ok</property> - </emphasis> button will bring you to the <property>Web Module</property> wizard form - again.</para> - <section id="seamWithJPA"> - <title>Seam project with JPA facets</title> - <para>For creating Seam project with JPA support you need to select<property> Java - Persistent</property> facet on <property>Project Facets</property> page and - click <property>OK</property>.</para> - <para>Then you should press <property>Next</property> and may leave the default value on - <property>Java application building</property> page and <property>Web Module - Settings</property> page.</para> - <para>After that you will see <property>JPA facet</property> page.</para> - <figure> - <title>JPA Facet page</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_16b.png"/> - </imageobject> - </mediaobject> - </figure> - <para>On this page you can choose <property>Platform</property> (vendor-specific JPA - implementation) for your project, type of JPA Implementation, and configure the - <property>Connection</property> to database in the <property - >Connection</property> area.</para> - <para>More about <property>JPA facet</property> page you can read in <ulink - url="http://help.eclipse.org/galileo/index.jsp?topic=/org.eclipse.jp... - >Eclipse documentation</ulink>. </para> - <para>On the next step you will see <property>JSF Capabilities</property> and <property>Seam - facet</property> pages, which are mostly the same as in general Seam - project.</para> - </section> - </section> - <section id="configureJava"> - <title>Java application building configuration</title> - <para>With this wizard you can define Java source directories which will be generated on - build path. Also you can specify a default output folder. If you are agree with default - values, press <property>Next</property></para> - <figure> - <title>Java application building Wizard</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_16a.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - <section id="configureWebModule"> - <title>How to Configure Web Module Settings</title> - <para> As we deal with a Dynamic Web Application, we should at first specify the top level - directory of our application for deploying it to a server afterwards. You know, this - kind of application contains Web resources. Thus, it's important to indicate the content - directory. The wizard will put all those values itself, so you can leave everything as - is.</para> - <figure> - <title>Web Module Settings</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_9.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Choose <emphasis> - <property>Next</property> - </emphasis> to switch to the next wizard form.</para> - </section> - <section id="addJSFCapab"> - <title>Adding JSF Capabilities</title> - <para>This wizard helps you to add JSF capabilities to your project. </para> - <para>Choose <emphasis> - <property>Library provided by Target Runtime</property> - </emphasis> from Library Type list if you'd like to use a default JSF implementation - given by the present runtime.</para> - <figure> - <title>Adding JSF Capabilities to Web Project</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_10.png"/> - </imageobject> - </mediaobject> - </figure> - <para>In case if you prefer to use your custom JSF implementation, choose <property>User - Library</property> Item from Library Type list. In User Library list you can check - required library.</para> - <figure> - <title>Using Custom JSF implementation Library </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_17.png"/> - </imageobject> - </mediaobject> - </figure> - <para> If a new library is required, click <property>Manage libraries...</property> ( - <inlinemediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_17a.png"/> - </imageobject> - </inlinemediaobject>) button. Then you should click <property>New</property>.</para> - <figure> - <title>Using Custom JSF implementation Library </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_18.png"/> - </imageobject> - </mediaobject> - </figure> - <para> Here, it's necessary to type a <property>Library Name</property>. </para> - <figure> - <title>Entering New User Library Name</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_23.png"/> - </imageobject> - </mediaobject> - </figure> - <para>To add proper <property>Library JARs</property>, click <property>Add - JARs...</property> button and select the JARs on your hard drive. </para> - <figure> - <title>Selection Library JARs</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_25.png"/> - </imageobject> - </mediaobject> - </figure> - <para>You can download necessary JSF implementation libraries provided by Sun and Apache - Foundation as well. Click <property>Download...</property> (<inlinemediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_23a.png"/> - </imageobject> - </inlinemediaobject>) button and choose one of proposed libraries.</para> - <figure> - <title>Download JSF Implementation Library</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_24.png"/> - </imageobject> - </mediaobject> - </figure> - <para>The last wizard options allows to edit a path for <property>JSF Configuration - File</property>, a name for <property>JSF Servlet</property>, <property>JSF Servlet - Classname</property> and change <property>URL Mapping Patterns</property>.</para> - <figure> - <title>JSF Capabilities Wizard</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_19.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Since we are arranging the Seam Web project, the last step we should do is to adjust - project configurations associated with the Seam.</para> - </section> - <section id="seamFacet"> - <title>Configure Seam Facet Settings</title> - <para>The last wizard step is related to Seam facet and allows you to do the - following:</para> - <figure> - <title>Seam Facet Settings</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_11.png"/> - </imageobject> - </mediaobject> - </figure> - <itemizedlist> - <listitem> - <para>Create Seam runtime and define Seam home folder.</para> - </listitem> - </itemizedlist> - <para>For that click on <emphasis> - <property>Add</property> - </emphasis> button in the <property>General</property> section. Note, in the wizard - shown below you can create a Seam runtime only for the version that was selected in the - <link linkend="projectFacets">Project Facets</link> wizard (version 1.2 in our - case).</para> - <figure> - <title>Seam Runtime Creation</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_12.png"/> - </imageobject> - </mediaobject> - </figure> - <itemizedlist> - <listitem> - <para>Select EAR or WAR deployment by checking a necessary radio button.</para> - </listitem> - <listitem> - <para>Select a <emphasis> - <property>Database Type</property> - </emphasis></para> - </listitem> - </itemizedlist> - <figure> - <title>Database Type Selecting</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_20.png"/> - </imageobject> - </mediaobject> - </figure> - <itemizedlist> - <listitem> - <para>and then specify a <emphasis> - <property>Connection profile</property> - </emphasis> appropriate for your database.</para> - </listitem> - </itemizedlist> - <figure> - <title>Connection Profile Options</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_21.png"/> - </imageobject> - </mediaobject> - </figure> - <para>You can edit chosen profile by using <emphasis> - <property>Edit</property> - </emphasis> button or organise a new one by clicking on <emphasis> - <property>New</property> - </emphasis> button and selecting necessary for you type of connection profile.</para> - <figure> - <title>Connection Profile Selecting</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_13.png"/> - </imageobject> - </mediaobject> - </figure> - <para>On the dialog you&apos;ll be asked to enter its name and description. And then you - should select a proper driver and adjust connection details. Press <emphasis> - <property>Next</property> - </emphasis> to preview all the adjusted settings and complete the creation of the new - profile.</para> - <figure> - <title>Connection Details</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_22.png"/> - </imageobject> - </mediaobject> - </figure> - <para>The next block of settings in the Seam Facet wizard are describing a Database and a - connection to it.</para> - <para>In the <property>Code Generation</property> section the wizard has already provided - the names for your <property>Session Bean</property>, <property>Entity Bean</property> - and <property>Test</property> packages generation (optional). Of course, you can change - them on others of your choice.</para> - <figure> - <title>Code Generation Section</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/create_new_seam/create_seam_14.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Click on <emphasis> - <property>Finish</property> - </emphasis> to generate a project.</para> - <para/> - </section> -</chapter> +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="create_seam" xreflabel="create_seam" role="updated"> + <?dbhtml filename="create_new_seam.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Tools</keyword> + <keyword>Seam</keyword> + <keyword>JBDS</keyword> + </keywordset> + </chapterinfo> + <title>Creating a New Seam Project via the New Seam Project wizard</title> + <para>In this chapter we provide you with the necessary steps to start working with Seam + Framework.</para> + <para>At first, we suggest to set the specific Seam perspective that combines a number of + different views and editors needed for work with resources concerned. For that select + <emphasis> + <property>Window > Open Perspective > Other > Seam</property> + </emphasis> or you can also access it through the button in the right top corner.</para> + <figure> + <title>Seam Perspective Icon</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_0.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Also the <emphasis> + <property>Open Web Browser</property></emphasis> action is directly available in the + <property>Seam perspective</property>.</para> + <figure> + <title>Embedded Web Browser Button</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_01.png"/> + </imageobject> + </mediaobject> + </figure> + <section id="standaloneSeam" role="updated"> + <title>Create standalone Seam Web Project</title> + <para>The best way to get started with Seam is to create a simple Seam Project and + experiment with it.</para> + <para>Thus, you should select <emphasis> + <property>File > New > Seam Web Project</property> + </emphasis> to run the <property>New Seam Project</property> wizard. The wizard form + allows you to create runtime and server instances in order to get started creating, + running, and debugging J2EE (only) 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 allows the wizard to identify correctly + where the required datasource and driver libraries need to go.</para> + <para>Let&apos;s get through the wizard step-by-step. First, you should enter a name and a + location directory for your new project.</para> + <figure id="figure_create_seam1"> + <title>New Seam Project Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_1.png"/> + </imageobject> + </mediaobject> + </figure> + <para>On the figure above you can see the runtime and the server already created.</para> + <para>If you need to create a new runtime, click on the <emphasis> + <property>New...</property> + </emphasis> button in the <property>Target Runtime</property> section. It brings up the + wizard where you can specify a new JBoss Server Runtime environment or the other type of + runtime appropriate for your project configuration. Let's create one more JBoss 4.2 + Runtime. Hence, after choosing it click on <emphasis> + <property>Next</property> + </emphasis> button.</para> + <figure> + <title>Specifying Target Runtime</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_2.png"/> + </imageobject> + </mediaobject> + </figure> + <para>All what you need here is to name runtime, type the path to its install directory or + locate it by using <emphasis> + <property>Browse</property> + </emphasis> button, select a Java Runtime Environment, and select which configuration + you want.</para> + <figure> + <title>Specifying Target Runtime Configurations</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_3.png"/> + </imageobject> + </mediaobject> + </figure> + <para> Clicking on <emphasis> + <property>Finish</property> + </emphasis> returns you to the <link linkend="figure_create_seam1">New Seam Project + wizard page</link>.</para> + <para>The next step is to define a Server by clicking on <emphasis> + <property>New...</property> + </emphasis> button in the <property>Target Server</property> section. In appeared + <property>New Server dialog</property> the last server which matches the runtime + will be selected.</para> + <para>All declared runtimes are listed in the combo-box under the servers view. Here, you + can indicate a server runtime that you need. Click <emphasis> + <property>Add</property> + </emphasis> if you want to add a new Server Runtime.</para> + <figure> + <title>Specifying Target Server</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_4.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Next page allows you to verify the information for a chosen server. Leave everything + as it is and click on <emphasis> + <property>Next</property> + </emphasis>.</para> + <figure> + <title>JBoss Runtime Summary</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_5.png"/> + </imageobject> + </mediaobject> + </figure> + <para>On the last wizard step you can modify your projects to configure them on the + Server.</para> + <figure> + <title>Project Modification for Configuring on the Server</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_6.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Once you have the Target Server defined click on <emphasis> + <property>Finish</property> + </emphasis> button to return to the first page of the <property>New Seam Project + wizard</property>.</para> + <tip> + <title>Tip:</title> + <para>We suggest that you look through the Application Server Manager Guide to + find out more about runtimes and servers.</para> + </tip> + <figure> + <title>Completion of Runtime and Server Configuration</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_7.png"/> + </imageobject> + </mediaobject> + </figure> + <para>The last section on this wizard step is <property>Configuration</property>. Here, you + can select one of the pre-defined project configurations either associated with Seam + 1.2, Seam 2.0 or with Seam 2.1. Furthermore, you can create your own configuration by + pressing the <emphasis> + <property>Modify...</property> + </emphasis> button. It will open the dialog which allows to configure your own set of + facets for adding extra functionality to your project.</para> + <para>Pass to the next section to find out more details on this dialog.</para> + </section> + <section id="projectFacets"> + <title>Selecting the Project Facets</title> + <para>The <property>Project Facets wizard</property> allows you to enable or disable + specific facets which define necessary features for the project. When you switch to this + wizard form, all critical facets are already checked for the chosen + Configuration.</para> + <para>Notice that this page of the wizard also allows you to set the necessary version for + any facet. </para> + <figure> + <title>Project Facets Selection</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_8.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Moreover, here you can specify your own preset of selected facets by checking needed + ones in project facets window and clicking on <emphasis> + <property>Save</property> + </emphasis> button.</para> + <figure> + <title>Specifying Custom Facet Preset</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_15.png"/> + </imageobject> + </mediaobject> + </figure> + <para>To see all available Server runtimes click on <property>Runtimes</property> tab on the + left. You can create a new one using the <emphasis> + <property>New</property> + </emphasis> button. If more than one runtime is checked here, the <emphasis> + <property>Make Primary</property> + </emphasis> button won&apos;t be dimmed yet. Thus, you can make use of it to mark + primary runtime.</para> + <figure> + <title>Setting Runtime</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_16.png"/> + </imageobject> + </mediaobject> + </figure> + <para><emphasis> + <property>Ok</property> + </emphasis> button will bring you to the <property>Web Module</property> wizard form + again.</para> + <section id="seamWithJPA"> + <title>Seam project with JPA facets</title> + <para>For creating Seam project with JPA support you need to select<property> Java + Persistent</property> facet on <property>Project Facets</property> page and + click <property>OK</property>.</para> + <para>Then you should press <property>Next</property> and may leave the default value on + <property>Java application building</property> page and <property>Web Module + Settings</property> page.</para> + <para>After that you will see <property>JPA facet</property> page.</para> + <figure> + <title>JPA Facet page</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_16b.png"/> + </imageobject> + </mediaobject> + </figure> + <para>On this page you can choose <property>Platform</property> (vendor-specific JPA + implementation) for your project, type of JPA Implementation, and configure the + <property>Connection</property> to database in the <property + >Connection</property> area.</para> + <para>More about <property>JPA facet</property> page you can read in <ulink + url="http://help.eclipse.org/galileo/index.jsp?topic=/org.eclipse.jp... + >Eclipse documentation</ulink>. </para> + <para>On the next step you will see <property>JSF Capabilities</property> and <property>Seam + facet</property> pages, which are mostly the same as in general Seam + project.</para> + </section> + </section> + <section id="configureJava"> + <title>Java application building configuration</title> + <para>With this wizard you can define Java source directories which will be generated on + build path. Also you can specify a default output folder. If you are agree with default + values, press <property>Next</property></para> + <figure> + <title>Java application building Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_16a.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="configureWebModule"> + <title>How to Configure Web Module Settings</title> + <para> As we deal with a Dynamic Web Application, we should at first specify the top level + directory of our application for deploying it to a server afterwards. You know, this + kind of application contains Web resources. Thus, it's important to indicate the content + directory. The wizard will put all those values itself, so you can leave everything as + is.</para> + <figure> + <title>Web Module Settings</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_9.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Choose <emphasis> + <property>Next</property> + </emphasis> to switch to the next wizard form.</para> + </section> + <section id="addJSFCapab"> + <title>Adding JSF Capabilities</title> + <para>This wizard helps you to add JSF capabilities to your project. </para> + <para>Choose <emphasis> + <property>Library provided by Target Runtime</property> + </emphasis> from Library Type list if you'd like to use a default JSF implementation + given by the present runtime.</para> + <figure> + <title>Adding JSF Capabilities to Web Project</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_10.png"/> + </imageobject> + </mediaobject> + </figure> + <para>In case if you prefer to use your custom JSF implementation, choose <property>User + Library</property> Item from Library Type list. In User Library list you can check + required library.</para> + <figure> + <title>Using Custom JSF implementation Library </title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_17.png"/> + </imageobject> + </mediaobject> + </figure> + <para> If a new library is required, click <property>Manage libraries...</property> ( + <inlinemediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_17a.png"/> + </imageobject> + </inlinemediaobject>) button. Then you should click <property>New</property>.</para> + <figure> + <title>Using Custom JSF implementation Library </title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_18.png"/> + </imageobject> + </mediaobject> + </figure> + <para> Here, it's necessary to type a <property>Library Name</property>. </para> + <figure> + <title>Entering New User Library Name</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_23.png"/> + </imageobject> + </mediaobject> + </figure> + <para>To add proper <property>Library JARs</property>, click <property>Add + JARs...</property> button and select the JARs on your hard drive. </para> + <figure> + <title>Selection Library JARs</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_25.png"/> + </imageobject> + </mediaobject> + </figure> + <para>You can download necessary JSF implementation libraries provided by Sun and Apache + Foundation as well. Click <property>Download...</property> (<inlinemediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_23a.png"/> + </imageobject> + </inlinemediaobject>) button and choose one of proposed libraries.</para> + <figure> + <title>Download JSF Implementation Library</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_24.png"/> + </imageobject> + </mediaobject> + </figure> + <para>The last wizard options allows to edit a path for <property>JSF Configuration + File</property>, a name for <property>JSF Servlet</property>, <property>JSF Servlet + Classname</property> and change <property>URL Mapping Patterns</property>.</para> + <figure> + <title>JSF Capabilities Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_19.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Since we are arranging the Seam Web project, the last step we should do is to adjust + project configurations associated with the Seam.</para> + </section> + <section id="seamFacet"> + <title>Configure Seam Facet Settings</title> + <para>The last wizard step is related to Seam facet and allows you to do the + following:</para> + <figure> + <title>Seam Facet Settings</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_11.png"/> + </imageobject> + </mediaobject> + </figure> + <itemizedlist> + <listitem> + <para>Create Seam runtime and define Seam home folder.</para> + </listitem> + </itemizedlist> + <para>For that click on <emphasis> + <property>Add</property> + </emphasis> button in the <property>General</property> section. Note, in the wizard + shown below you can create a Seam runtime only for the version that was selected in the + <link linkend="projectFacets">Project Facets</link> wizard (version 1.2 in our + case).</para> + <figure> + <title>Seam Runtime Creation</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_12.png"/> + </imageobject> + </mediaobject> + </figure> + + <itemizedlist> + <listitem> + <para>Select EAR or WAR deployment by checking a necessary radio button.</para> + </listitem> + <listitem> + <para>Enter EJB project name and EAR project name in case of EAR radio button is checked.</para> + </listitem> + </itemizedlist> + + <tip> + <title>Tip:</title> + <para>If you want to name your web project "MyProject-war" note that the EJB project should not be "MyProject-war-ejb", + it should be "MyProject-ejb". The same for EAR and Test projects' names. They should be respectively "MyProject-ear" + and "MyProject-test".</para> + </tip> + + <itemizedlist> + <listitem> + <para>Select a <emphasis> + <property>Database Type</property> + </emphasis></para> + </listitem> + </itemizedlist> + <figure> + <title>Database Type Selecting</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_20.png"/> + </imageobject> + </mediaobject> + </figure> + <itemizedlist> + <listitem> + <para>and then specify a <emphasis> + <property>Connection profile</property> + </emphasis> appropriate for your database.</para> + </listitem> + </itemizedlist> + <figure> + <title>Connection Profile Options</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_21.png"/> + </imageobject> + </mediaobject> + </figure> + <para>You can edit chosen profile by using <emphasis> + <property>Edit</property> + </emphasis> button or organise a new one by clicking on <emphasis> + <property>New</property> + </emphasis> button and selecting necessary for you type of connection profile.</para> + <figure> + <title>Connection Profile Selecting</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_13.png"/> + </imageobject> + </mediaobject> + </figure> + <para>On the dialog you&apos;ll be asked to enter its name and description. And then you + should select a proper driver and adjust connection details. Press <emphasis> + <property>Next</property> + </emphasis> to preview all the adjusted settings and complete the creation of the new + profile.</para> + <figure> + <title>Connection Details</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_22.png"/> + </imageobject> + </mediaobject> + </figure> + <para>The next block of settings in the Seam Facet wizard are describing a Database and a + connection to it.</para> + <para>In the <property>Code Generation</property> section the wizard has already provided + the names for your <property>Session Bean</property>, <property>Entity Bean</property> + and <property>Test</property> packages generation (optional). Of course, you can change + them on others of your choice.</para> + <figure> + <title>Code Generation Section</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/create_new_seam/create_seam_14.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Click on <emphasis> + <property>Finish</property> + </emphasis> to generate a project.</para> + <para/> + </section> +</chapter> \ No newline at end of file Modified: trunk/seam/docs/reference/en-US/images/create_new_seam/create_seam_1.png =================================================================== (Binary files differ) Modified: trunk/seam/docs/reference/en-US/images/create_new_seam/create_seam_11.png =================================================================== (Binary files differ) Modified: trunk/seam/docs/reference/en-US/images/create_new_seam/create_seam_12.png =================================================================== (Binary files differ) Modified: trunk/seam/docs/reference/en-US/images/create_new_seam/create_seam_13.png =================================================================== (Binary files differ) Modified: trunk/seam/docs/reference/en-US/images/create_new_seam/create_seam_20.png =================================================================== (Binary files differ) Modified: trunk/seam/docs/reference/en-US/images/create_new_seam/create_seam_21.png =================================================================== (Binary files differ)