[jbosstools-commits] JBoss Tools SVN: r19849 - in trunk/documentation/guides/Beginners_Guide/en: modules and 1 other directory.

Author: ochikvina Date: 2010-01-21 11:46:45 -0500 (Thu, 21 Jan 2010) New Revision: 19849 Added: trunk/documentation/guides/Beginners_Guide/en/images/Drools_code_rule_editor.png trunk/documentation/guides/Beginners_Guide/en/images/Drools_rete_rule_editor.png trunk/documentation/guides/Beginners_Guide/en/images/ESB_Editor.png trunk/documentation/guides/Beginners_Guide/en/images/Eclipse_main.png trunk/documentation/guides/Beginners_Guide/en/images/Eclipse_welcome_screen.png trunk/documentation/guides/Beginners_Guide/en/images/Eclipse_workspace.png trunk/documentation/guides/Beginners_Guide/en/images/Guvnor_connection_wizard.png trunk/documentation/guides/Beginners_Guide/en/images/Guvnor_copy_file.png trunk/documentation/guides/Beginners_Guide/en/images/Guvnor_repository.png trunk/documentation/guides/Beginners_Guide/en/images/Guvnor_resource_history_view.png trunk/documentation/guides/Beginners_Guide/en/images/JBoss_AS_Overview.png trunk/documentation/guides/Beginners_Guide/en/images/JBoss_AS_localhost.png trunk/documentation/guides/Beginners_Guide/en/images/JSF_diagram_view.png trunk/documentation/guides/Beginners_Guide/en/images/JSF_source_view.png trunk/documentation/guides/Beginners_Guide/en/images/JSF_tree_view.png trunk/documentation/guides/Beginners_Guide/en/images/Server_Started.png trunk/documentation/guides/Beginners_Guide/en/images/Start_Stop_Server.png trunk/documentation/guides/Beginners_Guide/en/images/View_Button.png trunk/documentation/guides/Beginners_Guide/en/images/Web_Services_Using_Document.png trunk/documentation/guides/Beginners_Guide/en/images/Web_Services_Wizard.png trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Archive_Tools-Archive_Tools.png trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Hibernate_Tools-Hibernate_Console.png trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-JBoss_AS_Tools-JBoss_Server_View.png trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-JMX_Tools-MBean_Editor.png trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-JMX_Tools-MBean_Explorer.png trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Portal_Tools-Dynamic_Web_Project_wizard.png trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Seam_Development_Tools-New_Seam_Project_wizard.png trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Seam_Development_Tools-Seam_Components_Editor.png trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Seam_Development_Tools-Seam_Pages_Editor_graphical_view.png trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Visual_Web_Tools-Content_Assist.png trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Visual_Web_Tools-JBoss_Tools_Palette.png trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Visual_Web_Tools-Visual_Page_Editor.png trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Visual_Web_Tools-Web_Projects_View_for_JSF_left_and_Struts_right_projects.png trunk/documentation/guides/Beginners_Guide/en/modules/Author_Group.xml trunk/documentation/guides/Beginners_Guide/en/modules/Beginners_Guide.xml trunk/documentation/guides/Beginners_Guide/en/modules/Book_Info.xml trunk/documentation/guides/Beginners_Guide/en/modules/Feedback.xml trunk/documentation/guides/Beginners_Guide/en/modules/Introduction.xml trunk/documentation/guides/Beginners_Guide/en/modules/Java_Web_(EE)_and_Standard_Edition_(SE).xml trunk/documentation/guides/Beginners_Guide/en/modules/Preface.xml trunk/documentation/guides/Beginners_Guide/en/modules/Revision_History.xml trunk/documentation/guides/Beginners_Guide/en/modules/SOA-P_Workshop.xml trunk/documentation/guides/Beginners_Guide/en/modules/Service-Oriented_Architecture_Development.xml trunk/documentation/guides/Beginners_Guide/en/modules/The_interface.xml trunk/documentation/guides/Beginners_Guide/en/modules/Where_to_go_from_here.xml Log: <html><head><meta name="qrichtext" content="1" /></head><body style="font-size:9pt;font-family:Sans Serif"> <p>https://jira.jboss.org/jira/browse/JBIDE-5708 restructured the guide according to the documentation agreement.changed &lt;para&gt; to &lt;phrase&gt; where it's necessary.</p> </body></html> Added: trunk/documentation/guides/Beginners_Guide/en/images/Drools_code_rule_editor.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/Drools_code_rule_editor.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/Drools_rete_rule_editor.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/Drools_rete_rule_editor.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/ESB_Editor.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/ESB_Editor.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/Eclipse_main.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/Eclipse_main.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/Eclipse_welcome_screen.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/Eclipse_welcome_screen.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/Eclipse_workspace.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/Eclipse_workspace.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/Guvnor_connection_wizard.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/Guvnor_connection_wizard.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/Guvnor_copy_file.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/Guvnor_copy_file.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/Guvnor_repository.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/Guvnor_repository.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/Guvnor_resource_history_view.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/Guvnor_resource_history_view.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/JBoss_AS_Overview.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/JBoss_AS_Overview.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/JBoss_AS_localhost.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/JBoss_AS_localhost.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/JSF_diagram_view.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/JSF_diagram_view.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/JSF_source_view.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/JSF_source_view.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/JSF_tree_view.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/JSF_tree_view.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/Server_Started.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/Server_Started.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/Start_Stop_Server.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/Start_Stop_Server.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/View_Button.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/View_Button.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/Web_Services_Using_Document.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/Web_Services_Using_Document.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/Web_Services_Wizard.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/Web_Services_Wizard.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Archive_Tools-Archive_Tools.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Archive_Tools-Archive_Tools.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Hibernate_Tools-Hibernate_Console.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Hibernate_Tools-Hibernate_Console.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-JBoss_AS_Tools-JBoss_Server_View.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-JBoss_AS_Tools-JBoss_Server_View.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-JMX_Tools-MBean_Editor.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-JMX_Tools-MBean_Editor.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-JMX_Tools-MBean_Explorer.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-JMX_Tools-MBean_Explorer.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Portal_Tools-Dynamic_Web_Project_wizard.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Portal_Tools-Dynamic_Web_Project_wizard.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Seam_Development_Tools-New_Seam_Project_wizard.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Seam_Development_Tools-New_Seam_Project_wizard.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Seam_Development_Tools-Seam_Components_Editor.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Seam_Development_Tools-Seam_Components_Editor.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/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/images/figu-Beginners_Guide-Seam_Development_Tools-Seam_Pages_Editor_graphical_view.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Visual_Web_Tools-Content_Assist.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Visual_Web_Tools-Content_Assist.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Visual_Web_Tools-JBoss_Tools_Palette.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Visual_Web_Tools-JBoss_Tools_Palette.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Visual_Web_Tools-Visual_Page_Editor.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/Beginners_Guide/en/images/figu-Beginners_Guide-Visual_Web_Tools-Visual_Page_Editor.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/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/images/figu-Beginners_Guide-Visual_Web_Tools-Web_Projects_View_for_JSF_left_and_Struts_right_projects.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: trunk/documentation/guides/Beginners_Guide/en/modules/Author_Group.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en/modules/Author_Group.xml (rev 0) +++ trunk/documentation/guides/Beginners_Guide/en/modules/Author_Group.xml 2010-01-21 16:46:45 UTC (rev 19849) @@ -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&gt;irooskov(a)redhat.com&lt;/email&gt; + </author> + <author> + <firstname>Sean</firstname> + <surname>Rogers</surname> + <email&gt;serogers(a)redhat.com&lt;/email&gt; + </author> + <editor> + <firstname>Andrew</firstname> + <surname>Ross</surname> + <email&gt;anross(a)redhat.com&lt;/email&gt; + </editor> + <editor> + <firstname>Max</firstname> + <surname>Andersen</surname> + <email&gt;max.andersen(a)redhat.com&lt;/email&gt; + </editor> +</authorgroup> + Added: trunk/documentation/guides/Beginners_Guide/en/modules/Beginners_Guide.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en/modules/Beginners_Guide.xml (rev 0) +++ trunk/documentation/guides/Beginners_Guide/en/modules/Beginners_Guide.xml 2010-01-21 16:46:45 UTC (rev 19849) @@ -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/modules/Book_Info.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en/modules/Book_Info.xml (rev 0) +++ trunk/documentation/guides/Beginners_Guide/en/modules/Book_Info.xml 2010-01-21 16:46:45 UTC (rev 19849) @@ -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>&nbsp; and the <application>JBoss Developer Studio</application>&nbsp; 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/modules/Feedback.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en/modules/Feedback.xml (rev 0) +++ trunk/documentation/guides/Beginners_Guide/en/modules/Feedback.xml 2010-01-21 16:46:45 UTC (rev 19849) @@ -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/modules/Introduction.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en/modules/Introduction.xml (rev 0) +++ trunk/documentation/guides/Beginners_Guide/en/modules/Introduction.xml 2010-01-21 16:46:45 UTC (rev 19849) @@ -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> + Property changes on: trunk/documentation/guides/Beginners_Guide/en/modules/Introduction.xml ___________________________________________________________________ Name: svn:executable + * Added: trunk/documentation/guides/Beginners_Guide/en/modules/Java_Web_(EE)_and_Standard_Edition_(SE).xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en/modules/Java_Web_(EE)_and_Standard_Edition_(SE).xml (rev 0) +++ trunk/documentation/guides/Beginners_Guide/en/modules/Java_Web_(EE)_and_Standard_Edition_(SE).xml 2010-01-21 16:46:45 UTC (rev 19849) @@ -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"> + <?dbhtml filename="java_Web_EE_and_Standard_Edition_SE_Plug_Ins.html"?> + <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> + <phrase> + The JBoss Tools Palette, with a number of standard libraries loaded. + </phrase> + </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> + <phrase> + The Web Projects View, showing a <acronym>JSF</acronym> project on the left and a Struts project on the right. + </phrase> + </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> + <phrase> + Content Assist with <acronym>JSF</acronym> code completion suggestions. + </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>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> + <phrase> + The New Seam Project wizard, used to configure a Seam project. + </phrase> + </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> + <phrase> + The graphical view of the Seam Pages Editor, representing the project page-flow and exception handling. + </phrase> + </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> + <phrase> + The Seam Components Editor, displaying the components in a hierarchical tree. + </phrase> + </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> + <phrase> + The Hibernate Console consists of multiple panels representing the database. + </phrase> + </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> + <phrase> + The Dynamic Web Project wizard streamlines the creation of a <application>JBoss Portal</application> application. + </phrase> + </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> + <phrase> + The MBean Explorer lists a connection's Managed Beans, domains, attributes, and operations in a hierarchical tree. + </phrase> + </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> + <phrase> + The MBean Editor is a property editor for Managed Beans. + </phrase> + </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> + <phrase> + The Servers view shows the installed servers and their current states. + </phrase> + </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> + <phrase> + Project archives can be managed with the Archive Tools. + </phrase> + </textobject> + </mediaobject> + </figure> + <para> + Refer to the <citetitle pubwork="book">JBoss Server Manager Reference Guide</citetitle> for full details. + </para> + </section> + +</chapter> + Property changes on: trunk/documentation/guides/Beginners_Guide/en/modules/Java_Web_(EE)_and_Standard_Edition_(SE).xml ___________________________________________________________________ Name: svn:executable + * Added: trunk/documentation/guides/Beginners_Guide/en/modules/Preface.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en/modules/Preface.xml (rev 0) +++ trunk/documentation/guides/Beginners_Guide/en/modules/Preface.xml 2010-01-21 16:46:45 UTC (rev 19849) @@ -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> + Property changes on: trunk/documentation/guides/Beginners_Guide/en/modules/Preface.xml ___________________________________________________________________ Name: svn:executable + * Added: trunk/documentation/guides/Beginners_Guide/en/modules/Revision_History.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en/modules/Revision_History.xml (rev 0) +++ trunk/documentation/guides/Beginners_Guide/en/modules/Revision_History.xml 2010-01-21 16:46:45 UTC (rev 19849) @@ -0,0 +1,23 @@ +<?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&gt;irooskov(a)redhat.com&lt;/email&gt; + </author> + <revdescription> + <simplelist> + <member>Initial creation of book by publican</member> + </simplelist> + </revdescription> + </revision> + </revhistory> + </simpara> +</appendix> + Property changes on: trunk/documentation/guides/Beginners_Guide/en/modules/Revision_History.xml ___________________________________________________________________ Name: svn:executable + * Added: trunk/documentation/guides/Beginners_Guide/en/modules/SOA-P_Workshop.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en/modules/SOA-P_Workshop.xml (rev 0) +++ trunk/documentation/guides/Beginners_Guide/en/modules/SOA-P_Workshop.xml 2010-01-21 16:46:45 UTC (rev 19849) @@ -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/modules/Service-Oriented_Architecture_Development.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en/modules/Service-Oriented_Architecture_Development.xml (rev 0) +++ trunk/documentation/guides/Beginners_Guide/en/modules/Service-Oriented_Architecture_Development.xml 2010-01-21 16:46:45 UTC (rev 19849) @@ -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> + Property changes on: trunk/documentation/guides/Beginners_Guide/en/modules/Service-Oriented_Architecture_Development.xml ___________________________________________________________________ Name: svn:executable + * Added: trunk/documentation/guides/Beginners_Guide/en/modules/The_interface.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en/modules/The_interface.xml (rev 0) +++ trunk/documentation/guides/Beginners_Guide/en/modules/The_interface.xml 2010-01-21 16:46:45 UTC (rev 19849) @@ -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 &gt;</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 &gt;</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>&lt; 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> + Property changes on: trunk/documentation/guides/Beginners_Guide/en/modules/The_interface.xml ___________________________________________________________________ Name: svn:executable + * Added: trunk/documentation/guides/Beginners_Guide/en/modules/Where_to_go_from_here.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en/modules/Where_to_go_from_here.xml (rev 0) +++ trunk/documentation/guides/Beginners_Guide/en/modules/Where_to_go_from_here.xml 2010-01-21 16:46:45 UTC (rev 19849) @@ -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> + Property changes on: trunk/documentation/guides/Beginners_Guide/en/modules/Where_to_go_from_here.xml ___________________________________________________________________ Name: svn:executable + *