Author: mmcallis Date: 2008-02-18 03:25:42 -0500 (Mon, 18 Feb 2008) New Revision: 10012 Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml Log: 5.2.4.4. Building your Apache MyFaces JSF Porlet revising and adding content to make this section consistent with 5.2.2.5. Building your JSP Portlet Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml =================================================================== --- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml 2008-02-18 06:04:52 UTC (rev 10011) +++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml 2008-02-18 08:25:42 UTC (rev 10012) @@ -1431,9 +1431,9 @@ </para> <para> <note> - <title>Adding Functionality to a Apache MyFaces JSF Porlet</title> + <title>Adding Functionality to an Apache MyFaces JSF Porlet</title> <para> - To add functionality to a Apache MyFaces JSF Porlet, sub-class it and create your own class. + To add functionality to an Apache MyFaces JSF Porlet, sub-class it and create your own class. </para> </note> </para> @@ -1482,11 +1482,68 @@ </sect3> <sect3> <title>Building your Apache MyFaces JSF Porlet</title> - <para>If you have downloaded the sample, you can execute the build.xml with ant or inside your IDE. - Executing <literal>ant</literal> will compile all source files and produce a - <literal>helloworldjsfportlet.war</literal> file in a way similar to what we saw in - <xref linkend="first_portlet_build"/>. - </para> + <para> + The <filename>HelloWorldJSFMyFaces42Portlet.zip</filename> file contains a pre-compiled <filename>helloworldjsfmyfacesportlet.war</filename> file; however, to manually build the <filename>helloworldjsfmyfacesportlet.war</filename> file: + </para> + <para> + <orderedlist> + <listitem> + <para> + Change into the <filename>HelloWorldJSFMyFaces42Portlet/</filename> directory, and remove the existing <filename>helloworldjsfmyfacesportlet.war</filename> file. + </para> + </listitem> + <listitem> + <para> + If required, edit the <filename>HelloWorldJSFMyFaces42Portlet/src/main/org/jboss/portlet/hello/bean/User.java</filename> file, and the application descriptors in the <filename>HelloWorldJSFMyFaces42Portlet/src/resources/helloworldjsfmyfacesportlet-war/WEB-INF/</filename> directory. + </para> + </listitem> + <listitem> + <para> + Change into <filename>HelloWorldJSFMyFaces42Portlet/</filename> directory, and run the <command>ant deploy</command> command. On Linux, the output will be similar to the following: + </para> + <para> + <mediaobject> + <imageobject> + <imagedata align="center" fileref="images/tutorials/jsf_portlet/myfaces_ant_deploy.png" valign="middle"/> + </imageobject> + </mediaobject> + </para> + </listitem> + </orderedlist> + </para> + <para> + Note: the directory names will be different for your system. + </para> + <para> + Expanding the <filename>helloworldjsfmyfacesportlet.war</filename> file allows you to deploy the portlet as an expanded directory, which makes development easier. As well, it gives you access to the application descriptors, resource files, JSF, and JSP pages. To expand the <filename>helloworldjsfmyfacesportlet.war</filename> file: + </para> + <para> + <orderedlist> + <listitem> + <para> + If you do not have the <filename>HelloWorldJSFMyFaces42Portlet/helloworldjsfmyfacesportlet.war</filename> file, change into the <filename>HelloWorldJSFMyFaces42Portlet/</filename> directory, and run the <command>ant deploy</command> command. This creates the <filename>helloworldjsfmyfacesportlet.war</filename> file. + </para> + </listitem> + <listitem> + <para> + To expand the WAR file, change into the <filename>HelloWorldJSFMyFaces42Portlet/</filename> directory, and run the <command>ant explode</command> command. On Linux, the output will be similar to the following: + </para> + <para> + <mediaobject> + <imageobject> + <imagedata align="center" fileref="images/tutorials/jsf_portlet/myfaces_ant_explode.png" valign="middle"/> + </imageobject> + </mediaobject> + </para> + </listitem> + </orderedlist> + </para> + <para> + Note: the directory names will be different for your system. + </para> + <para> + The expanded WAR file and the application descriptors are located in the <filename>HelloWorldJSFMyFaces42Portlet/output/lib/exploded/helloworldjsfmyfacesportlet.war/WEB-INF/</filename> directory. + </para> </sect3> <sect3> <title>Deploying your Apache MyFaces JSF Portlet</title>