From portal-commits at lists.jboss.org Sat Feb 16 01:20:27 2008
Content-Type: multipart/mixed; boundary="===============3865801488017387026=="
MIME-Version: 1.0
From: portal-commits at lists.jboss.org
To: portal-commits at lists.jboss.org
Subject: [portal-commits] JBoss Portal SVN: r10000 - in
 docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en:
 images/tutorials/jsp_portlet and 1 other directories.
Date: Sat, 16 Feb 2008 01:20:27 -0500
Message-ID: <E1JQGPT-0004pK-Mv@committer01.frg.pub.inap.atl.jboss.com>

--===============3865801488017387026==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: mmcallis
Date: 2008-02-16 01:20:27 -0500 (Sat, 16 Feb 2008)
New Revision: 10000

Added:
   docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/images/tutorials=
/jsf_portlet/jsf_ant_deploy.png
   docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/images/tutorials=
/jsf_portlet/jsf_ant_explode.png
Modified:
   docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/images/tutorials=
/jsp_portlet/jsp_ant_explode.png
   docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorial=
s.xml
Log:
5.2.3. An example Sun JSF Reference Implementation (RI) Portlet
* adding images of ant deploy and ant explode
* fixing my images that had a black line
* revising 5.2.3 to be consistent with 5.2.1. Deploying your first Portlet
and 5.2.2. An example JSP Portlet


Added: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/images/tutor=
ials/jsf_portlet/jsf_ant_deploy.png
=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
(Binary files differ)


Property changes on: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/e=
n/images/tutorials/jsf_portlet/jsf_ant_deploy.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/images/tutor=
ials/jsf_portlet/jsf_ant_explode.png
=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
(Binary files differ)


Property changes on: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/e=
n/images/tutorials/jsf_portlet/jsf_ant_explode.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/images/tu=
torials/jsp_portlet/jsp_ant_explode.png
=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
(Binary files differ)

Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/t=
utorials.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
--- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutoria=
ls.xml	2008-02-16 05:05:05 UTC (rev 9999)
+++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutoria=
ls.xml	2008-02-16 06:20:27 UTC (rev 10000)
@@ -1155,34 +1155,114 @@
 </para>
          </sect3>
          <sect3>
-            <title>Building and deploying your portlet</title>
-            <para>If you have downloaded the sample, you can execute the b=
uild.xml with ant or inside your IDE.
-               Executing <literal>ant</literal> will compile all source fi=
les and produce a
-               <literal>helloworldjspportlet.war</literal> file in a way s=
imilar to what we saw in
-               <xref linkend=3D"first_portlet_build"/>.
+		 <title>Building your JSF Portlet</title>
+		 <para>
+			 The <filename>HelloWorldJSFSunRIPortlet.zip</filename> file contains a=
 pre-compiled <filename>helloworldjsfsunriportlet.war</filename> file; howe=
ver, to manually build the <filename>helloworldjsfsunriportlet.war</filenam=
e> file:
+	         </para>
+		 <para>
+			 <orderedlist>
+				 <listitem>
+					 <para>
+						 Change into the <filename>HHelloWorldJSFSunRIPortlet</filename> dir=
ectory, and remove the existing <filename>helloworldjsfsunriportlet.war</fi=
lename> file.
+					 </para>
+				 </listitem>
+				 <listitem>
+					 <para>
+						 If required, edit the <filename>HelloWorldJSFSunRIPortlet/src/main/=
org/jboss/portlet/hello/bean/User.java</filename> file, and the XML descrip=
tors in the <filename>HelloWorldJSFSunRIPortlet/src/resources/helloworldjsf=
sunriportlet-war/WEB-INF/</filename> directory.
+					 </para>
+				 </listitem>
+				 <listitem>
+					 <para>
+						 Change into <filename>HelloWorldJSFSunRIPortlet/</filename> directo=
ry, and run the <command>ant deploy</command> command. On Linux, the output=
 will be similar to the following:
+					 </para>
+					 <para>
+						 <mediaobject>
+							 <imageobject>
+								 <imagedata align=3D"center" fileref=3D"images/tutorials/jsf_portl=
et/jsf_ant_deploy.png" valign=3D"middle"/>
+							 </imageobject>
+						 </mediaobject>
+					 </para>
+				 </listitem>
+			 </orderedlist>
+		 </para>
+		 <para>
+			 Note: the directory names will be different for your system.
+	    </para>
+	    <para>
+		    Expanding the <filename>helloworldjsfsunriportlet.war</filename> fil=
e allows you to deploy the portlet as an expanded directory, which makes de=
velopment easier. As well, it gives you access to the XML descriptors, reso=
urce files, JSF, and JSP pages. To expand the <filename>helloworldjsfsunrip=
ortlet.war</filename> file:
+	    </para>
+	    <para>
+		    <orderedlist>
+			    <listitem>
+				    <para>
+					    If you do not have the <filename>HelloWorldJSFSunRIPortlet/hellow=
orldjsfsunriportlet.war</filename> file, change into the <filename>HelloWor=
ldJSFSunRIPortlet/</filename> directory, and run the <command>ant deploy</c=
ommand> command. This creates the <filename>helloworldjsfsunriportlet.war</=
filename> file.
+				    </para>
+			    </listitem>
+			    <listitem>
+				    <para>
+					    To expand the war file, change into the <filename>HelloWorldJSFSu=
nRIPortlet/</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=3D"center" fileref=3D"images/tutorials/jsf_por=
tlet/jsf_ant_explode.png" valign=3D"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 XML descriptors are located in the <fi=
lename>HelloWorldJSFSunRIPortlet/output/lib/exploded/helloworldjsfsunriport=
let.war</filename> directory.
             </para>
