From jbosstools-commits at lists.jboss.org Thu Jan 29 12:35:56 2009 Content-Type: multipart/mixed; boundary="===============1186300166531054324==" MIME-Version: 1.0 From: jbosstools-commits at lists.jboss.org To: jbosstools-commits at lists.jboss.org Subject: [jbosstools-commits] JBoss Tools SVN: r13343 - branches/jbosstools-3.0.0.CR2/jsf/docs/jsf_tools_tutorial/en. Date: Thu, 29 Jan 2009 12:35:55 -0500 Message-ID: --===============1186300166531054324== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: ochikvina Date: 2009-01-29 12:35:55 -0500 (Thu, 29 Jan 2009) New Revision: 13343 Added: branches/jbosstools-3.0.0.CR2/jsf/docs/jsf_tools_tutorial/en/master_outp= ut.xml Log: https://jira.jboss.org/jira/browse/JBDS-571- adding the master_output.xml; Added: branches/jbosstools-3.0.0.CR2/jsf/docs/jsf_tools_tutorial/en/master_= output.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- branches/jbosstools-3.0.0.CR2/jsf/docs/jsf_tools_tutorial/en/master_out= put.xml (rev 0) +++ branches/jbosstools-3.0.0.CR2/jsf/docs/jsf_tools_tutorial/en/master_out= put.xml 2009-01-29 17:35:55 UTC (rev 13343) @@ -0,0 +1,798 @@ + + + + + + + + + + + + + + + + + + + + + = + +]> + = + + JSF Tools Tutorial + = + AnatolyFedosik + OlgaChikvina + SvetlanaMukhina<= email>smukhina(a)exadel.com + = + April 2008 + + 2007 + 2008 + JBoss, a division of Red Hat Inc. + + + + Version: 3.0.0.CR2 + + + + + + + PDF version + + + + + = + = + = + = + = + = + + + + + JBoss Developer Studio + Eclipse + Java + JBoss + + + Introduction + The following chapters describe how to deal with classic/old style= of JSF development. We + recommend users to use JBoss + Seam to simplify development, but until then you can read abou= t classical JSF = + usage here. + = + Thus, in this document we are going to show you how to create a si= mple JSF application + using JBoss Tools plug= ins for Eclipse. The completed + application will ask a user to enter a name and click a button. The re= sulting new page + will display the familiar message, "Hello <name>!" This + tutorial will show you how to create and run such an application from = the beginning along the + way demonstrating some of the powerful features of JBoss Tools. + = +
+ Other relevant resources on the topic + All JBoss Developer Studio/JBoss Tools documentation you can fin= d here.= + The latest documentation builds are available here. +
+ = +
+ + = + + + + + JBoss Developer Studio + JSF application + Java + + + + Creating a Simple JSF Application + + Firstly, we assume that you have already launched Eclipse with <= property moreinfo=3D"none">JBoss Tools + plug-ins installed and also that the W= eb Development perspective is the current + one. (If not, make it active by selecting + Window > Open Perspective > = Web Development + from the menu bar or by selecting + Window > Open Perspective > = Other... + from the menu bar and then selecting + Web Development + from the Select Perspective dialog box.) + +
+ + Setting Up the Project + Now we are going to create a new project for the application= . + + + For that go to the menu bar and select + File > New > Pro= ject... + + + + Select + JBoss Tools Web > J= SF > JSF Project + in the New Project dialog box + + + Click + Next + + + + Enter "jsfHello" as the project name. + + + Leave everything else as is, and click + Finish + + + + +
+ +
+ + JSF Configuration File + A jsfHello node should appear in the upper-left Package Expl= orer view. +
+ Package Explorer View + + + + + +
+ + + Click the plus sign next to + jsfHello + to reveal the child nodes + + + Click the plus sign next to + WebContent + under jsfHello + + + Click the plus sign next to + WEB-INF + under WebContent + + + + Then double-click on the faces-config.xml node to display + the JSF application configuration file editor + + +
+ Configuration File Editor + + + + + +
+ +
+
+ + = + + + + + JBoss Tools + JSF application + Java + + + = + Adding Navigation to the Application + = + In our simple application, the flow is defined as a single n= avigation rule connecting + two views (presentation files). At this point, we will create = the placeholders for the + two JSP presentation files and then the navigation rule to con= nect them as views. Later, + we will complete the coding for the JSP presentation files. We= can do all of this in the + Diagram mode of the configuration file editor. +
+ + Adding Two Views (JSP Pages) + + + Right-click anywhere on the diagram and select <= emphasis> + New View... + from the pop-up menu + + + In the dialog box, type + pages/inputname + as the value for From-view-id + + + Leave everything else as is + + + Click + Finish + + If you look in the Package Explorer view you sho= uld see a + pages + folder under WebContent. Opening it will r= eveal the JSP file you + just created + + + Back on the diagram, right-click anywhere and se= lect + New View... + from the pop-up menu + + + In the dialog box, type + pages/greeting + as the value for From-view-id + + + Leave everything else as is + + + Click + Finish + + + + = +
+
+ + Creating the Transition (Navigation Rule) + + + In the diagram, select the connection icon third fro= m the top along + the upper left side of the diagram + + +
+ Connection Icon + + + + + +
+ to get an arrow cursor with a two-pronged plug at the arrow'= s bottom. + + + Click on the + pages/inputname + page icon and then click on the + pages/greeting + page icon + + = + + A transition should appear between the two icons. +
+ Transition Between Two Icons + + + + + +
+ + + Select + File > Save + from the menu bar + + +
+ = +
+ = + + + + + JBoss Developer Studio + JSF application + Java + + + + Adding a Managed Bean to the Application + To store data in the application, we will use a managed bean= . + + + Click on the + Tree + tab at the bottom of the editing window + + + Select the + Managed Beans + node and then click the + Add... + button displayed along the right side of the e= ditor window + + + Type in + jsfHello.PersonBean + for Class and + personBean + for Name. Leave Scope as is and Generate Sourc= e Code as is + (checked) + + + Click + Finish + + + + personBean will now be selected and three sections o= f information: + Managed Bean + , + Properties + , and + Advanced + , will be displayed about it. Under the Propert= ies section, click the + Add... + button + + + Type in + name + for Property-Name. Leave everything else as is= . (When Property- + Class is not filled in, String is the assumed type) + + + Click + Finish + + + + Select the + personBean + node in the tree + + + You should see this now: +
+ Tree View in Config Editor + + + + + +
+ + + Select + File > Save + from the menu bar + + + You have now registered the + managed bean + and created a + stub-coded class + file for it. + = +
+ = + + + + + JBoss Tools + JSF application + Java + + + + Editing the JSP View Files + = + Now we will finish editing the JSP files for our two "views"= using + JSP Visual Page. +
+ inputname.jsp + + + Click on the + Diagram + tab for the configuration file editor + + + Open the editor for this first JSP file by doubl= e-clicking on the + /pages/inputname. jsp<= /property> + icon + + + = + The Visual Page Editor will open in a screen split betwe= en source code along the + top and a WYSIWIG view along the bottom: +
+ Visual Page Editor + + + + + +
+ Some JSF code is already in the file, because we have ch= osen a template to create + a page. + + + Select the + Visual + tab, so we can work with the editor comple= tely in its WYSIWYG + mode + + + To the right of the editor, in the JBoss Tools P= alette, expand the + JSF HTML + palette folder by selecting it + + +
+ JBoss Tools Palette + + + + + +
+ + + Click on + form + within this folder, drag the cursor over t= o the editor, and drop + it inside the red box in the editor + + + Another red box will appear inside the first red= box + + + Right-click on the innermost box and select + <h:form> + Attributes from the menu + + + In the value field next to id, type + greeting + and click on the + Close + button + + + Type "Please enter name:" inside the boxes + + + Select + inputText + within the JSF HTML palette folder and dra= g it into the + innermost box in the editor after "Please enter + name:" + + + In the attributes dialog, click in the + value + field next to the value attribute and clic= k on the ... + button + + + Then, select the + Managed Beans > per= sonBean > name + node and click on the + Ok + button + + + Back in the attributes dialog, select the + Advanced + tab, type in + name + as the value for the + "id" + attribute, and then click on the + Finish + button + + + Select + commandButton + within the JSF HTML palette folder and dra= g it into the + innermost box in the editor after the input box + + + In the attributes dialog, click in the value fie= ld next to the + "action" + attribute and click on the ... + button + + + Then, select the + View Actions > gree= ting + node and click on the + OK + button + + + Back in the attributes dialog box, type in "Say = Hello" + as the value for the value attribute ("Say Hello")= and + then click on the + Finish + button + + + The source coding should be something like this now: + +<%@ taglib uri=3D"http://java.sun.com/jsf/core" prefix=3D"f" %> + + + + + + + +Please enter a name: + + + + + + +]]> + The editor should look like this: +
+ Visual Page Editor + + + + + +
+ + + Save the file by selecting + File > Save + from the menu bar + + +
+
+ greeting.jsp + + + Click on the + faces-config.xml + tab to bring the diagram back + + + Open the editor for the second file by double-cl= icking on the + /pages/greeting.jsp + icon + + + Select the + Visual + tab, so we can work with the editor comple= tely in its WYSIWYG + mode + + + Type "Hello "(note space after Hello) into the + box + + + Select + outputText + within the JSF HTML palette folder and dra= g it into the + innermost box in the editor after "Hello" + + + In the attributes dialog, click in + value + field next to the value attribute and clic= k on the + ... (Browse= ) button + + + Then, select the + Managed Beans > per= sonBean > name + node, click on the + Ok + button, and then click on the + Finish + button + + + Right after the output field, type an + exclamation point + ( + ! + ) + + + The source coding should be something like this now: + +<%@ taglib uri=3D"http://java.sun.com/jsf/core" prefix=3D"f" %> + + + + + + +Hello ! + + + +]]> + + + Save the file + + +
+
+ = + + + + + JBoss Tools + JSF application + Java + + + + Creating the Start Page + You also need to create a start page as an entry point into = the application. + + + In the Package Explorer view to the left, right-clic= k + jsfHello > WebContent + and select + New > JSP File + + + + For Name type in + index + , for Template select + JSPRedirect + and click + Finish + + + + A JSP editor will open up on the newly created file. + = + + + In the Source part of the split screen, type + /pages/inputname.jsf + in between the quotes for the page attribute + + + The source coding should look like this now: + + + + + + + +]]> + = + Note the + .jsf + extension for the file name. This is a mapping defined= in the web.xml file + for the project for invoking JavaS= erver Faces when you run the + application. + + + Select + File > Save + from the menu bar + + + + = + + + + + JBoss Tools + JSF application + Java + + + = + Running the Application + Everything is now ready for running our application by using= the JBoss engine. For + controlling JBoss server there is JBoss Server view: +
+ JBoss Server View + + + + + +
+ + + Start up JBoss by clicking on the icon in JBoss Serv= er view. (If JBoss is + already running, stop it by clicking on the red icon a= nd then start it again. + Remember, the JSF run-time requires restarting the ser= vlet engine when any + changes have been made.) After the messages in the Con= sole tabbed view stop + scrolling, JBoss is available + + = + + Click the Run icon or right click your project folde= r and select + Run As > Run on Server<= /property> + : + + +
+ Run Icon + + + + + +
+ This is the equivalent of launching the browser and typing <= emphasis> + http://localhost:8080/jsfHello + into your browser. Our JSF= application should now + appear. +
= + = + + + + + JBoss Tools + JSF application + Java + + + + Other Relevant Resources on the topic + JSF on Sun: JavaServer Faces + Technology + Core JSF: Core = JavaServer Faces + API: JSF + API + JSF Tags: JSF Core + Tags + HTML Tags Reference: JSF HTML Tags Reference + JSF Central: JSF Centr= al - Your JavaServer Faces + Community + FAQ: JSF + FAQ + Download: JavaServer + Faces Technology - Download + + In summary, with this tutorial you should now know how to organi= ze JSF sample application + using the wizards provided by JBoss To= ols, configure its stuff and + finally run it on the JBoss Server. + + Find out more features on JSF tooling in our JSF Tools + Reference Guide. If you have questions and suggestions= , please refer to JBoss + Tools Forum. + + = +
--===============1186300166531054324==--