Author: mmcallis Date: 2008-02-15 00:51:47 -0500 (Fri, 15 Feb 2008) New Revision: 9986 Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml Log: revising 5.2.2. An example JSP Portlet adding: 5.2.2.5. Building your JSP Portlet, 5.2.2.6. Deploying your JSP Portlet to be consistent with 5.2.1.5. Building your 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-15 04:44:18 UTC (rev 9985) +++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml 2008-02-15 05:51:47 UTC (rev 9986) @@ -869,7 +869,7 @@ </para> </sect3> <sect3> - <title>Building your Portlet</title> + <title>Building your JSP Portlet</title> <para> The <filename>HelloWorldJSPPortlet.zip</filename> file contains a pre-compiled <filename>helloworldjspportlet.war</filename> file; however, to manually build the <filename>helloworldjspportlet.war</filename> file: </para> @@ -940,8 +940,55 @@ </mediaobject> </para> <para> - The expanded war file and the XML descriptors are located in the <filename>HelloWorldPortlet/output/lib/exploded/helloworldportlet.war/</filename> directory. + The expanded war file and the XML descriptors are located in the <filename>HelloWorldJSPPortlet/output/lib/exploded/helloworldjspportlet.war/</filename> directory. </para> + </sect3> + <sect3> + <title>Deploying your JSP Portlet</title> + <para> + If you did not expand the <filename>helloworldjspportlet.war</filename> file, copy the <filename>HelloWorldJSPPortlet/helloworldjspportlet.war</filename> file into the correct JBoss AS or JBoss EAP <filename>deploy/</filename> directory. If you expanded the <filename>helloworldjspportlet.war</filename> file, copy the <filename>HelloWorldJSPPortlet/output/lib/exploded/helloworldjspportlet.war/</filename> directory into the correct JBoss AS or JBoss EAP <filename>deploy/</filename> directory. For example, if you are using JBoss AS, copy the war file or the expanded directory into the <filename>$JBOSS_HOME/server/default/deploy/</filename> 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=/helloworldjspportlet, +warUrl=.../deploy/helloworldjspportlet.war/]]> +</screen> +</para> +<para> + To see the HelloWorldJSPPortlet, navigate to http://localhost:8080/portal/, or, if the default JBoss Portal page is already open, refresh the page. The HelloWorldJSPPortlett is added to the bottom of the default JBoss Portal page: +</para> +<para> + <mediaobject> + <imageobject> + <imagedata align="center" fileref="images/tutorials/jsp_portlet/output.png" valign="middle"/> + </imageobject> + </mediaobject> +</para> +<para> + To re-deploy the portlet, for example, if you have made changes to any of the XML descriptors, touch the $JBOSS_HOME/server/configuration/deploy/helloworldjspportlet.war/WEB-INF/web.xml file. On Linux, run the following command to re-deploy the HelloWorldJSPPortlet: +</para> +<para> +<screen> +touch $JBOSS_HOME/server/<replaceable>configuration</replaceable>/deploy//helloworldjspportlet.war/WEB-INF/web.xml +</screen> +</para> +<para> + Re-deploying the HelloWorldJSPPortlet will produce output to the JBoss AS or JBoss EAP console, similar to the following: +</para> +<para> +<screen><![CDATA[ +INFO [TomcatDeployer] undeploy, ctxPath=/helloworldjspportlet, +warUrl=.../deploy/helloworldjspportlet.war/ +INFO [TomcatDeployer] deploy, ctxPath=/helloworldjspportlet, +warUrl=.../deploy/helloworldjspportlet.war/]]> +</screen> +</para> +</sect3> <!-- + + @@ -992,7 +1039,7 @@ from PortletSwap.com, using this link: <ulink url="http://anonsvn.jboss.org/repos/portletswap/portlets/2_6/bundles...;. </para> - </sect3> + </sect3> --> <sect3> <title>Package Content</title> <para>