-            <!--
-            <para>
-               The <literal>explode</literal> target will produce the foll=
owing:
-               <mediaobject>
-                  <imageobject>
-                     <imagedata align=3D"center" fileref=3D"images/tutoria=
ls/jsf_portlet/exploded.gif" valign=3D"middle"/>
-                  </imageobject>
+    </sect3>
+    <sect3>
+	    <title>Deploying your JSF Portlet</title>
+	    <para>
+		    If you did not expand the <filename>helloworldjsfsunriportlet.war</f=
ilename> file, copy the <filename>HelloWorldJSFSunRIPortlet/helloworldjsfsu=
nriportlet.war</filename> file into the correct JBoss AS or JBoss EAP <file=
name>deploy/</filename> directory. If you expanded the <filename>helloworld=
jsfsunriportlet.war</filename> file, copy the <filename>HelloWorldJSFSunRIP=
ortlet/output/lib/exploded/helloworldjsfsunriportlet.war/</filename> direct=
ory into the correct JBoss AS or JBoss EAP <filename>deploy/</filename> dir=
ectory. For example, if you are using JBoss AS, copy the war file or the ex=
panded directory into the <filename>$JBOSS_HOME/server/default/deploy/</fil=
ename> directory.
+	    </para>
+	    <para>
+		    Performing this step on a running instance of JBoss AS or JBoss EAP,=
 and JBoss Portal, will trigger a hot-deploy of the portlet:
+	    </para>
+	    <para>
+<screen><![CDATA[
+INFO  [TomcatDeployer] deploy, ctxPath=3D/helloworldjsfsunriportlet, warUr=
l=3D.../tmp/deploy/tmp9138helloworldjsfsunriportlet-exp.war/]]>
+</screen>
+	   </para>
+	   <para>
+		   To see the HelloWorldJSFPortlet, navigate to <ulink url=3D"http://loc=
alhost:8080/portal/">http://localhost:8080/portal/</ulink>, or, if the defa=
ult JBoss Portal page is already open, refresh the page. The HelloWorldJSFP=
ortlet is added to the bottom of the default JBoss Portal page:
+	   </para>
+	   <para>
+		   <mediaobject>
+			   <imageobject>
+				   <imagedata align=3D"center" fileref=3D"images/tutorials/jsf_portlet=
/output.png" valign=3D"middle"/>
+			   </imageobject>
                </mediaobject>
             </para>
-             -->
-            <para>
-               Deploying the portlet is as easy as copying/moving the <lit=
eral>helloworldjspportlet.war</literal> file
-               to the server <literal>deploy</literal> directory. We can t=
hen see our portlet on the Portal default
-               page (<ulink url=3D"http://localhost:8080/portal/">http://l=
ocalhost:8080/portal/</ulink>):
-               <mediaobject>
-                  <imageobject>
-                     <imagedata align=3D"center" fileref=3D"images/tutoria=
ls/jsf_portlet/output.png" valign=3D"middle"/>
-                  </imageobject>
-               </mediaobject>
-            </para>
-         </sect3>
-      </sect2>
+	    <para>
+		    To re-deploy the portlet, for example, if you have made changes to a=
ny of the XML descriptors, touch the <filename>$JBOSS_HOME/server/<replacea=
ble>configuration</replaceable>/deploy/helloworldjsfsunriportlet.war/WEB-IN=
F/web.xml</filename> file. On Linux, run the following command to re-deploy=
 the HelloWorldPortlet:
+	    </para>
+	    <para>
+<screen>
+touch $JBOSS_HOME/server/<replaceable>configuration</replaceable>/deploy/h=
elloworldjsfsunriportlet.war/WEB-INF/web.xml
+</screen>
+	   </para>
+	   <para>
+		   Re-deploying the HelloWorldJSFPortlet will produce output to the JBos=
s AS or JBoss EAP console, similar to the following:
+	   </para>
+	   <para>
+<screen><![CDATA[
+INFO  [TomcatDeployer] undeploy, ctxPath=3D/helloworldjsfsunriportlet, =

+warUrl=3D.../deploy/helloworldjsfsunriportlet.war/
+INFO  [TomcatDeployer] deploy, ctxPath=3D/helloworldjsfsunriportlet, =

+warUrl=3D.../deploy/helloworldjsfsunriportlet.war/]]>
+</screen>
+	   </para>
+   </sect3>
+</sect2>
       <!--<sect2 id=3D"sunri_42x_301">
          <title>Portal and JSF RI: A basic demonstration using common comp=
onents</title>
          <sect3>


--===============3865801488017387026==--