[jbosstools-commits] JBoss Tools SVN: r22207 - in trunk/seam/docs/reference/en-US: images/create_new_seam and 1 other directory.
jbosstools-commits at lists.jboss.org
jbosstools-commits at lists.jboss.org
Thu May 20 09:38:03 EDT 2010
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'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'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.jpt.doc.user/ref_jpa_facet.htm"
- >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'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'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'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.jpt.doc.user/ref_jpa_facet.htm"
+ >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'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)
More information about the jbosstools-commits
mailing list