Author: irooskov(a)redhat.com
Date: 2010-01-20 17:13:38 -0500 (Wed, 20 Jan 2010)
New Revision: 19834
Added:
trunk/documentation/guides/Beginners_Guide/en-US/
trunk/documentation/guides/Beginners_Guide/en-US/Author_Group.xml
trunk/documentation/guides/Beginners_Guide/en-US/Beginners_Guide.ent
trunk/documentation/guides/Beginners_Guide/en-US/Beginners_Guide.xml
trunk/documentation/guides/Beginners_Guide/en-US/Book_Info.xml
trunk/documentation/guides/Beginners_Guide/en-US/Feedback.xml
trunk/documentation/guides/Beginners_Guide/en-US/Introduction.xml
trunk/documentation/guides/Beginners_Guide/en-US/Java_Web_(EE)_and_Standard_Edition_(SE).xml
trunk/documentation/guides/Beginners_Guide/en-US/Preface.xml
trunk/documentation/guides/Beginners_Guide/en-US/Revision_History.xml
trunk/documentation/guides/Beginners_Guide/en-US/SOA-P_Workshop.xml
trunk/documentation/guides/Beginners_Guide/en-US/Service-Oriented_Architecture_Development.xml
trunk/documentation/guides/Beginners_Guide/en-US/The_interface.xml
trunk/documentation/guides/Beginners_Guide/en-US/Where_to_go_from_here.xml
trunk/documentation/guides/Beginners_Guide/en-US/images/
trunk/documentation/guides/Beginners_Guide/en-US/images/Drools_code_rule_editor.png
trunk/documentation/guides/Beginners_Guide/en-US/images/Drools_rete_rule_editor.png
trunk/documentation/guides/Beginners_Guide/en-US/images/ESB_Editor.png
trunk/documentation/guides/Beginners_Guide/en-US/images/Eclipse_main.png
trunk/documentation/guides/Beginners_Guide/en-US/images/Eclipse_welcome_screen.png
trunk/documentation/guides/Beginners_Guide/en-US/images/Eclipse_workspace.png
trunk/documentation/guides/Beginners_Guide/en-US/images/Guvnor_connection_wizard.png
trunk/documentation/guides/Beginners_Guide/en-US/images/Guvnor_copy_file.png
trunk/documentation/guides/Beginners_Guide/en-US/images/Guvnor_repository.png
trunk/documentation/guides/Beginners_Guide/en-US/images/Guvnor_resource_history_view.png
trunk/documentation/guides/Beginners_Guide/en-US/images/JBoss_AS_Overview.png
trunk/documentation/guides/Beginners_Guide/en-US/images/JBoss_AS_localhost.png
trunk/documentation/guides/Beginners_Guide/en-US/images/JSF_diagram_view.png
trunk/documentation/guides/Beginners_Guide/en-US/images/JSF_source_view.png
trunk/documentation/guides/Beginners_Guide/en-US/images/JSF_tree_view.png
trunk/documentation/guides/Beginners_Guide/en-US/images/Server_Started.png
trunk/documentation/guides/Beginners_Guide/en-US/images/Start_Stop_Server.png
trunk/documentation/guides/Beginners_Guide/en-US/images/View_Button.png
trunk/documentation/guides/Beginners_Guide/en-US/images/Web_Services_Using_Document.png
trunk/documentation/guides/Beginners_Guide/en-US/images/Web_Services_Wizard.png
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Archive_Tools-Archive_Tools.png
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Hibernate_Tools-Hibernate_Console.png
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-JBoss_AS_Tools-JBoss_Server_View.png
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-JMX_Tools-MBean_Editor.png
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-JMX_Tools-MBean_Explorer.png
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Portal_Tools-Dynamic_Web_Project_wizard.png
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Seam_Development_Tools-New_Seam_Project_wizard.png
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Seam_Development_Tools-Seam_Components_Editor.png
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Seam_Development_Tools-Seam_Pages_Editor_graphical_view.png
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Visual_Web_Tools-Content_Assist.png
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Visual_Web_Tools-JBoss_Tools_Palette.png
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Visual_Web_Tools-Visual_Page_Editor.png
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Visual_Web_Tools-Web_Projects_View_for_JSF_left_and_Struts_right_projects.png
trunk/documentation/guides/Beginners_Guide/en-US/master.xml
Log:
adding en-US directory
Added: trunk/documentation/guides/Beginners_Guide/en-US/Author_Group.xml
===================================================================
--- trunk/documentation/guides/Beginners_Guide/en-US/Author_Group.xml
(rev 0)
+++ trunk/documentation/guides/Beginners_Guide/en-US/Author_Group.xml 2010-01-20 22:13:38
UTC (rev 19834)
@@ -0,0 +1,26 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+<authorgroup>
+ <author>
+ <firstname>Isaac</firstname>
+ <surname>Rooskov</surname>
+ <email>irooskov(a)redhat.com</email>
+ </author>
+ <author>
+ <firstname>Sean</firstname>
+ <surname>Rogers</surname>
+ <email>serogers(a)redhat.com</email>
+ </author>
+ <editor>
+ <firstname>Andrew</firstname>
+ <surname>Ross</surname>
+ <email>anross(a)redhat.com</email>
+ </editor>
+ <editor>
+ <firstname>Max</firstname>
+ <surname>Andersen</surname>
+ <email>max.andersen(a)redhat.com</email>
+ </editor>
+</authorgroup>
+
Added: trunk/documentation/guides/Beginners_Guide/en-US/Beginners_Guide.ent
===================================================================
--- trunk/documentation/guides/Beginners_Guide/en-US/Beginners_Guide.ent
(rev 0)
+++ trunk/documentation/guides/Beginners_Guide/en-US/Beginners_Guide.ent 2010-01-20
22:13:38 UTC (rev 19834)
@@ -0,0 +1,4 @@
+<!ENTITY PRODUCT "JBoss">
+<!ENTITY BOOKID "Beginners_Guide">
+<!ENTITY YEAR "2009">
+<!ENTITY HOLDER "Red Hat">
Added: trunk/documentation/guides/Beginners_Guide/en-US/Beginners_Guide.xml
===================================================================
--- trunk/documentation/guides/Beginners_Guide/en-US/Beginners_Guide.xml
(rev 0)
+++ trunk/documentation/guides/Beginners_Guide/en-US/Beginners_Guide.xml 2010-01-20
22:13:38 UTC (rev 19834)
@@ -0,0 +1,15 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+<book>
+ <xi:include href="Book_Info.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Preface.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Introduction.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="The_interface.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Java_Web_(EE)_and_Standard_Edition_(SE).xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Service-Oriented_Architecture_Development.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Where_to_go_from_here.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Revision_History.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <!-- <index /> -->
+</book>
+
Added: trunk/documentation/guides/Beginners_Guide/en-US/Book_Info.xml
===================================================================
--- trunk/documentation/guides/Beginners_Guide/en-US/Book_Info.xml
(rev 0)
+++ trunk/documentation/guides/Beginners_Guide/en-US/Book_Info.xml 2010-01-20 22:13:38 UTC
(rev 19834)
@@ -0,0 +1,28 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+<bookinfo id="book-Beginners_Guide-Beginners_Guide">
+ <title>Beginners Guide</title>
+ <subtitle>Provides information about the use of <application>JBoss Tools
</application>and the <application>JBoss Developer Studio</application>
from a beginners level.</subtitle>
+ <productname>JBoss Developer Studio</productname>
+ <productnumber>3.0</productnumber>
+ <edition>1.0</edition>
+ <pubsnumber>7</pubsnumber>
+ <abstract>
+ <para>
+The Beginners Guide brings all concepts pertaining to <application>JBoss
Tools</application> and the <application>JBoss Developer
Studio</application> back to basics. It is intended for individuals who
may be
+new to application servers and the creation of applications for
+deployment.
+</para>
+ </abstract>
+ <corpauthor>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="Common_Content/images/title_logo.svg"
format="SVG" />
+ </imageobject>
+ </inlinemediaobject>
+ </corpauthor>
+ <xi:include href="Common_Content/Legal_Notice.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Author_Group.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+</bookinfo>
+
Added: trunk/documentation/guides/Beginners_Guide/en-US/Feedback.xml
===================================================================
--- trunk/documentation/guides/Beginners_Guide/en-US/Feedback.xml
(rev 0)
+++ trunk/documentation/guides/Beginners_Guide/en-US/Feedback.xml 2010-01-20 22:13:38 UTC
(rev 19834)
@@ -0,0 +1,20 @@
+<?xml version='1.0' encoding='utf-8' ?>
+
+<section id="sect-Beginners_Guide-We_Need_Feedback"
lang="en-US">
+ <title>We Need Feedback!</title>
+ <indexterm>
+ <primary>feedback</primary>
+ <secondary>contact information for this manual</secondary>
+ </indexterm>
+ <para>
+ If you find a typographical error in this manual, or if you have thought of a way to
make this manual better, we would love to hear from you! Please submit a report in JIRA
agaist JBoss Tools for the community: <ulink
url="https://jira.jboss.org/jira/browse/JBIDE">https://jira....
or JBoss Developer Studio for the enterprise: <ulink
url="https://jira.jboss.org/jira/browse/JBDS">https://jira.j...
+ </para>
+ <para>
+ When submitting a bug report, be sure to mention the manual's name.
+ </para>
+ <para>
+ If you have a suggestion for improving the documentation, try to be as specific as
possible when describing it. If you have found an error, please include the section number
and some of the surrounding text so we can find it easily.
+ </para>
+</section>
+
+
Added: trunk/documentation/guides/Beginners_Guide/en-US/Introduction.xml
===================================================================
--- trunk/documentation/guides/Beginners_Guide/en-US/Introduction.xml
(rev 0)
+++ trunk/documentation/guides/Beginners_Guide/en-US/Introduction.xml 2010-01-20 22:13:38
UTC (rev 19834)
@@ -0,0 +1,12 @@
+<?xml version='1.0' encoding='utf-8' ?>
+
+<chapter id="chap-Beginners_Guide-Introduction">
+ <title>Introduction</title>
+ <para>
+ The <application>JBoss Tools</application> and <application>JBoss
Developer Studio</application> tools suites are designed to assist with the
development of applications and services for JBoss Middleware software. These tools have
been developed and are used by developers to increase their efficiency and productivity
with JBoss software offerings (be it community or enterprise offerings).
+ </para>
+ <para>
+ This beginners guide covers the basics of the interface you will be working with and
the tools within it, assuming as little knowledge on your side as possible. If you are not
familiar with <application>JBoss Tools</application> or
<application>JBoss Developer Studio</application> then this guide provides the
best place to begin.
+ </para>
+</chapter>
+
Added:
trunk/documentation/guides/Beginners_Guide/en-US/Java_Web_(EE)_and_Standard_Edition_(SE).xml
===================================================================
---
trunk/documentation/guides/Beginners_Guide/en-US/Java_Web_(EE)_and_Standard_Edition_(SE).xml
(rev 0)
+++
trunk/documentation/guides/Beginners_Guide/en-US/Java_Web_(EE)_and_Standard_Edition_(SE).xml 2010-01-20
22:13:38 UTC (rev 19834)
@@ -0,0 +1,646 @@
+<?xml version='1.0' encoding='utf-8' ?>
+
+<chapter
id="chap-Beginners_Guide-Java_Web_EE_and_Standard_Edition_SE_Plug_Ins">
+ <title>Java Web (EE) and Standard Edition (SE) Plug-Ins</title>
+ <para>
+ This chapter covers the Java plug-ins included with <application>JBoss
Tools</application> and the <application>JBoss Developer
Studio</application>.
+ </para>
+ <section
id="sect-Beginners_Guide-Java_Web_EE_and_Standard_Edition_SE_Plug_Ins-Visual_Web_Tools">
+ <title>Visual Web Tools</title>
+ <para>
+ The Visual Web Tools consist of a number of features designed to aid in the
development of web pages and web projects.
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>Visual Page Editor</term>
+ <listitem>
+ <para>
+ The Visual Page Editor allows an application to be developed alongside a visual
preview. The application can be viewed either as the source code, as a preview of the
application, or both simultaneously in a split-screen presentation. The Visual Page Editor
can be used for developing an application using technologies such as JavaServer Faces
(<acronym>JSF</acronym>), JavaServer Pages
(<acronym>JSP</acronym>), Struts, and Hypertext Markup Language
(<acronym>HTML</acronym>). The Visual Page Editor also features a graphical
toolbar for in-line styling.
+ </para>
+ <figure
id="figu-Beginners_Guide-Visual_Web_Tools-Visual_Page_Editor">
+ <title>Visual Page Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/figu-Beginners_Guide-Visual_Web_Tools-Visual_Page_Editor.png"
format="PNG" width="444" />
+ </imageobject>
+ <textobject>
+ <phrase>
+ The Visual Page Editor, showing both the source and a visual preview
simultaneously.
+ </phrase>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Refer to the <citetitle pubwork="chapter">Editors</citetitle>
chapter of <citetitle pubwork="book">Visual Web Tools Reference
Guide</citetitle> for full details.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>JBoss Tools Palette</term>
+ <listitem>
+ <para>
+ The JBoss Tools Palette provides access to tag libraries for creating
<acronym>JSP</acronym> and <acronym>JSF</acronym> pages. Tags can
be quickly inserted into pages from a number of included libraries:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <acronym>HTML</acronym>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ JBoss
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <acronym>JSF</acronym>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <acronym>JSTL</acronym> (<acronym>JSP</acronym> Standard
Tag Library)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ MyFaces
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Oracle <acronym>ADF</acronym> (Application Development Framework)
Faces
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Struts
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <acronym>XHTML</acronym> (Extensible Hypertext Markup Language)
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ Custom-made tags and third-party tag libraries can also be included in the JBoss
Tools Palette.
+ </para>
+ <figure
id="figu-Beginners_Guide-Visual_Web_Tools-JBoss_Tools_Palette">
+ <title>JBoss Tools Palette</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/figu-Beginners_Guide-Visual_Web_Tools-JBoss_Tools_Palette.png"
format="PNG" />
+ </imageobject>
+ <textobject>
+ <para>
+ The JBoss Tools Palette, with a number of standard libraries loaded.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Refer to the <citetitle pubwork="chapter">JBoss Tools
Palette</citetitle> chapter of <citetitle pubwork="book">Visual Web
Tools Reference Guide</citetitle> for full details.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Web Projects View</term>
+ <listitem>
+ <para>
+ The Web Projects View is an additional view for <application>JBoss
Tools</application> and the <application>JBoss Developer
Studio</application>. It enhances project authoring with a number of features:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Project artifacts for <acronym>JSF</acronym> and Struts projects are
organized by function, allowing for better project visualization.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Selected items can be dragged and dropped into <acronym>JSP</acronym>
pages:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <acronym>JSF</acronym> managed bean attributes
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <acronym>JSF</acronym> navigation rule outcomes
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Property file values
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Tag library files
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Tags from tag libraries
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <acronym>JSP</acronym> page links
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>
+ Context menus can be used to speed up application authoring.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <acronym>JSF</acronym> and Struts projects can be quickly created or
imported from the shortcut buttons.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Tag library files can be expanded, inspected, and easily added to the JBoss Tools
Palette.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <figure
id="figu-Beginners_Guide-Visual_Web_Tools-Web_Projects_View_for_JSF_left_and_Struts_right_projects">
+ <title>Web Projects View for <acronym>JSF</acronym> (left) and
Struts (right) projects</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/figu-Beginners_Guide-Visual_Web_Tools-Web_Projects_View_for_JSF_left_and_Struts_right_projects.png"
format="PNG" width="444" />
+ </imageobject>
+ <textobject>
+ <para>
+ The Web Projects View, showing a <acronym>JSF</acronym> project on
the left and a Struts project on the right.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Refer to the <citetitle pubwork="chapter">Web Projects
View</citetitle> chapter of <citetitle pubwork="book">Visual Web
Tools Reference Guide</citetitle> for full details.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>OpenOn</term>
+ <listitem>
+ <para>
+ OpenOn provides an easy method to switch directly from one resource to another in
the project without navigating through the <guilabel>Package
Explorer</guilabel> view. Pressing <keycap>F3</keycap> or
<keycombo><keycap>Ctrl</keycap><mousebutton>click</mousebutton></keycombo>
when a reference to another file is highlighted will open the file in the editor.
+ </para>
+ <para>
+ Refer to the <citetitle pubwork="chapter">Editors</citetitle>
chapter of <citetitle pubwork="book">Visual Web Tools Reference
Guide</citetitle> for full details.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Content Assist</term>
+ <listitem>
+ <para>
+ Content Assist displays context-specific code completion suggestions while typing,
speeding up development and reducing typing errors. Content Assist is supported in a
number of contexts:
+ </para>
+ <para>
+ The suggestion list can be displayed by pressing
<keycombo><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo>,
and the highlighted entry can be selected and inserted by pressing
<keycap>Enter</keycap>.
+ </para>
+ <figure id="figu-Beginners_Guide-Visual_Web_Tools-Content_Assist">
+ <title>Content Assist</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/figu-Beginners_Guide-Visual_Web_Tools-Content_Assist.png"
format="PNG" width="444" />
+ </imageobject>
+ <textobject>
+ <para>
+ Content Assist with <acronym>JSF</acronym> code completion
suggestions.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Refer to the <citetitle pubwork="chapter">Editors</citetitle>
chapter of <citetitle pubwork="book">Visual Web Tools Reference
Guide</citetitle> for full details.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Drag-and-Drop</term>
+ <listitem>
+ <para>
+ Properties, managed bean attributes, navigation rules, tag library file
declarations, and <acronym>JSP</acronym> pages can all be dragged from the
<guilabel>Web Projects</guilabel> view and dropped into the editor to add
content.
+ </para>
+ <para>
+ Refer to the <citetitle pubwork="chapter">Web Projects
View</citetitle> chapter of <citetitle pubwork="book">Visual Web
Tools Reference Guide</citetitle> for full details.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>RichFaces Support</term>
+ <listitem>
+ <para>
+ The RichFaces framework is tightly integrated with <application>JBoss
Tools</application> and the <application>JBoss Developer
Studio</application>. RichFaces and Ajax4jsf tag libraries can be used in the JBoss
Tools Palette, and RichFaces components are rendered in the Visual Page Editor.
+ </para>
+ <para>
+ Refer to the <citetitle pubwork="chapter">Editors</citetitle>
chapter of <citetitle pubwork="book">Visual Web Tools Reference
Guide</citetitle> for full details.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+
+ <section
id="sect-Beginners_Guide-Java_Web_EE_and_Standard_Edition_SE_Plug_Ins-Seam_Development_Tools">
+ <title>Seam Development Tools</title>
+ <para>
+ <application>JBoss Seam</application> is an application framework that
simplifies the development of Web 2.0 applications. It combines several technologies to
reduce the complexity of developing modern web applications:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Enterprise Java Beans (<acronym>EJB3</acronym>)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ JavaServer Faces (<acronym>JSF</acronym>)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Asynchronous JavaScript and <acronym>XML</acronym> (Ajax)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Java Portlets
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Business Process Management (<acronym>BPM</acronym>)
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <application>Seam</application> provides an interface to these different
technologies through simple <emphasis>Plain Old Java Objects</emphasis>
(<acronym>POJO</acronym>), user interface components, and
<acronym>XML</acronym>. <application>Seam</application> does not
distinguish between presentation-tier components and business logic components in an
effort to present a simple, unified component model for the Java Enterprise Edition
platform. Seam also provides mechanisms to manage application states across multiple
workspaces, methods to manage workflow and pageflow through
<acronym>jBPM</acronym>, and comprehensive integrated testing features.
+ </para>
+ <para>
+ The Seam Development Tools in <application>JBoss Tools</application> and
the <application>JBoss Developer Studio</application> allow for easy
<application>Seam</application> application development:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>New Seam Project wizard</term>
+ <listitem>
+ <para>
+ The New Seam Project wizard allows the details of the Seam project to be
configured, including target runtimes, target servers, project facets, and web module
settings, then generates all the necessary files for a Seam project.
+ </para>
+ <figure
id="figu-Beginners_Guide-Seam_Development_Tools-New_Seam_Project_wizard">
+ <title>New Seam Project wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/figu-Beginners_Guide-Seam_Development_Tools-New_Seam_Project_wizard.png"
format="PNG" />
+ </imageobject>
+ <textobject>
+ <para>
+ The New Seam Project wizard, used to configure a Seam project.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Other Seam wizards</term>
+ <listitem>
+ <para>
+ Wizards are also included for creating new Seam Actions, new Seam Forms, new Seam
Conversations, and new Seam Entities.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Entity generation</term>
+ <listitem>
+ <para>
+ Another wizard exists for generating Seam entities. The wizard produces a set of
<acronym>CRUD</acronym> (create-read-update-delete) Seam components and web
pages. These can be generated by reverse-engineering an existing database, or by using
existing entities in the application.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Editors and views</term>
+ <listitem>
+ <para>
+ There are a number of editors available in <application>JBoss
Tools</application> and the <application>JBoss Developer
Studio</application> for working with Seam in addition to the Visual Page Editor:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>Seam Pages Editor</term>
+ <listitem>
+ <para>
+ The Seam Pages Editor is used for editing the
<filename>pages.xml</filename> file. The file can be edited through three
different views:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ the graphical view, which diagrammatically represents the project page-flow
and exception handling;
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ the tree view, which lists the elements and attributes of the
<filename>pages.xml</filename> file in a hierarchical tree for simplified
editing;
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ and the source view, which allows direct editing of the
<filename>pages.xml</filename> source.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <figure
id="figu-Beginners_Guide-Seam_Development_Tools-Seam_Pages_Editor_graphical_view">
+ <title>Seam Pages Editor (graphical view)</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/figu-Beginners_Guide-Seam_Development_Tools-Seam_Pages_Editor_graphical_view.png"
format="PNG" width="444" />
+ </imageobject>
+ <textobject>
+ <para>
+ The graphical view of the Seam Pages Editor, representing the project
page-flow and exception handling.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Seam Components Editor</term>
+ <listitem>
+ <para>
+ The Seam Components Editor is used for editing the
<filename>components.xml</filename> file. The file can be edited through two
views, the tree view and the source view, which operate similarly to the views in the Seam
Pages Editor.
+ </para>
+ <figure
id="figu-Beginners_Guide-Seam_Development_Tools-Seam_Components_Editor">
+ <title>Seam Components Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/figu-Beginners_Guide-Seam_Development_Tools-Seam_Components_Editor.png"
format="PNG" width="444" />
+ </imageobject>
+ <textobject>
+ <para>
+ The Seam Components Editor, displaying the components in a hierarchical
tree.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>
+ The Seam Editors feature Content Assist and OpenOn; for more details on these
technologies refer to <xref
linkend="sect-Beginners_Guide-Java_Web_EE_and_Standard_Edition_SE_Plug_Ins-Visual_Web_Tools"
/>. Seam Editors also feature validation tools to highlight potential issues with the
application.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><acronym>CRUD</acronym> database applications</term>
+ <listitem>
+ <para>
+ <acronym>CRUD</acronym> refers to the four basic
<acronym>SQL</acronym> commands: <code>create</code>,
<code>read</code>, <code>update</code>, and
<code>delete</code>. A <acronym>CRUD</acronym> database
application uses forms to retrieve data from and submit data to a database.
+ </para>
+ <para>
+ <acronym>CRUD</acronym> database applications can be created through
the New Seam Project wizard.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>TestNG</term>
+ <listitem>
+ <para>
+ TestNG (<emphasis>Testing, the Next Generation</emphasis>) is a
Java-based unit testing framework. TestNG suites can be added to a project through the New
Seam Action wizard.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>
+ Refer to the <citetitle pubwork="book">Seam Development Tools
Reference Guide</citetitle> for full details.
+ </para>
+ </section>
+
+ <section
id="sect-Beginners_Guide-Java_Web_EE_and_Standard_Edition_SE_Plug_Ins-Hibernate_Tools">
+ <title>Hibernate Tools</title>
+ <para>
+ <application>Hibernate</application> is an object-relational mapping
(<acronym>ORM</acronym>) library, used for mapping an object-oriented domain
model to a relational database. It replaces persistence-related database accesses with
high-level object-handling functions to solve problems relating to object-relational
impedance mismatch. <application>Hibernate</application> also serves as a
query service, allowing queries to be expressed in native
<acronym>SQL</acronym> (Structured Query Language), an extension of
<acronym>SQL</acronym> named <emphasis>Hibernate Query
Language</emphasis> (<acronym>HQL</acronym>), or an object-oriented
Criteria and Example <acronym>API</acronym> (Application Programming
Interface).
+ </para>
+ <para>
+ Hibernate Tools in <application>JBoss Tools</application> and the
<application>JBoss Developer Studio</application> provides several features to
aid in developing with <application>Hibernate</application>:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>Mapping Editor</term>
+ <listitem>
+ <para>
+ The Mapping Editor is used for authoring Hibernate
<acronym>XML</acronym> mapping files. It supports code completion (Content
Assist) and syntax highlighting.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Console</term>
+ <listitem>
+ <para>
+ The Hibernate Console provides a visual representation of database connections and
class relationships. Queries can be interactively performed on the database
representation.
+ </para>
+ <figure
id="figu-Beginners_Guide-Hibernate_Tools-Hibernate_Console">
+ <title>Hibernate Console</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/figu-Beginners_Guide-Hibernate_Tools-Hibernate_Console.png"
format="PNG" width="444" />
+ </imageobject>
+ <textobject>
+ <para>
+ The Hibernate Console consists of multiple panels representing the database.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Reverse Engineering</term>
+ <listitem>
+ <para>
+ Databases can be reverse-engineered to construct domain model classes, Hibernate
mapping files, annotated entity beans, <acronym>HTML</acronym> documentation,
or complete JBoss Seam applications.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Wizards</term>
+ <listitem>
+ <para>
+ Wizards are included to step through procedures to generate Hibernate configuration
files and Hibernate console configurations.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><application>Apache Ant</application> Task</term>
+ <listitem>
+ <para>
+ <application>Apache Ant</application> is a tool for automating software
build processes. Hibernate Tools includes an Apache Ant Task for generating schema,
mapping, and Java code related to the build process.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>
+ Refer to the <citetitle pubwork="book">Hibernate Tools
Reference</citetitle> for full details.
+ </para>
+ </section>
+
+ <section
id="sect-Beginners_Guide-Java_Web_EE_and_Standard_Edition_SE_Plug_Ins-Portal_Tools">
+ <title>Portal Tools</title>
+ <para>
+ <application>JBoss Portal</application> is a platform for hosting and
serving the web interface of a portal. It allows for content management and experience
customization, and supports standard portlets, single sign-ons, clustering, and
internationalization.
+ </para>
+ <para>
+ <application>JBoss Portal</application> applications can be created
through the Dynamic Web Project wizard. Java portlets, <acronym>JSF</acronym>
portlets, and Seam portlets are all supported.
+ </para>
+ <figure
id="figu-Beginners_Guide-Portal_Tools-Dynamic_Web_Project_wizard">
+ <title>Dynamic Web Project wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/figu-Beginners_Guide-Portal_Tools-Dynamic_Web_Project_wizard.png"
format="PNG" width="444" />
+ </imageobject>
+ <textobject>
+ <para>
+ The Dynamic Web Project wizard streamlines the creation of a
<application>JBoss Portal</application> application.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Refer to the <citetitle pubwork="book">JBoss Portal Tools Reference
Guide</citetitle> for full details.
+ </para>
+ </section>
+
+ <section
id="sect-Beginners_Guide-Java_Web_EE_and_Standard_Edition_SE_Plug_Ins-JMX_Tools">
+ <title>JMX Tools</title>
+ <para>
+ Java Management Extensions (<acronym>JMX</acronym>) is a Java tool-set for
managing and monitoring applications, connected devices, and service-oriented networks. A
managed resource is represented by a dynamic object called a <emphasis>Managed
Bean</emphasis> (or <emphasis>MBean</emphasis>, which is a JavaBean with
a dependency injection.
+ </para>
+ <para>
+ The <acronym>JMX</acronym> Tools in <application>JBoss
Tools</application> and the <application>JBoss Developer
Studio</application> consist on the <emphasis>MBean Explorer</emphasis>
and the <emphasis>MBean Editor</emphasis>.
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>MBean Explorer</term>
+ <listitem>
+ <para>
+ The MBean Explorer lists a connection's Managed Beans, domains, attributes, and
operations in a hierarchical tree. Items in the tree can be filtered, expanded, and
collapsed, and double-clicking on any item will open the item in the MBean Editor.
+ </para>
+ <figure id="figu-Beginners_Guide-JMX_Tools-MBean_Explorer">
+ <title>MBean Explorer</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/figu-Beginners_Guide-JMX_Tools-MBean_Explorer.png"
format="PNG" />
+ </imageobject>
+ <textobject>
+ <para>
+ The MBean Explorer lists a connection's Managed Beans, domains, attributes,
and operations in a hierarchical tree.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>MBean Editor</term>
+ <listitem>
+ <para>
+ The MBean Editor is a detailed property-editor made up of four pages:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ the Attributes page, which allows the attributes of the Managed Bean to be viewed
edited;
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ the Operations page, which allows the operations of the Managed Bean to be viewed
and edited;
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ the Notifications page, which allows the Managed Bean to be subscribed to, and
which notifications are received
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ the Info page, which displays information on the Managed Bean.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <figure id="figu-Beginners_Guide-JMX_Tools-MBean_Editor">
+ <title>MBean Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/figu-Beginners_Guide-JMX_Tools-MBean_Editor.png"
format="PNG" width="444" />
+ </imageobject>
+ <textobject>
+ <para>
+ The MBean Editor is a property editor for Managed Beans.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>
+ Refer to the <citetitle pubwork="book">JMX Tools Reference
Guide</citetitle> for full details.
+ </para>
+ </section>
+
+ <section
id="sect-Beginners_Guide-Java_Web_EE_and_Standard_Edition_SE_Plug_Ins-JBoss_AS_Tools">
+ <title>JBoss AS Tools</title>
+ <para>
+ The JBoss <acronym>AS</acronym> Tools consist of a number of additional
views for managing an installed JBoss Server through the JBoss
<acronym>AS</acronym> (Application Server) perspective. These additional views
include the standard Console view and Properties view, and the Servers view. The Servers
view allows installed servers to be configured, monitored, and managed.
+ </para>
+ <figure id="figu-Beginners_Guide-JBoss_AS_Tools-Servers_view">
+ <title>Servers view</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/figu-Beginners_Guide-JBoss_AS_Tools-JBoss_Server_View.png"
format="PNG" width="444" />
+ </imageobject>
+ <textobject>
+ <para>
+ The Servers view shows the installed servers and their current states.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Refer to the <citetitle pubwork="book">JBoss Server Manager Reference
Guide</citetitle> for full details.
+ </para>
+ </section>
+
+ <section
id="sect-Beginners_Guide-Java_Web_EE_and_Standard_Edition_SE_Plug_Ins-Archive_Tools">
+ <title>Archive Tools</title>
+ <para>
+ The JBoss AS Tools also include the Project Archives view for streamlined packaging
and archiving of applications. Application projects can be configured with specific
packaging instructions, and wizards are included for creating and managing archives.
+ </para>
+ <figure id="figu-Beginners_Guide-Archive_Tools-Archive_Tools">
+ <title>Archive Tools</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/figu-Beginners_Guide-Archive_Tools-Archive_Tools.png"
format="PNG" width="444" />
+ </imageobject>
+ <textobject>
+ <para>
+ Project archives can be managed with the Archive Tools.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Refer to the <citetitle pubwork="book">JBoss Server Manager Reference
Guide</citetitle> for full details.
+ </para>
+ </section>
+
+</chapter>
+
Added: trunk/documentation/guides/Beginners_Guide/en-US/Preface.xml
===================================================================
--- trunk/documentation/guides/Beginners_Guide/en-US/Preface.xml
(rev 0)
+++ trunk/documentation/guides/Beginners_Guide/en-US/Preface.xml 2010-01-20 22:13:38 UTC
(rev 19834)
@@ -0,0 +1,10 @@
+<?xml version='1.0' encoding='utf-8' ?>
+
+<preface id="pref-Beginners_Guide-Preface">
+ <title>Preface</title>
+ <xi:include href="Common_Content/Conventions.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Feedback.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"><xi:fallback
xmlns:xi="http://www.w3.org/2001/XInclude"><xi:include
href="Common_Content/Feedback.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ </xi:fallback>
+ </xi:include>
+</preface>
+
Added: trunk/documentation/guides/Beginners_Guide/en-US/Revision_History.xml
===================================================================
--- trunk/documentation/guides/Beginners_Guide/en-US/Revision_History.xml
(rev 0)
+++ trunk/documentation/guides/Beginners_Guide/en-US/Revision_History.xml 2010-01-20
22:13:38 UTC (rev 19834)
@@ -0,0 +1,24 @@
+<?xml version='1.0' encoding='utf-8' ?>
+
+<appendix id="appe-Beginners_Guide-Revision_History">
+ <title>Revision History</title>
+ <simpara>
+ <revhistory>
+ <revision>
+ <revnumber>0</revnumber>
+ <date>Thu Nov 26 2009</date>
+ <author>
+ <firstname>Isaac</firstname>
+ <surname>Rooskov</surname>
+ <email>irooskov(a)redhat.com</email>
+ </author>
+ <revdescription>
+ <simplelist>
+ <member>Initial creation of book by publican</member>
+ </simplelist>
+ </revdescription>
+ </revision>
+ </revhistory>
+ </simpara>
+</appendix>
+
Added: trunk/documentation/guides/Beginners_Guide/en-US/SOA-P_Workshop.xml
===================================================================
--- trunk/documentation/guides/Beginners_Guide/en-US/SOA-P_Workshop.xml
(rev 0)
+++ trunk/documentation/guides/Beginners_Guide/en-US/SOA-P_Workshop.xml 2010-01-20
22:13:38 UTC (rev 19834)
@@ -0,0 +1,26 @@
+<?xml version='1.0' encoding='utf-8' ?>
+
+<chapter
id="chap-Beginners_Guide-JBoss_Service_Oriented_Architecture_Platform_Workshop">
+ <title>JBoss Service-Oriented Architecture Platform Workshop</title>
+ <para>
+ This chapter demonstraits the basic use of the JBoss Enterprise SOA Platform with the
JBoss Developer Studio, through a series of lab examples.
+ </para>
+ <section
id="sect-Beginners_Guide-JBoss_Service_Oriented_Architecture_Platform_Workshop-Workshop_Introduction">
+ <title>Workshop Introduction</title>
+ <para>
+ The JBoss Enterprise SOA Platform is a collection of technologies designed to meet an
organization's SOA needs. This technology includes an ESB, BPM engine (jBPM), Rules
engine (JBoss Rules), UDDI Registry (jUDDI), as well as a full JEE application server.
+ </para>
+ <para>
+ To cover each of these areas in depth is beyond the scope of this workshop. Instead,
this workshop is designed to give you an overview of the JBoss Enterprise SOA Platform as
well as some experience using JBoss Developer Studio to create and deploy Service-Oriented
Architecture applications.
+ </para>
+ <section
id="sect-Beginners_Guide-Workshop_Introduction-The_JBoss_Enterprise_SOA_Platform_ESB_architecture">
+ <title>The JBoss Enterprise SOA Platform ESB architecture</title>
+ <para>
+ Understanding the JBoss Enterprise SOA Platform ESB architecture is important to
really understanding what is happening in the following labs. Here is an architecture
overview of the JBoss Enterprise SOA Platform ESB that we will discuss.
+ </para>
+ </section>
+
+ </section>
+
+</chapter>
+
Added:
trunk/documentation/guides/Beginners_Guide/en-US/Service-Oriented_Architecture_Development.xml
===================================================================
---
trunk/documentation/guides/Beginners_Guide/en-US/Service-Oriented_Architecture_Development.xml
(rev 0)
+++
trunk/documentation/guides/Beginners_Guide/en-US/Service-Oriented_Architecture_Development.xml 2010-01-20
22:13:38 UTC (rev 19834)
@@ -0,0 +1,311 @@
+<?xml version='1.0' encoding='utf-8' ?>
+
+<chapter
id="chap-Beginners_Guide-Service_Oriented_Architecture_Development">
+ <title>Service-Oriented Architecture Development</title>
+ <para>
+ This chapter covers the <application>JBoss Tools</application> and the
<application>JBoss Developer Studio</application> plug-ins for development on
Service-Oriented Architecture (SOA).
+ </para>
+ <section
id="sect-Beginners_Guide-Service_Oriented_Architecture_Development-jBPM_Tools">
+ <title>jBPM Tools</title>
+ <para>
+ jBPM is a workflow tool, allowing for the creation of framework control over business
processes and languages.
+ </para>
+ <para>
+ jBPM supports the jBPM Process Definition Language (jPDL) and includes a perspective
for easy creation and manipulation using the jPDL. Through this view you can add states,
transitions and other processes and waypoints in order to create your own business
workflow. Refer to the <citetitle pubwork="section">A Minimal Process
Definition</citetitle> section of the <citetitle
pubwork="chapter">Creating an Empty Process Definition</citetitle>
chapter within the <citetitle pubwork="book">jBPM Tools Reference
Guide</citetitle> for more details.
+ </para>
+ <para>
+ Refer to the <citetitle pubwork="book">jBPM Tools Reference
Guide</citetitle> for further details.
+ </para>
+ </section>
+
+ <section
id="sect-Beginners_Guide-Service_Oriented_Architecture_Development-ESB_Editor">
+ <title>ESB Editor</title>
+ <para>
+ The Enterprise Service Bus (ESB) is an abstraction layer that interacts with the
messaging system in a Service-Oriented Architecture (SOA).
+ </para>
+ <figure id="figu-Beginners_Guide-ESB_Editor-ESB_Editor">
+ <title>ESB Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/ESB_Editor.png" format="PNG"
width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ <application>JBoss Tools</application> and the <application>JBoss
Developer Studio</application> include a tool called the ESB file Editor. Through
the use of this tool you can develop an application that will utilize the advantages of
ESB technology. Features of the ESB Editor include:
+ </para>
+ <formalpara
id="form-Beginners_Guide-ESB_Editor-ESB_syntax_validation">
+ <title>ESB syntax validation</title>
+ <para>
+ Contextual error checking is provided constantly, with error checking on incorrect or
incomplete tags also included when using the Source viewer.
+ </para>
+ </formalpara>
+ <formalpara id="form-Beginners_Guide-ESB_Editor-XML_schema_support">
+ <title>XML schema support</title>
+ <para>
+ By checking the child elements of the providers, the ESB Editor relays incorrect
usage combinations to you through error messages upon startup.
+ </para>
+ </formalpara>
+ <formalpara
id="form-Beginners_Guide-ESB_Editor-ESB_XML_content_assistance">
+ <title>ESB XML content assistance</title>
+ <para>
+ Content Assist enables you to write code fast and with accuracy when using the Source
mode.
+ </para>
+ </formalpara>
+ <formalpara
id="form-Beginners_Guide-ESB_Editor-Synchronized_source_and_visual_editing">
+ <title>Synchronized source and visual editing</title>
+ <para>
+ The ESB Editor gives you the choice of using a graphical view (Tree), a code view
(Source) or both when developing your ESB applications. With both instances open at once,
the changes made to one can be directly viewable in the other, ensuring that you are
always working with the most current version of your application no matter your choice.
+ </para>
+ </formalpara>
+ <para>
+ Refer to the <citetitle pubwork="chapter">ESB Editor</citetitle>
chapter of the <citetitle pubwork="book">ESB Tools Reference
Guide</citetitle> for further information.
+ </para>
+ <para>
+ Allowing for the value of messaging between middleware components to be used and
intergrated into the JBoss Service-Oriented Architecture, the JBoss ESB is an integral
part of JBoss middleware integration. For information on how to use and configure JBoss
ESB with the JBoss Service-Oriented Architecture refer to the <citetitle
pubwork="chapter">Using and Configuring SOA Platform</citetitle>
chapter of the <citetitle pubwork="book">ESB Tools Reference
Guide</citetitle>.
+ </para>
+ </section>
+
+ <section
id="sect-Beginners_Guide-Service_Oriented_Architecture_Development-Web_Services_Tools">
+ <title>Web Services Tools</title>
+ <para>
+ JBoss Web Services is an integral part of the JBoss Application Server and JBoss
Enterprise Application Platform, providing a standard means of working reliably between
different software applications.
+ </para>
+ <para>
+ A Web Service defines a collection of technologies that provide protocols and
standards for the exchange of data between applications. You can create a Web Service for
your application server through the use of wizards in <application>JBoss
Tools</application> or the <application>JBoss Developer
Studio</application>. For further details refer to the <citetitle
pubwork="chapter">Creating a Web Service using JBossWS
runtime</citetitle> chapter of the <citetitle pubwork="book">JBoss
WS User Guide</citetitle>
+ </para>
+ <figure
id="figu-Beginners_Guide-Web_Services_Tools-Example_of_a_Web_Services_wizard">
+ <title>Example of a Web Services wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/Web_Services_Wizard.png"
format="PNG" width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Web Services Tools also includes the ability to create a Web Service client through
the use of a Web Services Description Language (WSDL) document. This can be useful if you
already have a predefined service that you wish to recreate in JBoss Tools, or you wish to
use one as a template for you to work with. Refer to the <citetitle
pubwork="chapter">Creating a Web Service Client from a WSDL Document using
JBoss WS</citetitle> chapter of the <citetitle pubwork="book">JBoss
WS User Guide</citetitle> for more details.
+ </para>
+ <figure
id="figu-Beginners_Guide-Web_Services_Tools-Web_Services_client_creation">
+ <title>Web Services client creation</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/Web_Services_Using_Document.png"
format="PNG" width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+
+ <section
id="sect-Beginners_Guide-Service_Oriented_Architecture_Development-Drools_Tools">
+ <title>Drools Tools</title>
+ <para>
+ Drools is a Business Rule Management System (BRMS) that uses an enhanced
implementation of the Rete algorithm to become a forward chaining inference based rules
engine (production rule system). Refer to the <citetitle
pubwork="chapter">The Rule Engine</citetitle> chapter of the JBoss
Enterprise SOA <citetitle pubwork="book">JBoss Rules Reference
Guide</citetitle> for more details.
+ </para>
+ <para>
+ Drools Tools includes wizards for creating new Drools projects and resources. The
resources that can be created include a new rule, domain specific language, decision table
and business rule. After these have been created there are numerous editors included to
assist you with the rest of the development. Included editors are The Rule editor, The
Domain Specific Language editor, The Rule Flow graphical editor and The Guided editor that
provides a Graphical User Interface (GUI). Refer to the <citetitle
pubwork="book">Drools Tools Reference Guide</citetitle> for more
details.
+ </para>
+ <figure id="figu-Beginners_Guide-Drools_Tools-Rule_text_editor">
+ <title>Rule text editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/Drools_code_rule_editor.png"
format="PNG" width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <figure
id="figu-Beginners_Guide-Drools_Tools-Rule_Flow_graphical_editor">
+ <title>Rule Flow graphical editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/Drools_rete_rule_editor.png"
format="PNG" width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+
+ <section
id="sect-Beginners_Guide-Service_Oriented_Architecture_Development-Eclipse_Guvnor_Tools">
+ <title>Eclipse Guvnor Tools</title>
+ <para>
+ Eclipse Guvnor Tools work with Drools Guvnor through rich web based GUIs and editors
to provide a centralized repository for a vast quantity of rules. You can store versions
of rules, models, functions, processes and other Drools generated components that all
relate to executeable knowledge bases. Access to the Guvnor is controlled, allowing you to
lock down access and restrict features so domain experts (non programmers) can view and
edit rules without being exposed to all the features at once.
+ </para>
+ <para>
+ The tools included for Eclipse Guvnor are outlined as follows:
+ </para>
+ <formalpara
id="form-Beginners_Guide-Eclipse_Guvnor_Tools-Guvnor_Connection_Wizard">
+ <title>Guvnor Connection Wizard</title>
+ <para>
+ The Guvnor Connection Wizard is used to create a connection to a Guvnor repository.
This wizard can be started by following the menu items
<menuchoice><guimenuitem>File</guimenuitem><guimenuitem>New</guimenuitem><guimenuitem>Other</guimenuitem><guimenuitem>Guvnor</guimenuitem><guimenuitem>Guvnor
repository location</guimenuitem></menuchoice>, through the Guvnor
Repositories View and other locations throughout Eclipse Guvnor Tools. Refer to the
<citetitle pubwork="section">Guvnor Connection Wizard</citetitle>
section of the <citetitle pubwork="chapter">Functionality
Overview</citetitle> chapter within the <citetitle
pubwork="book">Eclipse Guvnor Tools Reference Guide</citetitle> for
more details.
+ </para>
+ </formalpara>
+ <figure
id="figu-Beginners_Guide-Eclipse_Guvnor_Tools-Guvnor_connection_wizard">
+ <title>Guvnor connection wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/Guvnor_connection_wizard.png"
format="PNG" width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <formalpara
id="form-Beginners_Guide-Eclipse_Guvnor_Tools-The_Guvnor_Repositories_View">
+ <title>The Guvnor Repositories View</title>
+ <para>
+ The Guvnor Repositories View tool displays the contents of a repository using a tree
structure. From within this tool you can create a new Guvnor repository connection, remove
a Guvnor repository connection, refresh the tree display and expand or condense the tree
layout. Refer to the <citetitle pubwork="section">Guvnor Repositories
View</citetitle> section of the <citetitle
pubwork="chapter">Functionality Overview</citetitle> chapter within the
<citetitle pubwork="book">Eclipse Guvnor Tools Reference
Guide</citetitle> for more details.
+ </para>
+ </formalpara>
+ <figure
id="figu-Beginners_Guide-Eclipse_Guvnor_Tools-Guvnor_repository_view">
+ <title>Guvnor repository view</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/Guvnor_repository.png"
format="PNG" width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <formalpara
id="form-Beginners_Guide-Eclipse_Guvnor_Tools-Guvnor_Resource_History_View">
+ <title>Guvnor Resource History View</title>
+ <para>
+ The task of the Guvnor Resource History View is to display the revision history
details for files that are both locally stored and within Guvnor repositories. Refer to
the <citetitle pubwork="section">Guvnor Resource History
View</citetitle> section of the <citetitle
pubwork="chapter">Functionality Overview</citetitle> chapter within the
<citetitle pubwork="book">Eclipse Guvnor Tools Reference
Guide</citetitle> for more details.
+ </para>
+ </formalpara>
+ <figure
id="figu-Beginners_Guide-Eclipse_Guvnor_Tools-Guvnor_resource_history_view">
+ <title>Guvnor resource history view</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/Guvnor_resource_history_view.png"
format="PNG" width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <formalpara
id="form-Beginners_Guide-Eclipse_Guvnor_Tools-Guvnor_Resource_Importing_Wizard">
+ <title>Guvnor Resource Importing Wizard</title>
+ <para>
+ The Guvnor Resource Importing Wizard assists with the copying of one or more files
from a Guvnor repository to the local workspace (while keeping file association with the
Guvnor repository). This wizard can be started by following the menu items
<menuchoice><guimenuitem>File</guimenuitem><guimenuitem>Import</guimenuitem><guimenuitem>Guvnor</guimenuitem><guimenuitem>Resource
from Guvnor</guimenuitem></menuchoice>. Refer to the <citetitle
pubwork="section">Importing Guvnor Repository Resources</citetitle>
section of the <citetitle pubwork="chapter">Functionality
Overview</citetitle> chapter within the <citetitle
pubwork="book">Eclipse Guvnor Tools Reference Guide</citetitle> for
more details.
+ </para>
+ </formalpara>
+ <figure
id="figu-Beginners_Guide-Eclipse_Guvnor_Tools-Guvnor_resource_importing_wizard">
+ <title>Guvnor resource importing wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/Guvnor_copy_file.png" format="PNG"
width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <formalpara
id="form-Beginners_Guide-Eclipse_Guvnor_Tools-Actions_for_Local_Guvnor_Resources">
+ <title>Actions for Local Guvnor Resources</title>
+ <para>
+ Through Eclipse Guvnor Tools a variety of actions can be performed on a file. Those
actions are:
+ </para>
+ </formalpara>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <emphasis>Update</emphasis>: Replaces the contents of the local file
with the updated contents from the Guvnor repository.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis>Add</emphasis>: Include a local file in a Guvnor repository.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis>Commit</emphasis>: Update a Guvnor repository file with new
content from a locally modified version.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis>Show History</emphasis>: Displays the revision history of a
file.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis>Compare with Version</emphasis>: Opens a wizard that allows to
files to be compared for similarities and differences.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis>Switch to Version</emphasis>: Provides the ability to replace
a local file with an earlier revision of the same file.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis>Delete</emphasis>: Removes a file from the Guvnor repository
and the local copy.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis>Disconnect</emphasis>: Removes a Guvnor repository
association.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ Refer to the <citetitle pubwork="section">Actions for Local Guvnor
Resources</citetitle> section of the <citetitle
pubwork="chapter">Functionality Overview</citetitle> chapter within the
<citetitle pubwork="book">Eclipse Guvnor Tools Reference
Guide</citetitle> for more details.
+ </para>
+ </section>
+
+ <section
id="sect-Beginners_Guide-Service_Oriented_Architecture_Development-JSF_Tools">
+ <title>JSF Tools</title>
+ <para>
+ JavaServer Faces (JSF) is a Web application framework developed by Sun Microsystems©
Inc. that <application>JBoss Tools</application> and the
<application>JBoss Developer Studio</application> provide developer tools for.
JSF Tools allows you to build JSF based applications, add JSF capabilities to existing web
projects, import JSF projects and choose a JSF implementation during application
development.
+ </para>
+ <para>
+ The tools included are outlined as follows:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Wizards that assist with the creation of new JSF and Facelets projects and adding
JSF capabilities to existing web projects.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Pre-configured templates are included and the functionality to create your own.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Add and generate code for new managed beans and then add them to a JSF configuration
file.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The ability to create your own custom Converter and Validator.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Constant validation checking no matter how you are currently interacting with the
code, ensures you are always aware of any errors during the development process.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Three views are provided for interacting with the code: Diagram view, Tree view and
Source view. Synchronization between the views ensures you are always working on the
newest version.
+ </para>
+ <figure id="figu-Beginners_Guide-JSF_Tools-Diagram_view">
+ <title>Diagram view</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/JSF_diagram_view.png"
format="PNG" width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <figure id="figu-Beginners_Guide-JSF_Tools-Tree_view">
+ <title>Tree view</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/JSF_tree_view.png" format="PNG"
width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <figure id="figu-Beginners_Guide-JSF_Tools-Source_view">
+ <title>Source view</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/JSF_source_view.png"
format="PNG" width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </itemizedlist>
+ <para>
+ Refer to the <citetitle pubwork="book">JSF Tools Reference
Guide</citetitle> for more details.
+ </para>
+ </section>
+
+</chapter>
+
Added: trunk/documentation/guides/Beginners_Guide/en-US/The_interface.xml
===================================================================
--- trunk/documentation/guides/Beginners_Guide/en-US/The_interface.xml
(rev 0)
+++ trunk/documentation/guides/Beginners_Guide/en-US/The_interface.xml 2010-01-20 22:13:38
UTC (rev 19834)
@@ -0,0 +1,237 @@
+<?xml version='1.0' encoding='utf-8' ?>
+
+<chapter id="chap-Beginners_Guide-The_interface">
+ <title>The interface</title>
+ <para>
+ This chapter discusses the interfaces that the <application>JBoss
Tools</application> and the <application>JBoss Developer
Studio</application> plug-ins are built for.
+ </para>
+ <section id="sect-Beginners_Guide-The_interface-Eclipse">
+ <title>Eclipse</title>
+ <para>
+ Eclipse is the container for all development work in <application>JBoss
Tools</application> and the <application>JBoss Developer
Studio</application>. It allows for control over the running of the application
server, the applications on it and provides an interface for developing your own
applications.
+ </para>
+ <para>
+ Eclipse is started by double-clicking on the <filename>eclipse</filename>
executeable in your installation directory.
+ </para>
+ <para>
+ Following this you will be asked to specify a workspace for your Eclipse session. A
workspace is the location on your computer where your files will be stored relating to the
session. If you wish to change your workspace location after this step you can do so by
following the menu items <guimenuitem>File</guimenuitem>,
<guimenuitem>Switch Workspace</guimenuitem>,
<guimenuitem>Other...</guimenuitem>.
+ </para>
+ <figure id="figu-Beginners_Guide-Eclipse-Eclipse_Workspace_launcher">
+ <title>Eclipse Workspace launcher</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/Eclipse_workspace.png"
format="PNG" width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ After selecting a workspace location, you will be greeted with the
<guilabel>Welcome</guilabel> screen. This screen provides a few pathway
options, including a <guilabel>Getting Started</guilabel> link to a selection
of documentation, an option to create a new project with the <guilabel>Create
New...</guilabel> option and an option to skip straight to your
<guilabel>Workbench</guilabel>.
+ </para>
+ <figure id="figu-Beginners_Guide-Eclipse-Eclipse_welcome_screen">
+ <title>Eclipse welcome screen</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/Eclipse_welcome_screen.png"
format="PNG" width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Skipping straight to your workbench, you will see a screen with a few sections and the
JBoss Application Server listed in the bottom area of the interface.
+ </para>
+ <figure id="figu-Beginners_Guide-Eclipse-Eclipse_Workbench">
+ <title>Eclipse Workbench</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/Eclipse_main.png" format="PNG"
width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ In the bottom left hand corner of the screen is a picture of a white column with a
blue bar and a yellow plus sign beside it. Clicking on this button will open a menu of
different views and windows.
+ </para>
+ <figure id="figu-Beginners_Guide-Eclipse-Views_button">
+ <title>Views button</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/View_Button.png" format="PNG"
width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ The window that may be of most use to you can be found by following:
<menuchoice><guimenuitem>Other...</guimenuitem><guimenuitem>JBoss
Tools Web</guimenuitem><guimenuitem>JBoss Tools
Palette</guimenuitem></menuchoice>. This window opens an interface to the
tools included with <application>JBoss Tools</application> and the
<application>JBoss Developer Studio</application>.
+ </para>
+ <para>
+ Refer to the <citetitle pubwork="section">Welcome to JBoss Developer
Studio</citetitle> section of the <citetitle pubwork="book">Getting
Started with JBoss Developer Studio</citetitle> guide for further details.
+ </para>
+ </section>
+
+ <section
id="sect-Beginners_Guide-The_interface-JBoss_Application_Server">
+ <title>JBoss Application Server</title>
+ <para>
+ The JBoss Application Server provides the full range of Java EE 5 features as well as
extended enterprise services including clustering, caching, and persistence.
+ </para>
+ <section
id="sect-Beginners_Guide-JBoss_Application_Server-Use_of_the_application_server_shipped_with_JBoss_Tools_or_JBoss_Developer_Studio">
+ <title>Use of the application server shipped with JBoss Tools or JBoss Developer
Studio</title>
+ <para>
+ This section discusses the JBoss Application Server with regards to its use through
Eclipse. Once you have started the Eclipse interface for <application>JBoss
Tools</application> or the <application>JBoss Developer
Studio</application>, the JBoss Application Server can be started by clicking on its
name in the lower part of the window and then clicking the green arrow to the right.
+ </para>
+ <figure
id="figu-Beginners_Guide-Use_of_the_application_server_shipped_with_JBoss_Tools_or_JBoss_Developer_Studio-Starting_and_stopping_the_server">
+ <title>Starting and stopping the server</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/Start_Stop_Server.png"
format="PNG" width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <note>
+ <para>
+ If the <guimenu>Servers</guimenu> view is not displayed at the bottom of
your Workbench, you can activate it through
<menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Show
View</guimenuitem><guimenuitem>Other</guimenuitem><guimenuitem>Server</guimenuitem><guimenuitem>Servers</guimenuitem></menuchoice>
and then click the <guibutton>OK</guibutton> button.
+ </para>
+ </note>
+ <para>
+ After the server has been successfully started the status next to the server name
will change from displaying <emphasis>Stopped</emphasis> to displaying
<emphasis>Started, Synchronized</emphasis>.
+ </para>
+ <figure
id="figu-Beginners_Guide-Use_of_the_application_server_shipped_with_JBoss_Tools_or_JBoss_Developer_Studio-Server_started_successfully">
+ <title>Server started successfully</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/Server_Started.png" format="PNG"
width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Once Eclipse and the server are started, double click on the server name in Eclipse
to see an <guilabel>Overview</guilabel> screen in the center.
+ </para>
+ <figure
id="figu-Beginners_Guide-Use_of_the_application_server_shipped_with_JBoss_Tools_or_JBoss_Developer_Studio-JBoss_Application_Server_overview">
+ <title>JBoss Application Server overview</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/JBoss_AS_Overview.png"
format="PNG" width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ From this <guilabel>Overview</guilabel> section there are six subsections
consisting of: <guilabel>General Information</guilabel>, <guilabel>Login
Credentials</guilabel>, <guilabel>Publishing</guilabel>,
<guilabel>Timeouts</guilabel>, <guilabel>Server Polling</guilabel>
and <guilabel>Server Ports</guilabel>.
+ </para>
+ <para>
+ The <guilabel>General Information</guilabel> subsection allows you to
change the <guilabel>Server name</guilabel> and <guilabel>Host
name</guilabel> to your own preferences. By clicking on the <guilabel>Runtime
Environment</guilabel> label a dialog box with options to change the name of the
server runtime, the home directory, the Java compiler and which server configuration
should be used when running the application server. The <guibutton>Open launch
configuration</guibutton> button displays a dialog box for configuring the technical
details of the application server instance.
+ </para>
+ <para>
+ Below the <guilabel>General Information</guilabel> subsection is the
<guilabel>Login Credentials</guilabel> subsection. This allows you to set the
<guilabel>User Name</guilabel> and <guilabel>Password</guilabel>
for your server.
+ </para>
+ <para>
+ The <guilabel>Publishing</guilabel> subsection at the top right of the
<guilabel>Overview</guilabel> section allows you to set when applications
should be made available through the application server. You can select to either never
have an application be published automatically or for a check of new applications yet to
be published to occur at a certain timed interval.
+ </para>
+ <para>
+ The <guilabel>Timeouts</guilabel> subsection below
<guilabel>Publishing</guilabel> allows you to set the start and stop time (in
seconds) for the server to complete all of its operations. This setting is made available
in order to decrease the chance of the server freezing or hanging.
+ </para>
+ <para>
+ Below the <guilabel>Timeouts</guilabel> subsection is the
<guilabel>Server Polling</guilabel> subsection. A server poller gathers
information about the server at certain points in time, capturing information about
processes and applications. This section allows you to select between either the
<literal>JMX Poller</literal> or <literal>Timeout Poller</literal>
for startup and the <literal>Process Terminated Poller</literal> or
<literal>Timeout Poller</literal> for shutdown.
+ </para>
+ <para>
+ The final subsection is <guilabel>Server Ports</guilabel>, below
<guilabel>Server Polling</guilabel>. This section allows you to alter the port
numbers that the server pollers gather their information from. The two settings of
<guilabel>JNDI Port</guilabel> and <guilabel>Web Port</guilabel>
are set to be automatically detected by default; normally there should be no reason to
manually select the port numbers.
+ </para>
+ <note>
+ <para>
+ Changing the <guilabel>Server Ports</guilabel> subsection configuration
will not alter which ports the server itself listens on.
+ </para>
+ </note>
+ <para>
+ Default access to the server can be achieved by typing the address <ulink
url="http://localhost:8080">http://localhost:8080</ulink> into your
Internet browser address bar.
+ </para>
+ <figure
id="figu-Beginners_Guide-Use_of_the_application_server_shipped_with_JBoss_Tools_or_JBoss_Developer_Studio-Server_access">
+ <title>Server access</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/JBoss_AS_localhost.png"
format="PNG" width="444" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Refer to the <citetitle pubwork="chapter">Manage JBoss AS from JBoss
Developer Studio</citetitle> chapter of the <citetitle
pubwork="book">Getting Started with JBoss Developer Studio</citetitle>
guide for further details.
+ </para>
+ </section>
+
+ <section
id="sect-Beginners_Guide-JBoss_Application_Server-Adding_a_new_application_server_for_use_with_JBoss_Tools_or_JBoss_Developer_Studio">
+ <title>Adding a new application server for use with JBoss Tools or JBoss
Developer Studio</title>
+ <para>
+ Though JBoss Tools and JBoss Developer Studio may come with a pre-configured
application server, you can still add your own servers. This section details how to add
additional servers for use with JBoss Tools and the JBoss Developer Studio.
+ </para>
+ <para>
+ To add a new server runtime follow these steps:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ In the Eclipse interface click on
<menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>Server</guimenuitem><guimenuitem>Runtime
Environments</guimenuitem></menuchoice>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click on the <guibutton>Add...</guibutton> button
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Select the type of runtime environment your application server is from the list
provided
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Tick the box for <guilabel>Create a new local server</guilabel>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click on the <guibutton>Next ></guibutton> button
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Name your server runtime and then click on the
<guibutton>Browse...</guibutton> button next to the <guilabel>Home
Directory</guilabel> location space
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Navigate to the directory where the server you wish to add is installed and click
on the <guibutton>OK</guibutton> button
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Select the Java Runtime Environment (JRE) you wish to use for this server from the
drop-down menu. If the required JRE is not listed, click on the
<guibutton>JRE</guibutton> button beside the list and then select the
<guibutton>Add...</guibutton> button in the <guimenuitem>Installed
JREs</guimenuitem> <guilabel>Preferences</guilabel> dialog box and
follow the prompts to install the correct JRE
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The <guilabel>Configuration</guilabel> section should automatically
list the available profiles available for your server. Select the server configuration you
wish to use by clicking on its name in the list
+ </para>
+ <para>
+ If the profile you wish to use is not listed click on the
<guibutton>Browse...</guibutton> button, navigate to the profile location and
click the <guibutton>OK</guibutton> button
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click the <guibutton>Next ></guibutton> button to display the
<guilabel>Runtime Information</guilabel> for the server you are about to add.
If all the information is correct click the <guibutton>Finish</guibutton>
button.
+ </para>
+ <para>
+ If you need to change any information click the <guibutton><
Back</guibutton> button until you reach the screen with the information that needs
to be altered and then navigate back to the <guilabel>Runtime
Information</guilabel> screen and click the
<guibutton>Finish</guibutton> button.
+ </para>
+ </listitem>
+ </orderedlist>
+ <para>
+ Once the new sever has been added, you can select it for use by clicking on its name
in the <guilabel>Server Runtime Environment</guilabel> list and then clicking
the <guibutton>OK</guibutton> button that will then take you back to the main
Eclipse interface.
+ </para>
+ <para>
+ To start your new server, select it from those available through the
<guimenu>Servers</guimenu> view and click the white arrow in a green circle.
+ </para>
+ <note>
+ <para>
+ If the <guimenu>Servers</guimenu> view is not displayed at the bottom of
your Workbench, you can activate it through
<menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Show
View</guimenuitem><guimenuitem>Other</guimenuitem><guimenuitem>Server</guimenuitem><guimenuitem>JBoss
Server View</guimenuitem></menuchoice> and then click the
<guibutton>OK</guibutton> button.
+ </para>
+ </note>
+ </section>
+
+ </section>
+
+</chapter>
+
Added: trunk/documentation/guides/Beginners_Guide/en-US/Where_to_go_from_here.xml
===================================================================
--- trunk/documentation/guides/Beginners_Guide/en-US/Where_to_go_from_here.xml
(rev 0)
+++ trunk/documentation/guides/Beginners_Guide/en-US/Where_to_go_from_here.xml 2010-01-20
22:13:38 UTC (rev 19834)
@@ -0,0 +1,21 @@
+<?xml version='1.0' encoding='utf-8' ?>
+
+<chapter id="chap-Beginners_Guide-Where_to_go_from_here">
+ <title>Where to go from here</title>
+ <para>
+ For information pertaining to Eclipse visit <ulink
url="http://www.eclipse.org/">www.eclipse.org</ulink>.
+ </para>
+ <para>
+ For information about the JBoss Application Server visit <ulink
url="http://www.jboss.org/jbossas/">http://www.jboss.org/jbo...;.
+ </para>
+ <para>
+ For documentation about the JBoss Enterprise Application Platform visit <ulink
url="http://www.redhat.com/docs/en-US/JBoss_Enterprise_Application_P...;.
+ </para>
+ <para>
+ For documentation on the plugins available as part of JBoss Tools visit <ulink
url="http://www.jboss.org/tools/docs.html">http://www.jboss....;.
+ </para>
+ <para>
+ For documentation on the plugins available as part of the JBoss Developer Studio visit
<ulink
url="http://www.redhat.com/docs/en-US/JBoss_Developer_Studio/"&...;.
+ </para>
+</chapter>
+
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/Drools_code_rule_editor.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/Drools_code_rule_editor.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/Drools_rete_rule_editor.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/Drools_rete_rule_editor.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/Beginners_Guide/en-US/images/ESB_Editor.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/ESB_Editor.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/Beginners_Guide/en-US/images/Eclipse_main.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/Eclipse_main.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/Beginners_Guide/en-US/images/Eclipse_welcome_screen.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/Eclipse_welcome_screen.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/Beginners_Guide/en-US/images/Eclipse_workspace.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/Eclipse_workspace.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/Guvnor_connection_wizard.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/Guvnor_connection_wizard.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/Beginners_Guide/en-US/images/Guvnor_copy_file.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/Guvnor_copy_file.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/Beginners_Guide/en-US/images/Guvnor_repository.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/Guvnor_repository.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/Guvnor_resource_history_view.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/Guvnor_resource_history_view.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/Beginners_Guide/en-US/images/JBoss_AS_Overview.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/JBoss_AS_Overview.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/Beginners_Guide/en-US/images/JBoss_AS_localhost.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/JBoss_AS_localhost.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/Beginners_Guide/en-US/images/JSF_diagram_view.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/JSF_diagram_view.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/Beginners_Guide/en-US/images/JSF_source_view.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/JSF_source_view.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/Beginners_Guide/en-US/images/JSF_tree_view.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/JSF_tree_view.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/Beginners_Guide/en-US/images/Server_Started.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/Server_Started.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/Beginners_Guide/en-US/images/Start_Stop_Server.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/Start_Stop_Server.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/Beginners_Guide/en-US/images/View_Button.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/View_Button.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/Web_Services_Using_Document.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/Web_Services_Using_Document.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/Beginners_Guide/en-US/images/Web_Services_Wizard.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/Web_Services_Wizard.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Archive_Tools-Archive_Tools.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Archive_Tools-Archive_Tools.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Hibernate_Tools-Hibernate_Console.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Hibernate_Tools-Hibernate_Console.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-JBoss_AS_Tools-JBoss_Server_View.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-JBoss_AS_Tools-JBoss_Server_View.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-JMX_Tools-MBean_Editor.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-JMX_Tools-MBean_Editor.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-JMX_Tools-MBean_Explorer.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-JMX_Tools-MBean_Explorer.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Portal_Tools-Dynamic_Web_Project_wizard.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Portal_Tools-Dynamic_Web_Project_wizard.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Seam_Development_Tools-New_Seam_Project_wizard.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Seam_Development_Tools-New_Seam_Project_wizard.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Seam_Development_Tools-Seam_Components_Editor.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Seam_Development_Tools-Seam_Components_Editor.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Seam_Development_Tools-Seam_Pages_Editor_graphical_view.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Seam_Development_Tools-Seam_Pages_Editor_graphical_view.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Visual_Web_Tools-Content_Assist.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Visual_Web_Tools-Content_Assist.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Visual_Web_Tools-JBoss_Tools_Palette.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Visual_Web_Tools-JBoss_Tools_Palette.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Visual_Web_Tools-Visual_Page_Editor.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Visual_Web_Tools-Visual_Page_Editor.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Visual_Web_Tools-Web_Projects_View_for_JSF_left_and_Struts_right_projects.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/Beginners_Guide/en-US/images/figu-Beginners_Guide-Visual_Web_Tools-Web_Projects_View_for_JSF_left_and_Struts_right_projects.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/Beginners_Guide/en-US/master.xml
===================================================================
--- trunk/documentation/guides/Beginners_Guide/en-US/master.xml
(rev 0)
+++ trunk/documentation/guides/Beginners_Guide/en-US/master.xml 2010-01-20 22:13:38 UTC
(rev 19834)
@@ -0,0 +1,76 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3CR3//EN"
+"http://www.oasis-open.org/docbook/xml/4.3CR3/docbookx.dtd"
+
+[<!ENTITY Preface SYSTEM "Preface.xml">
+<!ENTITY Introduction SYSTEM "Introduction.xml">
+<!ENTITY The_interface SYSTEM "The_interface.xml">
+<!ENTITY Java_EE_and_SE SYSTEM
"Java_Web_(EE)_and_Standard_Edition_(SE).xml">
+<!ENTITY Service-Oriented_Architecture_Development SYSTEM
"Service-Oriented_Architecture_Development.xml">
+<!ENTITY Where_to_go_from_here SYSTEM "Where_to_go_from_here.xml">
+<!ENTITY Revision_History SYSTEM "Revision_History.xml">
+]>
+
+<book>
+
+ <bookinfo>
+ <title>Beginners Guide</title>
+ <corpauthor>
+ <inlinemediaobject>
+ <imageobject role="fo">
+ <imagedata format="PNG"
fileref="images/jbosstools_logo.png" />
+ </imageobject>
+ <imageobject role="html">
+ <imagedata/>
+ </imageobject>
+ </inlinemediaobject>
+ </corpauthor>
+
+ <author>
+ <firstname>Isaac</firstname>
+ <surname>Rooskov</surname>
+ <email>irooskov(a)redhat.com</email>
+ </author>
+ <author>
+ <firstname>Sean</firstname>
+ <surname>Rogers</surname>
+ <email>serogers(a)redhat.com</email>
+ </author>
+ <editor>
+ <firstname>Andrew</firstname>
+ <surname>Ross</surname>
+ <email>anross(a)redhat.com</email>
+ </editor>
+ <editor>
+ <firstname>Max</firstname>
+ <surname>Andersen</surname>
+ <email>max.andersen(a)redhat.com</email>
+ </editor>
+
+ <copyright>
+ <year>2010</year>
+ <holder>JBoss by Red Hat</holder>
+ </copyright>
+ <releaseinfo>
+ Version: 1.0
+ </releaseinfo>
+<!--<abstract>
+ <title/>
+ <para>
+ <ulink
url="http://download.jboss.org/jbosstools/nightly-docs/en/jboss_bpmn...
version</ulink>
+ </para>
+</abstract> -->
+
+
+ </bookinfo>
+
+ <toc/>
+ <!-- &Preface; -->
+ &Introduction;
+ &The_interface;
+ &Java_EE_and_SE;
+ &Service-Oriented_Architecture_Development;
+ &Where_to_go_from_here;
+ &Revision_History;
+
+</book>