Author: irooskov(a)redhat.com
Date: 2010-06-08 20:10:24 -0400 (Tue, 08 Jun 2010)
New Revision: 22658
Modified:
tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/images/jsf_support/jsf_support_23.png
tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/jsf_config_file.xml
tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/master.xml
tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/master_output.xml
tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/webxml_editor.xml
Log:
updated for 3.0.1
Modified:
tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/images/jsf_support/jsf_support_23.png
===================================================================
(Binary files differ)
Modified: tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/jsf_config_file.xml
===================================================================
---
tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/jsf_config_file.xml 2010-06-09
00:08:25 UTC (rev 22657)
+++
tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/jsf_config_file.xml 2010-06-09
00:10:24 UTC (rev 22658)
@@ -1,436 +1,436 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<chapter id="jsf_config_file" role="updated">
- <?dbhtml filename="jsf_config_file.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Developer Studio</keyword>
- <keyword>Eclipse</keyword>
- <keyword>JSF Tools</keyword>
- <keyword>Java</keyword>
- <keyword>JBoss</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>JSF Configuration File Editor</title>
-
- <para>First, we should mention that JSF configuration file (<emphasis>
- <property>faces-config.xml</property>
- </emphasis>) is intended for registering JSF application resources such as
Converters,
- Validators, Managed Beans and page-to-page navigation rules.</para>
- <para>Now, let's look at how you can easily configure this file by
means of a special
- graphical editor for JSF configuration file. The editor has three main
views:</para>
-
- <itemizedlist>
- <listitem>
- <para>Diagram</para>
- </listitem>
- <listitem>
- <para>Tree</para>
- </listitem>
- <listitem>
- <para>Source</para>
- </listitem>
- </itemizedlist>
-
- <para>They can be selected via the tabs at the bottom of the
editor.</para>
-
- <section id="Diagram9553">
-
- <title>Diagram view</title>
-
- <para>Here, we will show you how to work with JSF configuration file
through the Diagram
- view of the editor.</para>
- <para>As you can see on the figure below, the Diagram view displays the
navigation rules in
- the faces-config.xml:</para>
- <figure>
- <title>Diagram View</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_21.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>If your diagram is large, make use of the Outline view. Within it you
can switch to a <emphasis>
- <property>Diagram Navigator</property>
- </emphasis> mode by selecting the middle icon at the top of the view
window. It allows
- you to easily move around the diagram. Just move the blue area in any
direction, and the
- diagram on the left will also move:</para>
- <figure>
- <title>Outline View for Diagram</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_32.png" scale="50"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>To create a new page here, you should click the page icon (View
Template) on the
- toolbar from the left and then click anywhere on the diagram. A New Page
Wizard will
- appear.</para>
-
- <para>To create a transition for connecting pages:</para>
-
- <itemizedlist>
- <listitem>
- <para>Select the transition icon from the toolbar (New
Connection).</para>
- </listitem>
- <listitem>
- <para>Click the source page.</para>
- </listitem>
- <listitem>
- <para>Click the target page.</para>
- </listitem>
- </itemizedlist>
-
- <para>A transition will appear between the two pages:</para>
- <figure>
- <title>Transition between JSP Pages</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_22.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>It is also possible to create a new page with context menu by
right-clicking anywhere
- on the diagram and selecting <emphasis>
- <property>New View</property>.
</emphasis></para>
- <figure>
- <title>Creating a New View</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_23.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>To edit an existing transition, first select the transition line.
Then, place the
- mouse cursor over the last black dot (on the target page). The mouse cursor
will change
- to a big +. At this point, drag the line to a new target page:</para>
- <figure>
- <title>Editing Transition between Views</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_24.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section id="TreeView11123" role="updated">
-
- <title>Tree View</title>
-
- <para>You can find it more convenient to edit your JSF Configuration file
in the Tree view of
- the <property>VPE</property>.</para>
-
- <para>The view displays all JSF application artifacts referenced in the
configuration file
- in a tree format. By selecting any node on the left, you can see and edit its
properties
- which will appear in the right-hand area. Let's look at the
structure of this
- tree more closely.</para>
-
- <itemizedlist>
- <listitem>
- <para>Under the <emphasis>
- <property>Application</property>
- </emphasis> node you can adjust JSF application specific
settings such as
- internationalization, possibility to set extensions, add property and
variable
- resolvers, etc.</para>
- </listitem>
- </itemizedlist>
-
- <figure>
- <title>JSF Application Specific Settings</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_24a.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <itemizedlist>
- <listitem>
- <para>The <emphasis>
- <property>Components</property>
- </emphasis> node is for registering custom JSF components.
Right-click and
- choose <emphasis>
- <property>New > Component</property>
- </emphasis> or just press the <emphasis>
- <property>Add</property>
- </emphasis> button in the right-hand area to add a new
component to the JSF
- Configuration file.</para>
- </listitem>
- </itemizedlist>
-
- <figure>
- <title>Registering a New JSF Component</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_24b.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>In the <property>Add Component wizard</property>
you should set a component
- type and point to a component class by using the <emphasis>
- <property>Browse</property>
- </emphasis> button or create a new class for this component by
using the <emphasis>
- <property>Component-Class</property>
- </emphasis> link.</para>
-
- <figure>
- <title>Adding a New JSF Component to the JSF Configuration
File</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_24c.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <itemizedlist>
- <listitem>
- <para>Use the <emphasis>
- <property>Render Kit</property>
- </emphasis> node to create and register a set of related
renderers for custom
- JSF components.</para>
- </listitem>
- </itemizedlist>
-
- <figure>
- <title>Adding a New JSF Component to the JSF Configuration
File</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_24d.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <itemizedlist>
- <listitem>
- <para>Under the <emphasis>
- <property>Converters</property>
- </emphasis> node you can create a converter class for your JSF
application
- either with id or for a proper class. How to do that see the
<link
-
linkend="CreateAndRegisterACustomConverter94230">Create and Register a
- Custom Converter</link> section.</para>
- </listitem>
- </itemizedlist>
-
- <figure>
- <title>Creating a New Custom Converter</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_59.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <itemizedlist>
- <listitem>
- <para>The <emphasis>
- <property>Managed Bean</property>
- </emphasis> node is meant for creating and registering Bean
classes in your JSF
- application. Read more on the topic in the <link
linkend="managed_beans">Managed
- Beans</link> chapter.</para>
- </listitem>
- </itemizedlist>
-
- <figure>
- <title>Managed Beans</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_26.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <itemizedlist>
- <listitem>
- <para>Use the <emphasis>
- <property>Navigation Rules</property>
- </emphasis> node to configure a navigation between the pages in
your
- application: create a new navigation rule and adjust necessary
properties for it
- in the right-hand area.</para>
- </listitem>
- </itemizedlist>
- <tip>
- <title>Tip:</title>
- <para>The same you can do in the <link
linkend="Diagram9553">Diagram view</link> of the
- JSF Configuration file editor.</para>
- </tip>
-
- <figure>
- <title>Configuring Navigation Rules</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_26a.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <itemizedlist>
- <listitem>
- <para>Under the <emphasis>
- <property>Referenced Beans</property>
- </emphasis> node you can add a new Referenced Bean and
configure various
- properties for it. To learn more on this refer to the <link
- linkend="referenced_beans">Create and Register
Referenced Beans</link>
- section.</para>
- </listitem>
- </itemizedlist>
-
- <figure>
- <title>Referenced Beans</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_26b.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <itemizedlist>
- <listitem>
- <para>The <emphasis>
- <property>Validators</property>
- </emphasis> node is needed to create validator classes for
organizing the
- validation of your application data. You can read more on the topic
in the <link
-
linkend="CreateAndRegisterACustomValidator5632">Create and Register a Custom
- Validator</link> section.</para>
- </listitem>
- </itemizedlist>
-
- <figure>
- <title>Validators</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_26c.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <itemizedlist>
- <listitem>
- <para>The <emphasis>
- <property>Extensions</property>
- </emphasis> node is for setting extensions for your
<emphasis>
-
<property>faces-config.xml</property>.</emphasis></para>
- </listitem>
- </itemizedlist>
-
- <figure>
- <title>Adding Extensions</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_26d.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>In the <property>Tree view</property> you can also edit
the properties of the selected
- element with the help of the <property>Properties view</property>
as shown below:</para>
-
- <figure>
- <title>Properties View </title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_33.png" scale="75"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- </section>
- <section id="SourceView4643">
-
- <title>Source View</title>
-
- <para>Here, we'll discuss how you can configure your
faces-config.xml with the help
- of Source View.</para>
- <para>The Source view for the editor displays a text content of the JSF
configuration file.
- It is always synchronized with other two views, so any changes made in one of
the views
- will immediately appear in the other:</para>
- <figure>
- <title>Source View</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_27.png" scale="75"/>
- </imageobject>
- </mediaobject>
- </figure>
-
-
- <para>You can also work in the Source view with the help of the
<emphasis>
- <property>Outline view</property>.</emphasis> The
Outline view shows a tree
- structure of the JSF configuration file. Simply select any element in the
Outline view,
- and it will jump to the same place in the Source editor, so you can navigate
through the
- source code with Outline view.</para>
- <figure>
- <title>Outline View</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_31.png" scale="50"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- </section>
-
- <section id="jsf_editor_features">
- <title>Editor Features</title>
- <para>Here we'll discuss a very important features that JSF
configuration file
- editor provides for work with JSF resources.</para>
-
- <section id="jsf_openOn">
- <title>Open On</title>
- <para>The JSF configuration file editor comes with a very useful OpenOn
navigating
- feature. More fully you can read about it in our Visual Web Tools
- Guide.</para>
- </section>
-
- <section id="ContentAssist976">
-
- <title>Code Assist</title>
- <para>Code Assist provides pop-up tip to help you complete your code
statements. It
- allows you to write your code faster and with more
accuracy.</para>
- <para>Code assist is always available in the Source mode:</para>
- <figure>
- <title>Code Assist in Source View</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_28.png" scale="65"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- </section>
-
- <section id="ErrorReporting3324">
-
- <title>Error Reporting</title>
- <para>When you are developing your project, error checking is
constantly provided. This
- greatly reduces your development time as it allows you to catch many of
the errors
- during development.</para>
- <para>Errors will be reported by <link
linkend="jsf_project_verification">
- verification</link> facility:</para>
- <figure>
- <title>Error Reporting in Source View</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_29.png" scale="75"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Other errors are also reported.</para>
- <figure>
- <title>Other Errors Reporting</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_30.png" scale="75"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- </section>
- </section>
-
-</chapter>
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="jsf_config_file" role="updated">
+ <?dbhtml filename="jsf_config_file.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>Eclipse</keyword>
+ <keyword>JSF Tools</keyword>
+ <keyword>Java</keyword>
+ <keyword>JBoss</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>JSF Configuration File Editor</title>
+
+ <para>First, we should mention that JSF configuration file (<emphasis>
+ <property>faces-config.xml</property>
+ </emphasis>) is intended for registering JSF application resources such as
Converters,
+ Validators, Managed Beans and page-to-page navigation rules.</para>
+ <para>Now, let's look at how you can easily configure this file by
means of a special
+ graphical editor for JSF configuration file. The editor has three main
views:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Diagram</para>
+ </listitem>
+ <listitem>
+ <para>Tree</para>
+ </listitem>
+ <listitem>
+ <para>Source</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>They can be selected via the tabs at the bottom of the
editor.</para>
+
+ <section id="Diagram9553">
+
+ <title>Diagram view</title>
+
+ <para>Here, we will show you how to work with JSF configuration file
through the Diagram
+ view of the editor.</para>
+ <para>As you can see on the figure below, the Diagram view displays the
navigation rules in
+ the faces-config.xml:</para>
+ <figure>
+ <title>Diagram View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_21.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>If your diagram is large, make use of the Outline view. Within it you
can switch to a <emphasis>
+ <property>Diagram Navigator</property>
+ </emphasis> mode by selecting the middle icon at the top of the view
window. It allows
+ you to easily move around the diagram. Just move the blue area in any
direction, and the
+ diagram on the left will also move:</para>
+ <figure>
+ <title>Outline View for Diagram</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_32.png" scale="50"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>To create a new page here, you should click the page icon (View
Template) on the
+ toolbar from the left and then click anywhere on the diagram. A New Page
Wizard will
+ appear.</para>
+
+ <para>To create a transition for connecting pages:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Select the transition icon from the toolbar (New
Connection).</para>
+ </listitem>
+ <listitem>
+ <para>Click the source page.</para>
+ </listitem>
+ <listitem>
+ <para>Click the target page.</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>A transition will appear between the two pages:</para>
+ <figure>
+ <title>Transition between JSP Pages</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_22.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>It is also possible to create a new page with context menu by
right-clicking anywhere
+ on the diagram and selecting <emphasis>
+ <property>Rule...</property></emphasis></para>
+ <figure>
+ <title>Creating a New View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_23.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>To edit an existing transition, first select the transition line.
Then, place the
+ mouse cursor over the last black dot (on the target page). The mouse cursor
will change
+ to a big +. At this point, drag the line to a new target page:</para>
+ <figure>
+ <title>Editing Transition between Views</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_24.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="TreeView11123" role="updated">
+
+ <title>Tree View</title>
+
+ <para>You can find it more convenient to edit your JSF Configuration file
in the Tree view of
+ the <property>VPE</property>.</para>
+
+ <para>The view displays all JSF application artifacts referenced in the
configuration file
+ in a tree format. By selecting any node on the left, you can see and edit its
properties
+ which will appear in the right-hand area. Let's look at the
structure of this
+ tree more closely.</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Under the <emphasis>
+ <property>Application</property>
+ </emphasis> node you can adjust JSF application specific
settings such as
+ internationalization, possibility to set extensions, add property and
variable
+ resolvers, etc.</para>
+ </listitem>
+ </itemizedlist>
+
+ <figure>
+ <title>JSF Application Specific Settings</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_24a.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <itemizedlist>
+ <listitem>
+ <para>The <emphasis>
+ <property>Components</property>
+ </emphasis> node is for registering custom JSF components.
Right-click and
+ choose <emphasis>
+ <property>New > Component</property>
+ </emphasis> or just press the <emphasis>
+ <property>Add</property>
+ </emphasis> button in the right-hand area to add a new
component to the JSF
+ Configuration file.</para>
+ </listitem>
+ </itemizedlist>
+
+ <figure>
+ <title>Registering a New JSF Component</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_24b.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>In the <property>Add Component wizard</property>
you should set a component
+ type and point to a component class by using the <emphasis>
+ <property>Browse</property>
+ </emphasis> button or create a new class for this component by
using the <emphasis>
+ <property>Component-Class</property>
+ </emphasis> link.</para>
+
+ <figure>
+ <title>Adding a New JSF Component to the JSF Configuration
File</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_24c.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <itemizedlist>
+ <listitem>
+ <para>Use the <emphasis>
+ <property>Render Kit</property>
+ </emphasis> node to create and register a set of related
renderers for custom
+ JSF components.</para>
+ </listitem>
+ </itemizedlist>
+
+ <figure>
+ <title>Adding a New JSF Renderer Kit to the JSF Configuration
File</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_24d.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <itemizedlist>
+ <listitem>
+ <para>Under the <emphasis>
+ <property>Converters</property>
+ </emphasis> node you can create a converter class for your JSF
application
+ either with id or for a proper class. How to do that see the
<link
+
linkend="CreateAndRegisterACustomConverter94230">Create and Register a
+ Custom Converter</link> section.</para>
+ </listitem>
+ </itemizedlist>
+
+ <figure>
+ <title>Creating a New Custom Converter</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_59.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <itemizedlist>
+ <listitem>
+ <para>The <emphasis>
+ <property>Managed Bean</property>
+ </emphasis> node is meant for creating and registering Bean
classes in your JSF
+ application. Read more on the topic in the <link
linkend="managed_beans">Managed
+ Beans</link> chapter.</para>
+ </listitem>
+ </itemizedlist>
+
+ <figure>
+ <title>Managed Beans</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_26.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <itemizedlist>
+ <listitem>
+ <para>Use the <emphasis>
+ <property>Navigation Rules</property>
+ </emphasis> node to configure a navigation between the pages in
your
+ application: create a new navigation rule and adjust necessary
properties for it
+ in the right-hand area.</para>
+ </listitem>
+ </itemizedlist>
+ <tip>
+ <title>Tip:</title>
+ <para>The same you can do in the <link
linkend="Diagram9553">Diagram view</link> of the
+ JSF Configuration file editor.</para>
+ </tip>
+
+ <figure>
+ <title>Configuring Navigation Rules</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_26a.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <itemizedlist>
+ <listitem>
+ <para>Under the <emphasis>
+ <property>Referenced Beans</property>
+ </emphasis> node you can add a new Referenced Bean and
configure various
+ properties for it. To learn more on this refer to the <link
+ linkend="referenced_beans">Create and Register
Referenced Beans</link>
+ section.</para>
+ </listitem>
+ </itemizedlist>
+
+ <figure>
+ <title>Referenced Beans</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_26b.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <itemizedlist>
+ <listitem>
+ <para>The <emphasis>
+ <property>Validators</property>
+ </emphasis> node is needed to create validator classes for
organizing the
+ validation of your application data. You can read more on the topic
in the <link
+
linkend="CreateAndRegisterACustomValidator5632">Create and Register a Custom
+ Validator</link> section.</para>
+ </listitem>
+ </itemizedlist>
+
+ <figure>
+ <title>Validators</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_26c.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <itemizedlist>
+ <listitem>
+ <para>The <emphasis>
+ <property>Extensions</property>
+ </emphasis> node is for setting extensions for your
<emphasis>
+
<property>faces-config.xml</property>.</emphasis></para>
+ </listitem>
+ </itemizedlist>
+
+ <figure>
+ <title>Adding Extensions</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_26d.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>In the <property>Tree view</property> you can also edit
the properties of the selected
+ element with the help of the <property>Properties view</property>
as shown below:</para>
+
+ <figure>
+ <title>Properties View </title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_33.png" scale="75"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ </section>
+ <section id="SourceView4643">
+
+ <title>Source View</title>
+
+ <para>Here, we'll discuss how you can configure your
faces-config.xml with the help
+ of Source View.</para>
+ <para>The Source view for the editor displays a text content of the JSF
configuration file.
+ It is always synchronized with other two views, so any changes made in one of
the views
+ will immediately appear in the other:</para>
+ <figure>
+ <title>Source View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_27.png" scale="75"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+
+ <para>You can also work in the Source view with the help of the
<emphasis>
+ <property>Outline view</property>.</emphasis> The
Outline view shows a tree
+ structure of the JSF configuration file. Simply select any element in the
Outline view,
+ and it will jump to the same place in the Source editor, so you can navigate
through the
+ source code with Outline view.</para>
+ <figure>
+ <title>Outline View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_31.png" scale="50"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ </section>
+
+ <section id="jsf_editor_features">
+ <title>Editor Features</title>
+ <para>Here we'll discuss a very important features that JSF
configuration file
+ editor provides for work with JSF resources.</para>
+
+ <section id="jsf_openOn">
+ <title>Open On</title>
+ <para>The JSF configuration file editor comes with a very useful OpenOn
navigating
+ feature. More fully you can read about it in our Visual Web Tools
+ Guide.</para>
+ </section>
+
+ <section id="ContentAssist976">
+
+ <title>Code Assist</title>
+ <para>Code Assist provides pop-up tip to help you complete your code
statements. It
+ allows you to write your code faster and with more
accuracy.</para>
+ <para>Code assist is always available in the Source mode:</para>
+ <figure>
+ <title>Code Assist in Source View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_28.png" scale="65"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ </section>
+
+ <section id="ErrorReporting3324">
+
+ <title>Error Reporting</title>
+ <para>When you are developing your project, error checking is
constantly provided. This
+ greatly reduces your development time as it allows you to catch many of
the errors
+ during development.</para>
+ <para>Errors will be reported by <link
linkend="jsf_project_verification">
+ verification</link> facility:</para>
+ <figure>
+ <title>Error Reporting in Source View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_29.png" scale="75"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Other errors are also reported.</para>
+ <figure>
+ <title>Other Errors Reporting</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_30.png" scale="75"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ </section>
+ </section>
+
+</chapter>
\ No newline at end of file
Modified: tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/master.xml
===================================================================
--- tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/master.xml 2010-06-09
00:08:25 UTC (rev 22657)
+++ tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/master.xml 2010-06-09
00:10:24 UTC (rev 22658)
@@ -52,7 +52,7 @@
<holder>JBoss by Red Hat</holder>
</copyright>
<releaseinfo>
- Version: 3.1.0.GA
+ Version: 3.1.1.GA
</releaseinfo>
<abstract>
Modified: tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/master_output.xml
===================================================================
---
tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/master_output.xml 2010-06-09
00:08:25 UTC (rev 22657)
+++
tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/master_output.xml 2010-06-09
00:10:24 UTC (rev 22658)
@@ -3,14 +3,14 @@
"http://www.docbook.org/xml/4.3/docbookx.dtd"
[
-<!ENTITY introduction SYSTEM "modules/introduction.xml">
-<!ENTITY jsf_support SYSTEM "modules/jsf_support.xml">
-<!ENTITY projects SYSTEM "modules/projects.xml">
-<!ENTITY webxml_editor SYSTEM "modules/webxml_editor.xml">
-<!ENTITY jsf_config_file SYSTEM "modules/jsf_config_file.xml">
-<!ENTITY managed_beans SYSTEM "modules/managed_beans.xml">
-<!ENTITY creation_and_registration SYSTEM
"modules/creation_and_registration.xml">
-<!ENTITY jsf_project_verification SYSTEM
"modules/jsf_project_verification.xml">
+<!ENTITY introduction SYSTEM "introduction.xml">
+<!ENTITY jsf_support SYSTEM "jsf_support.xml">
+<!ENTITY projects SYSTEM "projects.xml">
+<!ENTITY webxml_editor SYSTEM "webxml_editor.xml">
+<!ENTITY jsf_config_file SYSTEM "jsf_config_file.xml">
+<!ENTITY managed_beans SYSTEM "managed_beans.xml">
+<!ENTITY creation_and_registration SYSTEM
"creation_and_registration.xml">
+<!ENTITY jsf_project_verification SYSTEM "jsf_project_verification.xml">
<!ENTITY seamlink "../../seam/html_single/index.html">
<!ENTITY aslink "../../as/html_single/index.html">
@@ -51,7 +51,7 @@
<holder>JBoss by Red Hat</holder>
</copyright>
<releaseinfo><diffmk:wrapper diffmk:change="changed">
- Version: 3.1.0.GA
+ Version: 3.1.1.GA
</diffmk:wrapper></releaseinfo>
<abstract>
@@ -66,7 +66,7 @@
<toc></toc>
-<chapter id="introduction"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jsf/docs/jsf_tools_ref_guide/en/modules/introduction.xml">
+<chapter id="introduction"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jsf/docs/jsf_tools_ref_guide/en-US/introduction.xml">
<?dbhtml filename="introduction.html"?>
<chapterinfo>
@@ -178,7 +178,7 @@
</chapter>
-<chapter id="jsf_support"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_support.xml">
+<chapter id="jsf_support"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jsf/docs/jsf_tools_ref_guide/en-US/jsf_support.xml">
<?dbhtml filename="jsf_support.html"?>
<chapterinfo>
<keywordset>
@@ -335,8 +335,8 @@
<section>
<title>Facelets components</title>
- <para>The <ulink
url="../../jsf/html_single/index.html#palette">JBoss Tools
- Palette</ulink> comes with the Facelets
components ready to
+ <para>The JBoss Tools
+ Palette comes with the Facelets components ready
to
use. A useful tip appears when you hover the mouse cursor
over the
tag, the tip includes a detailed description of the tag
component,
the syntax and available attributes.</para>
@@ -478,7 +478,7 @@
</chapter>
-<chapter id="projects"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jsf/docs/jsf_tools_ref_guide/en/modules/projects.xml">
+<chapter id="projects"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jsf/docs/jsf_tools_ref_guide/en-US/projects.xml">
<?dbhtml filename="projects.html"?>
<chapterinfo>
<keywordset>
@@ -549,13 +549,13 @@
customizable. Thus you can pick a different template on which the
projects
Importing Existing should be based on. Almost all templates come
in two
variations: with jsf libraries and without ones.</para>
- <figure float="0">
- <title>Choosing JSF Templates</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_12.png "></imagedata>
- </imageobject>
- </mediaobject>
+ <figure float="0">
+ <title>Choosing JSF Templates</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_12.png"></imagedata>
+ </imageobject>
+ </mediaobject>
</figure>
<para>The table below provides description for each possible JSF
template.</para>
@@ -692,9 +692,8 @@
<title>Importing Existing JSF Projects with Any
Structure</title>
- <para>For detailed information on migration of JSF projects into a
workspace see
- <ulink
url="../../Exadel-migration/html_single/index.html#jsf_struts">Migration
- Guide</ulink>.</para>
+ <para>For detailed information on migration of JSF projects into a
workspace see the Migration
+ Guide.</para>
</section>
<section id="add_jsf_capability">
@@ -875,12 +874,12 @@
<title>Relevant Resources Links</title>
<para>You can find more in-depth explanation on how to work with
special wizards, editors and views that can
- be used in various scenarios while developing JSF applications in
our <ulink url="../../jsf/html_single/index.html">Visual Web Tools
guide</ulink>.</para>
+ be used in various scenarios while developing JSF applications in
our Visual Web Tools Guide.</para>
</section>
</chapter>
-<chapter id="webxml_editor"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jsf/docs/jsf_tools_ref_guide/en/modules/webxml_editor.xml"
xreflabel="webxml_editor">
+<chapter id="webxml_editor"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jsf/docs/jsf_tools_ref_guide/en-US/webxml_editor.xml"
xreflabel="webxml_editor">
<?dbhtml filename="webxml_editor.html"?>
<chapterinfo>
<keywordset>
@@ -898,10 +897,10 @@
<para><property moreinfo="none">JBoss Tools</property> add
the <emphasis>
<property moreinfo="none">web.xml</property></emphasis>
file to created JSF project automatically and provides a special editor for its editing.
- See the Visual Web Tools guide that gives a descriptive information on the <ulink
url="../../jsf/html_single/index.html#GraphicalWebApplicationFileEditor">web.xml
editor</ulink>.</para>
+ See the Visual Web Tools guide that gives a descriptive information on the <filename
moreinfo="none"><diffmk:wrapper
diffmk:change="changed">web.xml
editor</diffmk:wrapper></filename><diffmk:wrapper
diffmk:change="changed">.</diffmk:wrapper></para>
</chapter>
-<chapter id="jsf_config_file" role="updated"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_config_file.xml">
+<chapter id="jsf_config_file" role="updated"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jsf/docs/jsf_tools_ref_guide/en-US/jsf_config_file.xml">
<?dbhtml filename="jsf_config_file.html"?>
<chapterinfo>
<keywordset>
@@ -997,7 +996,7 @@
<para>It is also possible to create a new page with context menu by
right-clicking anywhere
on the diagram and selecting <emphasis>
- <property moreinfo="none">New View</property>.
</emphasis></para>
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Rule...</diffmk:wrapper></property></emphasis></para>
<figure float="0">
<title>Creating a New View</title>
<mediaobject>
@@ -1099,7 +1098,7 @@
</itemizedlist>
<figure float="0">
- <title>Adding a New JSF Component to the JSF Configuration
File</title>
+ <title><diffmk:wrapper diffmk:change="changed">Adding a
New JSF Renderer Kit to the JSF Configuration File</diffmk:wrapper></title>
<mediaobject>
<imageobject>
<imagedata
fileref="images/jsf_support/jsf_support_24d.png"></imagedata>
@@ -1281,8 +1280,8 @@
<section id="jsf_openOn">
<title>Open On</title>
<para>The JSF configuration file editor comes with a very useful OpenOn
navigating
- feature. More fully you can read about it in our <ulink
url="../../jsf/html_single/index.html#OpenOnSelection4Hyperlinknavigation">Visual
Web Tools
- Guide</ulink>.</para>
+ feature. More fully you can read about it in our Visual Web Tools
+ Guide.</para>
</section>
<section id="ContentAssist976">
@@ -1333,9 +1332,8 @@
</section>
</chapter>
-
-<chapter id="managed_beans"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jsf/docs/jsf_tools_ref_guide/en/modules/managed_beans.xml">
+<chapter id="managed_beans"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jsf/docs/jsf_tools_ref_guide/en-US/managed_beans.xml">
<?dbhtml filename="managed_beans.html"?>
<chapterinfo>
<keywordset>
@@ -1543,7 +1541,7 @@
</chapter>
-<chapter id="creation_and_registration"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jsf/docs/jsf_tools_ref_guide/en/modules/creation_and_registration.xml">
+<chapter id="creation_and_registration"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jsf/docs/jsf_tools_ref_guide/en-US/creation_and_registration.xml">
<?dbhtml filename="creation_and_registration.html"?>
<chapterinfo>
<keywordset>
@@ -1877,7 +1875,7 @@
</section>
</chapter>
-<chapter id="jsf_project_verification"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_project_verification.xml">
+<chapter id="jsf_project_verification"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jsf/docs/jsf_tools_ref_guide/en-US/jsf_project_verification.xml">
<?dbhtml filename="struts_project_verification.html"?>
<chapterinfo>
@@ -1979,9 +1977,8 @@
reference introduces you to wizards for creating and importing JSF projects, JSF
Configuration File editor features, functionality for enabling JSF capabilities
and etc.</para>
- <para>If you have questions or good suggestions, please refer to
- <ulink
url="http://www.jboss.com/index.html?module=bb&op=viewforum&...
- Tools Forum</ulink>.</para>
+ <para>If you have questions or good suggestions, please refer to <ulink
+
url="http://www.jboss.com/index.html?module=bb&op=viewforum&...
+ Tools Forum</ulink>.</para>
</chapter>
-
</book>
Modified: tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/webxml_editor.xml
===================================================================
---
tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/webxml_editor.xml 2010-06-09
00:08:25 UTC (rev 22657)
+++
tags/jbosstools-3.1.1.GA/jsf/docs/jsf_tools_ref_guide/en-US/webxml_editor.xml 2010-06-09
00:10:24 UTC (rev 22658)
@@ -17,5 +17,5 @@
<para><property>JBoss Tools</property> add the <emphasis>
<property>web.xml</property></emphasis> file to created JSF project
automatically and provides a special editor for its editing.
- See the Visual Web Tools guide that gives a descriptive information on the
<filename>web.xml</filename> editor.</para>
+ See the Visual Web Tools guide that gives a descriptive information on the
<filename>web.xml editor</filename>.</para>
</chapter>
\ No newline at end of file