Author: mmcallis Date: 2008-02-14 19:04:46 -0500 (Thu, 14 Feb 2008) New Revision: 9977 Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml Log: 5.2.2.3. Portlet Class minor revisions, splitting first example for HelloWorldJSPPorlet.java into two screen elements 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-14 22:43:38 UTC (rev 9976) +++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml 2008-02-15 00:04:46 UTC (rev 9977) @@ -141,7 +141,7 @@ <sect3> <title>Introduction</title> <para> - This section describes how to deploy a portlet in JBoss Portal. Before proceeding, download the <ulink + This section describes how to deploy a portlet for JBoss Portal. Before proceeding, download the <ulink url="http://anonsvn.jboss.org/repos/portletswap/portlets/2_6/bundles... from <ulink url="http://labs.jboss.com/portletswap/">JBoss PortletSwap</ulink>. </para> </sect3> @@ -264,7 +264,7 @@ </mediaobject> </para> <para> - The following is an example of the <filename>HelloWorldPortlet/WEB-INF/portlet.xml</filename> file: + The following is an example of the <filename>HelloWorldPortlet/WEB-INF/portlet.xml</filename> file. In order to create the <filename>WEB-INF/</filename> and <filename>META-INF/</filename> directories, extract the <filename>helloworldportlet.war</filename> file.This file must adhere to its definition in the JSR-168 Portlet Specification. You may define more than one portlet application in this file: </para> <para> <screen><![CDATA[ @@ -289,9 +289,6 @@ </screen> </para> <para> - In order to create the <filename>WEB-INF</filename> and <filename>META-INF</filename> directories, extract the <filename>helloworldportlet.war</filename> file.This file must adhere to its definition in the JSR-168 Portlet Specification. You may define more than one portlet application in this file. - </para> - <para> <variablelist> <varlistentry><term><screen><![CDATA[ <portlet-name>HelloWorldPortlet</portlet-name>]]></screen></term> @@ -633,20 +630,20 @@ </sect3> </sect2> <sect2> - <title>An Example JSP Portlet</title> + <title>An example JSP Portlet</title> <sect3> <title>Introduction</title> <para> - This section describes how to deploy a JSP portlet in JBoss Portal. Before proceeding, download the <ulink url="http://anonsvn.jboss.org/repos/portletswap/portlets/2_4/bundles... from <ulink url="http://labs.jboss.com/portletswap/">JBoss PortletSwap</ulink>. The HelloWorldJSPPortlet demonstrates how to use JSPs for view rendering, and the portlet taglib for generating links. + This section describes how to deploy a JSP portlet for JBoss Portal. Before proceeding, download the <ulink url="http://anonsvn.jboss.org/repos/portletswap/portlets/2_4/bundles... from <ulink url="http://labs.jboss.com/portletswap/">JBoss PortletSwap</ulink>. The HelloWorldJSPPortlet demonstrates how to use JSPs for view rendering, and the portlet taglib for generating links. </para> </sect3> <sect3> <title>Package Content</title> <para> - The application descriptors for the HelloWorldJSPPortlet portlet are similar to those from the HelloWorldPortlet (<xref linkend="first_portlet_descriptors"/>). See <xref linkend="descriptors_portlet"/> for further details about application descriptors. + The application descriptors for the HelloWorldJSPPortlet portlet are similar to those from the HelloWorldPortlet (<xref linkend="first_portlet_descriptors"/>). See <xref linkend="descriptors_portlet"/> for further information about application descriptors. </para> <para> - The following is an example of the directory structure of the HelloWorldJSPPortlet portlet. The HelloWorldJSPPortlet portlet contains the traditional portlet and JBoss Portal specific application descriptors: + The following is an example of the directory structure of the HelloWorldJSPPortlet portlet. The HelloWorldJSPPortlet portlet contains the traditional portlet and JBoss Portal specific application descriptors. In order to create the <filename>WEB-INF/</filename> and <filename>META-INF/</filename> directories, extract the <filename>helloworldjspportlet.war</filename> file. </para> <para> <mediaobject> @@ -659,7 +656,7 @@ <sect3> <title>Portlet Class</title> <para> - The <ulink url="http://anonsvn.jboss.org/repos/portletswap/portlets/2_4/bundles... contains a <filename>HelloWorldJSPPortlet/src/main/org/jboss/portlet/hello/HelloWorldJSPPortlet.java</filename> file: + The <ulink url="http://anonsvn.jboss.org/repos/portletswap/portlets/2_4/bundles... contains the <filename>HelloWorldJSPPortlet/src/main/org/jboss/portlet/hello/HelloWorldJSPPortlet.java</filename> file: </para> <para> <screen><![CDATA[ @@ -732,11 +729,11 @@ <para> <variablelist> <varlistentry><term><screen><![CDATA[ -protected void doHelp(RenderRequest rRequest, RenderResponse rResponse) { ... } - -// And - -protected void doEdit(RenderRequest rRequest, RenderResponse rResponse) { ... } ]]> +protected void doHelp(RenderRequest rRequest, RenderResponse rResponse) + throws PortletException, IOException, UnavailableException]]> +</screen><screen><![CDATA[ +protected void doEdit(RenderRequest rRequest, RenderResponse rResponse) + throws PortletException, IOException, UnavailableException]]> </screen></term> <listitem> <para> @@ -776,7 +773,7 @@ </screen></term> <listitem> <para> - The <literal>doView</literal> implementation is responsible for dispatching to the appropriate JSP, <filename>HelloWorldJSPPortlet/WEB-INF/jsp/view.jsp</filename> or <filename>HelloWorldJSPPortlet/WEB-INF/jsp/view2.jsp</filename>, depending on the existence of the <literal>yourname</literal> parameter passed in from <literal>processAction</literal>. + The <literal>doView</literal> implementation is responsible for dispatching to the appropriate JSP, <filename>HelloWorldJSPPortlet/WEB-INF/jsp/view.jsp</filename>, or <filename>HelloWorldJSPPortlet/WEB-INF/jsp/view2.jsp</filename>, depending on the existence of the <literal>yourname</literal> parameter passed in from <literal>processAction</literal>. </para> </listitem> </varlistentry>