JBoss Tools SVN: r15739 - trunk/drools/docs/guvnor_ref/en.
by jbosstools-commits＠lists.jboss.org
Author: ochikvina
Date: 2009-06-05 11:18:28 -0400 (Fri, 05 Jun 2009)
New Revision: 15739
Added:
trunk/drools/docs/guvnor_ref/en/master_output.xml
Log:
https://jira.jboss.org/jira/browse/JBDS-743 - adding the master_output.xml;
Added: trunk/drools/docs/guvnor_ref/en/master_output.xml
===================================================================
--- trunk/drools/docs/guvnor_ref/en/master_output.xml (rev 0)
+++ trunk/drools/docs/guvnor_ref/en/master_output.xml 2009-06-05 15:18:28 UTC (rev 15739)
@@ -0,0 +1,1077 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+"http://www.docbook.org/xml/4.3/docbookx.dtd"
+
+[<!ENTITY introduction SYSTEM "modules/introduction.xml">
+<!ENTITY functionality_overview SYSTEM "modules/functionality_overview.xml">
+<!ENTITY guvnor_preferences SYSTEM "modules/guvnor_preferences.xml">
+<!ENTITY conclusion SYSTEM "modules/conclusion.xml">
+
+<!ENTITY seamlink "../../seam/html_single/index.html">
+<!ENTITY aslink "../../as/html_single/index.html">
+<!ENTITY esblink "../../esb_ref_guide/html_single/index.html">
+<!ENTITY gsglink "../../GettingStartedGuide/html_single/index.html">
+<!ENTITY hibernatelink "../../hibernatetools/html_single/index.html">
+<!ENTITY jbpmlink "../../jbpm/html_single/index.html">
+<!ENTITY jsflink "../../jsf/html_single/index.html">
+<!ENTITY jsfreflink "../../jsf_tools_ref_guide/html_single/index.html">
+<!ENTITY jsftutoriallink "../../jsf_tools_tutorial/html_single/index.html">
+<!ENTITY strutsreflink "../../struts_tools_ref_guide/html_single/index.html">
+<!ENTITY strutstutoriallink "../../struts_tools_tutorial/html_single/index.html">
+
+]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff">
+
+ <bookinfo>
+ <title>Eclipse Guvnor Tools Reference Guide</title>
+
+ <corpauthor>
+ <inlinemediaobject>
+ <imageobject role="fo">
+ <imagedata fileref="images/jbosstools_logo.png" format="PNG"></imagedata>
+ </imageobject>
+ <imageobject role="html">
+ <imagedata></imagedata>
+ </imageobject>
+ </inlinemediaobject>
+ </corpauthor>
+ <author><firstname>John</firstname><surname>Graham</surname><email>jgraham(a)redhat.com</email></author>
+ <author><firstname>Olga</firstname><surname>Chikvina</surname></author>
+
+ <pubdate>April 2008</pubdate>
+ <copyright>
+ <year>2009</year>
+ <holder>JBoss, a division of Red Hat</holder>
+ </copyright>
+ <releaseinfo>
+ Version: 5.1.0.trunk
+ </releaseinfo>
+<abstract>
+ <title></title>
+ <para>
+ <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/guvnor/pdf/Eclipse_G...">PDF version</ulink>
+ </para>
+ </abstract>
+
+ </bookinfo>
+
+
+ <toc></toc>
+
+
+<chapter id="introduction" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/drools/docs/guvnor_ref/en/modules/introduction.xml" xreflabel="introduction">
+ <title>Introduction</title>
+
+ <para>The purpose of this document is to describe briefly the functionality present in the
+ <property moreinfo="none">Eclipse Guvnor Tools</property> (EGT) for Drools 5. While not intended as a
+ comprehensive reference, there should be enough detail included for early adopters using
+ these tools.</para>
+
+ <para>The <property moreinfo="none">Guvnor repository</property> is not intended as a Source Code Management
+ (SCM) solution, and the <property moreinfo="none">EGT</property> are not intended to be Eclipse “team
+ provider” extensions or replacements. Rather, the Guvnor repository is a location where
+ certain artifacts (such as rules and SOA policy definitions) are controlled (“governed”) by
+ policies defined by the deployment environment. The purpose of the <property moreinfo="none">EGT</property>
+ is then to enable access to resources held by the Guvnor repository, so
+ they can be used in development. Thus, limited capabilities for reading, writing, adding,
+ and removing Guvnor repository resources are provided in the
+ <property moreinfo="none">EGT</property>.</para>
+
+ <section id="drools_key_features">
+ <title>Guvnor Tools Key Features</title>
+
+ <para>The following table lists all valuable features of the <property moreinfo="none">Guvnor
+ Tools</property>.</para>
+ <table>
+ <title>Key Functionality of Guvnor Tools</title>
+ <tgroup cols="3">
+
+ <colspec align="left" colnum="1" colwidth="1*"></colspec>
+ <colspec colnum="2" colwidth="5*"></colspec>
+ <colspec align="left" colnum="3" colwidth="1*"></colspec>
+
+ <thead>
+ <row>
+ <entry>Feature</entry>
+ <entry>Benefit</entry>
+ <entry>Chapter</entry>
+ </row>
+ </thead>
+
+ <tbody>
+
+ <row>
+ <entry>
+ <para>Guvnor Repositories View</para>
+ </entry>
+ <entry>
+ <para>The purpose of the view is to enable access to Guvnor repository
+ resources in a standard tree format</para>
+ </entry>
+ <entry>
+ <link linkend="guvnor_repositories_view">Guvnor Repositories View</link>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <para>Guvnor Connection Wizard</para>
+ </entry>
+ <entry>
+ <para>The wizard helps to create a connection to a Guvnor
+ repository.</para>
+ </entry>
+ <entry>
+ <link linkend="connection_wizard">Guvnor Connection Wizard</link>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <para>Guvnor Resource History View</para>
+ </entry>
+ <entry>
+ <para>This view shows revisions of specific resources available in the
+ repository.</para>
+ </entry>
+ <entry>
+ <link linkend="guvnor_history_view">Guvnor Resource History View</link>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <para>Resources from Guvnor Wizard</para>
+ </entry>
+ <entry>
+ <para>The wizard helps to get local copies of Guvnor repository
+ resources.</para>
+ </entry>
+ <entry>
+ <link linkend="resources_from_guvnor">Importing Guvnor Repository
+ Resources</link>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <para>A number of actions for working with files</para>
+ </entry>
+ <entry>
+ <para>The Guvnor actions (available through the <emphasis>
+ <property moreinfo="none">Guvnor</property>
+ </emphasis> context menu on files) are provided for working with
+ files, both those associated with Guvnor repository master copies
+ and those not associated.</para>
+ </entry>
+ <entry>
+ <link linkend="actions">Actions for Local Guvnor Resources</link>
+ </entry>
+ </row>
+
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+
+ <section id="how_to_start">
+ <title>How to start with Guvnor Tools</title>
+
+ <para><property moreinfo="none">Guvnor Tools</property> is a part of the <property moreinfo="none">JBoss Tools</property>
+ project. Thus to get started with <property moreinfo="none">Guvnor Tools</property>, you should have the following:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Eclipse 3.4.x with Jboss Tools bundle of Eclipse plugins installed. How to
+ install JBoss Tools onto Eclipse you can find in the <ulink url="../../GettingStartedGuide/html_single/index.html#JBossToolsInstall">"JBoss Tools
+ Installation"</ulink> section.</para>
+ </listitem>
+
+ <listitem>
+ <para>JBoss Server 4.2 or higher with Guvnor repository deployed. Thus, you should
+ download <ulink url="http://download.jboss.org/drools/release/5.0.0.25561.CR1/drools-5.0.0.CR1...">Guvnor CR1</ulink> and extract it to the deploy directory of the
+ server.</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>Now refer to the <link linkend="functionality_overview">"Functionality
+ Overview"</link> section to find out what you can do with Guvnor and
+ Eclipse synchronisation tool.</para>
+ </section>
+
+ <section>
+ <title>Other relevant resources on the topic</title>
+
+ <itemizedlist>
+ <listitem>
+ <para>Guvnor <ulink url="http://www.jboss.org/community/wiki/Guvnor">wiki page</ulink></para>
+ </listitem>
+
+ <listitem>
+ <para>Drools on <ulink url="http://www.jboss.org/drools/">JBoss.org</ulink></para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <ulink url="http://www.jboss.org/tools/">JBoss Tools Home Page</ulink>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">The latest
+ JBossTools/JBDS documentation builds</ulink>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <ulink url="http://docs.jboss.org/tools/">JBossTools/JBDS
+ release documentation</ulink></para>
+ </listitem>
+ </itemizedlist>
+
+ </section>
+</chapter>
+
+
+<chapter id="functionality_overview" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/drools/docs/guvnor_ref/en/modules/functionality_overview.xml" xreflabel="functionality_overview">
+ <?dbhtml filename="functionality_overview.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Eclipse Guvnor Tools</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Functionality Overview</title>
+
+ <para>This chapter will introduce you to the <property moreinfo="none">Guvnor Repository Exploring
+ perspective</property> and give an overview on all functionality the <property moreinfo="none">Guvnor Tools</property> provides.</para>
+
+ <section id="guvnor_perspective">
+ <title>Guvnor Perspective</title>
+
+ <para>The <property moreinfo="none">Guvnor Repository Exploring perspective</property> contains two views
+ supplied by <property moreinfo="none">EGT</property> – <property moreinfo="none">Repository Explorer</property> and
+ <property moreinfo="none">Version History</property>, that will be the center of most interaction
+ with Guvnor, and Eclipse standard views such as <property moreinfo="none">Properties</property> and
+ <property moreinfo="none">Resource Navigator</property> that are also useful.</para>
+
+ <para>While each of these views can be opened and positioned independently within an Eclipse
+ workbench, the <property moreinfo="none">Guvnor perspective</property> provides a convenient method of
+ getting a suggested layout. In the Eclipse workbench menu, choose <emphasis>
+ <property moreinfo="none">Window > Open Perspective > Other</property>
+ </emphasis> to get the perspective list:</para>
+
+ <figure float="0">
+ <title>Enabling the Guvnor Repository Perspective</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/open_guvnor_perspectine.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>And then choose <emphasis>
+ <property moreinfo="none">Guvnor Repository Exploring</property>.</emphasis> This opens the
+ <property moreinfo="none">Guvnor perspective</property>.</para>
+ </section>
+
+ <section id="connection_wizard">
+ <title>Guvnor Connection Wizard</title>
+
+ <para>After opening the <property moreinfo="none">Guvnor perspective</property>, the first task is to make a
+ connection to a Guvnor repository. This is handled by the <property moreinfo="none">Guvnor Connection
+ wizard</property>. This wizard appears in a number of places within the
+ <property moreinfo="none">EGT</property> (as detailed below), but in this section we will cover only
+ the two most basic entry points.</para>
+
+ <para>The <property moreinfo="none">Guvnor Connection wizard</property> can be started in the following
+ ways:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>using the Eclipse menu <emphasis>
+ <property moreinfo="none">File > New > Other > Guvnor > Guvnor
+ repository location</property>
+ </emphasis></para>
+
+ <figure float="0">
+ <title>New Guvnor Repository Location</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/start_guvnor_connection1.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem>
+ <para>in the <property moreinfo="none">Guvnor Repositories view</property> using the drop-down menu</para>
+
+ <figure float="0">
+ <title>Adding New Guvnor Connection</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/start_guvnor_connection2.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem>
+ <para>using the menu button
+ ( <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/guvnor_connection_button.png"></imagedata>
+ </imageobject>
+ </inlinemediaobject> )
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <para>Choosing either of these will start the <property moreinfo="none">Guvnor Connection
+ wizard</property>.</para>
+
+ <figure float="0" id="guvnor_connection_wizard">
+ <title>Guvnor Connection Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/guvnor_connection_wizard.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Default values appear in the <emphasis>
+ <property moreinfo="none">Location</property>,</emphasis>
+ <emphasis>
+ <property moreinfo="none">Port</property>,</emphasis> and <emphasis>
+ <property moreinfo="none">Repository</property>
+ </emphasis> fields (See the <link linkend="guvnor_preferences">“Guvnor Preferences”</link> section below for details about how to
+ change these default values.) Of course, any of these fields can be edited by typing in
+ the corresponding text box. Drag-and-drop or paste into the <emphasis>
+ <property moreinfo="none">Location</property>
+ </emphasis> field of a typical Guvnor repository URL such as:</para>
+
+ <para>
+ <emphasis>
+ <property moreinfo="none">http://localhost:8080/drools-guvnor/org.drools.guvnor.Guvnor/webdav</property>
+ </emphasis>
+ </para>
+
+ <para>Results in the URL being parsed into the respective fields as well. The authentication
+ information (user name and password) can optionally be stored in the Eclipse
+ workbench's key-ring file based on the selection of <emphasis>
+ <property moreinfo="none">Save user name and password</property>.</emphasis></para>
+
+ <note>
+ <title>Note:</title>
+ <para>If the authentication information is not stored in the key-ring, then the
+ <property moreinfo="none">EGT</property> uses a session authentication, what means that the
+ credentials supplied are used only for the lifetime of the Eclipse workbench
+ instance.</para>
+ </note>
+
+ <para>If authentication information is not stored in the key-ring or the authentication
+ information (key-ring or session) is not valid, the <property moreinfo="none">EGT</property> will prompt
+ for authentication information when it has to access the Guvnor repository.</para>
+
+ <para>If authentication fails, the <property moreinfo="none">EGT</property> will retry once and then issue
+ an authentication failure error.</para>
+
+ <tip>
+ <title>Tip:</title>
+ <para>If an authentication failure error occurs, you can retry the same operation and
+ supply different authentication information.</para>
+ </tip>
+
+ <para>Note that the <property moreinfo="none">EGT</property> calls the Guvnor repository at various times,
+ such as when determining if resource updates are available. Thus if you use session
+ authentication, the authentication dialog will appear at different times during the
+ Eclipse workbench session, depending on what actions you take. For ease of use, we
+ recommend saving the authentication information in the Eclipse key-ring.</para>
+
+ <note>
+ <title>Note:</title>
+ <para>The Eclipse key-ring file is distinct from key-ring files found in some platforms
+ such as Mac OS X and many forms of Linux. Thus, sometimes if you access a Guvnor
+ repository outside the <property moreinfo="none">EGT</property>, the key-ring files might become
+ unsynchronized and you will be unexpectedly prompted for authentication in Eclipse.
+ This is nuisance, but your usual credentials should apply in this case.</para>
+ </note>
+ </section>
+
+ <section id="guvnor_repositories_view">
+ <title>Guvnor Repositories View</title>
+
+ <para>The <property moreinfo="none">Guvnor Repositories view</property> contains tree structures for Guvnor
+ repository contents.</para>
+
+ <figure float="0">
+ <title>Guvnor Repositories View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/guvnor_repository.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>You can perform the following actions under the resources in the
+ <property moreinfo="none">Guvnor Repositories view</property>:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>create a new Guvnor repository connection. How to do this is describe above in the <link linkend="connection_wizard">"Guvnor Connection Wizard"</link> section.</para>
+ </listitem>
+
+ <listitem>
+ <para>remove a Guvnor repository connection. Use the Delete button
+ ( <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/delete_connection_button.png"></imagedata>
+ </imageobject>
+ </inlinemediaobject> ) in the tool-bar or the <emphasis>
+ <property moreinfo="none">Delete</property></emphasis> option in the context menu to remove a repository connection.</para>
+ </listitem>
+
+ <listitem>
+ <para>refresh Guvnor repository resorces. Use the <emphasis>
+ <property moreinfo="none">Refresh</property></emphasis> context menu item to reload a tree content for the selected node.</para>
+ </listitem>
+
+ <listitem>
+ <para>make use of "drill-into" functionality. It's represented by a number of tool-bar/context menu items such as <emphasis><property moreinfo="none">Go Home</property></emphasis>
+ ( <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/go_home_button.png"></imagedata>
+ </imageobject>
+ </inlinemediaobject> ), <emphasis><property moreinfo="none">Go Back</property></emphasis>
+ ( <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/go_back_button.png"></imagedata>
+ </imageobject>
+ </inlinemediaobject> ) and <emphasis>
+ <property moreinfo="none">Go Into</property></emphasis>
+ ( <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/go_into_button.png"></imagedata>
+ </imageobject>
+ </inlinemediaobject> ).</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>Drill-down is useful when working with deeply nested tree structures and when you wish to concentrate on only branch of the tree. For example, drilling into the <emphasis>
+ <property moreinfo="none">"defaultPackage"</property></emphasis> node changes the tree view to:</para>
+
+ <figure float="0">
+ <title>Going Into the <emphasis>"defaultPackage"</emphasis></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/go_into_defaultPackage.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Clicking on the Go Home button ( <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/go_home_button.png"></imagedata>
+ </imageobject>
+ </inlinemediaobject> ) or selecting <emphasis>
+ <property moreinfo="none">Go Home</property></emphasis> in the context menu returns the tree to the top-level structure shown in the previous picture above.
+ </para>
+
+ <para>There are a number of operations that can be performed on Guvnor repository files. Selecting a file in
+the Guvnor repository causes the Eclipse <property moreinfo="none">Properties view</property> to update with details about that file:
+</para>
+
+ <figure float="0">
+ <title>Guvnor Repository Files Properties</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/repository_files_properties.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para></para>
+ </section>
+
+ <section id="local_copies">
+ <title>Local Copies of Guvnor Files</title>
+
+ <para>As mentioned in the <link linkend="introduction">"Introduction"</link>, the main purpose
+ of the <property moreinfo="none">EGT</property> is to allow development using resources held in a Guvnor
+ repository. There are two method of getting local copies of Guvnor repository
+ resources:</para>
+
+ <orderedlist continuation="restarts" inheritnum="ignore">
+ <listitem>
+ <para>Drag-and-drop from the <property moreinfo="none">Guvnor Repositories view</property></para>
+ </listitem>
+ <listitem>
+ <para>Using the <link linkend="resources_from_guvnor">Import from Guvnor
+ wizard</link>, as described further in this document</para>
+ </listitem>
+ </orderedlist>
+
+ <para>When local copies of Guvnor repository files are created, the <property moreinfo="none">EGT</property>
+ sets an association between the local copy and the master file in the repository. This
+ information is kept in the (normally) hidden <emphasis>
+ <property moreinfo="none">.guvnorinfo</property>
+ </emphasis> folder in the local project and, like all metadata, should not be changed by
+ end users.</para>
+
+ <figure float="0">
+ <title>.guvnorinfo metadata</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/guvnorinfo.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The association allows for operations such as update and commit in
+ synchronization with the master copy held in the Guvnor repository.</para>
+
+ <para>The <property moreinfo="none">EGT</property> decorates local resources associated with Guvnor
+ repository master copies. This decoration appears in Eclipse views conforming to the
+ Eclipse Common Navigator framework, such as the Eclipse <property moreinfo="none">Resource
+ Navigator</property> and the Java <property moreinfo="none">Package Explorer</property>. On the image
+ above you can see the <emphasis>
+ <property moreinfo="none">Dummy rule.drl</property></emphasis> file with the decoration in the <property moreinfo="none">Resource Navigator</property>. The Guvnor icon decorator is on the top right of the file image, and the Guvnor
+ revision details are appended to the file name. (The presence/location of these can be
+ changed the <link linkend="resource_decoration_preferences">Guvnor
+ Preferences</link>.)</para>
+
+ <para>Here we see that, <emphasis><property moreinfo="none">Dummy role.drl</property></emphasis> is associated with a Guvnor repository
+ resource and the local copy is based on revision 0, with a <code>02-10-2008, 4:21:53</code> date/time
+ stamp. The file <emphasis><property moreinfo="none">Sample.drl</property>,</emphasis> however, is not associated with a Guvnor repository
+ file. Further details about the association can be found in the standard Eclipse
+ properties page, accessed via the <emphasis><property moreinfo="none">Properties</property></emphasis> option in the context menu:</para>
+
+ <figure float="0">
+ <title>Association Details</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/association_details.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The <property moreinfo="none">EGT</property> contributes a property page to the standard Eclipse
+ properties dialog, the contents of which are shown above. It displays the specific Guvnor
+ repository, the location within the repository, the version (date/time stamp) and
+ the revision number.</para>
+ </section>
+
+ <section id="actions">
+ <title>Actions for Local Guvnor Resources</title>
+
+ <para>The <property moreinfo="none">EGT</property> provides a number of actions (available through the
+ <emphasis><property moreinfo="none">Guvnor</property></emphasis> context menu on files) for working with files, both those associated with
+ Guvnor repository master copies and those not associated. The actions are:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ <link linkend="update_action">Update</link>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <link linkend="add_action">Add</link>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <link linkend="commit_action">Commit</link>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <link linkend="show_history_action">Show History</link>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <link linkend="compare_with_version">Compare with Version</link>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <link linkend="switch_to_version">Switch to Version</link>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <link linkend="delete_action">Delete</link>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <link linkend="disconnect_action">Disconnect</link>
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <para>Each of these actions is described below.</para>
+
+ <section id="update_action">
+ <title>Update Action</title>
+
+ <para>The <emphasis>
+ <property moreinfo="none">Update</property>
+ </emphasis> action is available for one or more Guvnor resources that are not in
+ synchronization with the Guvnor repository master copies. These resources would not
+ be in synchronization because either/both</para>
+
+ <orderedlist continuation="restarts" inheritnum="ignore">
+ <listitem><para>There are local changes to these
+ resources</para></listitem>
+ <listitem><para>The master copies have been changed in the Guvnor repository</para></listitem>
+ </orderedlist>
+
+ <para>Performing the <emphasis>
+ <property moreinfo="none">Update</property>
+ </emphasis> action replaces the local file contents with the current contents from
+ the Guvnor repository master copies (equivalent to <emphasis>
+ <link linkend="switch_to_version">Switch to version</link>
+ </emphasis> for the latest version).</para>
+ </section>
+
+ <section id="add_action">
+ <title>Add Action</title>
+
+ <para>The <emphasis>
+ <property moreinfo="none">Add</property>
+ </emphasis> action is available for one or more local files that are not associated
+ with a Guvnor repository master copy. Choosing the <emphasis>
+ <property moreinfo="none">Add</property>
+ </emphasis> action launches the <property moreinfo="none">Add to Guvnor wizard</property>:</para>
+
+ <figure float="0">
+ <title>Add to Guvnor Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/add_toGuvnor_wizard.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The first page of the wizard asks for the selection of the target Guvnor
+ repository and gives the choice to create a new Guvnor repository connection (in
+ which case the second page is the same as the <link linkend="guvnor_connection_wizard">Guvnor Connection wizard</link>). Once the target Guvnor repository is chosen,
+ the wizard then asks for the folder location to add the selection files:</para>
+
+ <figure float="0">
+ <title>Selecting a Target Folder</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/select_target_folder.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Here the <emphasis>
+ <property moreinfo="none">"defaultPackage"</property></emphasis> folder is selected as the destination
+ location.</para>
+
+ <note>
+ <title>Note:</title>
+ <para>Note that the <emphasis>
+ <property moreinfo="none">"snapshot"</property></emphasis> folder in the Guvnor repository is read-only for
+ <property moreinfo="none">EGT</property>, and hence not visible as a candidate location in
+ this wizard. The Guvnor repository web administration tools must be used to add
+ snapshot content.</para>
+ </note>
+
+ <para>Clicking on <emphasis>
+ <property moreinfo="none">Finish</property>
+ </emphasis> adds the selected files to the Guvnor repository and creates an
+ association between the local and Guvnor repository files.</para>
+
+ <note>
+ <title>Note:</title>
+ <para>Note that the wizard will not allow for overwrite of existing Guvnor
+ repository files. Another target location must be chosen.</para>
+ </note>
+ </section>
+
+ <section id="commit_action">
+ <title>Commit Action</title>
+
+ <para>The <emphasis>
+ <property moreinfo="none">Commit</property>
+ </emphasis> action is enabled for one or more Guvnor repository associated files
+ that have local changes. The <emphasis>
+ <property moreinfo="none">Commit</property>
+ </emphasis> action will write the local changes back to the associated Guvnor
+ repository files and update the association for the new revision created.</para>
+
+ <para>If a local change is based on an older revision of a file that is currently in the
+ Guvnor repository (for example, someone else changed the same file), then the <emphasis>
+ <property moreinfo="none">Commit</property>
+ </emphasis> action will<figure float="0">
+ <title>Add to Guvnor Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/add_toGuvnor_wizard.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure> ask whether you wish to overwrite the current version in the
+ Guvnor repository with the local content. When such conflicts occur, however, you
+ should use the Eclipse Guvnor version tools, along with Eclipse standard tools, to
+ determine the differences and merge content based on the current version in the
+ Guvnor repository.</para>
+ </section>
+
+ <section id="show_history_action">
+ <title>Show History Action</title>
+
+ <para>The <emphasis>
+ <property moreinfo="none">Show History</property>
+ </emphasis> action is enable for one Guvnor repository associated file and causes
+ the <link linkend="guvnor_history_view">Guvnor Resource History view</link> to be
+ populated with revision history for the selected file.</para>
+ </section>
+
+ <section id="compare_with_version">
+ <title>Compare with Version Action</title>
+
+ <para>The <emphasis>
+ <property moreinfo="none">Compare with Version</property>
+ </emphasis> action is enabled for one Guvnor repository associated file. This action
+ first opens a wizard asking for the version for comparison (with the local file
+ contents):</para>
+
+ <figure float="0">
+ <title>Compare with Version Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/compare_with_version.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Once the revision is selected, the action opens the Eclipse <property moreinfo="none">Compare
+ editor</property> (read-only):</para>
+ <figure float="0">
+ <title>Eclipse Compare Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/compare_with_version2.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>This editor uses Eclipse-standard comparison techniques to show the differences in
+ the two versions. In cases where there are no differences, the editor will not open,
+ rather a dialog saying that there are no differences will appear.</para>
+ <figure float="0">
+ <title>Alert Dialog</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/compare_with_version3.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+
+ <section id="switch_to_version">
+ <title>Switch to Version Action</title>
+
+ <para>The <emphasis>
+ <property moreinfo="none">Switch to Version</property>
+ </emphasis> action is enabled for one Guvnor repository associated file.</para>
+ <para>First the <emphasis>
+ <property moreinfo="none">Switch to Version</property>
+ </emphasis> action prompts for selection of version:</para>
+
+ <figure float="0">
+ <title>Select Version Window</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/compare_with_version.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Once the version is selected, the <emphasis>
+ <property moreinfo="none">Switch to Version</property>
+ </emphasis> action replaces the local file contents with those from the revision
+ selected.</para>
+ </section>
+
+ <section id="delete_action">
+ <title>Delete Action</title>
+
+ <para>The <emphasis>
+ <property moreinfo="none">Delete</property>
+ </emphasis> action is enabled for one or more Guvnor repository associated files.
+ After confirmation via a dialog, the <emphasis>
+ <property moreinfo="none">Delete</property>
+ </emphasis> action removes the files in the Guvnor repository and deletes local
+ metadata for the Guvnor repository association.</para>
+
+ <figure float="0">
+ <title>Comfirm Delete Dialog</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/confirm_delete.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+
+ <section id="disconnect_action">
+ <title>Disconnect Action</title>
+
+ <para>The <emphasis>
+ <property moreinfo="none">Disconnect</property>
+ </emphasis> action is enabled for one or more Guvnor repository associated files,
+ and removes local metadata for the Guvnor repository association.</para>
+ </section>
+ </section>
+
+ <section id="guvnor_history_view">
+ <title>Guvnor Resource History View</title>
+
+ <para>The <property moreinfo="none">Guvnor Resource History view</property> should details about revision
+ history for selected files, both local and those in Guvnor repositories. The initial
+ state of this view is shown on the figure below.</para>
+
+ <figure float="0">
+ <title>Initial State of the Guvnor Resource History View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/resource_history_view.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The <property moreinfo="none">Guvnor Resource History view</property> is populated by <emphasis>
+ <property moreinfo="none">Show History</property>
+ </emphasis> actions in either the local <emphasis>
+ <property moreinfo="none">Guvnor</property></emphasis> context menu or in the context menu for
+ a Guvnor repository file in the <link linkend="guvnor_repositories_view">Guvnor
+ Repositories view</link>. Once this action is performed, the <property moreinfo="none">Guvnor
+ Resource History view</property> updates to show the revision history:</para>
+
+ <figure float="0">
+ <title>IGuvnor Resource History View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/resource_history_view2.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Here we see that the file <emphasis>
+ <property moreinfo="none">test.txt</property>
+ </emphasis> has three revisions. Double clicking on a revision row (or the context menu <emphasis>
+ <property moreinfo="none">Open (Read only)</property>)</emphasis> opens an Eclipse read-only editor
+ with the revision contents.</para>
+
+ <figure float="0">
+ <title>Eclipse Read-only Editor with the Revision Contents</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/resource_history_view3.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <note>
+ <title>Note:</title>
+ <para>You can also use the <emphasis>
+ <property moreinfo="none">Save As...</property>
+ </emphasis> option when a file is open in a read-only editor to save a local
+ writable copy of the contents. Doing so, however, will not associate the file
+ created with its Guvnor source.</para>
+ </note>
+
+ </section>
+
+ <section id="resources_from_guvnor">
+ <title>Importing Guvnor Repository Resources</title>
+
+ <para>In addition to the single file drag-and-drop from the <property moreinfo="none">Guvnor Repositories
+ view</property>, the <property moreinfo="none">EGT</property> also includes a wizard for copying one
+ or more files from a Guvnor repository to the local workspace (and setting the
+ association with the Guvnor repository). This wizard is available from the <emphasis>
+ <property moreinfo="none">File > Import > Guvnor > Resource from
+ Guvnor</property>
+ </emphasis> and the <emphasis>
+ <property moreinfo="none">File > New > Other > Guvnor > Resource from
+ Guvnor</property>
+ </emphasis> menu items.</para>
+ <note>
+ <title>Note:</title>
+
+ <para>Note that the wizard is identical but appears in both locations to accommodate
+ users who tend to view this functionality as being in either category.</para>
+ </note>
+
+ <para>The first page of the wizard asks for the selection of the source Guvnor repository
+ and gives the choice to create a new Guvnor repository connection (in which case the
+ second page is the same as the <link linkend="guvnor_connection_wizard">Guvnor Connection wizard</link>).</para>
+
+ <figure float="0">
+ <title>Resource from Guvnor Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/add_toGuvnor_wizard.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Once the source Guvnor repository is chosen, the wizard prompts for resource selection:</para>
+
+ <figure float="0">
+ <title>Resource Selection</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/resource_from_guvnor.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Finally, the target location in the local workspace should be chosen:</para>
+ <figure float="0">
+ <title>Choosing the Target Location</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/resource_from_guvnor2.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>On completion the wizard copies the selected files from the Guvnor repository to the local workspace.
+ If a file with the same name already exists in the destination, the wizard uses the Eclipse standard
+ "prompt for rename" dialog:</para>
+
+ <figure float="0">
+ <title>Prompt for Rename Dialog</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/functionality_overview/resource_from_guvnor3.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+</chapter>
+
+
+<chapter id="guvnor_preferences" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/drools/docs/guvnor_ref/en/modules/guvnor_preferences.xml" xreflabel="guvnor_preferences">
+ <?dbhtml filename="guvnor_preferences.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Eclipse Guvnor Tools</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Guvnor Preferences</title>
+
+ <para>The <property moreinfo="none">EGT</property> provides a preference page in the <emphasis>
+ <property moreinfo="none">Guvnor</property>
+ </emphasis> category:</para>
+
+ <figure float="0">
+ <title>Resource Selection</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/guvnor_preferences/guvnor_preferences.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The preferences cover two categories:</para>
+ <itemizedlist>
+ <listitem><para>Guvnor repository connections</para></listitem>
+
+ <listitem><para>Local Guvnor
+ repository resource decorations.</para></listitem>
+ </itemizedlist>
+
+ <section id="repo_connection_preferences">
+ <title>Guvnor Repository Connection Preferences</title>
+ <para>There are two preferences that can be set for Guvnor repository connections, that are
+ used when creating new connections:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>The first is a default Guvnor repository URL template, which can make it
+ easier to create multiple similar connections by simply changing part of the
+ field, such as the host name.</para>
+ </listitem>
+ <listitem>
+ <para>The second is whether saving of authentication information in the Eclipse
+ platform key-ring should be enabled by default.</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>As with the Guvnor repository URL template, actually whether to save a specific
+ instance of authentication information in the Eclipse platform key-ring can be
+ determined when actually creating the connection. That is, both of these preferences are
+ simply convenience values set to reasonable defaults.</para>
+ </section>
+
+ <section id="resource_decoration_preferences">
+ <title>Local Guvnor Repository Resource Decoration Preferences</title>
+
+ <para>The second category of preferences provided by the <property moreinfo="none">EGT</property> deals with how the decoration of
+ local resources associated with Guvnor repository resources is presented. Since the
+ Guvnor repository is not a substitute for a SCM, and since SCM tools in Eclipse tend to
+ decorate local resources, it is useful to be able to control just how the <property moreinfo="none">EGT</property> decorate
+ its local resources to avoid messy conflicts with SCM packages.</para>
+
+ <para>In the <emphasis>
+ <property moreinfo="none">File Decoration</property></emphasis>
+ section of the preference page, you can choose the location (Top right, Top left, Bottom right,
+ Bottom left) of the decoration icon, or you can choose not to display it. In
+ the <emphasis>
+ <property moreinfo="none">Text</property></emphasis> section, you can format the Guvnor metadata that is appended to the file
+ names:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Whether to show an indicator (>) when the local file has changes not committed back to the
+ Guvnor repository</para>
+ </listitem>
+ <listitem>
+ <para>Whether to show the revision number</para>
+ </listitem>
+ <listitem>
+ <para>Whether to show the date/time stamp</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>Any changes to these preferences take effect immediately upon clicking the <emphasis>
+ <property moreinfo="none">Apply</property></emphasis> and then <emphasis>
+ <property moreinfo="none">Ok</property></emphasis> buttons.</para>
+ </section>
+</chapter>
+
+
+<chapter id="conclusion" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/drools/docs/guvnor_ref/en/modules/conclusion.xml" xreflabel="conclusion">
+ <?dbhtml filename="conclusion.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Eclipse Guvnor Tools</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Conclusion</title>
+
+ <para>As stated at the beginning of this document, the key goal of the <property moreinfo="none">EGT</property>
+ is to provide a way of interacting with Guvnor repository resources in a local Eclipse
+ workspace. While clearly there is a lot more that could be done, and no doubt there will be
+ aspects of the current tooling that require revision going forward, we feel that the current
+ state of the <property moreinfo="none">EGT</property> is sufficient for the major use cases.</para>
+
+ <para>If you have some questions, comments or suggestions on the topic, please feel free to ask in the
+ <ulink url="http://www.jboss.org/index.html?module=bb&op=viewforum&f=201">Jboss Tools Forum</ulink>.</para>
+</chapter>
+
+
+</book>
15 years, 6 months
- 1
- 0
JBoss Tools SVN: r15738 - trunk/drools/docs/guvnor_ref/en.
by jbosstools-commits＠lists.jboss.org
Author: ochikvina
Date: 2009-06-05 11:14:36 -0400 (Fri, 05 Jun 2009)
New Revision: 15738
Modified:
trunk/drools/docs/guvnor_ref/en/master.xml
Log:
https://jira.jboss.org/jira/browse/JBDS-743 - updating the master.xml;
Modified: trunk/drools/docs/guvnor_ref/en/master.xml
===================================================================
--- trunk/drools/docs/guvnor_ref/en/master.xml 2009-06-05 15:04:33 UTC (rev 15737)
+++ trunk/drools/docs/guvnor_ref/en/master.xml 2009-06-05 15:14:36 UTC (rev 15738)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-"http://www.docbook.org/xsd/4.3/docbook.xsd"
+"http://www.docbook.org/xml/4.3/docbookx.dtd"
[<!ENTITY introduction SYSTEM "modules/introduction.xml">
<!ENTITY functionality_overview SYSTEM "modules/functionality_overview.xml">
15 years, 6 months
- 1
- 0
JBoss Tools SVN: r15737 - trunk/drools/docs/reference/en.
by jbosstools-commits＠lists.jboss.org
Author: ochikvina
Date: 2009-06-05 11:04:33 -0400 (Fri, 05 Jun 2009)
New Revision: 15737
Modified:
trunk/drools/docs/reference/en/master_output.xml
Log:
https://jira.jboss.org/jira/browse/JBDS-743 - updating the master_output.xml;
Modified: trunk/drools/docs/reference/en/master_output.xml
===================================================================
--- trunk/drools/docs/reference/en/master_output.xml 2009-06-05 15:04:13 UTC (rev 15736)
+++ trunk/drools/docs/reference/en/master_output.xml 2009-06-05 15:04:33 UTC (rev 15737)
@@ -21,752 +21,761 @@
<!ENTITY strutsreflink "../../struts_tools_ref_guide/html_single/index.html">
<!ENTITY strutstutoriallink "../../struts_tools_tutorial/html_single/index.html">
-]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff">
-
- <bookinfo>
- <title>Drools Tools Reference Guide</title>
-
- <author><firstname>Olga</firstname><surname>Chikvina</surname></author>
-
- <pubdate>April 2008</pubdate>
- <copyright>
- <year>2007</year>
- <year>2009</year>
- <holder>JBoss, a division of Red Hat</holder>
- </copyright>
- <releaseinfo><diffmk:wrapper diffmk:change="changed">
- Version: 5.0.0.CR1
- </diffmk:wrapper></releaseinfo>
-<abstract>
- <title></title>
- <para>
- <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/as/pdf/AS_Reference_...">PDF version</ulink>
- </para>
-</abstract>
-
- </bookinfo>
-
-
- <toc></toc>
-
-<chapter id="introduction" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/drools/docs/reference/en/modules/introduction.xml" xreflabel="introduction">
- <title>Introduction</title>
-
- <section id="whatisDrools">
- <title>What is Drools?</title>
-
- <para><property moreinfo="none">Drools</property> is a business rule management system (BRMS) with a forward
- chaining inference based rules engine, more correctly known as a production rule system,
- using an enhanced implementation of the Rete algorithm.</para>
-
- <para><diffmk:wrapper diffmk:change="changed"> In this guide we are going to get you familiar with Drools Eclipse plugin which
- provides development tools for creating, executing and debugging Drools processes and
- rules from within Eclipse.</diffmk:wrapper></para>
-
- <note>
- <title>Note:</title>
- <para>It is assumed that you has some familiarity with rule engines and Drools in
- particular. If no, we suggest that you look carefully through the <ulink url="http://downloads.jboss.com/drools/docs/4.0.7.19894.GA/html_single/index.html">Drools Documentation</ulink>.</para>
- </note>
-
- <para><property moreinfo="none">Drools Tools</property> come bundled with <property moreinfo="none">JBoss Tools</property>
- set of Eclipse plugins. How to install <property moreinfo="none">JBoss Tools</property><diffmk:wrapper diffmk:change="changed"> you can find in
- the </diffmk:wrapper><ulink url="../../GettingStartedGuide/html_single/index.html#JBossToolsInstall">Getting Started Guide</ulink>.</para>
- </section>
-
- <section id="drools_key_features">
- <title>Drools Tools Key Features</title>
-
- <para>The following table lists all valuable features of the <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Drools
- Tools</diffmk:wrapper></property>.</para>
- <table>
- <title>Key Functionality of Drools Tools</title>
- <tgroup cols="3">
-
- <colspec align="left" colnum="1" colwidth="1*"></colspec>
- <colspec colnum="2" colwidth="5*"></colspec>
- <colspec align="left" colnum="3" colwidth="1*"></colspec>
-
- <thead>
- <row>
- <entry>Feature</entry>
- <entry>Benefit</entry>
- <entry>Chapter</entry>
- </row>
- </thead>
-
- <tbody>
-
- <row>
- <entry>
- <para>Wizard for creating a new Drools Project</para>
- </entry>
- <entry>
- <para>The wizard allows to create a sample project to easy get started
- with Drools</para>
- </entry>
- <entry>
- <link linkend="sample_drools_project">Creating a Sample Drools
- Project</link>
- </entry>
- </row>
-
- <row>
- <entry>
- <para>Wizards for creation new Drools resources</para>
- </entry>
- <entry>
- <para>A set of wizards are provided with the Drools Eclipse tools to
- quickly create a new Rule resource, a new Domain Specific language,
- Decision Table and Business rule</para>
- </entry>
- <entry>
- <link linkend="creating_rule">Creating a New Rule</link>
- <!--link linkend="creating_dsl">Creating a New DSL</link>
- <link linkend="creating_decision_table">Creating a New Decision
- Table</link>
- <link linkend="creating_business_rule">Creating a New Business
- Rule</link-->
- </entry>
- </row>
-
- <row>
- <entry>
- <para>The Rule editor</para>
- </entry>
- <entry>
- <para>An editor that is aware of DRL syntax and provides content
- assistance and synchronizing with the Outline view</para>
- </entry>
- <entry>
- <link linkend="textual_rule_editor">The Rule Editor</link>
- </entry>
- </row>
-
- <row>
- <entry>
- <para>The Domain Specific Language editor</para>
- </entry>
- <entry>
- <para>The editor allows to create and manage mappings from users
- language to the rule language</para>
- </entry>
- <entry>
- <!--link linkend="dsl_editor">The Domain Specific Language Editor</link-->
- </entry>
- </row>
-
- <row>
- <entry>
- <para>The Guided editor</para>
- </entry>
- <entry>
- <para>This guided editor for rules allows you to build rules in a GUI
- driven fashion based on your object model</para>
- </entry>
- <entry>
- <!--link linkend="guided_editor">The Guided Editor</link-->
- </entry>
- </row>
-
- <row>
- <entry>
- <para>The Rule Flow graphical editor</para>
- </entry>
- <entry>
- <para>The editor is meant for editing visual graphs which represent a
- process (a rule flow)</para>
- </entry>
- <entry>
- <!--link linkend="ruleflow_editor">The Rule Flow Graphical Editor</link-->
- </entry>
- </row>
-
- </tbody>
- </tgroup>
- </table>
- </section>
-
- <section>
- <title>Other relevant resources on the topic</title>
-
- <itemizedlist>
- <listitem>
- <para>Drools on <ulink url="http://www.jboss.org/drools/">JBoss.org</ulink></para>
- </listitem>
-
- <listitem>
- <para>
- <ulink url="http://www.jboss.org/tools/">JBoss Tools Home Page</ulink>
- </para>
- </listitem>
-
- <listitem>
- <para>
- <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">The latest
- JBossTools/JBDS documentation builds</ulink>
- </para>
- </listitem>
-
- <listitem>
- <para><diffmk:wrapper diffmk:change="added">All </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools/JBDS</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> documentation you can find on the
- </diffmk:wrapper><ulink diffmk:change="added" url="http://docs.jboss.org/tools/"><diffmk:wrapper diffmk:change="added">documentation release
- page</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
- </listitem>
- </itemizedlist>
-
- </section>
-</chapter>
-
-
-<chapter id="create_new_project" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/drools/docs/reference/en/modules/create_new_project.xml" xreflabel="create_new_project">
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Tools</keyword>
- <keyword>Drools Tools</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Creating a New Drools Project</title>
-
- <para>In this chapter we are going to show you how to setup an executable sample Drools project
- to start using rules immediately.</para>
-
-
-
- <section id="sample_drools_project">
- <title>Creating a Sample Drools Project</title>
-
- <para>First, we suggest that you use <property moreinfo="none">Drools perspective</property> which is aimed
- at work with Drools specific resources.</para>
-
- <para>To create a new Drools project follow to <emphasis>
- <property moreinfo="none">File > New > Drools Project</property>. </emphasis> This will open
- <property moreinfo="none">New Drools Project wizard</property> like on the figure below.</para>
-
- <para>On the first page type the project name and click
- <emphasis><property moreinfo="none">Next</property>.</emphasis></para>
-
- <figure float="0">
- <title>Creating a New Drools Project</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/create_new_project/create_new_project1.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Next you have a choice to add some default artifacts to it like sample rules, decision
- tables or ruleflows and Java classes for them. Let's select first two check
- boxes and press <emphasis>
- <property moreinfo="none">Next</property>. </emphasis></para>
-
- <figure float="0">
- <title>Selecting Drools Project Elements</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/create_new_project/create_new_project2.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Next page asks you to specify a Drools runtime. If you have not yet set it up, you
- should do this now by clicking the <emphasis>
- <property moreinfo="none">Configure Workspace Settings</property>
- </emphasis> link.</para>
-
- <figure float="0">
- <title>Configuring Drools Runtime</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/create_new_project/create_new_project3.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>You should see the <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Preferences window</diffmk:wrapper></property> where you can configure the
- workspace settings for Drools runtimes. To create a new runtime, press the <emphasis>
- <property moreinfo="none">Add</property>
- </emphasis> button. The appeared dialog prompts you to enter a
- name for a new runtime and a path to the Drools runtime on your file system.</para>
-
- <note>
- <title>Note:</title>
- <para>A Drools runtime is a collection of jars on your file system that represent one
- specific release of the Drools project jars. While creating a new runtime, you must
- either point to the release of your choice, or you can simply create a new runtime
- on your file system from the jars included in the Drools Eclipse plugin.</para>
- </note>
-
- <figure float="0">
- <title>Adding a New Drools Runtime</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/create_new_project/create_new_project4.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Let's simply create a new Drools 5 runtime from the jars embedded in the
- Drools Eclipse plugin. Thus, you should press <emphasis>
- <property moreinfo="none">Create a new Drools 5 runtime</property>
- </emphasis> button and select the folder where you want this runtime to be created and
- hit <emphasis>
- <property moreinfo="none">OK</property>.</emphasis></para>
-
- <para>You will see the newly created runtime show up in your list of Drools runtimes. Check
- it and press <emphasis>
- <property moreinfo="none">OK</property>.</emphasis></para>
-
- <figure float="0">
- <title>Selecting a Drools Runtime</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/create_new_project/create_new_project5.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Now press <emphasis>
- <property moreinfo="none">Finish</property>
- </emphasis> to complete the project creation.</para>
-
- <figure float="0">
- <title>Completing the Drools Project Creation</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/create_new_project/create_new_project6.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>This will setup a basic structure, classpath and sample rules and test case to get you
- started.</para>
- </section>
-
-
- <section id="structure_overview">
- <title>Drools Project Structure Overview</title>
-
- <para>Now let's look at the structure of the organized project. In the
- <property moreinfo="none">Package Explorer</property> you should see the following:</para>
-
- <figure float="0">
- <title>Drools Project in the Package Explorer</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/create_new_project/create_new_project7.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>The newly created project contains an example rule file <emphasis>
- <property moreinfo="none">Sample.drl</property>
- </emphasis> in the <emphasis>
- <property moreinfo="none">src/main/rules</property>
- </emphasis> directory and an example java file <emphasis>
- <property moreinfo="none">DroolsTest.java</property>
- </emphasis> that can be used to execute the rules in a Drools engine in the folder <emphasis>
- <property moreinfo="none">src/main/java</property>
- </emphasis>, in the <emphasis>
- <property moreinfo="none">com.sample</property>
- </emphasis> package. All the others jar's that are necessary during execution
- are also added to the classpath in a custom classpath container called <property moreinfo="none">Drools
- Library</property>.</para>
-
- <tip>
- <title>Tip:</title>
- <para>Rules do not have to be kept in Java projects at all, this is just a convenience
- for people who are already using eclipse as their Java IDE.</para>
- </tip>
-
- </section>
-
- <section id="creating_rule">
- <title>Creating a New Rule</title>
-
- <para>Now we are going to add a new Rule resource to the project.</para>
-
- <para>You can either create an empty text <emphasis>
- <property moreinfo="none">.drl</property>
- </emphasis> file or make use of the special <property moreinfo="none">New Rule Resource
- wizard</property> to do it.</para>
-
- <para>To open the wizard follow to <emphasis>
- <property moreinfo="none">File > New > Rule Resource</property>
- </emphasis> or use the menu with the JBoss Drools icon on the toolbar.</para>
-
- <figure float="0">
- <title>Opening the New Rule Resource Wizard</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/create_new_project/create_new_project8.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>On the wizard page first select <emphasis>
- <property moreinfo="none">/rules</property>
- </emphasis> as a top level directory to store your rules and type the rule name. Next
- it's mandatory to specify the rule package name. It defines a namespace that
- groups rules together.</para>
-
- <figure float="0">
- <title>New Rule Resource Wizard</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/create_new_project/create_new_project9.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>As a result the wizard generates a rule skeleton to get you started.</para>
-
- <figure float="0">
- <title>New Rule</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/create_new_project/create_new_project10.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- </section>
-
-</chapter>
-
-
-<chapter id="debugging_rules" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/drools/docs/reference/en/modules/debugging_rules.xml" xreflabel="debugging_rules">
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Tools</keyword>
- <keyword>Drools Tools</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Debugging rules</title>
-
- <para>This chapter describes how to debug rules during the execution of your Drools application.</para>
-
- <section id="creating_breakpoints">
- <title>Creating Breakpoints</title>
-
- <para>At first, we'll focus on how to add
- breakpoints in the consequences of your rules.</para>
-
- <para>Whenever such a breakpoint is uncounted
- during the execution of the rules, the execution is halted. It's possible then inspect the
- variables known at that point and use any of the default debugging actions to decide what
- should happen next (step over, continue, etc). To inspect
- the content of the working memory and agenda the Debug views can be used.</para>
-
- <para>You can add/remove rule breakpoints in <emphasis>
- <property moreinfo="none">.drl</property>
- </emphasis> files in two ways, similar to adding breakpoints to Java files:</para>
-
- <itemizedlist>
- <listitem>
- <para>Double-click the ruler in the <property moreinfo="none">Rule editor</property> at the line
- where you want to add a breakpoint.</para>
- <tip>
- <title>Tip:</title>
- <para>Note that rule breakpoints can only be created in the consequence of a
- rule. Double-clicking on a line where no breakpoint is allowed will do
- nothing.</para>
- </tip>
- <para>A breakpoint can be removed by double-clicking the ruler once more. </para>
- </listitem>
-
- <listitem>
- <para>Right-click the ruler. Select <emphasis>
- <property moreinfo="none">Toggle Breakpoint</property>
- </emphasis> action in the appeared popup menu. Clicking the action will add a
- breakpoint at the selected line or remove it if there is one already.</para>
- </listitem>
- </itemizedlist>
-
- <figure float="0">
- <title>Adding Breakpoints</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/debugging_rules/debugging_rules1.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>The <property moreinfo="none">Debug perspective</property> contains a <property moreinfo="none">Breakpoints
- view</property> which can be used to see all defined breakpoints, get their
- properties, enable/disable or remove them, etc. You can switch to it by navigating to <emphasis>
- <property moreinfo="none">Window > Perspective > Others > Debug</property>.</emphasis></para>
- </section>
-
- <section id="debugging">
- <title>Debugging</title>
-
- <para>Drools breakpoints are only enabled if you debug your application as a Drools
- Application. To do this you should perform one of the actions:</para>
-
- <itemizedlist>
- <listitem>
- <para>Select the main class of your application. Right click it and select <emphasis>
- <property moreinfo="none">Debug As > Drools Application</property>.</emphasis></para>
- </listitem>
- </itemizedlist>
- <figure float="0">
- <title>Debugging Drools Application</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/debugging_rules/debugging_rules2.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <itemizedlist>
- <listitem>
- <para>Alternatively, you can also go to <emphasis>
- <property moreinfo="none">Debug As > Debug Configuration</property>
- </emphasis> to open a new dialog for creating, managing and running debug
- configurations.</para>
-
- <para>Select the <emphasis>
- <property moreinfo="none">Drools Application</property>
- </emphasis> item in the left tree and click the <emphasis>
- <property moreinfo="none">New launch configuration</property>
- </emphasis> button (leftmost icon in the toolbar above the tree). This will
- create a new configuration and already fill in some of the properties (like the
- Project and Main class) based on main class you selected in the beginning. All
- properties shown here are the same as any standard Java program.</para>
- </listitem>
- </itemizedlist>
-
- <figure float="0">
- <title>New Debug Configuration</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/debugging_rules/debugging_rules3.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <tip>
- <title>Tip:</title>
- <para>Remember to change the name of your debug configuration to something meaningful.</para>
- </tip>
-
- <para>Next
- click the <emphasis>
- <property moreinfo="none">Debug</property>
- </emphasis> button on the bottom to start debugging your application. </para>
-
- <para>After enabling the debugging, the application starts executing and will halt if
- any breakpoint is encountered. This can be a Drools rule breakpoint, or any other
- standard Java breakpoint. Whenever a Drools rule breakpoint is encountered, the
- corresponding <emphasis>
- <property moreinfo="none">.drl</property></emphasis> file is opened and the active line is highlighted. The Variables view
- also contains all rule parameters and their value. You can then use the default Java
- debug actions to decide what to do next (resume, terminate, step over, etc.). The debug
- views can also be used to determine the contents of the working memory and agenda at
- that time as well (you don't have to select a working memory now, the current executing
- working memory is automatically shown).</para>
-
-
- </section>
-</chapter>
-
-
-<chapter id="editors" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/drools/docs/reference/en/modules/editors.xml" xreflabel="editors">
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Tools</keyword>
- <keyword>Drools Tools</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Editors</title>
-
- <section id="textual_rule_editor">
- <title>The Rule Editor</title>
-
- <para>The <property moreinfo="none">Rule editor</property> works on files that have a <emphasis>
- <property moreinfo="none">.drl</property>
- </emphasis> (or <emphasis>
- <property moreinfo="none">.rule</property>
- </emphasis> in the case of spreading rules across multiple rule files) extension.</para>
-
- <figure float="0">
- <title>New Rule</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/editors/editors1.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>The editor follows the pattern of a normal text editor in eclipse, with all the normal
- features of a text editor:</para>
-
- <itemizedlist>
- <listitem>
- <para>
- <link linkend="rules_editor_content_assist">Content Assist</link>
- </para>
- </listitem>
-
- <listitem>
- <para>
- <link linkend="rules_editor_code_folding">Code Folding</link>
- </para>
- </listitem>
-
- <!-- <listitem>
- <para>
- <link linkend="rules_editor_error_reporting">Error Reporting</link>
- </para>
- </listitem>-->
-
- <listitem>
- <para>
- <link linkend="rules_editor_sync_with_outline">Synchronization with Outline
- View</link>
- </para>
- </listitem>
- </itemizedlist>
-
- <section id="rules_editor_content_assist">
- <title>Content Assist</title>
-
- <para>While working in the <property moreinfo="none">Rule editor</property> you can get a content
- assistance the usual way by pressing <emphasis>
- <property moreinfo="none">Ctrl + Space</property>.</emphasis></para>
-
- <para>Content Assist shows all possible keywords for the current cursor position.</para>
-
- <figure float="0">
- <title>Content Assist Demonstration</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/editors/editors2.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Content Assist inside of the <emphasis>
- <property moreinfo="none">Message</property>
- </emphasis> suggests all available fields.</para>
-
- <figure float="0">
- <title>Content Assist Demonstration</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/editors/editors3.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- </section>
-
- <section id="rules_editor_code_folding">
- <title>Code Folding</title>
-
- <para>Code folding is also available in the <property moreinfo="none">Rule editor</property>. To
- hide/show sections of the file use the icons with minus/plus on the left vertical
- line of the editor.</para>
-
- <figure float="0">
- <title>Code Folding</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/editors/editors4.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- </section>
-
- <!--section id="rules_editor_error_reporting">
- <title>Error Reporting</title>
-
- </section-->
-
- <section id="rules_editor_sync_with_outline">
- <title>Synchronization with Outline View</title>
-
- <para>The <property moreinfo="none">Rule editor</property> works in synchronization with the
- <property moreinfo="none">Outline view</property> which shows the structure of the rules,
- imports in the file and also globals and functions if the file has them.</para>
-
- <figure float="0">
- <title>Synchronization with Outline View</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/editors/editors5.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>The view is updated on save. It provides a quick way of navigating around rules by
- names in a file which may have hundreds of rules. The items are sorted
- alphabetically by default.</para>
- </section>
-
- <section id="rete_view">
- <title>The Rete Tree View</title>
-
- <para>The <property moreinfo="none">Rete Tree view</property> shows you the current Rete Network for
- your <emphasis>
- <property moreinfo="none">.drl</property>
- </emphasis> file. Just click on the <emphasis>
- <property moreinfo="none">Rete Tree tab</property>
- </emphasis> at the bottom of the <property moreinfo="none">Rule editor</property>.</para>
-
- <figure float="0">
- <title>Rete Tree</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/editors/editors6.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Afterwards you can generate the current Rete Network visualization. You can push
- and pull the nodes to arrange your optimal network overview.</para>
- <para>If you got hundreds of nodes, select some of them with a frame. Then you can pull
- groups of them.</para>
-
- <figure float="0">
- <title>Selecting the nodes in the Rete Tree with Frame</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/editors/editors7.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>You can zoom in and out the Rete tree in case not all nodes are shown in the
- current view. For this use the combo box or "+" and "-" icons on the toolbar.</para>
-
- <figure float="0">
- <title>Rete Tree Zooming</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/editors/editors8.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <note>
- <title>Note:</title>
-
- <para>The <property moreinfo="none">Rete Tree view</property> works only in Drools Rule Projects,
- where the Drools Builder is set in the project properties.</para>
- </note>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">We hope, this guide helped you to get started with the JBoss BPMN Convert module. Besides, for additional information you are welcome on </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201"><diffmk:wrapper diffmk:change="added">JBoss forum</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
- </section>
-
- </section>
-
-</chapter>
-
-
-
-</book>
+]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff">
+
+ <bookinfo>
+ <title>Drools Tools Reference Guide</title>
+ <corpauthor diffmk:change="added">
+ <inlinemediaobject diffmk:change="added">
+ <imageobject diffmk:change="added" role="fo">
+ <imagedata diffmk:change="added" fileref="images/jbosstools_logo.png" format="PNG"></imagedata>
+ </imageobject>
+ <imageobject diffmk:change="added" role="html">
+ <imagedata diffmk:change="added"></imagedata>
+ </imageobject>
+ </inlinemediaobject>
+ </corpauthor>
+ <author><firstname>Olga</firstname><surname>Chikvina</surname></author>
+
+ <pubdate>April 2008</pubdate>
+ <copyright>
+ <year>2007</year>
+ <year>2009</year>
+ <holder>JBoss, a division of Red Hat</holder>
+ </copyright>
+ <releaseinfo><diffmk:wrapper diffmk:change="changed">
+ Version: 5.1.0.trunk
+ </diffmk:wrapper></releaseinfo>
+<abstract>
+ <title></title>
+ <para>
+ <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/as/pdf/AS_Reference_...">PDF version</ulink>
+ </para>
+</abstract>
+
+ </bookinfo>
+
+
+ <toc></toc>
+
+<chapter id="introduction" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/drools/docs/reference/en/modules/introduction.xml" xreflabel="introduction">
+ <title>Introduction</title>
+
+ <section id="whatisDrools">
+ <title>What is Drools?</title>
+
+ <para><property moreinfo="none">Drools</property> is a business rule management system (BRMS) with a forward
+ chaining inference based rules engine, more correctly known as a production rule system,
+ using an enhanced implementation of the Rete algorithm.</para>
+
+ <para> In this guide we are going to get you familiar with Drools Eclipse plugin which
+ provides development tools for creating, executing and debugging Drools processes and
+ rules from within Eclipse.</para>
+
+ <note>
+ <title>Note:</title>
+ <para>It is assumed that you has some familiarity with rule engines and Drools in
+ particular. If no, we suggest that you look carefully through the <ulink url="http://downloads.jboss.com/drools/docs/4.0.7.19894.GA/html_single/index.html">Drools Documentation</ulink>.</para>
+ </note>
+
+ <para><property moreinfo="none">Drools Tools</property> come bundled with <property moreinfo="none">JBoss Tools</property>
+ set of Eclipse plugins. How to install <property moreinfo="none">JBoss Tools</property> you can find in
+ the <ulink url="../../GettingStartedGuide/html_single/index.html#JBossToolsInstall">Getting Started Guide</ulink>.</para>
+ </section>
+
+ <section id="drools_key_features">
+ <title>Drools Tools Key Features</title>
+
+ <para>The following table lists all valuable features of the <property moreinfo="none">Drools
+ Tools</property>.</para>
+ <table>
+ <title>Key Functionality of Drools Tools</title>
+ <tgroup cols="3">
+
+ <colspec align="left" colnum="1" colwidth="1*"></colspec>
+ <colspec colnum="2" colwidth="5*"></colspec>
+ <colspec align="left" colnum="3" colwidth="1*"></colspec>
+
+ <thead>
+ <row>
+ <entry>Feature</entry>
+ <entry>Benefit</entry>
+ <entry>Chapter</entry>
+ </row>
+ </thead>
+
+ <tbody>
+
+ <row>
+ <entry>
+ <para>Wizard for creating a new Drools Project</para>
+ </entry>
+ <entry>
+ <para>The wizard allows to create a sample project to easy get started
+ with Drools</para>
+ </entry>
+ <entry>
+ <link linkend="sample_drools_project">Creating a Sample Drools
+ Project</link>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <para>Wizards for creation new Drools resources</para>
+ </entry>
+ <entry>
+ <para>A set of wizards are provided with the Drools Eclipse tools to
+ quickly create a new Rule resource, a new Domain Specific language,
+ Decision Table and Business rule</para>
+ </entry>
+ <entry>
+ <link linkend="creating_rule">Creating a New Rule</link>
+ <!--link linkend="creating_dsl">Creating a New DSL</link>
+ <link linkend="creating_decision_table">Creating a New Decision
+ Table</link>
+ <link linkend="creating_business_rule">Creating a New Business
+ Rule</link-->
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <para>The Rule editor</para>
+ </entry>
+ <entry>
+ <para>An editor that is aware of DRL syntax and provides content
+ assistance and synchronizing with the Outline view</para>
+ </entry>
+ <entry>
+ <link linkend="textual_rule_editor">The Rule Editor</link>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <para>The Domain Specific Language editor</para>
+ </entry>
+ <entry>
+ <para>The editor allows to create and manage mappings from users
+ language to the rule language</para>
+ </entry>
+ <entry>
+ <!--link linkend="dsl_editor">The Domain Specific Language Editor</link-->
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <para>The Guided editor</para>
+ </entry>
+ <entry>
+ <para>This guided editor for rules allows you to build rules in a GUI
+ driven fashion based on your object model</para>
+ </entry>
+ <entry>
+ <!--link linkend="guided_editor">The Guided Editor</link-->
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <para>The Rule Flow graphical editor</para>
+ </entry>
+ <entry>
+ <para>The editor is meant for editing visual graphs which represent a
+ process (a rule flow)</para>
+ </entry>
+ <entry>
+ <!--link linkend="ruleflow_editor">The Rule Flow Graphical Editor</link-->
+ </entry>
+ </row>
+
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+
+ <section>
+ <title>Other relevant resources on the topic</title>
+
+ <itemizedlist>
+ <listitem>
+ <para>Drools on <ulink url="http://www.jboss.org/drools/">JBoss.org</ulink></para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <ulink url="http://www.jboss.org/tools/">JBoss Tools Home Page</ulink>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">The latest
+ JBossTools/JBDS documentation builds</ulink>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>All <property moreinfo="none">JBoss Tools/JBDS</property> documentation you can find on the
+ <ulink url="http://docs.jboss.org/tools/">documentation release
+ page</ulink>.</para>
+ </listitem>
+ </itemizedlist>
+
+ </section>
+</chapter>
+
+
+<chapter id="create_new_project" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/drools/docs/reference/en/modules/create_new_project.xml" xreflabel="create_new_project">
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Drools Tools</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Creating a New Drools Project</title>
+
+ <para>In this chapter we are going to show you how to setup an executable sample Drools project
+ to start using rules immediately.</para>
+
+
+
+ <section id="sample_drools_project">
+ <title>Creating a Sample Drools Project</title>
+
+ <para>First, we suggest that you use <property moreinfo="none">Drools perspective</property> which is aimed
+ at work with Drools specific resources.</para>
+
+ <para>To create a new Drools project follow to <emphasis>
+ <property moreinfo="none">File > New > Drools Project</property>. </emphasis> This will open
+ <property moreinfo="none">New Drools Project wizard</property> like on the figure below.</para>
+
+ <para>On the first page type the project name and click
+ <emphasis><property moreinfo="none">Next</property>.</emphasis></para>
+
+ <figure float="0">
+ <title>Creating a New Drools Project</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/create_new_project/create_new_project1.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Next you have a choice to add some default artifacts to it like sample rules, decision
+ tables or ruleflows and Java classes for them. Let's select first two check
+ boxes and press <emphasis>
+ <property moreinfo="none">Next</property>. </emphasis></para>
+
+ <figure float="0">
+ <title>Selecting Drools Project Elements</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/create_new_project/create_new_project2.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Next page asks you to specify a Drools runtime. If you have not yet set it up, you
+ should do this now by clicking the <emphasis>
+ <property moreinfo="none">Configure Workspace Settings</property>
+ </emphasis> link.</para>
+
+ <figure float="0">
+ <title>Configuring Drools Runtime</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/create_new_project/create_new_project3.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>You should see the <property moreinfo="none">Preferences window</property> where you can configure the
+ workspace settings for Drools runtimes. To create a new runtime, press the <emphasis>
+ <property moreinfo="none">Add</property>
+ </emphasis> button. The appeared dialog prompts you to enter a
+ name for a new runtime and a path to the Drools runtime on your file system.</para>
+
+ <note>
+ <title>Note:</title>
+ <para>A Drools runtime is a collection of jars on your file system that represent one
+ specific release of the Drools project jars. While creating a new runtime, you must
+ either point to the release of your choice, or you can simply create a new runtime
+ on your file system from the jars included in the Drools Eclipse plugin.</para>
+ </note>
+
+ <figure float="0">
+ <title>Adding a New Drools Runtime</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/create_new_project/create_new_project4.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Let's simply create a new Drools 5 runtime from the jars embedded in the
+ Drools Eclipse plugin. Thus, you should press <emphasis>
+ <property moreinfo="none">Create a new Drools 5 runtime</property>
+ </emphasis> button and select the folder where you want this runtime to be created and
+ hit <emphasis>
+ <property moreinfo="none">OK</property>.</emphasis></para>
+
+ <para>You will see the newly created runtime show up in your list of Drools runtimes. Check
+ it and press <emphasis>
+ <property moreinfo="none">OK</property>.</emphasis></para>
+
+ <figure float="0">
+ <title>Selecting a Drools Runtime</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/create_new_project/create_new_project5.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Now press <emphasis>
+ <property moreinfo="none">Finish</property>
+ </emphasis> to complete the project creation.</para>
+
+ <figure float="0">
+ <title>Completing the Drools Project Creation</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/create_new_project/create_new_project6.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>This will setup a basic structure, classpath and sample rules and test case to get you
+ started.</para>
+ </section>
+
+
+ <section id="structure_overview">
+ <title>Drools Project Structure Overview</title>
+
+ <para>Now let's look at the structure of the organized project. In the
+ <property moreinfo="none">Package Explorer</property> you should see the following:</para>
+
+ <figure float="0">
+ <title>Drools Project in the Package Explorer</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/create_new_project/create_new_project7.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The newly created project contains an example rule file <emphasis>
+ <property moreinfo="none">Sample.drl</property>
+ </emphasis> in the <emphasis>
+ <property moreinfo="none">src/main/rules</property>
+ </emphasis> directory and an example java file <emphasis>
+ <property moreinfo="none">DroolsTest.java</property>
+ </emphasis> that can be used to execute the rules in a Drools engine in the folder <emphasis>
+ <property moreinfo="none">src/main/java</property>
+ </emphasis>, in the <emphasis>
+ <property moreinfo="none">com.sample</property>
+ </emphasis> package. All the others jar's that are necessary during execution
+ are also added to the classpath in a custom classpath container called <property moreinfo="none">Drools
+ Library</property>.</para>
+
+ <tip>
+ <title>Tip:</title>
+ <para>Rules do not have to be kept in Java projects at all, this is just a convenience
+ for people who are already using eclipse as their Java IDE.</para>
+ </tip>
+
+ </section>
+
+ <section id="creating_rule">
+ <title>Creating a New Rule</title>
+
+ <para>Now we are going to add a new Rule resource to the project.</para>
+
+ <para>You can either create an empty text <emphasis>
+ <property moreinfo="none">.drl</property>
+ </emphasis> file or make use of the special <property moreinfo="none">New Rule Resource
+ wizard</property> to do it.</para>
+
+ <para>To open the wizard follow to <emphasis>
+ <property moreinfo="none">File > New > Rule Resource</property>
+ </emphasis> or use the menu with the JBoss Drools icon on the toolbar.</para>
+
+ <figure float="0">
+ <title>Opening the New Rule Resource Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/create_new_project/create_new_project8.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>On the wizard page first select <emphasis>
+ <property moreinfo="none">/rules</property>
+ </emphasis> as a top level directory to store your rules and type the rule name. Next
+ it's mandatory to specify the rule package name. It defines a namespace that
+ groups rules together.</para>
+
+ <figure float="0">
+ <title>New Rule Resource Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/create_new_project/create_new_project9.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>As a result the wizard generates a rule skeleton to get you started.</para>
+
+ <figure float="0">
+ <title>New Rule</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/create_new_project/create_new_project10.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ </section>
+
+</chapter>
+
+
+<chapter id="debugging_rules" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/drools/docs/reference/en/modules/debugging_rules.xml" xreflabel="debugging_rules">
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Drools Tools</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Debugging rules</title>
+
+ <para>This chapter describes how to debug rules during the execution of your Drools application.</para>
+
+ <section id="creating_breakpoints">
+ <title>Creating Breakpoints</title>
+
+ <para>At first, we'll focus on how to add
+ breakpoints in the consequences of your rules.</para>
+
+ <para>Whenever such a breakpoint is uncounted
+ during the execution of the rules, the execution is halted. It's possible then inspect the
+ variables known at that point and use any of the default debugging actions to decide what
+ should happen next (step over, continue, etc). To inspect
+ the content of the working memory and agenda the Debug views can be used.</para>
+
+ <para>You can add/remove rule breakpoints in <emphasis>
+ <property moreinfo="none">.drl</property>
+ </emphasis> files in two ways, similar to adding breakpoints to Java files:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Double-click the ruler in the <property moreinfo="none">Rule editor</property> at the line
+ where you want to add a breakpoint.</para>
+ <tip>
+ <title>Tip:</title>
+ <para>Note that rule breakpoints can only be created in the consequence of a
+ rule. Double-clicking on a line where no breakpoint is allowed will do
+ nothing.</para>
+ </tip>
+ <para>A breakpoint can be removed by double-clicking the ruler once more. </para>
+ </listitem>
+
+ <listitem>
+ <para>Right-click the ruler. Select <emphasis>
+ <property moreinfo="none">Toggle Breakpoint</property>
+ </emphasis> action in the appeared popup menu. Clicking the action will add a
+ breakpoint at the selected line or remove it if there is one already.</para>
+ </listitem>
+ </itemizedlist>
+
+ <figure float="0">
+ <title>Adding Breakpoints</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/debugging_rules/debugging_rules1.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The <property moreinfo="none">Debug perspective</property> contains a <property moreinfo="none">Breakpoints
+ view</property> which can be used to see all defined breakpoints, get their
+ properties, enable/disable or remove them, etc. You can switch to it by navigating to <emphasis>
+ <property moreinfo="none">Window > Perspective > Others > Debug</property>.</emphasis></para>
+ </section>
+
+ <section id="debugging">
+ <title>Debugging</title>
+
+ <para>Drools breakpoints are only enabled if you debug your application as a Drools
+ Application. To do this you should perform one of the actions:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Select the main class of your application. Right click it and select <emphasis>
+ <property moreinfo="none">Debug As > Drools Application</property>.</emphasis></para>
+ </listitem>
+ </itemizedlist>
+ <figure float="0">
+ <title>Debugging Drools Application</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/debugging_rules/debugging_rules2.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <itemizedlist>
+ <listitem>
+ <para>Alternatively, you can also go to <emphasis>
+ <property moreinfo="none">Debug As > Debug Configuration</property>
+ </emphasis> to open a new dialog for creating, managing and running debug
+ configurations.</para>
+
+ <para>Select the <emphasis>
+ <property moreinfo="none">Drools Application</property>
+ </emphasis> item in the left tree and click the <emphasis>
+ <property moreinfo="none">New launch configuration</property>
+ </emphasis> button (leftmost icon in the toolbar above the tree). This will
+ create a new configuration and already fill in some of the properties (like the
+ Project and Main class) based on main class you selected in the beginning. All
+ properties shown here are the same as any standard Java program.</para>
+ </listitem>
+ </itemizedlist>
+
+ <figure float="0">
+ <title>New Debug Configuration</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/debugging_rules/debugging_rules3.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <tip>
+ <title>Tip:</title>
+ <para>Remember to change the name of your debug configuration to something meaningful.</para>
+ </tip>
+
+ <para>Next
+ click the <emphasis>
+ <property moreinfo="none">Debug</property>
+ </emphasis> button on the bottom to start debugging your application. </para>
+
+ <para>After enabling the debugging, the application starts executing and will halt if
+ any breakpoint is encountered. This can be a Drools rule breakpoint, or any other
+ standard Java breakpoint. Whenever a Drools rule breakpoint is encountered, the
+ corresponding <emphasis>
+ <property moreinfo="none">.drl</property></emphasis> file is opened and the active line is highlighted. The Variables view
+ also contains all rule parameters and their value. You can then use the default Java
+ debug actions to decide what to do next (resume, terminate, step over, etc.). The debug
+ views can also be used to determine the contents of the working memory and agenda at
+ that time as well (you don't have to select a working memory now, the current executing
+ working memory is automatically shown).</para>
+
+
+ </section>
+</chapter>
+
+
+<chapter id="editors" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/drools/docs/reference/en/modules/editors.xml" xreflabel="editors">
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Drools Tools</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Editors</title>
+
+ <section id="textual_rule_editor">
+ <title>The Rule Editor</title>
+
+ <para>The <property moreinfo="none">Rule editor</property> works on files that have a <emphasis>
+ <property moreinfo="none">.drl</property>
+ </emphasis> (or <emphasis>
+ <property moreinfo="none">.rule</property>
+ </emphasis> in the case of spreading rules across multiple rule files) extension.</para>
+
+ <figure float="0">
+ <title>New Rule</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/editors/editors1.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The editor follows the pattern of a normal text editor in eclipse, with all the normal
+ features of a text editor:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ <link linkend="rules_editor_content_assist">Content Assist</link>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <link linkend="rules_editor_code_folding">Code Folding</link>
+ </para>
+ </listitem>
+
+ <!-- <listitem>
+ <para>
+ <link linkend="rules_editor_error_reporting">Error Reporting</link>
+ </para>
+ </listitem>-->
+
+ <listitem>
+ <para>
+ <link linkend="rules_editor_sync_with_outline">Synchronization with Outline
+ View</link>
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <section id="rules_editor_content_assist">
+ <title>Content Assist</title>
+
+ <para>While working in the <property moreinfo="none">Rule editor</property> you can get a content
+ assistance the usual way by pressing <emphasis>
+ <property moreinfo="none">Ctrl + Space</property>.</emphasis></para>
+
+ <para>Content Assist shows all possible keywords for the current cursor position.</para>
+
+ <figure float="0">
+ <title>Content Assist Demonstration</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/editors/editors2.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Content Assist inside of the <emphasis>
+ <property moreinfo="none">Message</property>
+ </emphasis> suggests all available fields.</para>
+
+ <figure float="0">
+ <title>Content Assist Demonstration</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/editors/editors3.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ </section>
+
+ <section id="rules_editor_code_folding">
+ <title>Code Folding</title>
+
+ <para>Code folding is also available in the <property moreinfo="none">Rule editor</property>. To
+ hide/show sections of the file use the icons with minus/plus on the left vertical
+ line of the editor.</para>
+
+ <figure float="0">
+ <title>Code Folding</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/editors/editors4.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ </section>
+
+ <!--section id="rules_editor_error_reporting">
+ <title>Error Reporting</title>
+
+ </section-->
+
+ <section id="rules_editor_sync_with_outline">
+ <title>Synchronization with Outline View</title>
+
+ <para>The <property moreinfo="none">Rule editor</property> works in synchronization with the
+ <property moreinfo="none">Outline view</property> which shows the structure of the rules,
+ imports in the file and also globals and functions if the file has them.</para>
+
+ <figure float="0">
+ <title>Synchronization with Outline View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/editors/editors5.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The view is updated on save. It provides a quick way of navigating around rules by
+ names in a file which may have hundreds of rules. The items are sorted
+ alphabetically by default.</para>
+ </section>
+
+ <section id="rete_view">
+ <title>The Rete Tree View</title>
+
+ <para>The <property moreinfo="none">Rete Tree view</property> shows you the current Rete Network for
+ your <emphasis>
+ <property moreinfo="none">.drl</property>
+ </emphasis> file. Just click on the <emphasis>
+ <property moreinfo="none">Rete Tree tab</property>
+ </emphasis> at the bottom of the <property moreinfo="none">Rule editor</property>.</para>
+
+ <figure float="0">
+ <title>Rete Tree</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/editors/editors6.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Afterwards you can generate the current Rete Network visualization. You can push
+ and pull the nodes to arrange your optimal network overview.</para>
+ <para>If you got hundreds of nodes, select some of them with a frame. Then you can pull
+ groups of them.</para>
+
+ <figure float="0">
+ <title>Selecting the nodes in the Rete Tree with Frame</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/editors/editors7.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>You can zoom in and out the Rete tree in case not all nodes are shown in the
+ current view. For this use the combo box or "+" and "-" icons on the toolbar.</para>
+
+ <figure float="0">
+ <title>Rete Tree Zooming</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/editors/editors8.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <note>
+ <title>Note:</title>
+
+ <para>The <property moreinfo="none">Rete Tree view</property> works only in Drools Rule Projects,
+ where the Drools Builder is set in the project properties.</para>
+ </note>
+ <para>We hope, this guide helped you to get started with the JBoss BPMN Convert module. Besides, for additional information you are welcome on <ulink url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201">JBoss forum</ulink>.</para>
+ </section>
+
+ </section>
+
+</chapter>
+
+
+
+</book>
15 years, 6 months
- 1
- 0
JBoss Tools SVN: r15736 - trunk/documentation/guides/GettingStartedGuide/en.
by jbosstools-commits＠lists.jboss.org
Author: ochikvina
Date: 2009-06-05 11:04:13 -0400 (Fri, 05 Jun 2009)
New Revision: 15736
Modified:
trunk/documentation/guides/GettingStartedGuide/en/master_output.xml
Log:
https://jira.jboss.org/jira/browse/JBDS-743 - updating the master_output.xml;
Modified: trunk/documentation/guides/GettingStartedGuide/en/master_output.xml
===================================================================
--- trunk/documentation/guides/GettingStartedGuide/en/master_output.xml 2009-06-05 15:03:57 UTC (rev 15735)
+++ trunk/documentation/guides/GettingStartedGuide/en/master_output.xml 2009-06-05 15:04:13 UTC (rev 15736)
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="UTF-8"?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd"
[
@@ -29,6 +29,7 @@
<!ENTITY smookslink "../../jboss_smooks_plugin_ref_guide/html_single/index.html">
<!ENTITY droolslink "../../drools_tools_ref_guide/html_single/index.html">
<!ENTITY jmxlink "../../jmx_ref_guide/html_single/index.html">
+<!ENTITY guvnorlink "../../guvnor_tools_ref_guide/html_single/index.html">
]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff">
@@ -40,7 +41,7 @@
<year>2009</year>
<holder>JBoss, a division of Red Hat</holder>
</copyright>
- <releaseinfo><diffmk:wrapper diffmk:change="changed">Version: 2.0.1.GA</diffmk:wrapper></releaseinfo>
+ <releaseinfo>Version: 2.0.1.GA</releaseinfo>
<abstract>
<title></title>
<para>
@@ -81,6 +82,102 @@
Tools.</para>
</section>
+<section diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Key Features of JBoss Developer Studio</diffmk:wrapper></title>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">For a start, we propose you to look through the table of main features of JBoss Developer Studio</diffmk:wrapper></para>
+
+ <table diffmk:change="added">
+
+ <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Key Functionality of JBoss Developer Studio</diffmk:wrapper></title>
+ <tgroup cols="3" diffmk:change="added">
+
+ <colspec align="left" colnum="1" colwidth="2*" diffmk:change="added"></colspec>
+ <colspec colnum="2" colwidth="4*" diffmk:change="added"></colspec>
+
+
+ <thead diffmk:change="added">
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Feature</diffmk:wrapper></entry>
+ <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Benefit</diffmk:wrapper></entry>
+
+ </row>
+ </thead>
+
+ <tbody diffmk:change="added">
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss Enterprise Application Platform</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss Developer Studio includes and integrates JBoss Enterprise Application Platform, the same version of the middleware platform that Red Hat supports in production for 5 years.</diffmk:wrapper></para></entry>
+ </row>
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">New Seam Tools</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss Developer Studio includes brand new tools for Seam. They provide wizards for creating new Seam projects, validation tools, expression language code completion, testing tools, and wizards for generating entity objects.</diffmk:wrapper></para></entry>
+ </row>
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Visual Page Editor</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss Developer Studio includes a Visual Page Editor for combined visual and source editing of Web pages. The Visual Page Editor even renders AJAX-enabled RichFaces components.</diffmk:wrapper></para></entry>
+ </row>
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">AJAX Capabilities</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss Developer Studio includes a Technology Preview of JBoss RichFaces. RichFaces provides nearly 70 skinnable components, including calendar, tree, dropdown menu, drag-and-drop components, and more. JBoss Developer Studio’s Visual Page Editor can render RichFaces components.</diffmk:wrapper></para></entry>
+ </row>
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss Tools Palette</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The JBoss Tools Palette contains a developer’s project tag libraries and enables inserting tags into a JSP with one click. The Tools Palette supports custom and 3rd party tags.</diffmk:wrapper></para></entry>
+ </row>
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss jBPM Tools</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss Developer Studio includes jBPM tooling for defining Seam page flows.</diffmk:wrapper></para></entry>
+ </row>
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Spring Tools</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss Developer Studio includes Spring IDE for developing Spring applications.</diffmk:wrapper></para></entry>
+ </row>
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Struts Tools</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss Developer Studio includes Struts tools for Struts 1.x applications.</diffmk:wrapper></para></entry>
+ </row>
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Optimized JBoss Application Server adapter</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss Developer Studio’s advanced JBoss AS adapter includes features like incremental deployment for fast development and is pre-configured for the included JBoss Application server.</diffmk:wrapper></para></entry>
+ </row>
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Red Hat Enterprise Linux and RHN Access</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss Developer Studio includes access to Red Hat Enterprise Linux, Linux development tools, and Red Hat Network for development purposes.</diffmk:wrapper></para></entry>
+ </row>
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Business Intelligence Report Tool (BIRT)</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss Developer Studio includes Business Intelligence Report Tool, a reporting system that integrates with Java/J2EE, extracts certain information, analyzes it, and generates report summaries and charts.</diffmk:wrapper></para></entry>
+ </row>
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBossWeb Service</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss WS is a web service framework developed as a part of the JBoss Application Server. It implements the JAX-WS specification that defines a programming model and run-time architecture for implementing web services in Java, targeted at the Java Platform, Enterprise Edition 5 (Java EE 5).</diffmk:wrapper></para></entry>
+ </row>
+
+
+ </tbody>
+
+ </tgroup>
+ </table>
+
+</section>
+
+
+
+
+
+
<section id="ConfigJavaEnvironment">
<?dbhtml filename="ConfigJavaEnvironment.html"?>
<title>Configuring Your Java Environment</title>
@@ -513,8 +610,8 @@
<para>Get Eclipse and Web Tools</para>
</listitem>
</itemizedlist>
- <para><diffmk:wrapper diffmk:change="changed">The current version of JBoss Tools (3.0.1.GA) targets at Eclipse 3.4.2 and WTP
- 3.0.4</diffmk:wrapper></para>
+ <para>The current version of JBoss Tools (3.0.1.GA) targets at Eclipse 3.4.2 and WTP
+ 3.0.4</para>
<tip>
<title>Tip:</title>
@@ -522,7 +619,7 @@
Instead we suggest that you download the full binary from <ulink url="http://www.eclipse.org/downloads/">here</ulink>.</para>
</tip>
- <para>If you can only use Eclipse 3.3 use <ulink url="http://www.jboss.org/tools/download/index.html#stable">JBoss Tools 2.1.2</ulink>, but
+ <para>If you can only use Eclipse 3.3 use <ulink url="http://www.jboss.org/tools/download.html">JBoss Tools 2.1.2</ulink>, but
JBoss Tools 2.x will not have any of the new features.</para>
<note>
@@ -676,7 +773,7 @@
<section id="Support">
<?dbhtml filename="Support.html"?>
<title>Support</title>
- <para>If you have comments or questions, you can discuss them at our <ulink url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=258">JBoss
+ <para>If you have comments or questions, you can discuss them at our <ulink url="http://www.jboss.com/index.html?module=bb'op=viewforum'f=258">JBoss
Developer Studio Forum</ulink>.</para>
<para>When writing to the forum for questions, please include the following information:</para>
<orderedlist continuation="restarts" inheritnum="ignore">
@@ -700,7 +797,7 @@
<title>Other relevant resources on the topic</title>
<para>JBDS on JBoss: <ulink url="http://labs.jboss.com/rhdevstudio/">JBoss Developer
Studio</ulink></para>
- <para>Forum: <ulink url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=258">JBoss
+ <para>Forum: <ulink url="http://www.jboss.com/index.html?module=bb'op=viewforum'f=258">JBoss
Forum</ulink></para>
<para>Subscription: <ulink url="https://www.redhat.com/apps/store/developers/jboss_developer_studio.html">JBDS
Subscription</ulink></para>
@@ -727,8 +824,8 @@
<para>In this chapter we'll focus more on how to operate the <property moreinfo="none">JBoss
AS</property> from <property moreinfo="none">JBoss Developer Studio</property>.</para>
- <para><property moreinfo="none">JBoss Developer Studio</property> ships with <property moreinfo="none">JBoss EAP
- v.4.3</property> bundled. When you followed the default installation of <property moreinfo="none">JBoss
+ <para><property moreinfo="none">JBoss Developer Studio</property> is shipped with <property moreinfo="none">JBoss EAP
+ </property>. When you followed the default installation of <property moreinfo="none">JBoss
Developer Studio</property>, you should already have a JBoss EAP 4.3 Server installed and
defined. To run JBoss AS you need JDK 1.5, JDK 6 is not formally supported yet, although
you may be able to start the server with it.</para>
@@ -863,7 +960,7 @@
<title>JBoss AS Installation</title>
<itemizedlist>
<listitem>
- <para><diffmk:wrapper diffmk:change="changed">Download the binary package of JBoss AS, e.g. </diffmk:wrapper><property moreinfo="none">JBoss 4.2.3</property> and save
+ <para>Download the binary package of JBoss AS, e.g. <property moreinfo="none">JBoss 4.2.3</property> and save
it on your computer: <ulink url="http://labs.jboss.com/jbossas/downloads">http://labs.jboss.com/jbossas/downloads</ulink></para>
</listitem>
</itemizedlist>
@@ -1282,13 +1379,13 @@
<para>The complete information on how to manage JBoss AS from JBoss Developer Studio you can
read in a <link linkend="manage">corresponding chapter</link>.</para>
- <para><diffmk:wrapper diffmk:change="added">Now you just need to start the server by clicking on the Start the server icon (
- </diffmk:wrapper><inlinemediaobject diffmk:change="added">
+ <para>Now you just need to start the server by clicking on the Start the server icon (
+ <inlinemediaobject>
<imageobject>
<imagedata fileref="images/first_seam/first_seam50.png"></imagedata>
</imageobject>
- </inlinemediaobject><diffmk:wrapper diffmk:change="added"> ) in the
- JBoss Server View.</diffmk:wrapper></para>
+ </inlinemediaobject> ) in the
+ JBoss Server View.</para>
<para>Then run the project by selecting the project and use <emphasis><property moreinfo="none">Run As... >
Run on Server</property>.</emphasis></para>
@@ -2032,8 +2129,8 @@
who for some reason cannot use Seam.</para>
</note>
- <para>In this chapter you'll find out how to create a simple <ulink url="http://java.sun.com/products/jsp/">JSP</ulink><diffmk:wrapper diffmk:change="changed"> application using the
- </diffmk:wrapper><property moreinfo="none">JBoss Developer Studio</property>. The application will show a classic
+ <para>In this chapter you'll find out how to create a simple <ulink url="http://java.sun.com/products/jsp/">JSP</ulink> application using the
+ <property moreinfo="none">JBoss Developer Studio</property>. The application will show a classic
"Hello World!" on the page.</para>
<para>We'll assume that you have already launched <property moreinfo="none">JBoss Developer
Studio</property> and also that the <property moreinfo="none">Web Development</property> perspective is the
@@ -2105,12 +2202,12 @@
<?dbhtml filename="CreatingJSPPage.html"?>
<title>Creating JSP Page</title>
<para>This section covers all the points how to create, edit and then preview JSP page.</para>
- <para><diffmk:wrapper diffmk:change="changed">In our simple application we need to create only one JSP page which displays a
- </diffmk:wrapper><emphasis>"Hello World!"</emphasis> message.</para>
+ <para>In our simple application we need to create only one JSP page which displays a
+ <emphasis>"Hello World!"</emphasis> message.</para>
<itemizedlist>
<listitem>
- <para>Right click <emphasis><property moreinfo="none"><diffmk:wrapper diffmk:change="changed">WebContent > New >
- JSP</diffmk:wrapper></property>. </emphasis></para>
+ <para>Right click <emphasis><property moreinfo="none">WebContent > New >
+ JSP</property>. </emphasis></para>
</listitem>
<listitem>
<para>Type "hello.jsp" for a file name and click the <emphasis>
@@ -2142,8 +2239,8 @@
<section id="EditingJSPPage">
<?dbhtml filename="EditingJSPPage.html"?>
<title>Editing a JSP Page</title>
- <para><diffmk:wrapper diffmk:change="changed">Let's now make a little change so that a jsp page displays
- </diffmk:wrapper><emphasis>"Hello World!"</emphasis> message.</para>
+ <para>Let's now make a little change so that a jsp page displays
+ <emphasis>"Hello World!"</emphasis> message.</para>
<itemizedlist>
<listitem>
<!--<para>Insert this line inside the <emphasis role="bold">
@@ -2151,13 +2248,13 @@
</emphasis><emphasis role="bold">
<property></body></property>
</emphasis> tag: </para>-->
- <para><diffmk:wrapper diffmk:change="added">
+ <para>
Insert this line inside the
- </diffmk:wrapper><code diffmk:change="added"><diffmk:wrapper diffmk:change="added"><body> </body>
- </diffmk:wrapper></code><diffmk:wrapper diffmk:change="added">
+ <code><body> </body>
+ </code>
tag:
- </diffmk:wrapper></para>
+ </para>
</listitem>
</itemizedlist>
<programlisting format="linespecific" role="XML"><![CDATA[<% System.out.println("Hello World!"); %>]]>
@@ -2185,9 +2282,9 @@
</figure>
<para>This line will actually output <emphasis>"Hello
- World!"</emphasis> message in the <property moreinfo="none">Console</property><diffmk:wrapper diffmk:change="changed">. To make the
+ World!"</emphasis> message in the <property moreinfo="none">Console</property>. To make the
message displayed in the Browser, just replace this line with the simple
- </diffmk:wrapper><emphasis>Hello World!</emphasis>.</para>
+ <emphasis>Hello World!</emphasis>.</para>
</section>
<section id="WebXML">
@@ -2196,8 +2293,8 @@
<para>When you are creating web project the wizard creates the <emphasis>
<property moreinfo="none">web.xml</property>
</emphasis> for you automatically. The <property moreinfo="none">web.xml file editor</property>
- provided by <property moreinfo="none">JBoss Developer Studio</property><diffmk:wrapper diffmk:change="changed"> is available in two modes:
- </diffmk:wrapper><property moreinfo="none">Tree</property> and <property moreinfo="none">Source</property>.</para>
+ provided by <property moreinfo="none">JBoss Developer Studio</property> is available in two modes:
+ <property moreinfo="none">Tree</property> and <property moreinfo="none">Source</property>.</para>
<figure float="0">
<title>Web.xml in Design and Source Mode</title>
<mediaobject>
@@ -2216,9 +2313,9 @@
<para>Switch to <property moreinfo="none">Source</property> tab.</para>
</listitem>
<listitem>
- <para><diffmk:wrapper diffmk:change="added">Add the next code into
- </diffmk:wrapper><code diffmk:change="added"><welcome-file-list></code><diffmk:wrapper diffmk:change="added">
- :</diffmk:wrapper></para>
+ <para>Add the next code into
+ <code><welcome-file-list></code>
+ :</para>
</listitem>
</itemizedlist>
<programlisting format="linespecific" role="XML"><![CDATA[<welcome-file>hello.jsp</welcome-file>
@@ -2231,9 +2328,9 @@
<section id="DeployTheProject">
<?dbhtml filename="DeployTheProject.html"?>
<title>Deploying the project</title>
- <para><diffmk:wrapper diffmk:change="changed">While creating any web project you could experience a pain writing ant scripts and
+ <para>While creating any web project you could experience a pain writing ant scripts and
managing the packaging even when writing the most trivial web applications. With
- </diffmk:wrapper><property moreinfo="none">JBoss Developer Studio</property> you are saved from such a pain. All
+ <property moreinfo="none">JBoss Developer Studio</property> you are saved from such a pain. All
you need is to start <property moreinfo="none">JBoss Server</property> and launch your application
in your favorite browser.</para>
<para>You can also create a war archive with <ulink url="../../as/html_single/index.html#Project_archivesView">JBDS's Archive Tools</ulink>
@@ -2245,8 +2342,8 @@
<itemizedlist>
<listitem>
<para>Select <emphasis>
- <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Window > Show view > Other > JBoss
- Tools > Project archives</diffmk:wrapper></property>
+ <property moreinfo="none">Window > Show view > Other > JBoss
+ Tools > Project archives</property>
</emphasis> from menu bar</para>
</listitem>
<listitem>
@@ -2297,8 +2394,8 @@
<listitem>
<para>Click <emphasis>
<property moreinfo="none">Finish</property>. </emphasis> The
- <emphasis>.war</emphasis> file will appear in <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Package
- Explorer</diffmk:wrapper></property> and also in <property moreinfo="none">Project Archives</property>
+ <emphasis>.war</emphasis> file will appear in <property moreinfo="none">Package
+ Explorer</property> and also in <property moreinfo="none">Project Archives</property>
view as structure tree: <figure float="0">
<title>Archive is Created</title>
<mediaobject>
@@ -2333,13 +2430,26 @@
<section id="AutoRedeploy">
<?dbhtml filename="AutoRedeploy.html"?>
<title>Auto redeploy</title>
- <para>When you are creating a web application and register it on <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss
- Server</diffmk:wrapper></property> it is automatically deployed into
- <emphasis>/deploy</emphasis><diffmk:wrapper diffmk:change="changed"> directory of the server. JBDS comes with the
+ <para>When you are creating a web application and register it on <property moreinfo="none">JBoss
+ Server</property> it is automatically deployed into
+ <emphasis>/deploy</emphasis> directory of the server. JBDS comes with the
feature of auto-redeploy. It means that you don't need to restart
- </diffmk:wrapper><property moreinfo="none">JBoss Server</property>. Any changes made in the application in
+ <property moreinfo="none">JBoss Server</property>. Any changes made in the application in
exploded format will trigger a redeployment on the server.</para>
+
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You can also use the "Finger touch" button for a quick restart of the project without restarting the server:</diffmk:wrapper></para>
+ <figure diffmk:change="added" float="0">
+ <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Finger Touch button</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added" fileref="images/jsp_application/jsp_application_19_finger_touch.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The "Finger" touches descriptors dependent on project (i.e. web.xml for WAR, application.xml for EAR, jboss-esb.xml in ESB projects).</diffmk:wrapper></para>
+
</section>
+
</section>
<section id="Previewtab">
@@ -2382,18 +2492,18 @@
<section id="LaunchingTheProject">
<?dbhtml filename="LaunchingTheProject.html"?>
<title>Launch JSP Project</title>
- <para><diffmk:wrapper diffmk:change="changed">Let's now launch our project on server. We'll use
- </diffmk:wrapper><property moreinfo="none">JBoss Server</property> that is shipped with <property moreinfo="none">JBoss Developer
+ <para>Let's now launch our project on server. We'll use
+ <property moreinfo="none">JBoss Server</property> that is shipped with <property moreinfo="none">JBoss Developer
Studio</property>. You can do it by performing one of the following actions:</para>
<itemizedlist>
<listitem>
- <para>Start JBoss Server from <ulink url="../../as/html_single/index.html#JBossServerView"><diffmk:wrapper diffmk:change="changed">JBoss
- Server view</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> by clicking the Start the server icon (
- </diffmk:wrapper><inlinemediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/jsp_application/jsp_application_18.png"></imagedata>
+ <para>Start JBoss Server from <ulink url="../../as/html_single/index.html#JBossServerView">JBoss
+ Server view</ulink> by clicking the Start the server icon (
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="images/jsp_application/jsp_application_18.png"></imagedata>
</imageobject>
- </inlinemediaobject><diffmk:wrapper diffmk:change="added"> ) .</diffmk:wrapper></para>
+ </inlinemediaobject> ) .</para>
</listitem>
</itemizedlist>
@@ -2407,12 +2517,12 @@
clicking the <emphasis>
<property moreinfo="none">hello.jsp</property>
</emphasis> page and selecting <emphasis>
- <property moreinfo="none">Run on the Server</property> </emphasis><diffmk:wrapper diffmk:change="added">(
- </diffmk:wrapper><inlinemediaobject diffmk:change="added">
+ <property moreinfo="none">Run on the Server</property> </emphasis>(
+ <inlinemediaobject>
<imageobject>
<imagedata fileref="images/jsp_application/jsp_application_16.png"></imagedata>
</imageobject>
- </inlinemediaobject><diffmk:wrapper diffmk:change="added"> ).</diffmk:wrapper></para>
+ </inlinemediaobject> ).</para>
</listitem>
</itemizedlist>
@@ -3005,14 +3115,14 @@
<para>The Visual Page Editor will open in a screen split between source code along the
top and a WYSIWIG view along the bottom. You can see that some JSF code will be
already generated as we choose a template when creating the page.</para>
- <para><diffmk:wrapper diffmk:change="added">At the beginning it's necessary to create a
- </diffmk:wrapper><code diffmk:change="added"><h:form></code><diffmk:wrapper diffmk:change="added">
- component where all others components are put.</diffmk:wrapper></para>
+ <para>At the beginning it's necessary to create a
+ <code><h:form></code>
+ component where all others components are put.</para>
<itemizedlist>
<listitem>
- <para><diffmk:wrapper diffmk:change="added">Place the mouse cursor inside
- </diffmk:wrapper><code diffmk:change="added"><diffmk:wrapper diffmk:change="added"><f:view>
- </f:view></diffmk:wrapper></code>
+ <para>Place the mouse cursor inside
+ <code><f:view>
+ </f:view></code>
</para>
</listitem>
<listitem>
@@ -3020,9 +3130,9 @@
it</para>
</listitem>
<listitem>
- <para><diffmk:wrapper diffmk:change="added">Click on
- </diffmk:wrapper><code diffmk:change="added"><h:form></code><diffmk:wrapper diffmk:change="added">
- tag </diffmk:wrapper><figure float="0">
+ <para>Click on
+ <code><h:form></code>
+ tag <figure float="0">
<title>Insert h:form</title>
<mediaobject>
<imageobject>
@@ -3147,11 +3257,11 @@
</figure>
<itemizedlist>
<listitem>
- <para><diffmk:wrapper diffmk:change="added">Switch to Source mode and insert
- </diffmk:wrapper><code diffmk:change="added"><br/></code><diffmk:wrapper diffmk:change="added">
+ <para>Switch to Source mode and insert
+ <code><br/></code>
tag after
- </diffmk:wrapper><code diffmk:change="added"><h:outputText></code><diffmk:wrapper diffmk:change="added">
- component to make a new line.</diffmk:wrapper></para>
+ <code><h:outputText></code>
+ component to make a new line.</para>
</listitem>
<listitem>
<para>Click <emphasis>
@@ -3164,11 +3274,11 @@
editor, and drop it inside the editor after the text.</para>
</listitem>
<listitem>
- <para><diffmk:wrapper diffmk:change="added">Switch to a Source mode and insert
- </diffmk:wrapper><code diffmk:change="added"><br/></code><diffmk:wrapper diffmk:change="added">
+ <para>Switch to a Source mode and insert
+ <code><br/></code>
tag after
- </diffmk:wrapper><code diffmk:change="added"><h:outputText></code><diffmk:wrapper diffmk:change="added">
- component to make a new line</diffmk:wrapper></para>
+ <code><h:outputText></code>
+ component to make a new line</para>
</listitem>
<listitem>
<para>Click <emphasis>
@@ -3253,9 +3363,9 @@
<para>Go to Source mode</para>
</listitem>
<listitem>
- <para><diffmk:wrapper diffmk:change="added">Add the validation attribute to
- </diffmk:wrapper><code diffmk:change="added"><f:validateLongRange></code><diffmk:wrapper diffmk:change="added">
- for user input validation</diffmk:wrapper></para>
+ <para>Add the validation attribute to
+ <code><f:validateLongRange></code>
+ for user input validation</para>
</listitem>
</itemizedlist>
<programlisting format="linespecific" role="XML"><![CDATA[<h:inputText id="userNumber" value="#{NumberBean.userNumber}" required="true">
@@ -3317,13 +3427,13 @@
</emphasis></para>
</listitem>
<listitem>
- <para><diffmk:wrapper diffmk:change="added">In Source mode add
- </diffmk:wrapper><code diffmk:change="added"><br/></code><diffmk:wrapper diffmk:change="added">
+ <para>In Source mode add
+ <code><br/></code>
tags between
- </diffmk:wrapper><code diffmk:change="added"><outputText></code><diffmk:wrapper diffmk:change="added">
- , </diffmk:wrapper><code diffmk:change="added"><inputText></code><diffmk:wrapper diffmk:change="added">
- and </diffmk:wrapper><code diffmk:change="added"><commandButton></code><diffmk:wrapper diffmk:change="added">
- components to place them on different lines</diffmk:wrapper></para>
+ <code><outputText></code>
+ , <code><inputText></code>
+ and <code><commandButton></code>
+ components to place them on different lines</para>
</listitem>
</itemizedlist>
<para>inputnumber.jsp page should look like this:</para>
@@ -3393,12 +3503,12 @@
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="added">This page, success.jsp, is shown if you correctly guessed the number. The
- </diffmk:wrapper><code diffmk:change="added"><h:outputFormat></code><diffmk:wrapper diffmk:change="added">
+ <para>This page, success.jsp, is shown if you correctly guessed the number. The
+ <code><h:outputFormat></code>
tag will get the value of success_text from the properties file. The {0}
in success_text will be substituted for by the value of the value attribute within
- the </diffmk:wrapper><code diffmk:change="added"><f:param></code><diffmk:wrapper diffmk:change="added">
- tag during runtime.</diffmk:wrapper></para>
+ the <code><f:param></code>
+ tag during runtime.</para>
<para>At the end, you have a button which allows you to replay the game. The action
value references a backing bean method. In this case, the method only terminates the
current session so that when you are shown the first page, the input text box is
@@ -3561,7 +3671,7 @@
</figure>
<itemizedlist>
- <listitem><para><diffmk:wrapper diffmk:change="changed">Now in the New Project Example dialog you can select a project you would like to explore and a site to download it from</diffmk:wrapper></para>
+ <listitem><para>Now in the New Project Example dialog you can select a project you would like to explore and a site to download it from</para>
<para>Project Examples Wizard provides a filter field to more easily locate the project examples you want, so you can type in the project you would like to explore in the field.</para></listitem>
</itemizedlist>
@@ -3687,7 +3797,25 @@
<para>Open the JBDS perspective. If you see the Help view open, close it and restart
JBDS</para>
</listitem>
- <listitem>
+ <listitem><para diffmk:change="added"><diffmk:wrapper diffmk:change="added"> If it doesn't help and you use Fedora Core Linux and Eclipse Version: 3.4.1,the issue can be produced because libswt-xulrunner-gtk-3449.so file doesn't present
+ in eclipse-swt-3.4.1-5.fc10.x86_64.rpm/eclipse/plugins/org.eclipse.swt.gtk.linux.x86_64_3.4.1.v3449c.jar.To add this file to eclipse you should:
+ </diffmk:wrapper></para>
+ <itemizedlist diffmk:change="added">
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Decompress eclipse/plugins/org.eclipse.swt.gtk.linux.x86_3.4.1.v3449c.jar form eclipse-SDK-3.4.1-linux-gtk-x86_64.tar.gz</diffmk:wrapper></para>
+ </listitem>
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Copy </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">libswt-xulrunner-gtk-3449.so</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> file to your Fedora Eclipse location.</diffmk:wrapper></para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Open the file eclipse.ini,which can be found in your Fedora Eclipse location and add the following line: </diffmk:wrapper></para>
+ <programlisting diffmk:change="added" format="linespecific" role="JAVA"><diffmk:wrapper diffmk:change="added"><![CDATA[-Dswt.library.path=/usr/lib/eclipse
+]]></diffmk:wrapper></programlisting><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">,where </diffmk:wrapper><code diffmk:change="added"><diffmk:wrapper diffmk:change="added">/usr/lib/eclipse</diffmk:wrapper></code><diffmk:wrapper diffmk:change="added"> is the path to your eclipse folder.</diffmk:wrapper></para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem diffmk:change="added">
<para>If none of these work, do the following:</para>
<itemizedlist>
<listitem>
@@ -3864,147 +3992,157 @@
</chapterinfo>
<title>Further Reading</title>
-<itemizedlist diffmk:change="added">
+<itemizedlist>
- <listitem diffmk:change="added">
- <para diffmk:change="added">
- <emphasis role="bold"><diffmk:wrapper diffmk:change="changed">Seam Dev Tools Reference Guide</diffmk:wrapper></emphasis>
- <ulink url="../../seam/html_single/index.html">(html)
- </ulink>
- <para><diffmk:wrapper diffmk:change="changed"> This guide helps you to understand what Seam is and how to install Seam plug-in into
+ <listitem>
+ <para>
+ <emphasis role="bold">Seam Dev Tools Reference Guide</emphasis>
+ <ulink url="../../seam/html_single/index.html">(html)</ulink>
+ </para>
+ <para> This guide helps you to understand what Seam is and how to install Seam plug-in into
Eclipse. It tells you the necessary steps to start working with Seam Framework and assists in a
simple Seam Project creation. Also you will learn how to create and run the CRUD Database
- Application with Seam as well as find out what Seam Editors Features and Seam Components are. </diffmk:wrapper></para>
- </para>
+ Application with Seam as well as find out what Seam Editors Features and Seam Components are. </para>
+ </listitem>
<listitem>
- <para diffmk:change="added">
- <emphasis role="bold"><diffmk:wrapper diffmk:change="changed">Visual Web Tools Reference Guide</diffmk:wrapper></emphasis>
- <ulink url="../../jsf/html_single/index.html">(html)<diffmk:wrapper diffmk:change="changed"> provides general orientation and an overview of JBDS visual web tools functionality. This guide discusses the following topics: editors, palette, web properties view, openOn, content assist, RichFaces support.
- </diffmk:wrapper></ulink>
- </para>
+ <para>
+ <emphasis role="bold">Visual Web Tools Reference Guide</emphasis>
+ <ulink url="../../jsf/html_single/index.html">(html)</ulink> provides general orientation and an overview of JBDS visual web tools functionality. This guide discusses the following topics: editors, palette, web properties view, openOn, content assist, RichFaces support.
+ </para>
+ </listitem>
- <listitem diffmk:change="added">
+ <listitem>
<para>
- <emphasis diffmk:change="added" role="bold"><diffmk:wrapper diffmk:change="added">JBoss Server Manager Reference Guide</diffmk:wrapper></emphasis>
- <ulink diffmk:change="added" url="../../as/html_single/index.html"><diffmk:wrapper diffmk:change="added">(html)</diffmk:wrapper></ulink>
+ <emphasis role="bold">JBoss Server Manager Reference Guide</emphasis>
+ <ulink url="../../as/html_single/index.html">(html)</ulink>
</para>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added"> This guide covers the basics of working with the JBoss server manager. You will read how to
+ <para> This guide covers the basics of working with the JBoss server manager. You will read how to
install runtimes and servers and quickly learn how to configure, start, stop the server and know
how deployment and archiving process. You will find out how to manage installed JBoss Servers
- via JBoss AS Perspective. You will also read how to deploy modules onto the server. </diffmk:wrapper></para>
+ via JBoss AS Perspective. You will also read how to deploy modules onto the server. </para>
</listitem>
<listitem>
- <para diffmk:change="added">
- <emphasis role="bold"><diffmk:wrapper diffmk:change="changed">jBPM Tools Reference Guide</diffmk:wrapper></emphasis>
- <ulink url="../../jbpm/html_single/index.html">(html)
- </ulink>
- <para><diffmk:wrapper diffmk:change="changed">With jBPM Tools Reference Guide we'll help you to facilitate a cross-product
+ <para>
+ <emphasis role="bold">jBPM Tools Reference Guide</emphasis>
+ <ulink url="../../jbpm/html_single/index.html">(html)</ulink>
+ </para>
+ <para>With jBPM Tools Reference Guide we'll help you to facilitate a cross-product
learning and know how you can speed your development using special editors and visual designers.
We'll also guide you through the steps on how to create a simple process and test it
- within jBPM jPDL perspective.</diffmk:wrapper></para>
- </para>
+ within jBPM jPDL perspective.</para>
+ </listitem>
<listitem>
- <para diffmk:change="added">
- <emphasis role="bold"><diffmk:wrapper diffmk:change="changed">Hibernate Tools Reference Guide</diffmk:wrapper></emphasis>
- <ulink url="../../hibernatetools/html_single/index.html">(html)
- </ulink>
- <para><diffmk:wrapper diffmk:change="changed">Throughout this guide you will learn how to install and use Hibernate Tools bath via Ant and
+ <para>
+ <emphasis role="bold">Hibernate Tools Reference Guide</emphasis>
+ <ulink url="../../hibernatetools/html_single/index.html">(html)</ulink>
+ </para>
+ <para>Throughout this guide you will learn how to install and use Hibernate Tools bath via Ant and
through Eclipse. We'll supply you with the information on how to create mapping files,
configuration file as well as a file for controlling reverse engineering by using specific
wizards that Hibernate tooling provides. Also you will know about Code Generation and
- peculiarities of work within Hibernate Console Perspective.</diffmk:wrapper></para>
- </para>
+ peculiarities of work within Hibernate Console Perspective.</para>
+ </listitem>
<listitem>
- <para diffmk:change="added">
- <emphasis role="bold"><diffmk:wrapper diffmk:change="changed">ESB Editor Reference Guide</diffmk:wrapper></emphasis>
- <ulink url="../../esb_ref_guide/html_single/index.html">(html)
- </ulink>
- <para><diffmk:wrapper diffmk:change="changed">This guide provides you with the information on ESB Editor and all necessary wizards for ESB
- files development.</diffmk:wrapper></para>
- </para>
+ <para>
+ <emphasis role="bold">ESB Editor Reference Guide</emphasis>
+ <ulink url="../../esb_ref_guide/html_single/index.html">(html)</ulink>
+ </para>
+ <para>This guide provides you with the information on ESB Editor and all necessary wizards for ESB
+ files development.</para>
+ </listitem>
<listitem>
- <para diffmk:change="added">
- <emphasis role="bold"><diffmk:wrapper diffmk:change="changed">JBoss Portal Tools Reference Guide</diffmk:wrapper></emphasis>
- <ulink url="../../jboss_portal_tools_ref_guide/html_single/index.html">(html)
- </ulink>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The guide gives a detail look at how you can easily build a Portlet Web Application with
- JBoss Tools and deploy it onto JBoss Portal.</diffmk:wrapper></para>
- </para>
+ <para>
+ <emphasis role="bold">JBoss Portal Tools Reference Guide</emphasis>
+ <ulink url="../../jboss_portal_tools_ref_guide/html_single/index.html">(html)</ulink>
+ </para>
+ <para>The guide gives a detail look at how you can easily build a Portlet Web Application with
+ JBoss Tools and deploy it onto JBoss Portal.</para>
+ </listitem>
<listitem>
- <para diffmk:change="added">
- <emphasis role="bold"><diffmk:wrapper diffmk:change="changed">JBoss WS User Guide</diffmk:wrapper></emphasis>
+ <para>
+ <emphasis role="bold">JBoss WS User Guide</emphasis>
<ulink url="../../ws_ref_guide/html_single/index.html">(html)</ulink>
</para>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">This guide gives you practical help on JBossWS usage. You will learn how to create a web service using JBossWS runtime, find out how to create a web service client from a WSDL document using JBoss WS and also see how to set your development environment.</diffmk:wrapper></para>
+ <para>This guide gives you practical help on JBossWS usage. You will learn how to create a web service using JBossWS runtime, find out how to create a web service client from a WSDL document using JBoss WS and also see how to set your development environment.</para>
</listitem>
- <listitem diffmk:change="added">
+ <listitem>
<para>
- <emphasis diffmk:change="added" role="bold"><diffmk:wrapper diffmk:change="added">Smooks Tools Reference Guide</diffmk:wrapper></emphasis>
- <ulink diffmk:change="added" url="../../jboss_smooks_plugin_ref_guide/html_single/index.html"><diffmk:wrapper diffmk:change="added">(html)</diffmk:wrapper></ulink>
+ <emphasis role="bold">Smooks Tools Reference Guide</emphasis>
+ <ulink url="../../jboss_smooks_plugin_ref_guide/html_single/index.html">(html)</ulink>
</para>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">This guide is packed with useful and easy-to-understand information about graphical, configuration and source editor pages.</diffmk:wrapper></para>
+ <para>This guide is packed with useful and easy-to-understand information about graphical, configuration and source editor pages.</para>
</listitem>
<listitem>
- <para diffmk:change="added">
- <emphasis role="bold"><diffmk:wrapper diffmk:change="changed">Drools Tools Reference Guide</diffmk:wrapper></emphasis>
+ <para>
+ <emphasis role="bold">Drools Tools Reference Guide</emphasis>
<ulink url="../../drools_tools_ref_guide/html_single/index.html">(html)</ulink>
</para>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The guide help you to discover how to create a new Drools project, use debugging rules and work with different editors.</diffmk:wrapper></para>
+ <para>The guide help you to discover how to create a new Drools project, use debugging rules and work with different editors.</para>
</listitem>
- <listitem diffmk:change="added">
+ <listitem>
<para>
- <emphasis diffmk:change="added" role="bold"><diffmk:wrapper diffmk:change="added">JMX Tools Reference Guide</diffmk:wrapper></emphasis>
- <ulink diffmk:change="added" url="../../jmx_ref_guide/html_single/index.html"><diffmk:wrapper diffmk:change="added">(html)</diffmk:wrapper></ulink>
+ <emphasis role="bold">JMX Tools Reference Guide</emphasis>
+ <ulink url="../../jmx_ref_guide/html_single/index.html">(html)</ulink>
</para>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">With the help of this guide you'll explore the best practices to follow when working with MBean Explorer, MBean Editor, Connections and etc.</diffmk:wrapper></para>
+ <para>With the help of this guide you'll explore the best practices to follow when working with MBean Explorer, MBean Editor, Connections and etc.</para>
</listitem>
<listitem>
+ <para diffmk:change="added">
+ <emphasis diffmk:change="added" role="bold"><diffmk:wrapper diffmk:change="added">Eclipse Guvnor Tools Reference Guide</diffmk:wrapper></emphasis>
+ <ulink diffmk:change="added" url="../../guvnor_tools_ref_guide/html_single/index.html"><diffmk:wrapper diffmk:change="added">(html)</diffmk:wrapper></ulink>
+ </para>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The purpose of this guide is to describe briefly the functionality present in the Eclipse Guvnor Tools (EGT) for Drools 5.</diffmk:wrapper></para>
+ </listitem>
+
+
+
+ <listitem diffmk:change="added">
<para>
- <emphasis role="bold"><diffmk:wrapper diffmk:change="changed">JSF Tools Tutorial</diffmk:wrapper></emphasis>
+ <emphasis role="bold">JSF Tools Tutorial</emphasis>
<ulink url="../../jsf_tools_tutorial/html_single/index.html">(html)</ulink>
</para>
- <para><diffmk:wrapper diffmk:change="changed"> This tutorial will describe how to deal with classic/old style of JSF development and how
- to create a simple JSF application using the JBoss Developer Studio. </diffmk:wrapper></para>
+ <para> This tutorial will describe how to deal with classic/old style of JSF development and how
+ to create a simple JSF application using the JBoss Developer Studio. </para>
</listitem>
<listitem> <para>
- <emphasis role="bold"><diffmk:wrapper diffmk:change="changed">JSF Tools Reference Guide</diffmk:wrapper></emphasis>
- <ulink url="../../jsf_tools_ref_guide/html_single/index.html">(html)
+ <emphasis role="bold">JSF Tools Reference Guide</emphasis>
+ <ulink url="../../jsf_tools_ref_guide/html_single/index.html">(html)</ulink>
- </ulink>
- <para><diffmk:wrapper diffmk:change="changed"> From this guide you'll discover all peculiarities of work at a JSF project. You'll
+ </para>
+ <para> From this guide you'll discover all peculiarities of work at a JSF project. You'll
learn all shades that cover the process of project creation and take a closer look at the JSF
configuration file. Also you'll get to know managed beans and how to work with them and
find out, how to create and register a custom converter, custom validator and referenced beans
- in a JSF project. </diffmk:wrapper></para>
- </para>
+ in a JSF project. </para>
+ </listitem>
<listitem> <para>
- <emphasis role="bold"><diffmk:wrapper diffmk:change="changed">Struts Tools Reference Guide</diffmk:wrapper></emphasis>
+ <emphasis role="bold">Struts Tools Reference Guide</emphasis>
<ulink url="../../struts_tools_ref_guide/html_single/index.html">(html)</ulink>
</para>
- <para><diffmk:wrapper diffmk:change="changed"> In Struts Tools Reference Guide you will learn how to create and work with a new struts
+ <para> In Struts Tools Reference Guide you will learn how to create and work with a new struts
project. This guide also provides information about graphical editor for struts configuration
- files, tiles files, and struts validation files. </diffmk:wrapper></para>
+ files, tiles files, and struts validation files. </para>
</listitem>
<listitem>
<para>
- <emphasis role="bold"><diffmk:wrapper diffmk:change="changed">Struts Tools Tutorial</diffmk:wrapper></emphasis>
+ <emphasis role="bold">Struts Tools Tutorial</emphasis>
<ulink url="../../struts_tools_tutorial/html_single/index.html">(html)</ulink>
</para>
- <para><diffmk:wrapper diffmk:change="changed"> This tutorial will describe the classical style of Struts development, and will
- step-by-step show you how to create a simple Struts application in JBoss Developer Studio.</diffmk:wrapper></para>
+ <para> This tutorial will describe the classical style of Struts development, and will
+ step-by-step show you how to create a simple Struts application in JBoss Developer Studio.</para>
</listitem>
@@ -4013,14 +4151,14 @@
<emphasis role="bold">Exadel Studio Migration Guide</emphasis>
<ulink url="../../Exadel-migration/html_single/index.html">(html)</ulink>
</para>
- <para><diffmk:wrapper diffmk:change="changed">This document is intended to help you to migrate an existing Exadel JSF or Struts projects
- from Exadel Studio into JBoss Developer Studio. </diffmk:wrapper></para>
+ <para>This document is intended to help you to migrate an existing Exadel JSF or Struts projects
+ from Exadel Studio into JBoss Developer Studio. </para>
</listitem>
-</listitem>
+</itemizedlist>
-<para diffmk:change="added"><diffmk:wrapper diffmk:change="added">If there's anything we didn't cover in this guide, please feel free to visit our </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=258"><diffmk:wrapper diffmk:change="added">JBoss Developer Studio Users Forum</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> or </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201"><diffmk:wrapper diffmk:change="added">JBoss Tools Users Forum</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> to ask questions. There we are also looking for
- your suggestions and comments.</diffmk:wrapper></para>
-</listitem>
+<para>If there's anything we didn't cover in this guide, please feel free to visit our <ulink url="http://www.jboss.com/index.html?module=bb'op=viewforum'f=258">JBoss Developer Studio Users Forum</ulink> or <ulink url="http://www.jboss.com/index.html?module=bb'op=viewforum'f=201">JBoss Tools Users Forum</ulink> to ask questions. There we are also looking for
+ your suggestions and comments.</para>
+</chapter>
-</listitem></listitem></listitem></listitem></listitem></itemizedlist></chapter></book>
+</book>
15 years, 6 months
- 1
- 0
JBoss Tools SVN: r15735 - trunk/documentation/guides/Exadel-migration/en.
by jbosstools-commits＠lists.jboss.org
Author: ochikvina
Date: 2009-06-05 11:03:57 -0400 (Fri, 05 Jun 2009)
New Revision: 15735
Modified:
trunk/documentation/guides/Exadel-migration/en/master_output.xml
Log:
https://jira.jboss.org/jira/browse/JBDS-743 - updating the master_output.xml;
Modified: trunk/documentation/guides/Exadel-migration/en/master_output.xml
===================================================================
--- trunk/documentation/guides/Exadel-migration/en/master_output.xml 2009-06-05 15:03:26 UTC (rev 15734)
+++ trunk/documentation/guides/Exadel-migration/en/master_output.xml 2009-06-05 15:03:57 UTC (rev 15735)
@@ -30,9 +30,9 @@
<year>2009</year>
<holder>JBoss, a division of Red Hat</holder>
</copyright>
- <releaseinfo><diffmk:wrapper diffmk:change="changed">
+ <releaseinfo>
Version: 2.0.1.GA
-</diffmk:wrapper></releaseinfo>
+</releaseinfo>
<abstract>
<title></title>
@@ -47,7 +47,7 @@
<toc></toc>
<chapter id="introduction" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/documentation/guides/Exadel-migration/en/modules/introduction.xml" xreflabel="introduction">
-
+ <?dbhtml filename="introduction.html"?>
<chapterinfo>
<keywordset>
<keyword>JBoss Developer Studio</keyword>
@@ -57,13 +57,60 @@
</chapterinfo>
<title>Introduction </title>
- <para><diffmk:wrapper diffmk:change="changed">This document is intended to help you to migrate an existing Exadel JSF or Struts projects
- into </diffmk:wrapper><property moreinfo="none">JBoss Developer Studio</property><diffmk:wrapper diffmk:change="changed">. Preferences can be exported from Eclipse 3.2.0
- (3.2.1 or 3.2.2) and imported in Eclipse 3.4.x by the standard Eclipse means.</diffmk:wrapper></para>
+ <para>This document is intended to help you to migrate an existing Exadel JSF or Struts projects
+ into <property moreinfo="none">JBoss Developer Studio</property>. Preferences can be exported from Eclipse 3.2.0
+ (3.2.1 or 3.2.2) and imported in Eclipse 3.4.x by the standard Eclipse means.</para>
+
<section diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Key Features of Projects Migration to JBoss Developer Studio</diffmk:wrapper></title>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">For a start, we propose you to look through the table of main features of migrating projects to JBoss Developer Studio:</diffmk:wrapper></para>
+
+ <table diffmk:change="added">
+
+ <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Key Features of Project Migration to JBoss Developer Studio</diffmk:wrapper></title>
+ <tgroup cols="3" diffmk:change="added">
+
+ <colspec align="left" colnum="1" colwidth="2*" diffmk:change="added"></colspec>
+ <colspec colnum="2" colwidth="4*" diffmk:change="added"></colspec>
+ <colspec align="left" colnum="3" colwidth="2*" diffmk:change="added"></colspec>
+
+ <thead diffmk:change="added">
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Feature</diffmk:wrapper></entry>
+ <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Benefit</diffmk:wrapper></entry>
+ <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Chapter</diffmk:wrapper></entry>
+ </row>
+ </thead>
+
+ <tbody diffmk:change="added">
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Import JSF Project Wizard</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">It simplifies the process of bringing your existing JSF applications into your JBoss Developer Studio workspace as JSF projects. The import is possible with *.war files.</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added">
+ <link diffmk:change="added" linkend="import_jsf"><diffmk:wrapper diffmk:change="added">Migration of JSF project</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added"> and </diffmk:wrapper><link diffmk:change="added" linkend="jsf_war"><diffmk:wrapper diffmk:change="added">Migration of JSF project from *.war file</diffmk:wrapper></link>
+ </entry>
+ </row>
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Import Struts Project Wizard</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">It simplifies the process of bringing your existing Struts applications into your JBoss Developer Studio workspace as Struts projects. The import is possible with *.war files.</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added">
+ <link diffmk:change="added" linkend="struts_import"><diffmk:wrapper diffmk:change="added">Migration of Struts project</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added"> and </diffmk:wrapper><link diffmk:change="added" linkend="struts_war"><diffmk:wrapper diffmk:change="added">Migration of Struts project from *.war file</diffmk:wrapper></link>
+ </entry>
+ </row>
+
+ </tbody>
+
+ </tgroup>
+ </table>
+
+ </section>
+
+ <section>
<title>Other relevant resources on the topic</title>
- <para><diffmk:wrapper diffmk:change="changed">All JBoss Developer Studio/JBoss Tools release documentation you can find at</diffmk:wrapper><diffmk:wrapper diffmk:change="changed">http://docs.jboss.org/tools</diffmk:wrapper><diffmk:wrapper diffmk:change="changed"> in the corresponding release directory.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="changed">The latest documentation builds are available at </diffmk:wrapper><ulink url="http://download.jboss.org/jbosstools/nightly-docs/"><diffmk:wrapper diffmk:change="changed">http://download.jboss.org/jbosstools/nightly-docs</diffmk:wrapper></ulink>.</para>
+ <para>All JBoss Developer Studio/JBoss Tools release documentation you can find at<ulink url="http://docs.jboss.org/tools/">http://docs.jboss.org/tools</ulink> in the corresponding release directory.</para>
+ <para>The latest documentation builds are available at <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">http://download.jboss.org/jbosstools/nightly-docs</ulink>.</para>
</section>
@@ -177,7 +224,7 @@
</figure>
</section>
- <section>
+ <section id="struts_import">
<title>Struts</title>
<itemizedlist>
<listitem><para><emphasis><property moreinfo="none">Select File > Import...</property></emphasis> from the menu bar, and then select <emphasis><property moreinfo="none">Other > Struts Project</property></emphasis> from the Import dialog box that appears.</para></listitem>
@@ -285,7 +332,7 @@
<title>Migrate JSF and Struts projects from *.war file</title>
<para>After you familiarized oneself with last chapter you can read this chapter. It looks as if you read in last chapter.</para>
- <section>
+ <section id="jsf_war">
<title>JSF</title>
<itemizedlist>
@@ -362,7 +409,7 @@
</itemizedlist>
</section>
- <section>
+ <section id="struts_war">
<title>Struts</title>
<itemizedlist>
@@ -416,9 +463,9 @@
</itemizedlist>
<para>The migration process is completed</para>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">If there's anything we didn't cover or you can't figure
- out, please feel free to visit our </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=258"><diffmk:wrapper diffmk:change="added">JBoss Developer Studio Users Forum</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> or </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201"><diffmk:wrapper diffmk:change="added">JBoss Tools Users Forum</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> to ask questions. There we are also looking for
- your suggestions and comments.</diffmk:wrapper></para>
+ <para>If there's anything we didn't cover or you can't figure
+ out, please feel free to visit our <ulink url="http://www.jboss.com/index.html?module=bb'op=viewforum'f=258">JBoss Developer Studio Users Forum</ulink> or <ulink url="http://www.jboss.com/index.html?module=bb'op=viewforum'f=201">JBoss Tools Users Forum</ulink> to ask questions. There we are also looking for
+ your suggestions and comments.</para>
</section>
</chapter>
15 years, 6 months
- 1
- 0
JBoss Tools SVN: r15734 - trunk/birt/docs/en.
by jbosstools-commits＠lists.jboss.org
Author: ochikvina
Date: 2009-06-05 11:03:26 -0400 (Fri, 05 Jun 2009)
New Revision: 15734
Modified:
trunk/birt/docs/en/master_output.xml
Log:
https://jira.jboss.org/jira/browse/JBDS-743 - adding master_output.xml;
Modified: trunk/birt/docs/en/master_output.xml
===================================================================
--- trunk/birt/docs/en/master_output.xml 2009-06-05 15:02:52 UTC (rev 15733)
+++ trunk/birt/docs/en/master_output.xml 2009-06-05 15:03:26 UTC (rev 15734)
@@ -11,10 +11,21 @@
<!ENTITY gsglink "../../GettingStartedGuide/html_single/index.html">
]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff">
<bookinfo>
- <title><diffmk:wrapper diffmk:change="changed">Birt Plugin Integration Reference Guide</diffmk:wrapper></title>
+ <title>Birt Plugin Integration Reference Guide</title>
+ <corpauthor diffmk:change="added">
+ <inlinemediaobject diffmk:change="added">
+ <imageobject diffmk:change="added" role="fo">
+ <imagedata diffmk:change="added" fileref="images/jbosstools_logo.png" format="PNG"></imagedata>
+ </imageobject>
+ <imageobject diffmk:change="added" role="html">
+ <imagedata diffmk:change="added"></imagedata>
+ </imageobject>
+ </inlinemediaobject>
+ </corpauthor>
+
<author><firstname>Anastasiya</firstname><surname>Bogachuk</surname><email>abogachuk(a)exadel.com</email></author>
- <author diffmk:change="added"><firstname diffmk:change="added"><diffmk:wrapper diffmk:change="added">Olga</diffmk:wrapper></firstname><surname diffmk:change="added"><diffmk:wrapper diffmk:change="added">Chikvina</diffmk:wrapper></surname></author>
+ <author><firstname>Olga</firstname><surname>Chikvina</surname></author>
<pubdate>August 2008</pubdate>
<copyright>
@@ -22,9 +33,9 @@
<year>2009</year>
<holder>JBoss, a division of Red Hat</holder>
</copyright>
- <releaseinfo>
- Version: 1.0.0.GA
- </releaseinfo>
+ <releaseinfo><diffmk:wrapper diffmk:change="changed">
+ Version: 1.1.0.M1
+ </diffmk:wrapper></releaseinfo>
<abstract>
@@ -58,10 +69,10 @@
<section>
<title>What is BIRT?</title>
- <para><diffmk:wrapper diffmk:change="changed">BIRT plugin is an Eclipse-based open source reporting system for web applications
+ <para>BIRT plugin is an Eclipse-based open source reporting system for web applications
based on Java and J2EE. BIRT consists of two main components: a report designer based on
Eclipse, and a runtime component that can be added to your app server. BIRT also offers
- a charting engine that lets you add charts to your own Web application.</diffmk:wrapper></para>
+ a charting engine that lets you add charts to your own Web application.</para>
<para>With the help of BIRT you can generate a great number of reports to be used in your
application:</para>
@@ -83,182 +94,234 @@
</listitem>
</itemizedlist>
- <para><diffmk:wrapper diffmk:change="added">You can find more detailed information on the BIRT plugin, its report types and
- anatomy on the </diffmk:wrapper><ulink url="http://www.eclipse.org/birt/phoenix/intro/"><diffmk:wrapper diffmk:change="changed">BIRT Homepage</diffmk:wrapper></ulink>.</para>
+ <para>You can find more detailed information on the BIRT plugin, its report types and
+ anatomy on the <ulink url="http://www.eclipse.org/birt/phoenix/intro/">BIRT Homepage</ulink>.</para>
- <para><diffmk:wrapper diffmk:change="added">To understand the basic BIRT concepts and to know how to create a basic BIRT report,
- refer to the </diffmk:wrapper><ulink diffmk:change="added" url="http://www.eclipse.org/birt/phoenix/tutorial/"><diffmk:wrapper diffmk:change="added">Eclipse BIRT
- Tutorials</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">. What extensions </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> provides for
- Eclipse BIRT you'll find out in the next sections.</diffmk:wrapper></para>
+ <para>To understand the basic BIRT concepts and to know how to create a basic BIRT report,
+ refer to the <ulink url="http://www.eclipse.org/birt/phoenix/tutorial/">Eclipse BIRT
+ Tutorials</ulink>. What extensions <property moreinfo="none">JBoss Tools</property> provides for
+ Eclipse BIRT you'll find out in the next sections.</para>
</section>
- <section diffmk:change="added">
- <title><diffmk:wrapper diffmk:change="changed">JBoss BIRT Integration Functionality Overview</diffmk:wrapper></title>
+<section diffmk:change="added" id="BIRT_key_features">
+ <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Key Features of BIRT</diffmk:wrapper></title>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">For a start, we propose you to look through the table of main features of BIRT plugin:</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="added">This reference guide describes the one module of the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> project which
- performs the integration with BIRT. The integration includes the following functionalities:</diffmk:wrapper></para>
+ <table diffmk:change="added">
+
+ <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Key Functionality for BIRT Plugin</diffmk:wrapper></title>
+ <tgroup cols="3" diffmk:change="added">
+
+ <colspec align="left" colnum="1" colwidth="2*" diffmk:change="added"></colspec>
+ <colspec colnum="2" colwidth="4*" diffmk:change="added"></colspec>
+ <colspec align="left" colnum="3" colwidth="2*" diffmk:change="added"></colspec>
+
+ <thead diffmk:change="added">
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Feature</diffmk:wrapper></entry>
+ <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Benefit</diffmk:wrapper></entry>
+ <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Chapter</diffmk:wrapper></entry>
+ </row>
+ </thead>
+
+ <tbody diffmk:change="added">
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Integration with Seam</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You can add a BIRT report to an .xhtml file or embed it in some Seam .xhtml page.</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added">
+ <link diffmk:change="added" linkend="integration"><diffmk:wrapper diffmk:change="added">integration with Seam</diffmk:wrapper></link>
+ </entry>
+ </row>
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Hibernate ODA Data Source</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Hibernate ODA Data Source for the JBoss BIRT Integration feature is completely integrated with Hibernate Tools.</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added">
+ <link diffmk:change="added" linkend="hibernate_datasource"><diffmk:wrapper diffmk:change="added">Hibernate ODA data source</diffmk:wrapper></link>
+ </entry>
+ </row>
+
+
+ </tbody>
+
+ </tgroup>
+ </table>
+
+
+
+
+
+
+</section>
+
+
+ <section>
+ <title>JBoss BIRT Integration Functionality Overview</title>
+
+ <para>This reference guide describes the one module of the <property moreinfo="none">JBoss Tools</property> project which
+ performs the integration with BIRT. The integration includes the following functionalities:</para>
<itemizedlist>
<listitem>
- <para><diffmk:wrapper diffmk:change="changed">Hibernate ODA driver that includes a dialog to create HQL queries with
+ <para>Hibernate ODA driver that includes a dialog to create HQL queries with
syntax-highlighting, content-assist, formatting as well as other functionalities
available in the HQL editor. There is also a possibility to add
- parameters.</diffmk:wrapper></para>
+ parameters.</para>
</listitem>
<listitem>
- <para><diffmk:wrapper diffmk:change="changed">possibility to add JBoss BIRT functionality to the standard Seam web
- project</diffmk:wrapper></para>
+ <para>possibility to add JBoss BIRT functionality to the standard Seam web
+ project</para>
</listitem>
<listitem>
- <para><diffmk:wrapper diffmk:change="changed">BIRT JSF/Seam control</diffmk:wrapper></para>
+ <para>BIRT JSF/Seam control</para>
</listitem>
<listitem>
- <para><diffmk:wrapper diffmk:change="changed">deployment of BIRT reports within web projects (Seam, JSF, etc.)</diffmk:wrapper></para>
+ <para>deployment of BIRT reports within web projects (Seam, JSF, etc.)</para>
</listitem>
</itemizedlist>
- <para><diffmk:wrapper diffmk:change="added">To enable </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> integration with BIRT you are intended to
- have the next:</diffmk:wrapper></para>
- <itemizedlist diffmk:change="added">
+ <para>To enable <property moreinfo="none">JBoss Tools</property> integration with BIRT you are intended to
+ have the next:</para>
+ <itemizedlist>
<listitem>
- <para><diffmk:wrapper diffmk:change="added">Eclipse with </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">
- installed (how to install </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> on Eclipse, what
- dependences and versions requirements are needed reed in the </diffmk:wrapper><ulink diffmk:change="added" url="../../GettingStartedGuide/html_single/index.html#JBossToolsInstall"><diffmk:wrapper diffmk:change="added">JBoss Tools Installation</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> section)</diffmk:wrapper></para>
+ <para>Eclipse with <property moreinfo="none">JBoss Tools</property>
+ installed (how to install <property moreinfo="none">JBoss Tools</property> on Eclipse, what
+ dependences and versions requirements are needed reed in the <ulink diffmk:change="added" url="../../GettingStartedGuide/html_single/index.html#JBossToolsInstall">JBoss Tools Installation</ulink> section)</para>
</listitem>
<listitem>
- <para><diffmk:wrapper diffmk:change="added">BIRT Report Designer (BIRT Report Designer 2.3.2
- you can download from </diffmk:wrapper><ulink diffmk:change="added" url="http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/..."><diffmk:wrapper diffmk:change="added">Eclipse downloads site</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">)</diffmk:wrapper></para>
+ <para>BIRT Report Designer (BIRT Report Designer 2.3.2
+ you can download from <ulink url="http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/...">Eclipse downloads site</ulink>)</para>
</listitem>
<listitem>
- <para><diffmk:wrapper diffmk:change="added">BIRT Web Tools Integration ( BIRT WTP Integration 2.3.2 you can download from
- </diffmk:wrapper><ulink diffmk:change="added" url="http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/..."><diffmk:wrapper diffmk:change="added">Eclipse downloads site</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">)</diffmk:wrapper></para>
+ <para>BIRT Web Tools Integration ( BIRT WTP Integration 2.3.2 you can download from
+ <ulink url="http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/...">Eclipse downloads site</ulink>)</para>
</listitem>
</itemizedlist>
- <note diffmk:change="added">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Note:</diffmk:wrapper></title>
- <para><diffmk:wrapper diffmk:change="added">Versions of BIRT framework and BIRT WTP integration should be no less than RC4 in
- order to the BIRT facet works correctly.</diffmk:wrapper></para>
+ <note>
+ <title>Note:</title>
+ <para>Versions of BIRT framework and BIRT WTP integration should be no less than RC4 in
+ order to the BIRT facet works correctly.</para>
</note>
</section>
- <section diffmk:change="added" id="birt_plugin_rel_resources">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Other Relevant Resources on the Topic</diffmk:wrapper></title>
+ <section id="birt_plugin_rel_resources">
+ <title>Other Relevant Resources on the Topic</title>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">All JBoss Developer Studio/JBoss Tools release documentation you can find at</diffmk:wrapper><ulink diffmk:change="added" url="http://docs.jboss.org/tools/"><diffmk:wrapper diffmk:change="added">http://docs.jboss.org/tools</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> in the corresponding release directory.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="added">The latest documentation builds are available at </diffmk:wrapper><ulink diffmk:change="added" url="http://download.jboss.org/jbosstools/nightly-docs/"><diffmk:wrapper diffmk:change="added">http://download.jboss.org/jbosstools/nightly-docs</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
+ <para>All JBoss Developer Studio/JBoss Tools release documentation you can find at<ulink url="http://docs.jboss.org/tools/">http://docs.jboss.org/tools</ulink> in the corresponding release directory.</para>
+ <para>The latest documentation builds are available at <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">http://download.jboss.org/jbosstools/nightly-docs</ulink>.</para>
</section>
</chapter>
-<chapter diffmk:change="added" id="birt_integration_with_seam" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/birt_integration_with_seam.xml" xreflabel="birt_integration_with_seam">
+<chapter id="birt_integration_with_seam" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/birt_integration_with_seam.xml" xreflabel="birt_integration_with_seam">
<?dbhtml filename="birt_integration_with_seam.html"?>
- <chapterinfo diffmk:change="added">
- <keywordset diffmk:change="added">
- <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss</diffmk:wrapper></keyword>
- <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">BIRT</diffmk:wrapper></keyword>
- <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">Seam</diffmk:wrapper></keyword>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss</keyword>
+ <keyword>BIRT</keyword>
+ <keyword>Seam</keyword>
</keywordset>
</chapterinfo>
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Adding BIRT Functionality to Standard Seam Web Project</diffmk:wrapper></title>
+ <title>Adding BIRT Functionality to Standard Seam Web Project</title>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">In this chapter you'll know how to create a Seam web project with BIRT
- capabilities included.</diffmk:wrapper></para>
+ <para>In this chapter you'll know how to create a Seam web project with BIRT
+ capabilities included.</para>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You are supposed to have Seam runtime and JBoss Application Server downloaded and
- extracted somewhere on you hard drive.</diffmk:wrapper></para>
+ <para>You are supposed to have Seam runtime and JBoss Application Server downloaded and
+ extracted somewhere on you hard drive.</para>
- <tip diffmk:change="added">
- <title><diffmk:wrapper diffmk:change="changed">Tip:</diffmk:wrapper></title>
- <para><diffmk:wrapper diffmk:change="added">We used</diffmk:wrapper><ulink diffmk:change="added" url="http://sourceforge.net/project/showfiles.php?group_id=22866&package_i..."><diffmk:wrapper diffmk:change="added">JBoss Seam 2.0.1 GA</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> and </diffmk:wrapper><ulink diffmk:change="added" url="http://sourceforge.net/project/showfiles.php?group_id=22866&package_i..."><diffmk:wrapper diffmk:change="added">JBoss Application Server 4.2.2 GA</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> in examples of this guide.</diffmk:wrapper></para>
+ <tip>
+ <title>Tip:</title>
+ <para>We used<ulink url="http://sourceforge.net/project/showfiles.php?group_id=22866'package_...">JBoss Seam 2.0.1 GA</ulink> and <ulink url="http://sourceforge.net/project/showfiles.php?group_id=22866'package_...">JBoss Application Server 4.2.2 GA</ulink> in examples of this guide.</para>
</tip>
- <section diffmk:change="added" id="creatin_project_with_birt">
- <title><diffmk:wrapper diffmk:change="changed">Creating Seam Web Project with Birt Facet</diffmk:wrapper></title>
+ <section id="creatin_project_with_birt">
+ <title>Creating Seam Web Project with Birt Facet</title>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">First, open </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Seam perspective</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> by going to </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Window > Open Perspective > Other > Seam</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.
- </diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> To create a new Seam Web project follow to </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">File > New > Seam Web Project</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> (or </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">File > New > Other > Seam > Seam Web
- Project</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> if you are not in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Seam perspective</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">).</diffmk:wrapper></para>
+ <para>First, open <property moreinfo="none">Seam perspective</property> by going to <emphasis>
+ <property moreinfo="none">Window > Open Perspective > Other > Seam</property>.
+ </emphasis> To create a new Seam Web project follow to <emphasis>
+ <property moreinfo="none">File > New > Seam Web Project</property>
+ </emphasis> (or <emphasis>
+ <property moreinfo="none">File > New > Other > Seam > Seam Web
+ Project</property>
+ </emphasis> if you are not in the <property moreinfo="none">Seam perspective</property>).</para>
- <para><diffmk:wrapper diffmk:change="added">On the first wizard page enter the project name, then specify the target runtime and
- target server. In the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Configuration</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> section click </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Modify</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> to configure the project facets.</diffmk:wrapper></para>
+ <para>On the first wizard page enter the project name, then specify the target runtime and
+ target server. In the <emphasis>
+ <property moreinfo="none">Configuration</property>
+ </emphasis> section click <emphasis>
+ <property moreinfo="none">Modify</property>
+ </emphasis> to configure the project facets.</para>
- <figure diffmk:change="added" float="0">
- <title><diffmk:wrapper diffmk:change="changed">Creating Seam Web Project</diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/birt_integration_with_seam/testBirtProject.png"></imagedata>
+ <figure float="0">
+ <title>Creating Seam Web Project</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/birt_integration_with_seam/testBirtProject.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="changed">Choose the 2.0 version of the </diffmk:wrapper><emphasis>
- <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Seam</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="changed"> facet and enable the </diffmk:wrapper><emphasis>
- <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Birt Reporting Runtime Component</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> facet.</diffmk:wrapper></para>
+ <para>Choose the 2.0 version of the <emphasis>
+ <property moreinfo="none">Seam</property>
+ </emphasis> facet and enable the <emphasis>
+ <property moreinfo="none">Birt Reporting Runtime Component</property>
+ </emphasis> facet.</para>
<figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Adding the Birt Reporting Runtime Component Facet </diffmk:wrapper></title>
+ <title>Adding the Birt Reporting Runtime Component Facet </title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/birt_integration_with_seam/addingBirtFacet.png"/>
+ <imagedata fileref="images/birt_integration_with_seam/addingBirtFacet.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Or you can just choose the </diffmk:wrapper><emphasis>
- <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss BIRT Integration Web Project</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="changed"> configuration.</diffmk:wrapper></para>
+ <para>Or you can just choose the <emphasis>
+ <property moreinfo="none">JBoss BIRT Integration Web Project</property>
+ </emphasis> configuration.</para>
<figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Choosing the JBoss BIRT Integration Web Project Configuration</diffmk:wrapper></title>
+ <title>Choosing the JBoss BIRT Integration Web Project Configuration</title>
<mediaobject>
<imageobject>
- <imagedata
- fileref="images/birt_integration_with_seam/projectBirtConfiguration.png"/>
+ <imagedata fileref="images/birt_integration_with_seam/projectBirtConfiguration.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="changed">Next three pages are filled out with defaults, just leave them through by pressing </diffmk:wrapper><emphasis>
- <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Next</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="changed"> On the </diffmk:wrapper><emphasis>
- <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Seam Facet</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="changed"> page you should specify the Seam runtime and Connection profile.</diffmk:wrapper></para>
+ <para>Next three pages are filled out with defaults, just leave them through by pressing <emphasis>
+ <property moreinfo="none">Next</property>.</emphasis> On the <emphasis>
+ <property moreinfo="none">Seam Facet</property>
+ </emphasis> page you should specify the Seam runtime and Connection profile.</para>
<figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Configuring the Seam Facet settings</diffmk:wrapper></title>
+ <title>Configuring the Seam Facet settings</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/birt_integration_with_seam/seamFacet.png"/>
+ <imagedata fileref="images/birt_integration_with_seam/seamFacet.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Hit </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> to create the project with Birt functionality enabled.</diffmk:wrapper></para>
+ <para>Hit <emphasis>
+ <property moreinfo="none">Finish</property>
+ </emphasis> to create the project with Birt functionality enabled.</para>
</section>
- <section diffmk:change="added" id="integration">
- <title><diffmk:wrapper diffmk:change="changed">Integration with Seam</diffmk:wrapper></title>
+ <section id="integration">
+ <title>Integration with Seam</title>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The JBoss BIRT Integration feature contains the BIRT tag that allows the user to add a
- BIRT report to an </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">.xhtml</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> file:</diffmk:wrapper></para>
+ <para>The JBoss BIRT Integration feature contains the BIRT tag that allows the user to add a
+ BIRT report to an <emphasis>
+ <property moreinfo="none">.xhtml</property>
+ </emphasis> file:</para>
- <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[<p:birt xmlns:ui="http://java.sun.com/jsf/facelets"
+ <programlisting format="linespecific" role="XHTML"><![CDATA[<p:birt xmlns:ui="http://java.sun.com/jsf/facelets"
xmlns:s="http://jboss.com/products/seam/taglib"
xmlns:p="http://jboss.com/products/seam/birt"
designType="run"
@@ -266,22 +329,22 @@
designName="test.rptdesign"
title="JBoss Birt Test">
-</p:birt>]]></diffmk:wrapper></programlisting>
+</p:birt>]]></programlisting>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Let's look how it works.</diffmk:wrapper></para>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Create in the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Web Content</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> folder three </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">.xhtml</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> pages with the following content:</diffmk:wrapper></para>
+ <para>Let's look how it works.</para>
+ <para>Create in the <emphasis>
+ <property moreinfo="none">Web Content</property>
+ </emphasis> folder three <emphasis>
+ <property moreinfo="none">.xhtml</property>
+ </emphasis> pages with the following content:</para>
- <itemizedlist diffmk:change="added">
- <listitem diffmk:change="added">
- <para diffmk:change="added">
- <emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">birttests.xhtml</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">:</diffmk:wrapper></emphasis>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <emphasis>
+ <property moreinfo="none">birttests.xhtml</property>:</emphasis>
</para>
- <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[<!DOCTYPE composition PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ <programlisting format="linespecific" role="XHTML"><![CDATA[<!DOCTYPE composition PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<ui:composition xmlns="http://www.w3.org/1999/xhtml"
xmlns:s="http://jboss.com/products/seam/taglib"
@@ -300,14 +363,14 @@
</ul>
</rich:panel>
</ui:define>
- </ui:composition>]]></diffmk:wrapper></programlisting>
+ </ui:composition>]]></programlisting>
</listitem>
- <listitem diffmk:change="added">
+ <listitem>
<para>
<emphasis>
- <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">testbirt.xhtml</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">:</diffmk:wrapper></emphasis>
+ <property moreinfo="none">testbirt.xhtml</property>:</emphasis>
</para>
- <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[<p:birt xmlns:ui="http://java.sun.com/jsf/facelets"
+ <programlisting format="linespecific" role="XHTML"><![CDATA[<p:birt xmlns:ui="http://java.sun.com/jsf/facelets"
xmlns:s="http://jboss.com/products/seam/taglib"
xmlns:p="http://jboss.com/products/seam/birt"
designType="run"
@@ -316,134 +379,134 @@
title="JBoss Birt Test">
<p:param name="sample" value="sample param"/>
-</p:birt>]]></diffmk:wrapper></programlisting>
+</p:birt>]]></programlisting>
</listitem>
- <listitem diffmk:change="added">
- <para diffmk:change="added">
- <emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">testbirt1.xhtml</diffmk:wrapper></property>:</emphasis>
+ <listitem>
+ <para>
+ <emphasis>
+ <property moreinfo="none">testbirt1.xhtml</property>:</emphasis>
</para>
- <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[<p:birt xmlns:ui="http://java.sun.com/jsf/facelets"
+ <programlisting format="linespecific" role="XHTML"><![CDATA[<p:birt xmlns:ui="http://java.sun.com/jsf/facelets"
xmlns:s="http://jboss.com/products/seam/taglib"
xmlns:p="http://jboss.com/products/seam/birt"
designType="frameset"
designName="test1.rptdesign"
title="JBoss Birt Test">
-</p:birt>]]></diffmk:wrapper></programlisting>
+</p:birt>]]></programlisting>
</listitem>
</itemizedlist>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Now start the application server by clicking the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Start</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> option in the context menu of the server in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Server
- View</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> (if the view isn't open go to </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Window > Show View > Other > JBoss Server
- View</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">)</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added">. Try the tests out by accessing </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">http://localhost:8080/hellobirt/birttests.seam</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> in your web browser.</diffmk:wrapper></para>
+ <para>Now start the application server by clicking the <emphasis>
+ <property moreinfo="none">Start</property>
+ </emphasis> option in the context menu of the server in the <property moreinfo="none">JBoss Server
+ View</property> (if the view isn't open go to <emphasis>
+ <property moreinfo="none">Window > Show View > Other > JBoss Server
+ View</property>)</emphasis>. Try the tests out by accessing <emphasis>
+ <property moreinfo="none">http://localhost:8080/hellobirt/birttests.seam</property>
+ </emphasis> in your web browser.</para>
<figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Welcome Page in the Browser</diffmk:wrapper></title>
+ <title>Welcome Page in the Browser</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/birt_integration_with_seam/birttestsPage.png"/>
+ <imagedata fileref="images/birt_integration_with_seam/birttestsPage.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="added">Now if you click </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Test Birt</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> you should see the following </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">.pdf</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> file:</diffmk:wrapper></para>
+ <para>Now if you click <emphasis>
+ <property moreinfo="none">Test Birt</property>
+ </emphasis> you should see the following <emphasis>
+ <property moreinfo="none">.pdf</property>
+ </emphasis> file:</para>
<figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">After Clicking Test Birt</diffmk:wrapper></title>
+ <title>After Clicking Test Birt</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/birt_integration_with_seam/testbirtPage.png"/>
+ <imagedata fileref="images/birt_integration_with_seam/testbirtPage.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="changed">After clicking </diffmk:wrapper><emphasis>
- <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Test Birt 1</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> the next page is displayed:</diffmk:wrapper></para>
+ <para>After clicking <emphasis>
+ <property moreinfo="none">Test Birt 1</property>
+ </emphasis> the next page is displayed:</para>
<figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">After Clicking Test Birt 1</diffmk:wrapper></title>
+ <title>After Clicking Test Birt 1</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/birt_integration_with_seam/testbirt1Page1.png"/>
+ <imagedata fileref="images/birt_integration_with_seam/testbirt1Page1.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Put the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">test param</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> as Sample Parameter value, specify the maximum possible Customer Number as
- </diffmk:wrapper><emphasis>
- <property moreinfo="none"><diffmk:wrapper diffmk:change="added">1001</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">,</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> for instance, and then press </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Ok</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="changed"> You'll see the following BIRT
- report:</diffmk:wrapper></para>
+ <para>Put the <emphasis>
+ <property moreinfo="none">test param</property>
+ </emphasis> as Sample Parameter value, specify the maximum possible Customer Number as
+ <emphasis>
+ <property moreinfo="none">1001</property>,</emphasis> for instance, and then press <emphasis>
+ <property moreinfo="none">Ok</property>.</emphasis> You'll see the following BIRT
+ report:</para>
<figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">BIRT Report in the Browser Window</diffmk:wrapper></title>
+ <title>BIRT Report in the Browser Window</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/birt_integration_with_seam/testbirt1Page2.png"/>
+ <imagedata fileref="images/birt_integration_with_seam/testbirt1Page2.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The BIRT tag recognizes most of the parameters described on </diffmk:wrapper><ulink diffmk:change="added" url="http://www.eclipse.org/birt/phoenix/deploy/viewerUsage2.2.php#parameters"><diffmk:wrapper diffmk:change="added">the
- BIRT Report Viewer Parameters page</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">. The attributes of the BIRT tag
- don't contain the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"__"</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> prefix.</diffmk:wrapper></para>
+ <para>The BIRT tag recognizes most of the parameters described on <ulink url="http://www.eclipse.org/birt/phoenix/deploy/viewerUsage2.2.php#parameters">the
+ BIRT Report Viewer Parameters page</ulink>. The attributes of the BIRT tag
+ don't contain the <emphasis>
+ <property moreinfo="none">"__"</property>
+ </emphasis> prefix.</para>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">param</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> tag describes report parameters (see the listing for the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">testbirt.xhtml</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> above). It supports the following attributes: </diffmk:wrapper></para>
- <itemizedlist diffmk:change="added">
- <listitem diffmk:change="added">
- <para diffmk:change="added"><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">name</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> - the parameter name (required)</diffmk:wrapper></para>
+ <para>The <emphasis>
+ <property moreinfo="none">param</property>
+ </emphasis> tag describes report parameters (see the listing for the <emphasis>
+ <property moreinfo="none">testbirt.xhtml</property>
+ </emphasis> above). It supports the following attributes: </para>
+ <itemizedlist>
+ <listitem>
+ <para><emphasis>
+ <property moreinfo="none">name</property>
+ </emphasis> - the parameter name (required)</para>
</listitem>
- <listitem diffmk:change="added">
- <para diffmk:change="added"><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">value</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> - the parameter value (required)</diffmk:wrapper></para>
+ <listitem>
+ <para><emphasis>
+ <property moreinfo="none">value</property>
+ </emphasis> - the parameter value (required)</para>
</listitem>
- <listitem diffmk:change="added">
- <para diffmk:change="added"><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">isnull</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> - specifies that a report parameter has a null value
- (optional)</diffmk:wrapper></para>
+ <listitem>
+ <para><emphasis>
+ <property moreinfo="none">isnull</property>
+ </emphasis> - specifies that a report parameter has a null value
+ (optional)</para>
</listitem>
- <listitem diffmk:change="added">
- <para diffmk:change="added"><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">islocale</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> - specifies whether the parameter is localized (optional)</diffmk:wrapper></para>
+ <listitem>
+ <para><emphasis>
+ <property moreinfo="none">islocale</property>
+ </emphasis> - specifies whether the parameter is localized (optional)</para>
</listitem>
</itemizedlist>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">These tags are defined in the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">org.jboss.birt.core/resources/jboss-seam-birt.jar</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> library that contains source. </diffmk:wrapper></para>
+ <para>These tags are defined in the <emphasis>
+ <property moreinfo="none">org.jboss.birt.core/resources/jboss-seam-birt.jar</property>
+ </emphasis> library that contains source. </para>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">It is also possible to embed a BIRT report in some Seam </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">.xhtml</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> page. See how it may be done:</diffmk:wrapper></para>
- <para diffmk:change="added"></para>
+ <para>It is also possible to embed a BIRT report in some Seam <emphasis>
+ <property moreinfo="none">.xhtml</property>
+ </emphasis> page. See how it may be done:</para>
+ <para></para>
- <para diffmk:change="added">
- <emphasis diffmk:change="added" role="bold"><diffmk:wrapper diffmk:change="added">Example:</diffmk:wrapper></emphasis>
+ <para>
+ <emphasis role="bold">Example:</emphasis>
</para>
- <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[<!DOCTYPE composition PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ <programlisting format="linespecific" role="XHTML"><![CDATA[<!DOCTYPE composition PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<ui:composition xmlns="http://www.w3.org/1999/xhtml"
xmlns:s="http://jboss.com/products/seam/taglib"
@@ -468,15 +531,15 @@
id="done" value="Done"/>
</div>
</ui:define>
-</ui:composition>]]></diffmk:wrapper></programlisting>
+</ui:composition>]]></programlisting>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">See the result in a Browser:</diffmk:wrapper></para>
+ <para>See the result in a Browser:</para>
- <figure diffmk:change="added" float="0">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Embedding BIRT Report in Seam xhtml Page</diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/birt_integration_with_seam/embeddedReportInSeamPage.png"></imagedata>
+ <figure float="0">
+ <title>Embedding BIRT Report in Seam xhtml Page</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/birt_integration_with_seam/embeddedReportInSeamPage.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
@@ -485,233 +548,232 @@
</chapter>
-<chapter diffmk:change="added" id="hibernate_datasource" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/hibernate_datasource.xml" xreflabel="hibernate_datasource">
+<chapter id="hibernate_datasource" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/hibernate_datasource.xml" xreflabel="hibernate_datasource">
<?dbhtml filename="hibernate_datasource.html"?>
- <chapterinfo diffmk:change="added">
- <keywordset diffmk:change="added">
- <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss</diffmk:wrapper></keyword>
- <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">BIRT</diffmk:wrapper></keyword>
- <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">Seam</diffmk:wrapper></keyword>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss</keyword>
+ <keyword>BIRT</keyword>
+ <keyword>Seam</keyword>
</keywordset>
</chapterinfo>
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Hibernate ODA Data Source</diffmk:wrapper></title>
+ <title>Hibernate ODA Data Source</title>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The JBoss BIRT Integration feature includes the Hibernate ODA Data Source completely
+ <para>The JBoss BIRT Integration feature includes the Hibernate ODA Data Source completely
integrated with Hibernate Tools. You can use it in the way you use any of BIRT ODA drivers.
- Let's perform simple actions that demonstrate it.</diffmk:wrapper></para>
+ Let's perform simple actions that demonstrate it.</para>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">First, run the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Seam Generate Entities</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> action (You can access it from </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">File > New > Seam Generate Entities</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Seam perspective</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">. More details on the Seam Generate
- Entities read in our </diffmk:wrapper><ulink diffmk:change="added" url="http://download.jboss.org/jbosstools/nightly-docs/en/seam/html_single/ind..."><diffmk:wrapper diffmk:change="added">Seam Dev Tools Reference guide</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">). This action will create a Hibernate Console
- configuration.</diffmk:wrapper></para>
+ <para>First, run the <emphasis>
+ <property moreinfo="none">Seam Generate Entities</property>
+ </emphasis> action (You can access it from <emphasis>
+ <property moreinfo="none">File > New > Seam Generate Entities</property>
+ </emphasis> in the <property moreinfo="none">Seam perspective</property>. More details on the Seam Generate
+ Entities read in our <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/seam/html_single/ind...">Seam Dev Tools Reference guide</ulink>). This action will create a Hibernate Console
+ configuration.</para>
- <tip diffmk:change="added">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Tip:</diffmk:wrapper></title>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Before performing Seam Generate Entities, you should have a connection profile
- adjusted and connected to a database. How to do this see in the </diffmk:wrapper><ulink diffmk:change="added" url="http://download.jboss.org/jbosstools/nightly-docs/en/seam/html_single/ind..."><diffmk:wrapper diffmk:change="added">CRUD Database Application</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> chapter of the Seam Dev Tools Reference
- guide.</diffmk:wrapper></para>
+ <tip>
+ <title>Tip:</title>
+ <para>Before performing Seam Generate Entities, you should have a connection profile
+ adjusted and connected to a database. How to do this see in the <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/seam/html_single/ind...">CRUD Database Application</ulink> chapter of the Seam Dev Tools Reference
+ guide.</para>
</tip>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Next add a new BIRT report. To do that navigate to </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">File > New > Other > Business Intelligence and Reporting
- Tools > Report</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> In the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">New Report
- wizard</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> enter the report name, for instance </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">testHibernateOda.rptdesign</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">,</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> then click </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para>
+ <para>Next add a new BIRT report. To do that navigate to <emphasis>
+ <property moreinfo="none">File > New > Other > Business Intelligence and Reporting
+ Tools > Report</property>.</emphasis> In the <property moreinfo="none">New Report
+ wizard</property> enter the report name, for instance <emphasis>
+ <property moreinfo="none">testHibernateOda.rptdesign</property>,</emphasis> then click <emphasis>
+ <property moreinfo="none">Finish</property>.</emphasis></para>
- <figure diffmk:change="added" float="0">
- <title><diffmk:wrapper diffmk:change="changed">Creating a New BIRT Report </diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/hibernate_datasource/creatingNewBirtReport.png"></imagedata>
+ <figure float="0">
+ <title>Creating a New BIRT Report </title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/hibernate_datasource/creatingNewBirtReport.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="added">Now switch to the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Report Design perspective</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
+ <para>Now switch to the <property moreinfo="none">Report Design perspective</property>.</para>
- <para><diffmk:wrapper diffmk:change="added">In the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Data Explorer View</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> right-click the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Data Source</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> node and choose </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">New Data Source</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para>
+ <para>In the <property moreinfo="none">Data Explorer View</property> right-click the <emphasis>
+ <property moreinfo="none">Data Source</property>
+ </emphasis> node and choose <emphasis>
+ <property moreinfo="none">New Data Source</property>.</emphasis></para>
<figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Creating a New Data Source</diffmk:wrapper></title>
+ <title>Creating a New Data Source</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/hibernate_datasource/creatingDataSource.png"/>
+ <imagedata fileref="images/hibernate_datasource/creatingDataSource.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="added">In the wizard select </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Hibernate Data Source</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> and give it a proper name, </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">HbDataSource</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> for instance. Hit </diffmk:wrapper><emphasis>
- <property moreinfo="none">Next</property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para>
+ <para>In the wizard select <emphasis>
+ <property moreinfo="none">Hibernate Data Source</property>
+ </emphasis> and give it a proper name, <emphasis>
+ <property moreinfo="none">HbDataSource</property>
+ </emphasis> for instance. Hit <emphasis>
+ <property moreinfo="none">Next</property>.</emphasis></para>
<figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Creating Hibernate Data Source</diffmk:wrapper></title>
+ <title>Creating Hibernate Data Source</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/hibernate_datasource/hibernateDataSource.png"/>
+ <imagedata fileref="images/hibernate_datasource/hibernateDataSource.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="added">On the next wizard page leave everything as it is, just press the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Test Connection</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> button to verify the connection is successful.</diffmk:wrapper></para>
+ <para>On the next wizard page leave everything as it is, just press the <emphasis>
+ <property moreinfo="none">Test Connection</property>
+ </emphasis> button to verify the connection is successful.</para>
<figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Hibernate Data Source Profile</diffmk:wrapper></title>
+ <title>Hibernate Data Source Profile</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/hibernate_datasource/connectionSuccessful.png"/>
+ <imagedata fileref="images/hibernate_datasource/connectionSuccessful.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="added">Click </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Ok</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> and then </diffmk:wrapper><emphasis>
+ <para>Click <emphasis>
+ <property moreinfo="none">Ok</property>
+ </emphasis> and then <emphasis>
<property moreinfo="none">Finish</property>
- </emphasis><diffmk:wrapper diffmk:change="changed"> to complete.</diffmk:wrapper></para>
+ </emphasis> to complete.</para>
- <para><diffmk:wrapper diffmk:change="added">Now let's add a Hibernate ODA dataset. To do that you should bring up the
- </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">New Data Set wizard</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">. In the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Data Explorer View</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">
- right-click the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Data Set</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> node and select </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">New Data Set</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para>
+ <para>Now let's add a Hibernate ODA dataset. To do that you should bring up the
+ <property moreinfo="none">New Data Set wizard</property>. In the <property moreinfo="none">Data Explorer View</property>
+ right-click the <emphasis>
+ <property moreinfo="none">Data Set</property>
+ </emphasis> node and select <emphasis>
+ <property moreinfo="none">New Data Set</property>.</emphasis></para>
- <figure diffmk:change="added" float="0">
- <title><diffmk:wrapper diffmk:change="changed">Creating a New Data Set</diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/hibernate_datasource/creatingDataSet.png"></imagedata>
+ <figure float="0">
+ <title>Creating a New Data Set</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/hibernate_datasource/creatingDataSet.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="added">In the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Data Set Name</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> section specify the name. Let's it be </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">HbDataSet</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para>
+ <para>In the <emphasis>
+ <property moreinfo="none">Data Set Name</property>
+ </emphasis> section specify the name. Let's it be <emphasis>
+ <property moreinfo="none">HbDataSet</property>.</emphasis></para>
<figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Creating a Hibernate ODA Data Set</diffmk:wrapper></title>
+ <title>Creating a Hibernate ODA Data Set</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/hibernate_datasource/addingHibernateODADataset.png"/>
+ <imagedata fileref="images/hibernate_datasource/addingHibernateODADataset.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="changed">Next you'll be prompted to define the query for this data set. To validate the
- entered query you can press the </diffmk:wrapper><emphasis>
- <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Test query</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="changed"> button. All the HQL features like syntax highlighting, content assist,
- formatting, Drag and Drop, etc., are available to you here.</diffmk:wrapper></para>
+ <para>Next you'll be prompted to define the query for this data set. To validate the
+ entered query you can press the <emphasis>
+ <property moreinfo="none">Test query</property>
+ </emphasis> button. All the HQL features like syntax highlighting, content assist,
+ formatting, Drag and Drop, etc., are available to you here.</para>
<figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Testing Query </diffmk:wrapper></title>
+ <title>Testing Query </title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/hibernate_datasource/testingQuery.png"/>
+ <imagedata fileref="images/hibernate_datasource/testingQuery.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="changed">Next the output columns will be displayed. It's possible to edit them
- here.</diffmk:wrapper></para>
+ <para>Next the output columns will be displayed. It's possible to edit them
+ here.</para>
<figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">HQL Features - Output Columns Section</diffmk:wrapper></title>
+ <title>HQL Features - Output Columns Section</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/hibernate_datasource/hqlFeaturesOutputColumns.png"/>
+ <imagedata fileref="images/hibernate_datasource/hqlFeaturesOutputColumns.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="changed">To preview the results of the defined query click the </diffmk:wrapper><emphasis>
- <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Preview Results</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="changed"> item.</diffmk:wrapper></para>
+ <para>To preview the results of the defined query click the <emphasis>
+ <property moreinfo="none">Preview Results</property>
+ </emphasis> item.</para>
<figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">HQL Features - Preview Results Section</diffmk:wrapper></title>
+ <title>HQL Features - Preview Results Section</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/hibernate_datasource/hqlFeaturesPreviewResults.png"/>
+ <imagedata fileref="images/hibernate_datasource/hqlFeaturesPreviewResults.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">So far you have the Hibernate data source and data set defined. Now you can create a BIRT
- report using this data source and data set.</diffmk:wrapper></para>
+ <para>So far you have the Hibernate data source and data set defined. Now you can create a BIRT
+ report using this data source and data set.</para>
- <tip diffmk:change="added">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Tip:</diffmk:wrapper></title>
- <para><diffmk:wrapper diffmk:change="added">If you don't know how to do this we suggest that you refer to the </diffmk:wrapper><ulink diffmk:change="added" url="http://www.eclipse.org/birt/phoenix/tutorial/"><diffmk:wrapper diffmk:change="added">Eclipse BIRT Tutorial</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
+ <tip>
+ <title>Tip:</title>
+ <para>If you don't know how to do this we suggest that you refer to the <ulink url="http://www.eclipse.org/birt/phoenix/tutorial/">Eclipse BIRT Tutorial</ulink>.</para>
</tip>
<figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">Creating a BIRT Report using Created Data Source and Data Set</diffmk:wrapper></title>
+ <title>Creating a BIRT Report using Created Data Source and Data Set</title>
<mediaobject>
<imageobject>
- <imagedata
- fileref="images/hibernate_datasource/BIRTReportUsingDataSourceAndSet.png "/>
+ <imagedata fileref="images/hibernate_datasource/BIRTReportUsingDataSourceAndSet.png "></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="changed">If you switch to the </diffmk:wrapper><emphasis>
- <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Preview</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="changed"> tab, it will run your report and show the output.</diffmk:wrapper></para>
+ <para>If you switch to the <emphasis>
+ <property moreinfo="none">Preview</property></emphasis> tab, it will run your report and show the output.</para>
- <figure diffmk:change="added" float="0">
- <title><diffmk:wrapper diffmk:change="changed">BIRT Report -Preview Tab</diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/hibernate_datasource/BIRTReportPreviewTab.png"></imagedata>
+ <figure float="0">
+ <title>BIRT Report -Preview Tab</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/hibernate_datasource/BIRTReportPreviewTab.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="added">You can also use parameters within the Hibernate ODA driver.</diffmk:wrapper></para>
+ <para>You can also use parameters within the Hibernate ODA driver.</para>
- <figure diffmk:change="added" float="0">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Using Parameters within the Hibernate ODA Driver</diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/hibernate_datasource/parametersWithinHibernateODADriver.png"></imagedata>
+ <figure float="0">
+ <title>Using Parameters within the Hibernate ODA Driver</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/hibernate_datasource/parametersWithinHibernateODADriver.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <figure diffmk:change="added" float="0">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Adding New Parameter</diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/hibernate_datasource/addingNewParameter.png"></imagedata>
+ <figure float="0">
+ <title>Adding New Parameter</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/hibernate_datasource/addingNewParameter.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Again, to preview the results switch to the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Preview Results</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> item.</diffmk:wrapper></para>
- <figure diffmk:change="added" float="0">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Previewing the Results</diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/hibernate_datasource/previewingResults.png"></imagedata>
+ <para>Again, to preview the results switch to the <emphasis>
+ <property moreinfo="none">Preview Results</property>
+ </emphasis> item.</para>
+ <figure float="0">
+ <title>Previewing the Results</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/hibernate_datasource/previewingResults.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
@@ -719,40 +781,40 @@
</chapter>
-<chapter diffmk:change="added" id="birt_reports_deployment" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/birt_reports_deployment.xml" xreflabel="birt_reports_deployment">
+<chapter id="birt_reports_deployment" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/birt_reports_deployment.xml" xreflabel="birt_reports_deployment">
<?dbhtml filename="birt_reports_deployment"?>
<chapterinfo>
<keywordset>
<keyword>JBoss</keyword>
<keyword>BIRT</keyword>
- <keyword><diffmk:wrapper diffmk:change="changed">Seam</diffmk:wrapper></keyword>
+ <keyword>Seam</keyword>
</keywordset>
</chapterinfo>
- <title><diffmk:wrapper diffmk:change="changed">BIRT Reports Deployment</diffmk:wrapper></title>
+ <title>BIRT Reports Deployment</title>
- <para><diffmk:wrapper diffmk:change="changed">When everything is configured correctly you will be able to view/render the designed
- reports in your Seam (or any other) Web application.</diffmk:wrapper></para>
+ <para>When everything is configured correctly you will be able to view/render the designed
+ reports in your Seam (or any other) Web application.</para>
- <para><diffmk:wrapper diffmk:change="added">You can deploy a report by adding an action button to the Seam's CRUD </diffmk:wrapper><emphasis diffmk:change="added">
- <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">.xhtml</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> file.</diffmk:wrapper></para>
+ <para>You can deploy a report by adding an action button to the Seam's CRUD <emphasis>
+ <property moreinfo="none">.xhtml</property>
+ </emphasis> file.</para>
- <figure diffmk:change="added" float="0">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Adding Action Button to the Seam file</diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/birt_reports_deployment/addingActionButton.png"></imagedata>
+ <figure float="0">
+ <title>Adding Action Button to the Seam file</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/birt_reports_deployment/addingActionButton.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="added">As you can see on the figure you should have the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">testHibernateOda.xhtml</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> file. It's content should be the following:</diffmk:wrapper></para>
+ <para>As you can see on the figure you should have the <emphasis>
+ <property moreinfo="none">testHibernateOda.xhtml</property>
+ </emphasis> file. It's content should be the following:</para>
- <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[<p:birt xmlns:ui="http://java.sun.com/jsf/facelets"
+ <programlisting format="linespecific" role="XHTML"><![CDATA[<p:birt xmlns:ui="http://java.sun.com/jsf/facelets"
xmlns:s="http://jboss.com/products/seam/taglib"
xmlns:p="http://jboss.com/products/seam/birt"
designType="run"
@@ -761,83 +823,83 @@
title="JBoss Birt Test">
</p:birt>
-]]></diffmk:wrapper></programlisting>
+]]></programlisting>
- <para><diffmk:wrapper diffmk:change="added">Next run the Seam page with embedded report on the server by right-clicking the file and
- going to </diffmk:wrapper><emphasis diffmk:change="added">
- <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Run > Run on Server</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para>
+ <para>Next run the Seam page with embedded report on the server by right-clicking the file and
+ going to <emphasis>
+ <property moreinfo="none">Run > Run on Server</property>.</emphasis></para>
- <figure diffmk:change="added" float="0">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Opening Employees.xhtml Page</diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/birt_reports_deployment/openingArticlesPage.png"></imagedata>
+ <figure float="0">
+ <title>Opening Employees.xhtml Page</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/birt_reports_deployment/openingArticlesPage.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="added">After clicking the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">BIRT PDF Report</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> button, you should see the following report:</diffmk:wrapper></para>
+ <para>After clicking the <emphasis>
+ <property moreinfo="none">BIRT PDF Report</property>
+ </emphasis> button, you should see the following report:</para>
- <figure diffmk:change="added" float="0">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Birt PDF Report</diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/birt_reports_deployment/BirtPDFReport.png"></imagedata>
+ <figure float="0">
+ <title>Birt PDF Report</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/birt_reports_deployment/BirtPDFReport.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para><diffmk:wrapper diffmk:change="added">Thus, a Seam project that includes the BIRT facet can be deployed as any project. If you
+ <para>Thus, a Seam project that includes the BIRT facet can be deployed as any project. If you
define the Hibernate ODA driver, the JBoss BIRT engine will use JNDI URL that has to be bind
to either Hibernate Session Factory or Hibernate Entity Manager Factory. If you
don't specify the JNDI URL property, our engine will try the following JNDI
- URLs:</diffmk:wrapper></para>
- <itemizedlist diffmk:change="added">
+ URLs:</para>
+ <itemizedlist>
<listitem>
<para>
- <emphasis><diffmk:wrapper diffmk:change="changed">java:/<project_name></diffmk:wrapper></emphasis>
+ <emphasis>java:/<project_name></emphasis>
</para>
</listitem>
<listitem>
<para>
- <emphasis diffmk:change="added"><diffmk:wrapper diffmk:change="added">java:/<project_name>EntityManagerFactory</diffmk:wrapper></emphasis>
+ <emphasis>java:/<project_name>EntityManagerFactory</emphasis>
</para>
</listitem>
</itemizedlist>
- <para><diffmk:wrapper diffmk:change="added">When creating a Seam EAR project, Hibernate Entity Manager Factory is bound to
- </diffmk:wrapper><emphasis diffmk:change="added"><diffmk:wrapper diffmk:change="added">java:/{projectName}EntityManagerFactory</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added">. All you need to do is
+ <para>When creating a Seam EAR project, Hibernate Entity Manager Factory is bound to
+ <emphasis>java:/{projectName}EntityManagerFactory</emphasis>. All you need to do is
using the Hibernate Configuration created automatically. You can use default values for the
- Hibernate Configuration and JNDI URL within the BIRT Hibernate Data Source.</diffmk:wrapper></para>
+ Hibernate Configuration and JNDI URL within the BIRT Hibernate Data Source.</para>
- <para><diffmk:wrapper diffmk:change="added">When using a Seam WAR project, neither HSF nor HEMF aren't binded to JNDI by
+ <para>When using a Seam WAR project, neither HSF nor HEMF aren't binded to JNDI by
default. You has to do this manually. For instance, HSF can be bound to JNDI by adding the
- following property to the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">persistence.xml</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> file:</diffmk:wrapper></para>
+ following property to the <emphasis>
+ <property moreinfo="none">persistence.xml</property></emphasis> file:</para>
- <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[<property name="hibernate.session_factory_name" value="java:/projectname"/>
- ]]></diffmk:wrapper></programlisting>
+ <programlisting format="linespecific" role="XHTML"><![CDATA[<property name="hibernate.session_factory_name" value="java:/projectname"/>
+ ]]></programlisting>
- <para><diffmk:wrapper diffmk:change="added">And you can use </diffmk:wrapper><emphasis diffmk:change="added"><diffmk:wrapper diffmk:change="added">java:/projectname</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> as the JNDI URL property when creating a BIRT
- Hibernate Data Source.</diffmk:wrapper></para>
+ <para>And you can use <emphasis>java:/projectname</emphasis> as the JNDI URL property when creating a BIRT
+ Hibernate Data Source.</para>
- <note diffmk:change="added">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Note:</diffmk:wrapper></title>
- <para><diffmk:wrapper diffmk:change="added">If you want to test this feature using PDE Runtime, you need to add </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">osgi.dev=bin</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> to the </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">WebContent/WEB-INF/platform/configuration/config.ini</diffmk:wrapper></property>
- </emphasis><diffmk:wrapper diffmk:change="added"> file.</diffmk:wrapper></para>
+ <note>
+ <title>Note:</title>
+ <para>If you want to test this feature using PDE Runtime, you need to add <emphasis>
+ <property moreinfo="none">osgi.dev=bin</property>
+ </emphasis> to the <emphasis>
+ <property moreinfo="none">WebContent/WEB-INF/platform/configuration/config.ini</property>
+ </emphasis> file.</para>
</note>
- <para><diffmk:wrapper diffmk:change="added">In conclusion, the main goal of this document is to get you know with a full featureset
- that </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss BIRT Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> provide. Thus if you have some questions,
- comments or suggestions on the topic, please feel free to ask in the </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.org/index.html?module=bb&op=viewforum&f=201"><diffmk:wrapper diffmk:change="added">JBoss
- Tools Forum</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">. You can also influence on how you want to see JBoss Tools docs in
- future leaving your vote on our page </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.org/community/docs/DOC-10795"><diffmk:wrapper diffmk:change="added">here</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
+ <para>In conclusion, the main goal of this document is to get you know with a full featureset
+ that <property moreinfo="none">JBoss BIRT Tools</property> provide. Thus if you have some questions,
+ comments or suggestions on the topic, please feel free to ask in the <ulink url="http://www.jboss.org/index.html?module=bb'op=viewforum'f=201">JBoss
+ Tools Forum</ulink>. You can also influence on how you want to see JBoss Tools docs in
+ future leaving your vote on our page <ulink url="http://www.jboss.org/community/docs/DOC-10795">here</ulink>.</para>
+</chapter>
-
-</chapter></book>
+</book>
15 years, 6 months
- 1
- 0
JBoss Tools SVN: r15733 - trunk/as/docs/reference/en.
by jbosstools-commits＠lists.jboss.org
Author: ochikvina
Date: 2009-06-05 11:02:52 -0400 (Fri, 05 Jun 2009)
New Revision: 15733
Modified:
trunk/as/docs/reference/en/master_output.xml
Log:
https://jira.jboss.org/jira/browse/JBDS-743 - adding master_output.xml;
Modified: trunk/as/docs/reference/en/master_output.xml
===================================================================
--- trunk/as/docs/reference/en/master_output.xml 2009-06-05 13:40:53 UTC (rev 15732)
+++ trunk/as/docs/reference/en/master_output.xml 2009-06-05 15:02:52 UTC (rev 15733)
@@ -26,7 +26,17 @@
<bookinfo>
<title>JBoss Server Manager Reference Guide</title>
-
+ <corpauthor diffmk:change="added">
+ <inlinemediaobject diffmk:change="added">
+ <imageobject diffmk:change="added" role="fo">
+ <imagedata diffmk:change="added" fileref="images/jbosstools_logo.png" format="PNG"></imagedata>
+ </imageobject>
+ <imageobject diffmk:change="added" role="html">
+ <imagedata diffmk:change="added"></imagedata>
+ </imageobject>
+ </inlinemediaobject>
+ </corpauthor>
+
<author><firstname>Anatoly</firstname><surname>Fedosik</surname></author>
<author><firstname>Olga</firstname><surname>Chikvina</surname></author>
<author><firstname>Rob</firstname><surname>Stryker</surname><email>rob.stryker(a)jboss.com</email></author>
@@ -38,9 +48,9 @@
<year>2009</year>
<holder>JBoss, a division of Red Hat</holder>
</copyright>
- <releaseinfo>
- Version: 2.0.0.GA
- </releaseinfo>
+ <releaseinfo><diffmk:wrapper diffmk:change="changed">
+ Version: 2.1.0.M1
+ </diffmk:wrapper></releaseinfo>
<abstract>
<title></title>
<para>
@@ -56,10 +66,80 @@
<chapter id="quick_start" role="updated" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/as/docs/reference/en/modules/quick_start.xml">
<title>Quick Start with JBoss Server</title>
- <para>This chapter covers the basics of working with the <property moreinfo="none">JBoss Server</property>. If you
+ <para>This chapter covers the basics of working with the <property moreinfo="none">JBoss Server</property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
+
+ <section diffmk:change="added" id="JBoss_server_key_features">
+ <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Key Features of JBoss Server</diffmk:wrapper></title>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">For a start, we propose you to look through the table of main features of JBoss Server:</diffmk:wrapper></para>
+
+ <table diffmk:change="added">
+
+ <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Key Functionality for JBoss Server</diffmk:wrapper></title>
+ <tgroup cols="3" diffmk:change="added">
+
+ <colspec align="left" colnum="1" colwidth="2*" diffmk:change="added"></colspec>
+ <colspec colnum="2" colwidth="4*" diffmk:change="added"></colspec>
+ <colspec align="left" colnum="3" colwidth="2*" diffmk:change="added"></colspec>
+
+ <thead diffmk:change="added">
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Feature</diffmk:wrapper></entry>
+ <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Benefit</diffmk:wrapper></entry>
+ <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Chapter</diffmk:wrapper></entry>
+ </row>
+ </thead>
+ <tbody diffmk:change="added">
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss AS plugin</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Using WTP, JBoss AS plugin allows working with the server in run or debug mode. You can easily install runtimes and servers, copy the existing runtime configuration or configure it up to your needs.</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added">
+ <link diffmk:change="added" linkend="runtimes_servers"><diffmk:wrapper diffmk:change="added">runtimes and servers</diffmk:wrapper></link>
+ </entry>
+ </row>
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss AS Perspective</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">It makes managing installed JBoss Server quite easy and includes the standard Console and Properties views, and specially added Project archives View and JBoss Server View for that purpose. </diffmk:wrapper></para></entry>
+ <entry diffmk:change="added">
+ <link diffmk:change="added" linkend="perspective"><diffmk:wrapper diffmk:change="added">JBoss AS perspective</diffmk:wrapper></link>
+ </entry>
+ </row>
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Modules Deployment</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">A number of ways, provided by WTP and JBoss Tools, to deploy either a project or a single file on the server.</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added">
+ <link diffmk:change="added" linkend="modules"><diffmk:wrapper diffmk:change="added">deploying modules</diffmk:wrapper></link>
+ </entry>
+ </row>
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">TPTP Support</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Test and Performance Tools Platform (TPTP) profiling.</diffmk:wrapper></para></entry>
+ <entry diffmk:change="added">
+ <link diffmk:change="added" linkend="tptp_support"><diffmk:wrapper diffmk:change="added">TPTP support</diffmk:wrapper></link>
+ </entry>
+ </row>
+
+ </tbody>
+
+ </tgroup>
+ </table>
+
+ </section>
+
+
+
+
+
+
+
+
+
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added"> If you
already have installed JBoss server and runtime you can quickly learn how to configure, start,
stop the server, to know deployment and archiving processes. How to install runtimes and servers
- read in the <link linkend="runtimes_servers">Runtimes and Servers in the JBoss AS plugin</link>
+ read in the </diffmk:wrapper><link linkend="runtimes_servers">Runtimes and Servers in the JBoss AS plugin</link>
chapter.</para>
<para>To start working with JBoss AS, select a <property moreinfo="none">JBoss AS Perspective</property> via
@@ -77,9 +157,9 @@
<property moreinfo="none">stop</property>
</emphasis> it or <emphasis>
<property moreinfo="none">restart</property>
- </emphasis><diffmk:wrapper diffmk:change="changed"> it and </diffmk:wrapper><emphasis>
+ </emphasis> it and <emphasis>
<property moreinfo="none">publish</property>
- </emphasis><diffmk:wrapper diffmk:change="added"> to the server.</diffmk:wrapper></para>
+ </emphasis> to the server.</para>
<figure float="0">
<title>JBoss Server Toolbar</title>
@@ -401,7 +481,7 @@
<row>
<entry>
- <para><diffmk:wrapper diffmk:change="changed">JRE</diffmk:wrapper></para>
+ <para>JRE</para>
</entry>
<entry>
<para>The proper Java Runtime Environment. Because of the open-source nature of
@@ -411,17 +491,22 @@
wizard allows to create only a new configuration instead.</para>
</entry>
</row>
-
+
+ <row diffmk:change="added">
+ <entry diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Directory</diffmk:wrapper></para>
+ </entry>
+ <entry diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The path to a directory where the configurations are installed.</diffmk:wrapper></para>
+ </entry>
+ </row>
<row>
<entry>
<para>Configuration</para>
</entry>
<entry>
- <para>The list of configurations (all, default, minimal) that is updated as soon as
- you browse to a valid runtime installation folder. After the runtime is created
- the configuration becomes an unchanging property of that runtime. To compile
- against a different configuration's jars, you will need to create a new runtime
- from that configuration.</para>
+ <para><diffmk:wrapper diffmk:change="changed">The list of configurations (all, default, minimal) that is updated as soon as
+ you browse to a valid runtime installation folder.</diffmk:wrapper></para>
</entry>
</row>
@@ -429,19 +514,79 @@
</tgroup>
</table>
- <para>As a result of having each runtime represent a specific configuration rather than the
+ <para><diffmk:wrapper diffmk:change="changed">As a result of having each runtime represent a specific configuration rather than the
server installation as a whole, it is very likely you'll create several different
runtimes to test each of your configurations. It becomes important to ensure your runtimes,
- and later your servers, are given descriptive names that help you remember which is
- which.</para>
+ and later your servers, are given descriptive names that help you to remember which is
+ which.</diffmk:wrapper></para>
<para>Press <emphasis>
<property moreinfo="none">Finish</property>
- </emphasis> to see your new runtime in the list.</para>
+ </emphasis> to see your new runtime in the list.</para>
+ <note diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Note:</diffmk:wrapper></title>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">If you edit the configuration of a runtime, the changes don't affect the settings of the servers that currently use the runtime.
+ To apply the changes to them also,you should double right click the server, </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Overview>Runtime Environment</diffmk:wrapper></property> </emphasis><diffmk:wrapper diffmk:change="added">
+ ,make sure that necessary configuration is chosen,click </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property> </emphasis><diffmk:wrapper diffmk:change="added"> and then </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Save</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> button.</diffmk:wrapper></para>
+ </note>
</section>
-
+ <section diffmk:change="added" id="CopyRuntime">
+ <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Copying the existing runtime configuration</diffmk:wrapper></title>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">While installing a new runtime you can copy the configuration from the existing one.
+ To do this you should perform all the steps in the </diffmk:wrapper><link diffmk:change="added" linkend="InstNewRuntime"><diffmk:wrapper diffmk:change="added">previous</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added"> section except pressing </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added">
+ in the New Server Runtime Environment menu .
+ </diffmk:wrapper></para>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Make sure that you browse to a valid runtime folder and can see the list of configurations (all, default, minimal) in the Configuration section .
+ Then choose necessary Configuration from the list and click </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Copy</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added">.The next dialog should appear.
+ </diffmk:wrapper></para>
+ <figure diffmk:change="added" float="0">
+ <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Copy the existing configuration</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added" fileref="images/runtimes_servers/runtimes_servers_4a.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Change the name Click on </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Browse</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> and select your configuration location or leave as it's if you want it to be located together with other runtime configurations.
+ </diffmk:wrapper></para>
+ <figure diffmk:change="added" float="0">
+ <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Copy the existing configuration</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added" fileref="images/runtimes_servers/runtimes_servers_4b.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Click</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added"> Ok </diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added">and you should see the next wizard with the just added copied configuration.
+
+ </diffmk:wrapper></para>
+ <figure diffmk:change="added" float="0">
+ <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Runtime with copied configuration</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added" fileref="images/runtimes_servers/runtimes_servers_4c.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added"> Press </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> and you will see your new runtime in the list.
+ </diffmk:wrapper></para>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You can also change a configuration of existing runtime to a copied one in the same way from the </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added"> Window > Preferences </diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added">
+ menu </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Server > Runtime Environments </diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added">
+ and clicking </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Edit</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added">.
+ </diffmk:wrapper></para>
</section>
-
+ </section>
<section>
<title>Servers</title>
<para>WTP servers are eclipse-representations of a backing server installation. They are used to
@@ -473,11 +618,14 @@
or stopping, and runtimes keep track of the location of the installation. Thus, each server
instance must be backed by an appropriate runtime. </para>
- <para>From the list of already declared runtimes in the combo box below the view it's
+ <para> <emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added"> New server wizard </diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> allows to name the server appropriately in the </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Server name field </diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added">or you can use a generated default name.If it's nessecary to restore the default name,after you defined yours, click the Reset default button(</diffmk:wrapper><inlinemediaobject diffmk:change="added"> <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added" fileref="images/runtimes_servers/runtimes_servers_4d.png"></imagedata>
+ </imageobject></inlinemediaobject><diffmk:wrapper diffmk:change="added">).
+ From the list of already declared runtimes in the combo box below the view it's
possible to select which runtime you want your server to be backed by. If there is no
- runtime that matches your needs just press the <emphasis>
+ runtime that matches your needs just press the </diffmk:wrapper><emphasis>
<property moreinfo="none">Add...</property>
- </emphasis> link nearby to bring up the wizard for creating a new runtime (see the <link linkend="add_runtime_figure">previous section</link>). To configure the already installed
+ </emphasis> link nearby to bring up the wizard for creating a new runtime (see the <link linkend="add_runtime_figure"><diffmk:wrapper diffmk:change="changed">Installing a New Runtime section</diffmk:wrapper></link>). To configure the already installed
runtimes you should go to server preferences that you can easily do by pressing the <emphasis>
<property moreinfo="none">Configure runtime environments...</property></emphasis> link.</para>
@@ -495,9 +643,9 @@
<para>In this case the next page in the wizard which has the same form as in <link linkend="add_runtime_figure">the previous section</link> will ask you to create the
associated runtime.</para>
- <para>Either way, after targeting your server to a runtime, the final screen in this wizard is
+ <para><diffmk:wrapper diffmk:change="changed">Either way, after targeting your server to a runtime, the final screen in this wizard is
largely confirmational, giving you a chance to verify that you've selected the
- appropriate runtime. It also allows to name the server appropriately. </para>
+ appropriate runtime. </diffmk:wrapper></para>
<figure float="0">
<title>Installed Server Runtime Environments</title>
@@ -511,14 +659,14 @@
<para>Press <emphasis>
<property moreinfo="none">Finish</property>
</emphasis> to complete the process of the server creation.</para>
- <para><diffmk:wrapper diffmk:change="added">Now that we've created our runtimes and servers, we can dwell on all services
- and tools that JBoss Server Manager provides.</diffmk:wrapper></para>
+ <para>Now that we've created our runtimes and servers, we can dwell on all services
+ and tools that JBoss Server Manager provides.</para>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">We hope, this guide helped you to get started with the JBoss Tools server manager. Besides, for additional information you are welcome on </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201"><diffmk:wrapper diffmk:change="added">JBoss forum</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para>
+ <para>We hope, this guide helped you to get started with the JBoss Tools server manager. Besides, for additional information you are welcome on <ulink url="http://www.jboss.com/index.html?module=bb'op=viewforum'f=201">JBoss forum</ulink>.</para>
</section>
+ </section>
+
- </section>
-
</chapter>
@@ -568,9 +716,9 @@
<section id="jbossserver_view_toolbar">
<title>JBoss Server View Toolbar</title>
<para>In the right top corner of the <property moreinfo="none">JBoss Server View</property><diffmk:wrapper diffmk:change="changed"> there is a
- special toolbar which provides a quick access to starting a server (in the debug mode,
- run mode, or profile mode), restarting a server, stopping a server and a possibility to publish to a
- server.</diffmk:wrapper></para>
+ special toolbar which provides a quick access to starting a server (in the debug
+ mode, run mode, or profile mode), restarting a server, stopping a server and a
+ possibility to publish to a server.</diffmk:wrapper></para>
<figure float="0">
<title>The JBoss Server View Toolbar</title>
@@ -597,7 +745,7 @@
</emphasis> button will republish any modules where it has determined the workspace
is out of sync with the server. It will attempt to do an incremental publish if it
turns out that the module in question is capable of doing one.</para>
-
+
</section>
<section id="jbossserver_view_structure">
@@ -767,8 +915,8 @@
<para>Publish</para>
</entry>
<entry>
- <para><diffmk:wrapper diffmk:change="added">The action for synchronizing the publish information between
- the server and workspace</diffmk:wrapper></para>
+ <para>The action for synchronizing the publish information between
+ the server and workspace</para>
</entry>
</row>
@@ -914,8 +1062,8 @@
</emphasis> category allows you to quickly browse to descriptor files in your
server's deploy directory and check or change the values. Basically, <emphasis>
<property moreinfo="none">XML Configuration</property>
- </emphasis><diffmk:wrapper diffmk:change="changed"> includes XML XPaths where an xpath is a path used to access some
- specific part of an xml document. </diffmk:wrapper></para>
+ </emphasis> includes XML XPaths where an xpath is a path used to access some
+ specific part of an xml document. </para>
<note>
<title>Note:</title>
@@ -994,7 +1142,7 @@
<para>The goal here is to get an end result where the XPath matches up with a
necessary property. With that in mind, let's look how it works. If the
property you want to reach is the value of the <emphasis>name</emphasis>
- attribute in the element <code diffmk:change="added"><mbean></code>, then your <emphasis>
+ attribute in the element <code><mbean></code>, then your <emphasis>
<property moreinfo="none">XPath Patten</property>
</emphasis>should end with <emphasis>mbean</emphasis> and your <emphasis>
<property moreinfo="none">Attribute Name</property>
@@ -1032,7 +1180,7 @@
</tip>
<para>Then, on the other hand, if your desired field is the text of an element
- <code diffmk:change="added"><description></code>, your <emphasis>
+ <code><description></code>, your <emphasis>
<property moreinfo="none">XPath Patten</property>
</emphasis> should end with <emphasis>description</emphasis> and <emphasis>
<property moreinfo="none">Attribute Name</property>
@@ -1056,8 +1204,8 @@
<title>Drag-n-Drop to JBoss Server View</title>
<para>Starting from 2.0.0.CR2 version of <property moreinfo="none">JBoss AS Tools</property> the
- <property moreinfo="none">JBoss Server View</property><diffmk:wrapper diffmk:change="changed"> supports drag-n-drop of deployable and
- runnable projects/resources.</diffmk:wrapper></para>
+ <property moreinfo="none">JBoss Server View</property> supports drag-n-drop of deployable and
+ runnable projects/resources.</para>
<figure float="0">
<title>Dragging to the JBoss Server View</title>
@@ -1088,8 +1236,8 @@
<listitem>
<para>dragging a deployable resource (i.e. a datasource (<emphasis>
<property moreinfo="none">-ds.xml</property>
- </emphasis><diffmk:wrapper diffmk:change="changed">) file that has been made deployable) will simply deploy that
- resource directly to the server</diffmk:wrapper></para>
+ </emphasis>) file that has been made deployable) will simply deploy that
+ resource directly to the server</para>
</listitem>
</itemizedlist>
@@ -1212,10 +1360,10 @@
<tip>
<title>Tip:</title>
- <para><diffmk:wrapper diffmk:change="changed">On the figure you can see that a username/password is available in the UI when
+ <para>On the figure you can see that a username/password is available in the UI when
configuring the server. If you get a SecurityException when trying to launch the
server, it is most likely because your server is protected and hence you need to
- fill the username/password fields with appropriate values.</diffmk:wrapper></para>
+ fill the username/password fields with appropriate values.</para>
</tip>
<para>It should be pointed out that our server adapter by default tries to automatically
@@ -1251,20 +1399,23 @@
</mediaobject>
</figure>
- <para>The settings related to <emphasis>
- <property moreinfo="none">Publishing</property>
- </emphasis>, <emphasis>
- <property moreinfo="none">Timeouts</property>
- </emphasis> or <emphasis>
- <property moreinfo="none">Server Polling</property>
- </emphasis> can be also adjusted in the <property moreinfo="none">Server editor</property>.</para>
+ <para><diffmk:wrapper diffmk:change="added">In the </diffmk:wrapper><property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Server editor</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> you are able to edit the timeouts and the server pollers to use.</diffmk:wrapper></para>
+
+ <note diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Note:</diffmk:wrapper></title>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">By default, the Startup poller is set to JMX Poller (see the </diffmk:wrapper><emphasis>
+ <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Server Polling</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="changed"> section). If you change the Startup poller
+ to Timeout Poller (it may need in case, for example, you're using the minimal configuration for your server), this will do no polling at all and will only set the server
+ state to </diffmk:wrapper><emphasis>
+ <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">"Started"</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> after your startup timeout is reached.</diffmk:wrapper></para>
+ </note>
<para id="com_line_arg"><property moreinfo="none">Server editor</property> makes it also possible to
modify the server's launch configuration. It's just after clicking <emphasis>
<property moreinfo="none">Open launch configuration</property>
- </emphasis><diffmk:wrapper diffmk:change="changed"> link. In the open window there are the tabs for setting command line
+ </emphasis> link. In the open window there are the tabs for setting command line
arguments, classpaths and other things that are relevant to launching the
- server.</diffmk:wrapper></para>
+ server.</para>
<figure float="0">
<title>Launch Configuration Properties</title>
@@ -1278,48 +1429,47 @@
<para>Look up <ulink url="http://docs.jboss.org/jbossas/guides/installguide/r1/en/html/start-stop.html">here</ulink> to find parameters which can be specified for <property moreinfo="none">JBoss
Server</property>.</para>
- <note diffmk:change="added">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Note:</diffmk:wrapper></title>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Please note, that the Launch Configurations for JBoss Servers are enough
+ <note>
+ <title>Note:</title>
+ <para>Please note, that the Launch Configurations for JBoss Servers are enough
strict in enforcing the configured values in the server in order to avoid
- inconsistencies between server's and their configured runtime.</diffmk:wrapper></para>
+ inconsistencies between server's and their configured runtime.</para>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">For example, if you change the launch configuration program arguments to
- </diffmk:wrapper><emphasis diffmk:change="added"><diffmk:wrapper diffmk:change="added">"-c myConfig"</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> but do not change the
+ <para>For example, if you change the launch configuration program arguments to
+ <emphasis>"-c myConfig"</emphasis> but do not change the
targeted runtime configuration, then your program arguments will be ignored. The
server runtime "wins" so to speak. This ensures consistency
and if you change the location of the runtime, your launch configurations will
- automatically pick that up.</diffmk:wrapper></para>
+ automatically pick that up.</para>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Values are not controlled by the server and its runtime setup will be passed
- on unaltered.</diffmk:wrapper></para>
+ <para>Values are not controlled by the server and its runtime setup will be passed
+ on unaltered.</para>
</note>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Until 3.0.0.GA release of </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, the servers classpath was readonly, but that caused
- problems for users wanting to add their own jars in the startup classpath. That is
- relevant if you need to patch the server, add a custom charset or other tweaks that
- require early access to the classpath.</diffmk:wrapper></para>
+ <para>Until 3.0.0.GA release of <property moreinfo="none">JBoss Tools</property><diffmk:wrapper diffmk:change="changed">, the servers classpath
+ was readonly, but that caused problems for users wanting to add their own jars in
+ the startup classpath. That is relevant if you need to patch the server, add a
+ custom charset or other tweaks that require early access to the classpath.</diffmk:wrapper></para>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Now all servers have a custom 'server runtime classpath
+ <para>Now all servers have a custom 'server runtime classpath
container', which is there by default and point to the default jars in
JBoss. You can now adjust the classpath. Then just make sure this container is there
- if you want the classpath to be picked up.</diffmk:wrapper></para>
+ if you want the classpath to be picked up.</para>
- <figure diffmk:change="added" float="0">
- <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Server Classpaths</diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added" fileref="images/perspective/server_classpaths.png"></imagedata>
+ <figure float="0">
+ <title>Server Classpaths</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/perspective/server_classpaths.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
- <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">If for some reason you have a launch configuration without this container, </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Restore
- Default Entries</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> should add it properly. Also, </diffmk:wrapper><emphasis diffmk:change="added">
- <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Restore
- Default Entries</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> will also remove any
- extra entries you added yourself.</diffmk:wrapper></para>
+ <para>If for some reason you have a launch configuration without this container, <emphasis>
+ <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Restore Default Entries</diffmk:wrapper></property>
+ </emphasis> should add it properly. Also, <emphasis>
+ <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Restore Default Entries</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="changed"> will also remove any extra entries you added yourself.</diffmk:wrapper></para>
</section>
<section>
@@ -1533,11 +1683,11 @@
pattern. As you type in either of these fields, the preview viewer should update
itself with which files are matched.</para>
- <para><diffmk:wrapper diffmk:change="changed">You can create a Fileset with flattening or without it. Look at the difference
- on the figure below.</diffmk:wrapper></para>
+ <para>You can create a Fileset with flattening or without it. Look at the difference
+ on the figure below.</para>
<figure float="0">
- <title><diffmk:wrapper diffmk:change="changed">The FileSet with flattening and without it</diffmk:wrapper></title>
+ <title>The FileSet with flattening and without it</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/perspective/perspective_24a.png"></imagedata>
@@ -1743,10 +1893,10 @@
<property moreinfo="none">Next</property>
</emphasis> and you will see Dynamic Web Project page like on the figure below.</para>
- <para><diffmk:wrapper diffmk:change="changed"> The first page of most WTP projects allows you to target a specific runtime,
+ <para> The first page of most WTP projects allows you to target a specific runtime,
representing a server's library location. It will also provide you the ability to add
this project to an EAR project, and select a preselected default set of facets, called
- a configuration, rather than manually select each facet you might want.</diffmk:wrapper></para>
+ a configuration, rather than manually select each facet you might want.</para>
<para> Selecting the runtime, again, allows the project to install the proper classpaths to
the project so it knows what code to compile against.</para>
@@ -1859,8 +2009,8 @@
<section>
<title>Deploying on the Package Explorer</title>
- <para><diffmk:wrapper diffmk:change="changed">On the package explorer it is possible to publish either a project to a server or just
- a single file. Let's look at how to do this.</diffmk:wrapper></para>
+ <para>On the package explorer it is possible to publish either a project to a server or just
+ a single file. Let's look at how to do this.</para>
<section id="run_on_server_wizard">
<title>Deploying with Run On Server Wizard</title>
<para> The first WTP method is to right-click on a project, such as a Dynamic Web
@@ -1906,6 +2056,9 @@
directory. For quicker smarter deployment, you will need to create archives using
the <link linkend="Project_archivesView">Project Archives view</link> and customize
packaging yourself.</para>
+
+
+
</section>
<section id="single_file_deployment">
@@ -2025,6 +2178,19 @@
</emphasis> file, is to enable the builder for that project. This is done by either
changing the global preferences for the <property moreinfo="none">Archives View</property>, or by
enabling project-specific preferences and ensuring the builder is on.</para>
+
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You can also use the "Finger touch" button for a quick restart of the project without restarting the server:</diffmk:wrapper></para>
+ <figure diffmk:change="added" float="0">
+ <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Finger Touch button</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added" fileref="images/modules/modules_8_finger_touch.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The "Finger" touches descriptors dependent on project (i.e. web.xml for WAR, application.xml for EAR, jboss-esb.xml in ESB projects).</diffmk:wrapper></para>
+
+
<para>The last chapter covers a variety of methods on how you can deploy needed modules onto a
server.</para>
</section>
15 years, 6 months
- 1
- 0
JBoss Tools SVN: r15732 - trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib.
by jbosstools-commits＠lists.jboss.org
Author: akazakov
Date: 2009-06-05 09:40:53 -0400 (Fri, 05 Jun 2009)
New Revision: 15732
Modified:
trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/AbstractComponent.java
Log:
https://jira.jboss.org/jira/browse/JBIDE-2808
Modified: trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/AbstractComponent.java
===================================================================
--- trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/AbstractComponent.java 2009-06-05 13:35:44 UTC (rev 15731)
+++ trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/AbstractComponent.java 2009-06-05 13:40:53 UTC (rev 15732)
@@ -66,6 +66,9 @@
this.canHaveBody = canHaveBody;
}
+ /**
+ * @param s
+ */
public void setCanHaveBody(IValueInfo s) {
canHaveBody = s == null || "empty".equals(s.getValue());
attributesInfo.put(BODY_CONTENT, s);
@@ -158,6 +161,10 @@
this.componentType = componentType;
}
+ /**
+ *
+ * @param s
+ */
public void setComponentType(IValueInfo s) {
componentType = s == null ? null : s.getValue();
attributesInfo.put(COMPONENT_TYPE, s);
@@ -177,6 +184,9 @@
this.description = description;
}
+ /**
+ * @param s
+ */
public void setDescription(IValueInfo s) {
description = s == null ? null : s.getValue();
attributesInfo.put(DESCRIPTION, s);
@@ -196,6 +206,9 @@
this.name = name;
}
+ /**
+ * @param s
+ */
public void setName(IValueInfo s) {
name = s == null ? null : s.getValue();
attributesInfo.put(XMLStoreConstants.ATTR_NAME, s);
@@ -236,10 +249,18 @@
public static final Facet[] EMPTY_FACET_SET = new Facet[0];
+ /*
+ * (non-Javadoc)
+ * @see org.jboss.tools.jst.web.kb.taglib.IComponent#getFacets()
+ */
public Facet[] getFacets() {
return EMPTY_FACET_SET;
}
+ /*
+ * (non-Javadoc)
+ * @see org.jboss.tools.jst.web.kb.taglib.IComponent#getFacets(java.lang.String)
+ */
public Facet[] getFacets(String nameTemplate) {
return EMPTY_FACET_SET;
}
@@ -328,6 +349,11 @@
// Do nothing
}
+ /*
+ * (non-Javadoc)
+ * @see org.jboss.tools.jst.web.kb.internal.KbObject#clone()
+ */
+ @Override
public AbstractComponent clone() throws CloneNotSupportedException {
AbstractComponent copy = (AbstractComponent)super.clone();
copy.attributes = new HashMap<String, IAttribute>();
@@ -340,6 +366,11 @@
return copy;
}
+ /*
+ * (non-Javadoc)
+ * @see org.jboss.tools.jst.web.kb.internal.KbObject#merge(org.jboss.tools.jst.web.kb.internal.KbObject)
+ */
+ @Override
public List<Change> merge(KbObject s) {
List<Change> changes = super.merge(s);
@@ -372,6 +403,10 @@
return changes;
}
+ /**
+ * @param c
+ * @param children
+ */
public void mergeAttributes(AbstractComponent c, Change children) {
Map<Object,AbstractAttribute> attributeMap = new HashMap<Object, AbstractAttribute>();
for (IAttribute a: getAttributes()) attributeMap.put(((KbObject)a).getId(), (AbstractAttribute)a);
@@ -398,10 +433,20 @@
}
}
+ /*
+ * (non-Javadoc)
+ * @see org.jboss.tools.jst.web.kb.internal.KbObject#getXMLName()
+ */
+ @Override
public String getXMLName() {
return KbXMLStoreConstants.TAG_COMPONENT;
}
-
+
+ /*
+ * (non-Javadoc)
+ * @see org.jboss.tools.jst.web.kb.internal.KbObject#toXML(org.w3c.dom.Element, java.util.Properties)
+ */
+ @Override
public Element toXML(Element parent, Properties context) {
Element element = super.toXML(parent, context);
@@ -416,6 +461,11 @@
return element;
}
+ /*
+ * (non-Javadoc)
+ * @see org.jboss.tools.jst.web.kb.internal.KbObject#loadXML(org.w3c.dom.Element, java.util.Properties)
+ */
+ @Override
public void loadXML(Element element, Properties context) {
super.loadXML(element, context);
15 years, 6 months
- 1
- 0
JBoss Tools SVN: r15731 - in trunk/jst/plugins/org.jboss.tools.jst.web.kb: src/org/jboss/tools/jst/web/kb and 2 other directories.
by jbosstools-commits＠lists.jboss.org
Author: akazakov
Date: 2009-06-05 09:35:44 -0400 (Fri, 05 Jun 2009)
New Revision: 15731
Added:
trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/CustomTagLibAttribute.java
trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/CustomTagLibComponent.java
trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/ICustomTagLibComponent.java
Modified:
trunk/jst/plugins/org.jboss.tools.jst.web.kb/resources/kbCustomTagLibSchema-1.0.dtd
trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/PageProcessor.java
trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/AbstractAttribute.java
trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/AbstractComponent.java
trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/AbstractTagLib.java
trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/CustomTagLibrary.java
trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/CustomTagLibManager.java
trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/IAttribute.java
trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/IComponent.java
trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/ICustomTagLibrary.java
trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/ITagLibrary.java
Log:
https://jira.jboss.org/jira/browse/JBIDE-2808
Modified: trunk/jst/plugins/org.jboss.tools.jst.web.kb/resources/kbCustomTagLibSchema-1.0.dtd
===================================================================
--- trunk/jst/plugins/org.jboss.tools.jst.web.kb/resources/kbCustomTagLibSchema-1.0.dtd 2009-06-05 13:25:00 UTC (rev 15730)
+++ trunk/jst/plugins/org.jboss.tools.jst.web.kb/resources/kbCustomTagLibSchema-1.0.dtd 2009-06-05 13:35:44 UTC (rev 15731)
@@ -22,14 +22,12 @@
closeTag - "true" - Component can have a body.
"false" - Component cannot have a body. Used by default.
extended - "true" - Component is relevant only if this component exists in other tag-libs (tld, faclets, ...). Set to "true" by default.
- description
-->
-<!ELEMENT component (component*, attribute*)>
+<!ELEMENT component (description?, component*, attribute*)>
<!ATTLIST component name CDATA #REQUIRED>
<!ATTLIST component closeTag %Boolean; #IMPLIED>
<!ATTLIST component extended %Boolean; #IMPLIED>
-<!ATTLIST component description CDATA #IMPLIED>
<!--
Describes attribute of component.
@@ -38,15 +36,13 @@
required - "true" - attribute of element is required. "false" by default.
defaultValue - default value of attribute.
extended - "true" - Attribute is relevant only if this attribute exists in other tag-libs (tld, faclets, ...). Set to "true" by default.
- description
-->
-<!ELEMENT attribute (proposal*)>
+<!ELEMENT attribute (description?, proposal*)>
<!ATTLIST attribute name CDATA #REQUIRED>
<!ATTLIST attribute required %Boolean; #REQUIRED>
<!ATTLIST attribute defaultValue CDATA #IMPLIED>
<!ATTLIST attribute extended %Boolean; #IMPLIED>
-<!ATTLIST attribute description CDATA #IMPLIED>
<!--
Describe content assist proposal for value of attribute.
@@ -68,6 +64,8 @@
<!ATTLIST param value CDATA #REQUIRED>
<!ATTLIST param name CDATA #IMPLIED>
+<!ELEMENT description ()>
+
<!--
component extension describes common attributes with additional meta information
for component attributes in case these attributes are present in other types of tag libs.
Modified: trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/PageProcessor.java
===================================================================
--- trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/PageProcessor.java 2009-06-05 13:25:00 UTC (rev 15730)
+++ trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/PageProcessor.java 2009-06-05 13:35:44 UTC (rev 15731)
@@ -14,8 +14,11 @@
import org.jboss.tools.common.el.core.resolver.ELResolver;
import org.jboss.tools.common.text.TextProposal;
+import org.jboss.tools.jst.web.kb.internal.taglib.CustomTagLibAttribute;
+import org.jboss.tools.jst.web.kb.taglib.CustomTagLibManager;
import org.jboss.tools.jst.web.kb.taglib.IAttribute;
import org.jboss.tools.jst.web.kb.taglib.IComponent;
+import org.jboss.tools.jst.web.kb.taglib.ICustomTagLibrary;
import org.jboss.tools.jst.web.kb.taglib.ITagLibrary;
/**
@@ -24,6 +27,8 @@
public class PageProcessor implements IProposalProcessor {
private static final PageProcessor INSTANCE = new PageProcessor();
+ private ICustomTagLibrary[] customTagLibs;
+ private CustomTagLibAttribute[] componentExtensions;
/**
* @return instance of PageProcessor
@@ -33,6 +38,8 @@
}
private PageProcessor() {
+ customTagLibs = CustomTagLibManager.getInstance().getLibraries();
+ componentExtensions = CustomTagLibManager.getInstance().getComponentExtensions();
}
/*
@@ -48,6 +55,9 @@
proposals.add(libProposals[j]);
}
}
+ for (int i = 0; i < customTagLibs.length; i++) {
+ // TODO
+ }
if(query.getType() == KbQuery.Type.ATTRIBUTE_VALUE || ((query.getType() == KbQuery.Type.TEXT )&& context instanceof IFaceletPageContext)) {
String value = query.getValue();
//TODO convert value to EL string.
Modified: trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/AbstractAttribute.java
===================================================================
--- trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/AbstractAttribute.java 2009-06-05 13:25:00 UTC (rev 15730)
+++ trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/AbstractAttribute.java 2009-06-05 13:35:44 UTC (rev 15731)
@@ -226,4 +226,21 @@
super.loadAttributesInfo(element, context);
}
}
+
+ /*
+ * (non-Javadoc)
+ * @see org.jboss.tools.jst.web.kb.taglib.IAttribute#isExtended()
+ */
+ public boolean isExtended() {
+ // Return false by default
+ return false;
+ }
+
+ /*
+ * (non-Javadoc)
+ * @see org.jboss.tools.jst.web.kb.taglib.IAttribute#setExtended(boolean)
+ */
+ public void setExtended(boolean extended) {
+ // Do nothing by default
+ }
}
\ No newline at end of file
Modified: trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/AbstractComponent.java
===================================================================
--- trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/AbstractComponent.java 2009-06-05 13:25:00 UTC (rev 15730)
+++ trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/AbstractComponent.java 2009-06-05 13:35:44 UTC (rev 15731)
@@ -45,9 +45,12 @@
protected String componentType;
protected String description;
protected String name;
- protected Map<String, IAttribute> attributes = new HashMap<String, IAttribute>();
- protected Map<String, IAttribute> preferableAttributes = new HashMap<String, IAttribute>();
- protected Map<String, IAttribute> requiredAttributes = new HashMap<String, IAttribute>();
+ private Map<String, IAttribute> attributes = new HashMap<String, IAttribute>();
+ private IAttribute[] attributesArray;
+ private Map<String, IAttribute> preferableAttributes = new HashMap<String, IAttribute>();
+ private IAttribute[] preferableAttributesArray;
+ private Map<String, IAttribute> requiredAttributes = new HashMap<String, IAttribute>();
+ private IAttribute[] requiredAttributesArray;
/* (non-Javadoc)
* @see org.jboss.tools.jst.web.kb.taglib.IComponent#canHaveBody()
@@ -79,9 +82,12 @@
* @see org.jboss.tools.jst.web.kb.taglib.IComponent#getAttributes()
*/
public IAttribute[] getAttributes() {
- synchronized (attributes) {
- return attributes.values().toArray(new IAttribute[attributes.size()]);
+ if(attributesArray==null) {
+ synchronized (attributes) {
+ attributesArray = attributes.values().toArray(new IAttribute[attributes.size()]);
+ }
}
+ return attributesArray;
}
/* (non-Javadoc)
@@ -199,18 +205,24 @@
* @see org.jboss.tools.jst.web.kb.taglib.IComponent#getPreferableAttributes()
*/
public IAttribute[] getPreferableAttributes() {
- synchronized (preferableAttributes) {
- return preferableAttributes.values().toArray(new IAttribute[preferableAttributes.size()]);
+ if(preferableAttributesArray==null) {
+ synchronized (preferableAttributes) {
+ preferableAttributesArray = preferableAttributes.values().toArray(new IAttribute[preferableAttributes.size()]);
+ }
}
+ return preferableAttributesArray;
}
/* (non-Javadoc)
* @see org.jboss.tools.jst.web.kb.taglib.IComponent#getRequiredAttributes()
*/
public IAttribute[] getRequiredAttributes() {
- synchronized (requiredAttributes) {
- return requiredAttributes.values().toArray(new IAttribute[requiredAttributes.size()]);
+ if(requiredAttributesArray==null) {
+ synchronized (requiredAttributes) {
+ requiredAttributesArray = requiredAttributes.values().toArray(new IAttribute[requiredAttributes.size()]);
+ }
}
+ return requiredAttributesArray;
}
/**
@@ -280,8 +292,15 @@
if(attribute.isRequired()) {
requiredAttributes.put(attribute.getName(), attribute);
}
+ clearAttributeArrays();
}
+ private void clearAttributeArrays() {
+ attributesArray = null;
+ preferableAttributesArray = null;
+ requiredAttributesArray = null;
+ }
+
/**
* Removes the attribute from the component
* @param attribute
@@ -290,8 +309,25 @@
attributes.remove(attribute.getName());
preferableAttributes.remove(attribute.getName());
requiredAttributes.remove(attribute.getName());
+ clearAttributeArrays();
}
+ /*
+ * (non-Javadoc)
+ * @see org.jboss.tools.jst.web.kb.taglib.IComponent#isExtended()
+ */
+ public boolean isExtended() {
+ // Return false by default
+ return false;
+ }
+
+ /**
+ * @param extended
+ */
+ public void setExtended(boolean extended) {
+ // Do nothing
+ }
+
public AbstractComponent clone() throws CloneNotSupportedException {
AbstractComponent copy = (AbstractComponent)super.clone();
copy.attributes = new HashMap<String, IAttribute>();
@@ -357,6 +393,7 @@
attributes.remove(removed.getName());
Change change = new Change(this, null, removed, null);
children.addChildren(Change.addChange(null, change));
+ clearAttributeArrays();
}
}
}
@@ -408,5 +445,4 @@
}
}
}
-
}
\ No newline at end of file
Modified: trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/AbstractTagLib.java
===================================================================
--- trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/AbstractTagLib.java 2009-06-05 13:25:00 UTC (rev 15730)
+++ trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/AbstractTagLib.java 2009-06-05 13:35:44 UTC (rev 15731)
@@ -45,15 +45,20 @@
protected INameSpace nameSpace;
protected String uri;
- protected Map<String, IComponent> components = new HashMap<String, IComponent>();
+ protected String version;
+ private Map<String, IComponent> components = new HashMap<String, IComponent>();
+ private IComponent[] componentsArray;
/* (non-Javadoc)
* @see org.jboss.tools.jst.web.kb.taglib.TagLibrary#getAllComponents()
*/
public IComponent[] getComponents() {
- synchronized (components) {
- return components.values().toArray(new IComponent[components.size()]);
+ if(componentsArray==null) {
+ synchronized (components) {
+ componentsArray = components.values().toArray(new IComponent[components.size()]);
+ }
}
+ return componentsArray;
}
/* (non-Javadoc)
@@ -85,7 +90,7 @@
return getComponents(query, prefix, context);
}
- private String getPrefix(KbQuery query, IPageContext context) {
+ protected String getPrefix(KbQuery query, IPageContext context) {
String prefix = null;
Map<String, INameSpace> nameSpaces = context.getNameSpaces(query.getOffset());
if(nameSpaces!=null) {
@@ -99,7 +104,7 @@
private static final IComponent[] EMPTY_ARRAY = new IComponent[0];
- private IComponent[] getComponents(KbQuery query, String prefix, IPageContext context) {
+ protected IComponent[] getComponents(KbQuery query, String prefix, IPageContext context) {
String fullTagName = null;
boolean mask = false;
if(query.getType()==KbQuery.Type.TAG_NAME) {
@@ -155,6 +160,7 @@
public void addComponent(IComponent component) {
adopt((KbObject)component);
components.put(component.getName(), component);
+ componentsArray=null;
}
/**
@@ -162,6 +168,7 @@
*/
protected void setComponents(Map<String, IComponent> components) {
this.components = components;
+ componentsArray=null;
}
/*
@@ -233,6 +240,21 @@
attributesInfo.put(URI, s);
}
+ /*
+ * (non-Javadoc)
+ * @see org.jboss.tools.jst.web.kb.taglib.ITagLibrary#getVersion()
+ */
+ public String getVersion() {
+ return version;
+ }
+
+ /**
+ * @param version the version to set
+ */
+ public void setVersion(String version) {
+ this.version = version;
+ }
+
/* (non-Javadoc)
* @see org.jboss.tools.jst.web.kb.ProposalProcessor#getProposals(org.jboss.tools.jst.web.kb.KbQuery, org.jboss.tools.jst.web.kb.PageContext)
*/
@@ -242,35 +264,9 @@
IComponent[] components = getComponents(query, prefix, context);
if(query.getType() == KbQuery.Type.TAG_NAME) {
for (int i = 0; i < components.length; i++) {
- TextProposal proposal = new TextProposal();
- proposal.setContextInfo(components[i].getDescription());
- StringBuffer label = new StringBuffer();
- if(prefix!=null) {
- label.append(prefix + KbQuery.PREFIX_SEPARATOR);
+ if(!components[i].isExtended() || checkExtended(components[i], prefix, query, context)) {
+ proposals.add(getProposal(prefix, components[i]));
}
- label.append(components[i].getName());
- proposal.setLabel(label.toString());
-
- IAttribute[] attributes = components[i].getPreferableAttributes();
- StringBuffer attributeSB = new StringBuffer();
- for (int j = 0; j < attributes.length; j++) {
- attributeSB.append(" ").append(attributes[j].getName()).append("=\"\"");
- }
- label.append(attributeSB);
- if(!components[i].canHaveBody()) {
- label.append(" /");
- }
-
- proposal.setReplacementString(label.toString());
-
- int position = proposal.getReplacementString().indexOf('"');
- if(position!=-1) {
- position ++;
- } else {
- position = proposal.getReplacementString().length();
- }
- proposal.setPosition(position);
- proposals.add(proposal);
}
} else {
for (int i = 0; i < components.length; i++) {
@@ -285,6 +281,43 @@
return proposals.toArray(new TextProposal[proposals.size()]);
}
+ protected boolean checkExtended(IComponent component, String prefix, KbQuery query, IPageContext context) {
+ // TODO
+ return false;
+ }
+
+ protected TextProposal getProposal(String prefix, IComponent component) {
+ TextProposal proposal = new TextProposal();
+ proposal.setContextInfo(component.getDescription());
+ StringBuffer label = new StringBuffer();
+ if(prefix!=null) {
+ label.append(prefix + KbQuery.PREFIX_SEPARATOR);
+ }
+ label.append(component.getName());
+ proposal.setLabel(label.toString());
+
+ IAttribute[] attributes = component.getPreferableAttributes();
+ StringBuffer attributeSB = new StringBuffer();
+ for (int j = 0; j < attributes.length; j++) {
+ attributeSB.append(" ").append(attributes[j].getName()).append("=\"\"");
+ }
+ label.append(attributeSB);
+ if(!component.canHaveBody()) {
+ label.append(" /");
+ }
+
+ proposal.setReplacementString(label.toString());
+
+ int position = proposal.getReplacementString().indexOf('"');
+ if(position!=-1) {
+ position ++;
+ } else {
+ position = proposal.getReplacementString().length();
+ }
+ proposal.setPosition(position);
+ return proposal;
+
+ }
/*
* (non-Javadoc)
* @see org.jboss.tools.jst.web.kb.internal.KbObject#clone()
Added: trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/CustomTagLibAttribute.java
===================================================================
--- trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/CustomTagLibAttribute.java (rev 0)
+++ trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/CustomTagLibAttribute.java 2009-06-05 13:35:44 UTC (rev 15731)
@@ -0,0 +1,144 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Red Hat, Inc.
+ * Distributed under license by Red Hat, Inc. All rights reserved.
+ * This program is made available under the terms of the
+ * Eclipse Public License v1.0 which accompanies this distribution,
+ * and is available at http://www.eclipse.org/legal/epl-v10.html
+ *
+ * Contributors:
+ * Red Hat, Inc. - initial API and implementation
+ ******************************************************************************/
+package org.jboss.tools.jst.web.kb.internal.taglib;
+
+/**
+ * @author Alexey Kazakov
+ */
+public class CustomTagLibAttribute extends AbstractAttribute {
+
+ protected boolean extended = true;
+ protected String defaultValue;
+ protected Proposal[] proposals;
+
+ /*
+ * (non-Javadoc)
+ * @see org.jboss.tools.jst.web.kb.taglib.IAttribute#isExtended()
+ */
+ @Override
+ public boolean isExtended() {
+ return extended;
+ }
+
+ /*
+ * (non-Javadoc)
+ * @see org.jboss.tools.jst.web.kb.taglib.IAttribute#setExtended(boolean)
+ */
+ @Override
+ public void setExtended(boolean extended) {
+ this.extended = extended;
+ }
+
+ /**
+ * @return the defaultValue
+ */
+ public String getDefaultValue() {
+ return defaultValue;
+ }
+
+ /**
+ * @param defaultValue the defaultValue to set
+ */
+ public void setDefaultValue(String defaultValue) {
+ this.defaultValue = defaultValue;
+ }
+
+ /**
+ * @return the proposals
+ */
+ public Proposal[] getProposals() {
+ if(proposals==null) {
+ proposals = new Proposal[0];
+ }
+ return proposals;
+ }
+
+ /**
+ * @param proposals the proposals to set
+ */
+ public void setProposals(Proposal[] proposals) {
+ this.proposals = proposals;
+ }
+
+ /**
+ * @author Alexey Kazakov
+ */
+ public static class Proposal {
+
+ private Param[] params;
+ private String type;
+
+ /**
+ * @return the type
+ */
+ public String getType() {
+ return type;
+ }
+
+ /**
+ * @param type the type to set
+ */
+ public void setType(String type) {
+ this.type = type;
+ }
+
+ /**
+ * @return the params
+ */
+ public Param[] getParams() {
+ if(params==null) {
+ params = new Param[0];
+ }
+ return params;
+ }
+
+ /**
+ * @param params the params to set
+ */
+ public void setParams(Param[] params) {
+ this.params = params;
+ }
+ }
+
+ public static class Param {
+
+ private String name;
+ private String value;
+
+ /**
+ * @return the name
+ */
+ public String getName() {
+ return name;
+ }
+
+ /**
+ * @param name the name to set
+ */
+ public void setName(String name) {
+ this.name = name;
+ }
+
+ /**
+ * @return the value
+ */
+ public String getValue() {
+ return value;
+ }
+
+ /**
+ * @param value the value to set
+ */
+ public void setValue(String value) {
+ this.value = value;
+ }
+ }
+}
\ No newline at end of file
Property changes on: trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/CustomTagLibAttribute.java
___________________________________________________________________
Name: svn:mime-type
+ text/plain
Added: trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/CustomTagLibComponent.java
===================================================================
--- trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/CustomTagLibComponent.java (rev 0)
+++ trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/CustomTagLibComponent.java 2009-06-05 13:35:44 UTC (rev 15731)
@@ -0,0 +1,36 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Red Hat, Inc.
+ * Distributed under license by Red Hat, Inc. All rights reserved.
+ * This program is made available under the terms of the
+ * Eclipse Public License v1.0 which accompanies this distribution,
+ * and is available at http://www.eclipse.org/legal/epl-v10.html
+ *
+ * Contributors:
+ * Red Hat, Inc. - initial API and implementation
+ ******************************************************************************/
+package org.jboss.tools.jst.web.kb.internal.taglib;
+
+import org.jboss.tools.jst.web.kb.taglib.ICustomTagLibComponent;
+
+/**
+ * @author Alexey Kazakov
+ */
+public class CustomTagLibComponent extends AbstractComponent implements ICustomTagLibComponent {
+
+ protected boolean extended = true;
+
+ /*
+ * (non-Javadoc)
+ * @see org.jboss.tools.jst.web.kb.taglib.IComponent#isExtended()
+ */
+ public boolean isExtended() {
+ return extended;
+ }
+
+ /**
+ * @param extended
+ */
+ public void setExtended(boolean extended) {
+ this.extended = extended;
+ }
+}
\ No newline at end of file
Property changes on: trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/CustomTagLibComponent.java
___________________________________________________________________
Name: svn:mime-type
+ text/plain
Modified: trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/CustomTagLibrary.java
===================================================================
--- trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/CustomTagLibrary.java 2009-06-05 13:25:00 UTC (rev 15730)
+++ trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/internal/taglib/CustomTagLibrary.java 2009-06-05 13:35:44 UTC (rev 15731)
@@ -13,13 +13,22 @@
import java.io.ByteArrayInputStream;
import java.io.File;
import java.io.IOException;
+import java.util.ArrayList;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.parsers.ParserConfigurationException;
+import org.jboss.tools.jst.web.kb.IPageContext;
+import org.jboss.tools.jst.web.kb.KbQuery;
import org.jboss.tools.jst.web.kb.WebKbPlugin;
+import org.jboss.tools.jst.web.kb.taglib.IComponent;
+import org.jboss.tools.jst.web.kb.taglib.ICustomTagLibComponent;
import org.jboss.tools.jst.web.kb.taglib.ICustomTagLibrary;
+import org.w3c.dom.CharacterData;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.Node;
@@ -33,27 +42,32 @@
*/
public class CustomTagLibrary extends AbstractTagLib implements ICustomTagLibrary {
- private static final String DEFAULT_PREFIX = "defaultPrefix"; //$NON-NLS-1$
- private static final String TAG_LIB = "tag-lib"; //$NON-NLS-1$
- private static final String COMPONENT = "component"; //$NON-NLS-1$
- private static final String CLOSE_TAG = "closeTag"; //$NON-NLS-1$
- private static final String TRUE = "true"; //$NON-NLS-1$
- private static final String NAME = "name"; //$NON-NLS-1$
- private static final String ATTRIBUTE = "attribute"; //$NON-NLS-1$
- private static final String REQUIRED = "required"; //$NON-NLS-1$
- private static final String PROPOSAL = "proposal"; //$NON-NLS-1$
- private static final String TYPE = "type"; //$NON-NLS-1$
- private static final String ENUMERATION = "enumeration"; //$NON-NLS-1$
- private static final String PARAM = "param"; //$NON-NLS-1$
- private static final String VALUE = "value"; //$NON-NLS-1$
- private static final String COMPONET_EXTENSION = "componentExtension"; //$NON-NLS-1$
- private static final String DEFAULT_VALUE = "defaultValue"; //$NON-NLS-1$
- private static final String EXTENDED = "extended"; //$NON-NLS-1$
- private static final String DESCRIPTION = "description"; //$NON-NLS-1$
+ protected static final String DEFAULT_PREFIX = "defaultPrefix"; //$NON-NLS-1$
+ protected static final String TAG_LIB = "tag-lib"; //$NON-NLS-1$
+ protected static final String COMPONENT = "component"; //$NON-NLS-1$
+ protected static final String CLOSE_TAG = "closeTag"; //$NON-NLS-1$
+ protected static final String TRUE = "true"; //$NON-NLS-1$
+ protected static final String NAME = "name"; //$NON-NLS-1$
+ protected static final String ATTRIBUTE = "attribute"; //$NON-NLS-1$
+ protected static final String REQUIRED = "required"; //$NON-NLS-1$
+ protected static final String PROPOSAL = "proposal"; //$NON-NLS-1$
+ protected static final String TYPE = "type"; //$NON-NLS-1$
+ protected static final String ENUMERATION = "enumeration"; //$NON-NLS-1$
+ protected static final String PARAM = "param"; //$NON-NLS-1$
+ protected static final String VALUE = "value"; //$NON-NLS-1$
+ protected static final String COMPONET_EXTENSION = "componentExtension"; //$NON-NLS-1$
+ protected static final String DEFAULT_VALUE = "defaultValue"; //$NON-NLS-1$
+ protected static final String EXTENDED = "extended"; //$NON-NLS-1$
+ protected static final String DESCRIPTION = "description"; //$NON-NLS-1$
+ protected String name;
protected String defaultPrefix;
+ protected CustomTagLibAttribute[] extendedAttributes;
public CustomTagLibrary(File file, String uri, String version, String name) {
+ setURI(uri);
+ setVersion(version);
+ this.name = name;
Document document = null;
try {
DocumentBuilder builder = createDocumentBuilder(false);
@@ -72,17 +86,38 @@
Node child = children.item(i);
if(child instanceof Element) {
if(child.getNodeName().equals(COMPONENT)) {
- parseComponent((Element)child);
+ CustomTagLibComponent component = parseComponent((Element)child);
+ addComponent(component);
} else if (child.getNodeName().equals(COMPONET_EXTENSION)) {
- parseComponentExtension((Element)child);
+ extendedAttributes = getAttributes((Element)child);
}
}
}
}
- private void parseComponent(Element component) {
+ private CustomTagLibComponent parseComponent(Element component) {
String name = component.getAttribute(NAME);
boolean closeTag = TRUE.equalsIgnoreCase(component.getAttribute(CLOSE_TAG));
+ String description = getDescription(component);
+ String extendedStr = component.getAttribute(EXTENDED);
+ Boolean extended = extendedStr==null || extendedStr.length()==0 || TRUE.equals(extendedStr);
+ CustomTagLibComponent newComponent = new CustomTagLibComponent();
+ newComponent.setName(name);
+ newComponent.setCanHaveBody(!closeTag);
+ newComponent.setDescription(description);
+ newComponent.setExtended(extended);
+
+ // Extract attributes
+ CustomTagLibAttribute[] attributes = getAttributes(component);
+ for (int i = 0; i < attributes.length; i++) {
+ newComponent.addAttribute(attributes[i]);
+ }
+
+ return newComponent;
+ }
+
+ protected CustomTagLibAttribute[] getAttributes(Element component) {
+ Set<CustomTagLibAttribute> newAttributes = new HashSet<CustomTagLibAttribute>();
NodeList children = component.getChildNodes();
for (int i = 0; i < children.getLength(); i++) {
Node child = children.item(i);
@@ -91,15 +126,75 @@
Element attribute = (Element)child;
String attributeName = attribute.getAttribute(NAME);
boolean required = TRUE.equalsIgnoreCase(attribute.getAttribute(REQUIRED));
+ CustomTagLibAttribute newAttribute = new CustomTagLibAttribute();
+ newAttribute.setName(attributeName);
+ newAttribute.setRequired(required);
+ String atrDescription = getDescription(attribute);
+ newAttribute.setDescription(atrDescription);
+ String extendedAtrStr = attribute.getAttribute(EXTENDED);
+ Boolean extendedAtr = extendedAtrStr==null || extendedAtrStr.length()==0 || TRUE.equals(extendedAtrStr);
+ newAttribute.setExtended(extendedAtr);
+ String defaultValue = attribute.getAttribute(DEFAULT_VALUE);
+ newAttribute.setDefaultValue(defaultValue);
+ newAttributes.add(newAttribute);
+
+ // Extract proposals
+ List<CustomTagLibAttribute.Proposal> newProposals = new ArrayList<CustomTagLibAttribute.Proposal>();
+ NodeList proposals = attribute.getElementsByTagName(PROPOSAL);
+ for (int j = 0; j < proposals.getLength(); j++) {
+ Element proposal = (Element)proposals.item(j);
+ String type = proposal.getAttribute(TYPE);
+ CustomTagLibAttribute.Proposal newProposal = new CustomTagLibAttribute.Proposal();
+ newProposal.setType(type);
+ newProposals.add(newProposal);
+
+ List<CustomTagLibAttribute.Param> newParams = new ArrayList<CustomTagLibAttribute.Param>();
+ // Extract params
+ NodeList params = proposal.getElementsByTagName(PARAM);
+ for (int c = 0; c < params.getLength(); c++) {
+ Element param = (Element)params.item(c);
+ String paramName = param.getAttribute(NAME);
+ String paramValue = param.getAttribute(VALUE);
+ CustomTagLibAttribute.Param newParam = new CustomTagLibAttribute.Param();
+ if(paramName!=null && paramName.length()>0) {
+ newParam.setName(paramName);
+ }
+ newParam.setValue(paramValue);
+ newParams.add(newParam);
+ }
+ newProposal.setParams(newParams.toArray(new CustomTagLibAttribute.Param[0]));
+ }
+ newAttribute.setProposals(newProposals.toArray(new CustomTagLibAttribute.Proposal[0]));
}
}
}
+ return newAttributes.toArray(new CustomTagLibAttribute[0]);
+ }
- //TODO
+ private String getDescription(Element element) {
+ NodeList list = element.getChildNodes();
+ for(int i=0; i<list.getLength(); i++) {
+ Node node = list.item(i);
+ if(node instanceof Element) {
+ if(DESCRIPTION.equals(node.getNodeName())) {
+ return getElementBody((Element)node);
+ }
+ }
+ }
+ return null;
}
- private void parseComponentExtension(Element extension) {
- //TODO
+ private String getElementBody(Element element) {
+ StringBuffer sb = new StringBuffer();
+ NodeList nl = element.getChildNodes();
+ for (int i = 0; i < nl.getLength(); i++) {
+ Node n = nl.item(i);
+ short nodeType = n.getNodeType();
+ if (nodeType == Node.TEXT_NODE || nodeType == Node.CDATA_SECTION_NODE) {
+ sb.append(((CharacterData)n).getData());
+ }
+ }
+ return sb.toString();
}
private DocumentBuilder createDocumentBuilder(boolean validate) throws ParserConfigurationException {
@@ -120,4 +215,41 @@
}
return documentBuilder;
}
+
+ /**
+ * @return the name
+ */
+ public String getName() {
+ return name;
+ }
+
+ /**
+ * @return the defaultPrefix
+ */
+ public String getDefaultPrefix() {
+ return defaultPrefix;
+ }
+
+ /**
+ * @return the extendedAttributes
+ */
+ public CustomTagLibAttribute[] getExtendedAttributes() {
+ return extendedAttributes;
+ }
+
+ /*
+ * (non-Javadoc)
+ * @see org.jboss.tools.jst.web.kb.taglib.ICustomTagLibrary#getExtendedComponents(org.jboss.tools.jst.web.kb.KbQuery, org.jboss.tools.jst.web.kb.IPageContext)
+ */
+ public Set<ICustomTagLibComponent> getExtendedComponents(KbQuery query, IPageContext context) {
+ Set<ICustomTagLibComponent> set = new HashSet<ICustomTagLibComponent>();
+ IComponent[] components = getComponents(query, context);
+ for (int i = 0; i < components.length; i++) {
+ ICustomTagLibComponent component = (ICustomTagLibComponent)components[i];
+ if(component.isExtended()) {
+ set.add(component);
+ }
+ }
+ return set;
+ }
}
\ No newline at end of file
Modified: trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/CustomTagLibManager.java
===================================================================
--- trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/CustomTagLibManager.java 2009-06-05 13:25:00 UTC (rev 15730)
+++ trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/CustomTagLibManager.java 2009-06-05 13:35:44 UTC (rev 15731)
@@ -22,6 +22,7 @@
import org.eclipse.core.runtime.IExtensionRegistry;
import org.eclipse.core.runtime.Platform;
import org.jboss.tools.jst.web.kb.WebKbPlugin;
+import org.jboss.tools.jst.web.kb.internal.taglib.CustomTagLibAttribute;
import org.jboss.tools.jst.web.kb.internal.taglib.CustomTagLibrary;
import org.osgi.framework.Bundle;
@@ -86,4 +87,9 @@
}
return libs;
}
+
+ public CustomTagLibAttribute[] getComponentExtensions() {
+ //TODO
+ return null;
+ }
}
\ No newline at end of file
Modified: trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/IAttribute.java
===================================================================
--- trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/IAttribute.java 2009-06-05 13:25:00 UTC (rev 15730)
+++ trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/IAttribute.java 2009-06-05 13:35:44 UTC (rev 15731)
@@ -36,4 +36,16 @@
* @return true if the attribute is preferable. E.g. <h:outputText value=""/>
*/
boolean isPreferable();
+
+ /**
+ * Returns "true" if the attribute is relevant only if this attribute exists in other components with the same name in other tag-libs (tld, faclets, ...).
+ * If there are not any other attributes with the same name in the same component in other tag libs then this attribute should be ignored.
+ * @return
+ */
+ boolean isExtended();
+
+ /**
+ * @param extended
+ */
+ void setExtended(boolean extended);
}
\ No newline at end of file
Modified: trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/IComponent.java
===================================================================
--- trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/IComponent.java 2009-06-05 13:25:00 UTC (rev 15730)
+++ trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/IComponent.java 2009-06-05 13:35:44 UTC (rev 15731)
@@ -98,4 +98,11 @@
* @return facet by name
*/
Facet getFacet(String name);
+
+ /**
+ * Returns "true" if the component is relevant only if this component exists in other tag-libs (tld, faclets, ...).
+ * If there are not any other components with the same name in other tag libs then this component should be ignored.
+ * @return
+ */
+ boolean isExtended();
}
\ No newline at end of file
Added: trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/ICustomTagLibComponent.java
===================================================================
--- trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/ICustomTagLibComponent.java (rev 0)
+++ trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/ICustomTagLibComponent.java 2009-06-05 13:35:44 UTC (rev 15731)
@@ -0,0 +1,17 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Red Hat, Inc.
+ * Distributed under license by Red Hat, Inc. All rights reserved.
+ * This program is made available under the terms of the
+ * Eclipse Public License v1.0 which accompanies this distribution,
+ * and is available at http://www.eclipse.org/legal/epl-v10.html
+ *
+ * Contributors:
+ * Red Hat, Inc. - initial API and implementation
+ ******************************************************************************/
+package org.jboss.tools.jst.web.kb.taglib;
+
+/**
+ * @author Alexey Kazakov
+ */
+public interface ICustomTagLibComponent extends IComponent {
+}
\ No newline at end of file
Property changes on: trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/ICustomTagLibComponent.java
___________________________________________________________________
Name: svn:mime-type
+ text/plain
Modified: trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/ICustomTagLibrary.java
===================================================================
--- trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/ICustomTagLibrary.java 2009-06-05 13:25:00 UTC (rev 15730)
+++ trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/ICustomTagLibrary.java 2009-06-05 13:35:44 UTC (rev 15731)
@@ -10,9 +10,20 @@
******************************************************************************/
package org.jboss.tools.jst.web.kb.taglib;
+import java.util.Set;
+
+import org.jboss.tools.jst.web.kb.IPageContext;
+import org.jboss.tools.jst.web.kb.KbQuery;
+
/**
* @author Alexey Kazakov
*/
public interface ICustomTagLibrary extends ITagLibrary {
+ /**
+ * @param query
+ * @param context
+ * @return Components with "extended" flag. See org.jboss.tools.jst.web.kb.taglib.ICustomTagLibComponent#isExtended()
+ */
+ Set<ICustomTagLibComponent> getExtendedComponents(KbQuery query, IPageContext context);
}
\ No newline at end of file
Modified: trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/ITagLibrary.java
===================================================================
--- trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/ITagLibrary.java 2009-06-05 13:25:00 UTC (rev 15730)
+++ trunk/jst/plugins/org.jboss.tools.jst.web.kb/src/org/jboss/tools/jst/web/kb/taglib/ITagLibrary.java 2009-06-05 13:35:44 UTC (rev 15731)
@@ -22,18 +22,27 @@
*/
public interface ITagLibrary extends IProposalProcessor {
+ /**
+ * @return source path
+ */
public IPath getSourcePath();
/**
* @return name space
*/
INameSpace getDefaultNameSpace();
+
/**
* @return URI of the tag lib.
*/
String getURI();
/**
+ * @return version of the tag lib.
+ */
+ String getVersion();
+
+ /**
* @return resource of this tag lib.
*/
IResource getResource();
@@ -62,6 +71,10 @@
*/
public IComponent[] getComponents(KbQuery query, IPageContext context);
+ /**
+ * Clone the lib
+ * @return
+ * @throws CloneNotSupportedException
+ */
public ITagLibrary clone() throws CloneNotSupportedException;
-
-}
+}
\ No newline at end of file
15 years, 6 months
- 1
- 0
JBoss Tools SVN: r15730 - in trunk/seam/plugins: org.jboss.tools.seam.ui/src/org/jboss/tools/seam/ui/wizard and 1 other directory.
by jbosstools-commits＠lists.jboss.org
Author: dazarov
Date: 2009-06-05 09:25:00 -0400 (Fri, 05 Jun 2009)
New Revision: 15730
Modified:
trunk/seam/plugins/org.jboss.tools.seam.core/src/org/jboss/tools/seam/internal/core/refactoring/RenameSeamContextVariableProcessor.java
trunk/seam/plugins/org.jboss.tools.seam.core/src/org/jboss/tools/seam/internal/core/refactoring/SeamRenameProcessor.java
trunk/seam/plugins/org.jboss.tools.seam.ui/src/org/jboss/tools/seam/ui/wizard/RenameComponentWizard.java
trunk/seam/plugins/org.jboss.tools.seam.ui/src/org/jboss/tools/seam/ui/wizard/RenameSeamContextVariableWizard.java
Log:
Rename Seam Context Variable https://jira.jboss.org/jira/browse/JBIDE-1077
Modified: trunk/seam/plugins/org.jboss.tools.seam.core/src/org/jboss/tools/seam/internal/core/refactoring/RenameSeamContextVariableProcessor.java
===================================================================
--- trunk/seam/plugins/org.jboss.tools.seam.core/src/org/jboss/tools/seam/internal/core/refactoring/RenameSeamContextVariableProcessor.java 2009-06-05 12:33:49 UTC (rev 15729)
+++ trunk/seam/plugins/org.jboss.tools.seam.core/src/org/jboss/tools/seam/internal/core/refactoring/RenameSeamContextVariableProcessor.java 2009-06-05 13:25:00 UTC (rev 15730)
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2008 Red Hat, Inc.
+ * Copyright (c) 2009 Red Hat, Inc.
* Distributed under license by Red Hat, Inc. All rights reserved.
* This program is made available under the terms of the
* Eclipse Public License v1.0 which accompanies this distribution,
@@ -25,6 +25,7 @@
import org.eclipse.ltk.core.refactoring.participants.RefactoringParticipant;
import org.eclipse.ltk.core.refactoring.participants.SharableParticipants;
import org.jboss.tools.seam.core.ISeamComponent;
+import org.jboss.tools.seam.core.ISeamFactory;
import org.jboss.tools.seam.core.ISeamJavaComponentDeclaration;
import org.jboss.tools.seam.core.ISeamProject;
import org.jboss.tools.seam.core.SeamCoreMessages;
@@ -34,13 +35,13 @@
* @author Daniel Azarov
*/
public class RenameSeamContextVariableProcessor extends SeamRenameProcessor {
-
+ IFile file;
/**
* @param component Renamed component
*/
public RenameSeamContextVariableProcessor(IFile file, String oldName) {
super();
- declarationFile = file;
+ this.file = file;
setOldName(oldName);
}
@@ -81,30 +82,45 @@
ISeamComponent component = checkComponent();
if(component != null)
renameComponent(component);
+ else{
+ Set<ISeamFactory> factories = checkFactories();
+ if(factories != null)
+ renameFactories(factories);
+ }
return rootChange;
}
private ISeamComponent checkComponent(){
- IProject project = declarationFile.getProject();
+ IProject project = file.getProject();
ISeamProject seamProject = SeamCorePlugin.getSeamProject(project, true);
if (seamProject != null) {
- Set<ISeamComponent> components = seamProject.getComponentsByPath(declarationFile.getFullPath());
- for(ISeamComponent component : components){
- ISeamJavaComponentDeclaration declaration = component.getJavaDeclaration();
- if(declaration != null){
- IResource resource = declaration.getResource();
- if(resource != null && resource.getFullPath().equals(declarationFile.getFullPath())){
- if(declaration.getName().equals(component.getName())){
- return component;
- }
- }
- }
- }
+ return seamProject.getComponent(getOldName());
+// Set<ISeamComponent> components = seamProject.getComponentsByPath(file.getFullPath());
+// for(ISeamComponent component : components){
+// ISeamJavaComponentDeclaration declaration = component.getJavaDeclaration();
+// if(declaration != null){
+// IResource resource = declaration.getResource();
+// if(resource != null && resource.getFullPath().equals(file.getFullPath())){
+// if(declaration.getName().equals(component.getName())){
+// return component;
+// }
+// }
+// }
+// }
}
return null;
}
+ private Set<ISeamFactory> checkFactories(){
+ IProject project = file.getProject();
+ ISeamProject seamProject = SeamCorePlugin.getSeamProject(project, true);
+ if (seamProject != null) {
+ return seamProject.getFactoriesByName(getOldName());
+ }
+ return null;
+ }
+
/*
* (non-Javadoc)
* @see org.eclipse.ltk.core.refactoring.participants.RefactoringProcessor#getElements()
Modified: trunk/seam/plugins/org.jboss.tools.seam.core/src/org/jboss/tools/seam/internal/core/refactoring/SeamRenameProcessor.java
===================================================================
--- trunk/seam/plugins/org.jboss.tools.seam.core/src/org/jboss/tools/seam/internal/core/refactoring/SeamRenameProcessor.java 2009-06-05 12:33:49 UTC (rev 15729)
+++ trunk/seam/plugins/org.jboss.tools.seam.core/src/org/jboss/tools/seam/internal/core/refactoring/SeamRenameProcessor.java 2009-06-05 13:25:00 UTC (rev 15730)
@@ -1,3 +1,13 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Red Hat, Inc.
+ * Distributed under license by Red Hat, Inc. All rights reserved.
+ * This program is made available under the terms of the
+ * Eclipse Public License v1.0 which accompanies this distribution,
+ * and is available at http://www.eclipse.org/legal/epl-v10.html
+ *
+ * Contributors:
+ * Red Hat, Inc. - initial API and implementation
+ ******************************************************************************/
package org.jboss.tools.seam.internal.core.refactoring;
import java.io.IOException;
@@ -57,6 +67,9 @@
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;
+/**
+ * @author Daniel Azarov
+ */
public abstract class SeamRenameProcessor extends RenameProcessor {
protected static final String JAVA_EXT = "java"; //$NON-NLS-1$
protected static final String XML_EXT = "xml"; //$NON-NLS-1$
@@ -171,26 +184,30 @@
Set<ISeamFactory> factorySet = seamProject.getFactoriesByName(getOldName());
for(ISeamFactory factory : factorySet){
- IFile file = (IFile)factory.getResource();
- if(file.getFileExtension().equalsIgnoreCase(JAVA_EXT)){
- ITextSourceReference location = factory.getLocationFor(SeamAnnotations.FACTORY_ANNOTATION_TYPE);
- if(location != null){
- if(!files.contains(file.getFullPath())){
- files.add(file.getFullPath());
- changeAnnotation(location, file);
- }else if(force)
- changeAnnotation(location, file);
- }
- }else{
- ITextSourceReference location = factory.getLocationFor(ISeamXmlComponentDeclaration.NAME);
- if(location != null){
- if(!files.contains(file.getFullPath())){
- files.add(file.getFullPath());
- changeXMLNode(location, file);
- }else if(force)
- changeXMLNode(location, file);
- }
+ changeFactory(factory, force);
+ }
+ }
+
+ private void changeFactory(ISeamFactory factory, boolean force){
+ IFile file = (IFile)factory.getResource();
+ if(file.getFileExtension().equalsIgnoreCase(JAVA_EXT)){
+ ITextSourceReference location = factory.getLocationFor(SeamAnnotations.FACTORY_ANNOTATION_TYPE);
+ if(location != null){
+ if(!files.contains(file.getFullPath())){
+ files.add(file.getFullPath());
+ changeAnnotation(location, file);
+ }else if(force)
+ changeAnnotation(location, file);
}
+ }else{
+ ITextSourceReference location = factory.getLocationFor(ISeamXmlComponentDeclaration.NAME);
+ if(location != null){
+ if(!files.contains(file.getFullPath())){
+ files.add(file.getFullPath());
+ changeXMLNode(location, file);
+ }else if(force)
+ changeXMLNode(location, file);
+ }
}
}
@@ -517,4 +534,12 @@
findELReferences();
}
+
+ protected void renameFactories(Set<ISeamFactory> factories){
+ for(ISeamFactory factory : factories){
+ changeFactory(factory, true);
+ }
+
+ findELReferences();
+ }
}
Modified: trunk/seam/plugins/org.jboss.tools.seam.ui/src/org/jboss/tools/seam/ui/wizard/RenameComponentWizard.java
===================================================================
--- trunk/seam/plugins/org.jboss.tools.seam.ui/src/org/jboss/tools/seam/ui/wizard/RenameComponentWizard.java 2009-06-05 12:33:49 UTC (rev 15729)
+++ trunk/seam/plugins/org.jboss.tools.seam.ui/src/org/jboss/tools/seam/ui/wizard/RenameComponentWizard.java 2009-06-05 13:25:00 UTC (rev 15730)
@@ -39,7 +39,7 @@
import org.jboss.tools.seam.ui.widget.editor.IFieldEditorFactory;
/**
- * @author Alexey Kazakov
+ * @author Alexey Kazakov, Daniel Azarov
*/
public class RenameComponentWizard extends RefactoringWizard {
Modified: trunk/seam/plugins/org.jboss.tools.seam.ui/src/org/jboss/tools/seam/ui/wizard/RenameSeamContextVariableWizard.java
===================================================================
--- trunk/seam/plugins/org.jboss.tools.seam.ui/src/org/jboss/tools/seam/ui/wizard/RenameSeamContextVariableWizard.java 2009-06-05 12:33:49 UTC (rev 15729)
+++ trunk/seam/plugins/org.jboss.tools.seam.ui/src/org/jboss/tools/seam/ui/wizard/RenameSeamContextVariableWizard.java 2009-06-05 13:25:00 UTC (rev 15730)
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2008 Red Hat, Inc.
+ * Copyright (c) 2009 Red Hat, Inc.
* Distributed under license by Red Hat, Inc. All rights reserved.
* This program is made available under the terms of the
* Eclipse Public License v1.0 which accompanies this distribution,
@@ -42,11 +42,10 @@
import org.jboss.tools.seam.ui.widget.editor.IFieldEditorFactory;
/**
- * @author Alexey Kazakov
+ * @author Daniel Azarov
*/
public class RenameSeamContextVariableWizard extends RefactoringWizard {
- //private ISeamComponent component;
private String componentName;
private IFieldEditor editor;
private ISeamProject seamProject;
@@ -63,13 +62,13 @@
protected void addUserInputPages() {
setDefaultPageTitle(getRefactoring().getName());
RenameSeamContextVariableProcessor processor= (RenameSeamContextVariableProcessor) getRefactoring().getAdapter(RenameSeamContextVariableProcessor.class);
- addPage(new RenameComponentWizardPage(processor));
+ addPage(new RenameSeamContextVariableWizardPage(processor));
}
- class RenameComponentWizardPage extends UserInputWizardPage{
+ class RenameSeamContextVariableWizardPage extends UserInputWizardPage{
private SeamRenameProcessor processor;
- public RenameComponentWizardPage(SeamRenameProcessor processor){
+ public RenameSeamContextVariableWizardPage(SeamRenameProcessor processor){
super("");
this.processor = processor;
}
15 years, 6 months
- 1
- 0