Modified: portals/site-live/pluto/v30/portlet-api.html URL: http://svn.apache.org/viewvc/portals/site-live/pluto/v30/portlet-api.html?rev=1858149&r1=1858148&r2=1858149&view=diff ============================================================================== --- portals/site-live/pluto/v30/portlet-api.html (original) +++ portals/site-live/pluto/v30/portlet-api.html Thu Apr 25 17:29:43 2019 @@ -1,286 +1,162 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> - - - - - - - - - - - -<html xmlns="http://www.w3.org/1999/xhtml";> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Pluto - Portlet Concepts</title> - <style type="text/css" media="all"> - @import url("../css/maven-base.css"); - @import url("../css/maven-theme.css"); - @import url("../css/site.css"); - </style> - <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - </head> - <body class="composite"> - <div id="banner"> - <a href="http://portals.apache.org/pluto/"; id="bannerLeft"> - - <img src="http://portals.apache.org/pluto/images/apache-portals.gif"; alt="" /> - - </a> - <span id="bannerRight"> - - <img src="http://portals.apache.org/pluto/images/banner.png"; alt="" /> - - </span> - <div class="clear"> - <hr/> - </div> - </div> - <div id="breadcrumbs"> - - - - - - - - - <div class="xleft"> - Last Published: 2018-06-22 - | - <a href="http://portals.apache.org/pluto"; class="externalLink">Home</a> - </div> - <div class="xright"> <a href="../portlet-3.0-apidocs/index.html">Portlet 3.0 API</a> - | - <a href="../portlet-2.0-apidocs/index.html">Portlet 2.0 API</a> - | - <a href="../portlet-1.0-apidocs/index.html">Portlet 1.0 API</a> - | - <a href="http://jcp.org/en/jsr/detail?id=362"; class="externalLink">JSR 362 JCP Page</a> - | - <a href="http://jcp.org/en/jsr/detail?id=286"; class="externalLink">JSR 286 JCP Page</a> - | - <a href="http://jcp.org/en/jsr/detail?id=168"; class="externalLink">JSR 168 JCP Page</a> - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - <div id="leftColumn"> - <div id="navcolumn"> - - - - - - - - - <h5>The Pluto Project</h5> - <ul> - - <li class="none"> - <a href="../index.html">About Pluto</a> - </li> - - <li class="none"> - <a href="../mission.html">Mission</a> - </li> - - <li class="none"> - <a href="../download.html">Download</a> - </li> - - <li class="none"> - <a href="../news.html">News</a> - </li> - - <li class="none"> - <a href="../security.html">Security</a> - </li> - - <li class="none"> - <a href="../status.html">Status</a> - </li> - - <li class="none"> - <a href="../architecture.html">Architecture</a> - </li> - - <li class="none"> - <a href="../resources.html">Resources</a> - </li> - - <li class="none"> - <a href="../faq.html">FAQ</a> - </li> - - <li class="none"> - <a href="http://wiki.apache.org/portals/Pluto"; class="externalLink">Wiki</a> - </li> - - <li class="none"> - <a href="https://issues.apache.org/jira/browse/PLUTO"; class="externalLink">Issue Tracker (JIRA)</a> - </li> - - <li class="none"> - <a href="../helping.html">Get Involved</a> - </li> - </ul> - <h5>Pluto 3.0</h5> - <ul> - - <li class="none"> - <a href="../v301/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v301/deploying.html">Deploying Portlets</a> - </li> - - <li class="none"> - <a href="../v301/portlet-api.html">Portlet Concepts</a> - </li> - - <li class="none"> - <a href="../v301/v3Features.html">Version 3 Features</a> - </li> - - <li class="none"> - <a href="../v301/tck.html">Using the TCK</a> - </li> - - <li class="none"> - <a href="../v301/release-notes.html">Release Notes</a> - </li> - </ul> - <h5>Pluto 2.0</h5> - <ul> - - <li class="none"> - <a href="../v20/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v20/deploying.html">Deploying</a> - </li> - - <li class="none"> - <a href="../v20/embedding.html">Embedding</a> - </li> - - <li class="none"> - <a href="../v20/release-notes.html">Release Notes</a> - </li> - - <li class="none"> - <a href="../v20/app-servers.html">App Servers</a> - </li> - - <li class="none"> - <a href="../v20/powered.html">Powered By Pluto</a> - </li> - </ul> - <h5>Pluto 1.1</h5> - <ul> - - <li class="none"> - <a href="../v11/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v11/deploying.html">Deploying</a> - </li> - - <li class="none"> - <a href="../v11/release-notes.html">Release Notes</a> - </li> - </ul> - <h5>Subprojects</h5> - <ul> - - <li class="none"> - <a href="../subprojects/subprojects.html">Overview</a> - </li> - </ul> - <h5>Project Info</h5> - <ul> - - <li class="none"> - <a href="../project-summary.html">Project Summary</a> - </li> - - <li class="none"> - <a href="../team-list.html">Project Team</a> - </li> - - <li class="none"> - <a href="../license.html">Project License</a> - </li> - - <li class="none"> - <a href="../mail-lists.html">Mailing Lists</a> - </li> - - <li class="none"> - <a href="../source-repository.html">Source Repository</a> - </li> - - <li class="none"> - <a href="../issue-tracking.html">Issue Tracking</a> - </li> - </ul> - <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> - <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img> - </a> - - - - - - - - - </div> - </div> - <div id="bodyColumn"> - <div id="contentBox"> - <div class="section"><h2><a name="Portlet_Concepts"></a>Portlet Concepts</h2> -<div class="section"><h3><a name="The_Portlet_Phase_Model"></a>The Portlet Phase Model</h3> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> +<!-- Generated by Apache Maven Doxia Site Renderer 1.8.1 from src/site/xdoc/v30/portlet-api.xml at 2019-04-25 --> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + <title>Pluto – Portlet Concepts</title> + <style type="text/css" media="all"> + @import url("../css/maven-base.css"); + @import url("../css/maven-theme.css"); + @import url("../css/site.css"); + </style> + <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> + <meta http-equiv="Content-Language" content="en" /> + + </head> + <body class="composite"> + <div id="banner"> +<a href="http://portals.apache.org/pluto/"; id="bannerLeft"><img src="http://portals.apache.org/pluto/images/apache-portals.gif"; alt="Pluto"/></a> +<div id="bannerRight"> +<img src="http://portals.apache.org/pluto/images/banner.png"; alt=""/></div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="breadcrumbs"> + <div class="xleft"> + <span id="publishDate">Last Published: 2019-04-25</span> + | <a href="http://portals.apache.org/pluto"; class="externalLink" title="Home">Home</a> > +Portlet Concepts + </div> + <div class="xright"><a href="../portlet-3.0-apidocs/index.html" title="Portlet 3.0 API">Portlet 3.0 API</a> | +<a href="../portlet-2.0-apidocs/index.html" title="Portlet 2.0 API">Portlet 2.0 API</a> | +<a href="../portlet-1.0-apidocs/index.html" title="Portlet 1.0 API">Portlet 1.0 API</a> | +<a href="http://jcp.org/en/jsr/detail?id=362"; class="externalLink" title="JSR 362 JCP Page">JSR 362 JCP Page</a> | +<a href="http://jcp.org/en/jsr/detail?id=286"; class="externalLink" title="JSR 286 JCP Page">JSR 286 JCP Page</a> | +<a href="http://jcp.org/en/jsr/detail?id=168"; class="externalLink" title="JSR 168 JCP Page">JSR 168 JCP Page</a> </div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="leftColumn"> + <div id="navcolumn"> + <h5>The Pluto Project</h5> + <ul> + <li class="none"><a href="../index.html" title="About Pluto">About Pluto</a></li> + <li class="none"><a href="../mission.html" title="Mission">Mission</a></li> + <li class="none"><a href="../download.html" title="Download">Download</a></li> + <li class="none"><a href="../news.html" title="News">News</a></li> + <li class="none"><a href="../security.html" title="Security">Security</a></li> + <li class="none"><a href="../status.html" title="Status">Status</a></li> + <li class="none"><a href="../architecture.html" title="Architecture">Architecture</a></li> + <li class="none"><a href="../resources.html" title="Resources">Resources</a></li> + <li class="none"><a href="../faq.html" title="FAQ">FAQ</a></li> + <li class="none"><a href="http://wiki.apache.org/portals/Pluto"; class="externalLink" title="Wiki">Wiki</a></li> + <li class="none"><a href="https://issues.apache.org/jira/browse/PLUTO"; class="externalLink" title="Issue Tracker (JIRA)">Issue Tracker (JIRA)</a></li> + <li class="none"><a href="../helping.html" title="Get Involved">Get Involved</a></li> + </ul> + <h5>Pluto 3.1</h5> + <ul> + <li class="none"><a href="../v310/mvcbean-portlets.html" title="MVCBean Portlets">MVCBean Portlets</a></li> + <li class="none"><a href="../v310/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v310/maven-archetypes.html" title="Maven Archetypes">Maven Archetypes</a></li> + <li class="none"><a href="../v310/deploying.html" title="Deploying Portlets">Deploying Portlets</a></li> + <li class="none"><a href="../v310/portlet-api.html" title="Portlet Concepts">Portlet Concepts</a></li> + <li class="none"><a href="../v310/v3Features.html" title="Version 3 Features">Version 3 Features</a></li> + <li class="none"><a href="../v310/tck.html" title="Using the TCK">Using the TCK</a></li> + <li class="none"><a href="../v310/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Pluto 3.0</h5> + <ul> + <li class="none"><a href="../v301/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v301/deploying.html" title="Deploying Portlets">Deploying Portlets</a></li> + <li class="none"><a href="../v301/portlet-api.html" title="Portlet Concepts">Portlet Concepts</a></li> + <li class="none"><a href="../v301/v3Features.html" title="Version 3 Features">Version 3 Features</a></li> + <li class="none"><a href="../v301/tck.html" title="Using the TCK">Using the TCK</a></li> + <li class="none"><a href="../v301/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Pluto 2.0</h5> + <ul> + <li class="none"><a href="../v20/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v20/deploying.html" title="Deploying">Deploying</a></li> + <li class="none"><a href="../v20/embedding.html" title="Embedding">Embedding</a></li> + <li class="none"><a href="../v20/release-notes.html" title="Release Notes">Release Notes</a></li> + <li class="none"><a href="../v20/app-servers.html" title="App Servers">App Servers</a></li> + <li class="none"><a href="../v20/powered.html" title="Powered By Pluto">Powered By Pluto</a></li> + </ul> + <h5>Pluto 1.1</h5> + <ul> + <li class="none"><a href="../v11/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v11/deploying.html" title="Deploying">Deploying</a></li> + <li class="none"><a href="../v11/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Subprojects</h5> + <ul> + <li class="none"><a href="../subprojects/subprojects.html" title="Overview">Overview</a></li> + </ul> + <h5>Project Info</h5> + <ul> + <li class="none"><a href="../project-summary.html" title="Project Summary">Project Summary</a></li> + <li class="none"><a href="../team-list.html" title="Project Team">Project Team</a></li> + <li class="none"><a href="../license.html" title="Project License">Project License</a></li> + <li class="none"><a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a></li> + <li class="none"><a href="../source-repository.html" title="Source Repository">Source Repository</a></li> + <li class="none"><a href="../issue-tracking.html" title="Issue Tracking">Issue Tracking</a></li> + </ul> + <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> + <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /> + </a> + </div> + </div> + <div id="bodyColumn"> + <div id="contentBox"> + + + + + <div class="section"> +<h2><a name="Portlet_Concepts"></a>Portlet Concepts</h2> + +<div class="section"> +<h3><a name="The_Portlet_Phase_Model"></a>The Portlet Phase Model</h3> + <p> When a request arrives at a portal targeted to a portlet, the portlet container executes portlet code according to a phase model. </p> -<img src="../images/phaseModel.png" /><p> + <img src="../images/phaseModel.png" alt="" /> + +<p> There are three processing stages containing five processing phases, defined as follows: </p> + <p> The portlet API allows creation of URLs that can be included into portlet markup in order to activate the portlet processing stages. </p> -<ul><li> + +<ul> + +<li> The Action URL, or Partial Action URL triggers preparation stage processing. </li> + <li> The Render URL triggers aggregation stage processing. </li> + <li> The Resource URL triggers resourec stage processing. </li> -</ul> + </ul> + <p> When a stage is triggered, the processing phases within that stage are executed. </p> -<dl><dt> + +<dl> + +<dt> Action Phase </dt> <dd> @@ -322,25 +198,32 @@ the response returned to the client. It may produce markup, JSON data, or binary data, for example. </dd> -</dl> + </dl> + <p> The portlet container drives portlet phase execution by setting up the execution environment for each portlet and phase and calling the corresponding portlet lifecycle methods. </p> + <p> The portlet participates in the phase model by implementing the corresponding lifecycle methods and by using the portlet API to carry out the appropriate tasks. </p> -</div> -<div class="section"><h3><a name="The_Portlet_Lifecyce_Methods"></a>The Portlet Lifecyce Methods</h3> -<img src="../images/lifecycleMethods.png" /><p> + </div> + + +<div class="section"> +<h3><a name="The_Portlet_Lifecyce_Methods"></a>The Portlet Lifecyce Methods</h3> + <img src="../images/lifecycleMethods.png" alt="" /> + +<p> Each portlet phase has a corresponding lifecycle method. The portlet container executes the prrocessing phase by calling the portlet lifecycle method. Each phase is provided with specific request and response objects. Methods can implemented using the interfaces - <code>Portlet, ResourceServingPortlet, EventPortlet</code> and <code>HeaderPortlet</code>. + <tt>Portlet, ResourceServingPortlet, EventPortlet</tt> and <tt>HeaderPortlet</tt>. Portlets can be configured through annotation or using the portlet deployment descriptor. </p> <p> @@ -355,7 +238,10 @@ data beyond that provided in the annotation is required. Additional configuration is possible through annotation or portlet deployment descriptor. </p> -<ul><li> + +<ul> + +<li> Set up / tear down: @InitMethod, @DestroyMethod </li> <li> @@ -367,32 +253,26 @@ <li> Resource stage: @ServeResourceMethod </li> -</ul> -</div> -</div> - - </div> - </div> - <div class="clear"> - <hr/> - </div> - <div id="footer"> - <div class="xright">© - 2004-2018 - - Apache Software Foundation - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - </body> -</html> + </ul> + </div> + + </div> + + + + + </div> + </div> + <div class="clear"> + <hr/> + </div> + <div id="footer"> + <div class="xright"> + Copyright © 2004–2019 <a href="http://www.apache.org/";>Apache Software Foundation</a>. +All rights reserved. </div> + <div class="clear"> + <hr/> + </div> + </div> + </body> +</html>
Modified: portals/site-live/pluto/v30/release-notes.html URL: http://svn.apache.org/viewvc/portals/site-live/pluto/v30/release-notes.html?rev=1858149&r1=1858148&r2=1858149&view=diff ============================================================================== --- portals/site-live/pluto/v30/release-notes.html (original) +++ portals/site-live/pluto/v30/release-notes.html Thu Apr 25 17:29:43 2019 @@ -1,289 +1,143 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> - - - - - - - - - - - -<html xmlns="http://www.w3.org/1999/xhtml";> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Pluto - Pluto Release Notes</title> - <style type="text/css" media="all"> - @import url("../css/maven-base.css"); - @import url("../css/maven-theme.css"); - @import url("../css/site.css"); - </style> - <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - </head> - <body class="composite"> - <div id="banner"> - <a href="http://portals.apache.org/pluto/"; id="bannerLeft"> - - <img src="http://portals.apache.org/pluto/images/apache-portals.gif"; alt="" /> - - </a> - <span id="bannerRight"> - - <img src="http://portals.apache.org/pluto/images/banner.png"; alt="" /> - - </span> - <div class="clear"> - <hr/> - </div> - </div> - <div id="breadcrumbs"> - - - - - - - - - <div class="xleft"> - Last Published: 2018-06-22 - | - <a href="http://portals.apache.org/pluto"; class="externalLink">Home</a> - </div> - <div class="xright"> <a href="../portlet-3.0-apidocs/index.html">Portlet 3.0 API</a> - | - <a href="../portlet-2.0-apidocs/index.html">Portlet 2.0 API</a> - | - <a href="../portlet-1.0-apidocs/index.html">Portlet 1.0 API</a> - | - <a href="http://jcp.org/en/jsr/detail?id=362"; class="externalLink">JSR 362 JCP Page</a> - | - <a href="http://jcp.org/en/jsr/detail?id=286"; class="externalLink">JSR 286 JCP Page</a> - | - <a href="http://jcp.org/en/jsr/detail?id=168"; class="externalLink">JSR 168 JCP Page</a> - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - <div id="leftColumn"> - <div id="navcolumn"> - - - - - - - - - <h5>The Pluto Project</h5> - <ul> - - <li class="none"> - <a href="../index.html">About Pluto</a> - </li> - - <li class="none"> - <a href="../mission.html">Mission</a> - </li> - - <li class="none"> - <a href="../download.html">Download</a> - </li> - - <li class="none"> - <a href="../news.html">News</a> - </li> - - <li class="none"> - <a href="../security.html">Security</a> - </li> - - <li class="none"> - <a href="../status.html">Status</a> - </li> - - <li class="none"> - <a href="../architecture.html">Architecture</a> - </li> - - <li class="none"> - <a href="../resources.html">Resources</a> - </li> - - <li class="none"> - <a href="../faq.html">FAQ</a> - </li> - - <li class="none"> - <a href="http://wiki.apache.org/portals/Pluto"; class="externalLink">Wiki</a> - </li> - - <li class="none"> - <a href="https://issues.apache.org/jira/browse/PLUTO"; class="externalLink">Issue Tracker (JIRA)</a> - </li> - - <li class="none"> - <a href="../helping.html">Get Involved</a> - </li> - </ul> - <h5>Pluto 3.0</h5> - <ul> - - <li class="none"> - <a href="../v301/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v301/deploying.html">Deploying Portlets</a> - </li> - - <li class="none"> - <a href="../v301/portlet-api.html">Portlet Concepts</a> - </li> - - <li class="none"> - <a href="../v301/v3Features.html">Version 3 Features</a> - </li> - - <li class="none"> - <a href="../v301/tck.html">Using the TCK</a> - </li> - - <li class="none"> - <a href="../v301/release-notes.html">Release Notes</a> - </li> - </ul> - <h5>Pluto 2.0</h5> - <ul> - - <li class="none"> - <a href="../v20/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v20/deploying.html">Deploying</a> - </li> - - <li class="none"> - <a href="../v20/embedding.html">Embedding</a> - </li> - - <li class="none"> - <a href="../v20/release-notes.html">Release Notes</a> - </li> - - <li class="none"> - <a href="../v20/app-servers.html">App Servers</a> - </li> - - <li class="none"> - <a href="../v20/powered.html">Powered By Pluto</a> - </li> - </ul> - <h5>Pluto 1.1</h5> - <ul> - - <li class="none"> - <a href="../v11/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v11/deploying.html">Deploying</a> - </li> - - <li class="none"> - <a href="../v11/release-notes.html">Release Notes</a> - </li> - </ul> - <h5>Subprojects</h5> - <ul> - - <li class="none"> - <a href="../subprojects/subprojects.html">Overview</a> - </li> - </ul> - <h5>Project Info</h5> - <ul> - - <li class="none"> - <a href="../project-summary.html">Project Summary</a> - </li> - - <li class="none"> - <a href="../team-list.html">Project Team</a> - </li> - - <li class="none"> - <a href="../license.html">Project License</a> - </li> - - <li class="none"> - <a href="../mail-lists.html">Mailing Lists</a> - </li> - - <li class="none"> - <a href="../source-repository.html">Source Repository</a> - </li> - - <li class="none"> - <a href="../issue-tracking.html">Issue Tracking</a> - </li> - </ul> - <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> - <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img> - </a> - - - - - - - - - </div> - </div> - <div id="bodyColumn"> - <div id="contentBox"> - <subtitle></subtitle><div class="section"><h2><a name="Release_Notes_-_Pluto_3.0.0"></a>Release Notes - Pluto 3.0.0</h2> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> +<!-- Generated by Apache Maven Doxia Site Renderer 1.8.1 from src/site/xdoc/v30/release-notes.xml at 2019-04-25 --> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + <title>Pluto – Pluto Release Notes</title> + <style type="text/css" media="all"> + @import url("../css/maven-base.css"); + @import url("../css/maven-theme.css"); + @import url("../css/site.css"); + </style> + <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> + <meta http-equiv="Content-Language" content="en" /> + + </head> + <body class="composite"> + <div id="banner"> +<a href="http://portals.apache.org/pluto/"; id="bannerLeft"><img src="http://portals.apache.org/pluto/images/apache-portals.gif"; alt="Pluto"/></a> +<div id="bannerRight"> +<img src="http://portals.apache.org/pluto/images/banner.png"; alt=""/></div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="breadcrumbs"> + <div class="xleft"> + <span id="publishDate">Last Published: 2019-04-25</span> + | <a href="http://portals.apache.org/pluto"; class="externalLink" title="Home">Home</a> > +Pluto Release Notes + </div> + <div class="xright"><a href="../portlet-3.0-apidocs/index.html" title="Portlet 3.0 API">Portlet 3.0 API</a> | +<a href="../portlet-2.0-apidocs/index.html" title="Portlet 2.0 API">Portlet 2.0 API</a> | +<a href="../portlet-1.0-apidocs/index.html" title="Portlet 1.0 API">Portlet 1.0 API</a> | +<a href="http://jcp.org/en/jsr/detail?id=362"; class="externalLink" title="JSR 362 JCP Page">JSR 362 JCP Page</a> | +<a href="http://jcp.org/en/jsr/detail?id=286"; class="externalLink" title="JSR 286 JCP Page">JSR 286 JCP Page</a> | +<a href="http://jcp.org/en/jsr/detail?id=168"; class="externalLink" title="JSR 168 JCP Page">JSR 168 JCP Page</a> </div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="leftColumn"> + <div id="navcolumn"> + <h5>The Pluto Project</h5> + <ul> + <li class="none"><a href="../index.html" title="About Pluto">About Pluto</a></li> + <li class="none"><a href="../mission.html" title="Mission">Mission</a></li> + <li class="none"><a href="../download.html" title="Download">Download</a></li> + <li class="none"><a href="../news.html" title="News">News</a></li> + <li class="none"><a href="../security.html" title="Security">Security</a></li> + <li class="none"><a href="../status.html" title="Status">Status</a></li> + <li class="none"><a href="../architecture.html" title="Architecture">Architecture</a></li> + <li class="none"><a href="../resources.html" title="Resources">Resources</a></li> + <li class="none"><a href="../faq.html" title="FAQ">FAQ</a></li> + <li class="none"><a href="http://wiki.apache.org/portals/Pluto"; class="externalLink" title="Wiki">Wiki</a></li> + <li class="none"><a href="https://issues.apache.org/jira/browse/PLUTO"; class="externalLink" title="Issue Tracker (JIRA)">Issue Tracker (JIRA)</a></li> + <li class="none"><a href="../helping.html" title="Get Involved">Get Involved</a></li> + </ul> + <h5>Pluto 3.1</h5> + <ul> + <li class="none"><a href="../v310/mvcbean-portlets.html" title="MVCBean Portlets">MVCBean Portlets</a></li> + <li class="none"><a href="../v310/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v310/maven-archetypes.html" title="Maven Archetypes">Maven Archetypes</a></li> + <li class="none"><a href="../v310/deploying.html" title="Deploying Portlets">Deploying Portlets</a></li> + <li class="none"><a href="../v310/portlet-api.html" title="Portlet Concepts">Portlet Concepts</a></li> + <li class="none"><a href="../v310/v3Features.html" title="Version 3 Features">Version 3 Features</a></li> + <li class="none"><a href="../v310/tck.html" title="Using the TCK">Using the TCK</a></li> + <li class="none"><a href="../v310/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Pluto 3.0</h5> + <ul> + <li class="none"><a href="../v301/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v301/deploying.html" title="Deploying Portlets">Deploying Portlets</a></li> + <li class="none"><a href="../v301/portlet-api.html" title="Portlet Concepts">Portlet Concepts</a></li> + <li class="none"><a href="../v301/v3Features.html" title="Version 3 Features">Version 3 Features</a></li> + <li class="none"><a href="../v301/tck.html" title="Using the TCK">Using the TCK</a></li> + <li class="none"><a href="../v301/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Pluto 2.0</h5> + <ul> + <li class="none"><a href="../v20/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v20/deploying.html" title="Deploying">Deploying</a></li> + <li class="none"><a href="../v20/embedding.html" title="Embedding">Embedding</a></li> + <li class="none"><a href="../v20/release-notes.html" title="Release Notes">Release Notes</a></li> + <li class="none"><a href="../v20/app-servers.html" title="App Servers">App Servers</a></li> + <li class="none"><a href="../v20/powered.html" title="Powered By Pluto">Powered By Pluto</a></li> + </ul> + <h5>Pluto 1.1</h5> + <ul> + <li class="none"><a href="../v11/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v11/deploying.html" title="Deploying">Deploying</a></li> + <li class="none"><a href="../v11/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Subprojects</h5> + <ul> + <li class="none"><a href="../subprojects/subprojects.html" title="Overview">Overview</a></li> + </ul> + <h5>Project Info</h5> + <ul> + <li class="none"><a href="../project-summary.html" title="Project Summary">Project Summary</a></li> + <li class="none"><a href="../team-list.html" title="Project Team">Project Team</a></li> + <li class="none"><a href="../license.html" title="Project License">Project License</a></li> + <li class="none"><a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a></li> + <li class="none"><a href="../source-repository.html" title="Source Repository">Source Repository</a></li> + <li class="none"><a href="../issue-tracking.html" title="Issue Tracking">Issue Tracking</a></li> + </ul> + <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> + <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /> + </a> + </div> + </div> + <div id="bodyColumn"> + <div id="contentBox"> + + + <div class="section"> +<h2><a name="Release_Notes_-_Pluto_3.0.0"></a>Release Notes - Pluto 3.0.0</h2> + <p> Pluto version 3.0.0 is a completely new release dedicated to the implementation of JSR 362 Portlet Specification 3.0.0. </p> -<p></p> -</div> - - </div> - </div> - <div class="clear"> - <hr/> - </div> - <div id="footer"> - <div class="xright">© - 2004-2018 - - Apache Software Foundation - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - </body> -</html> + +<p> + </p> + + </div> + + + </div> + </div> + <div class="clear"> + <hr/> + </div> + <div id="footer"> + <div class="xright"> + Copyright © 2004–2019 <a href="http://www.apache.org/";>Apache Software Foundation</a>. +All rights reserved. </div> + <div class="clear"> + <hr/> + </div> + </div> + </body> +</html> Modified: portals/site-live/pluto/v30/tck.html URL: http://svn.apache.org/viewvc/portals/site-live/pluto/v30/tck.html?rev=1858149&r1=1858148&r2=1858149&view=diff ============================================================================== --- portals/site-live/pluto/v30/tck.html (original) +++ portals/site-live/pluto/v30/tck.html Thu Apr 25 17:29:43 2019 @@ -1,266 +1,132 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> - - - - - - - - - - - -<html xmlns="http://www.w3.org/1999/xhtml";> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Pluto - Using the JSR 362 TCK</title> - <style type="text/css" media="all"> - @import url("../css/maven-base.css"); - @import url("../css/maven-theme.css"); - @import url("../css/site.css"); - </style> - <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - </head> - <body class="composite"> - <div id="banner"> - <a href="http://portals.apache.org/pluto/"; id="bannerLeft"> - - <img src="http://portals.apache.org/pluto/images/apache-portals.gif"; alt="" /> - - </a> - <span id="bannerRight"> - - <img src="http://portals.apache.org/pluto/images/banner.png"; alt="" /> - - </span> - <div class="clear"> - <hr/> - </div> - </div> - <div id="breadcrumbs"> - - - - - - - - - <div class="xleft"> - Last Published: 2018-06-22 - | - <a href="http://portals.apache.org/pluto"; class="externalLink">Home</a> - </div> - <div class="xright"> <a href="../portlet-3.0-apidocs/index.html">Portlet 3.0 API</a> - | - <a href="../portlet-2.0-apidocs/index.html">Portlet 2.0 API</a> - | - <a href="../portlet-1.0-apidocs/index.html">Portlet 1.0 API</a> - | - <a href="http://jcp.org/en/jsr/detail?id=362"; class="externalLink">JSR 362 JCP Page</a> - | - <a href="http://jcp.org/en/jsr/detail?id=286"; class="externalLink">JSR 286 JCP Page</a> - | - <a href="http://jcp.org/en/jsr/detail?id=168"; class="externalLink">JSR 168 JCP Page</a> - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - <div id="leftColumn"> - <div id="navcolumn"> - - - - - - - - - <h5>The Pluto Project</h5> - <ul> - - <li class="none"> - <a href="../index.html">About Pluto</a> - </li> - - <li class="none"> - <a href="../mission.html">Mission</a> - </li> - - <li class="none"> - <a href="../download.html">Download</a> - </li> - - <li class="none"> - <a href="../news.html">News</a> - </li> - - <li class="none"> - <a href="../security.html">Security</a> - </li> - - <li class="none"> - <a href="../status.html">Status</a> - </li> - - <li class="none"> - <a href="../architecture.html">Architecture</a> - </li> - - <li class="none"> - <a href="../resources.html">Resources</a> - </li> - - <li class="none"> - <a href="../faq.html">FAQ</a> - </li> - - <li class="none"> - <a href="http://wiki.apache.org/portals/Pluto"; class="externalLink">Wiki</a> - </li> - - <li class="none"> - <a href="https://issues.apache.org/jira/browse/PLUTO"; class="externalLink">Issue Tracker (JIRA)</a> - </li> - - <li class="none"> - <a href="../helping.html">Get Involved</a> - </li> - </ul> - <h5>Pluto 3.0</h5> - <ul> - - <li class="none"> - <a href="../v301/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v301/deploying.html">Deploying Portlets</a> - </li> - - <li class="none"> - <a href="../v301/portlet-api.html">Portlet Concepts</a> - </li> - - <li class="none"> - <a href="../v301/v3Features.html">Version 3 Features</a> - </li> - - <li class="none"> - <a href="../v301/tck.html">Using the TCK</a> - </li> - - <li class="none"> - <a href="../v301/release-notes.html">Release Notes</a> - </li> - </ul> - <h5>Pluto 2.0</h5> - <ul> - - <li class="none"> - <a href="../v20/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v20/deploying.html">Deploying</a> - </li> - - <li class="none"> - <a href="../v20/embedding.html">Embedding</a> - </li> - - <li class="none"> - <a href="../v20/release-notes.html">Release Notes</a> - </li> - - <li class="none"> - <a href="../v20/app-servers.html">App Servers</a> - </li> - - <li class="none"> - <a href="../v20/powered.html">Powered By Pluto</a> - </li> - </ul> - <h5>Pluto 1.1</h5> - <ul> - - <li class="none"> - <a href="../v11/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v11/deploying.html">Deploying</a> - </li> - - <li class="none"> - <a href="../v11/release-notes.html">Release Notes</a> - </li> - </ul> - <h5>Subprojects</h5> - <ul> - - <li class="none"> - <a href="../subprojects/subprojects.html">Overview</a> - </li> - </ul> - <h5>Project Info</h5> - <ul> - - <li class="none"> - <a href="../project-summary.html">Project Summary</a> - </li> - - <li class="none"> - <a href="../team-list.html">Project Team</a> - </li> - - <li class="none"> - <a href="../license.html">Project License</a> - </li> - - <li class="none"> - <a href="../mail-lists.html">Mailing Lists</a> - </li> - - <li class="none"> - <a href="../source-repository.html">Source Repository</a> - </li> - - <li class="none"> - <a href="../issue-tracking.html">Issue Tracking</a> - </li> - </ul> - <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> - <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img> - </a> - - - - - - - - - </div> - </div> - <div id="bodyColumn"> - <div id="contentBox"> - <div class="section"><h2><a name="Using_the_JSR_362_TCK"></a>Using the JSR 362 TCK</h2> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> +<!-- Generated by Apache Maven Doxia Site Renderer 1.8.1 from src/site/xdoc/v30/tck.xml at 2019-04-25 --> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + <title>Pluto – Using the JSR 362 TCK</title> + <style type="text/css" media="all"> + @import url("../css/maven-base.css"); + @import url("../css/maven-theme.css"); + @import url("../css/site.css"); + </style> + <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> + <meta http-equiv="Content-Language" content="en" /> + + </head> + <body class="composite"> + <div id="banner"> +<a href="http://portals.apache.org/pluto/"; id="bannerLeft"><img src="http://portals.apache.org/pluto/images/apache-portals.gif"; alt="Pluto"/></a> +<div id="bannerRight"> +<img src="http://portals.apache.org/pluto/images/banner.png"; alt=""/></div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="breadcrumbs"> + <div class="xleft"> + <span id="publishDate">Last Published: 2019-04-25</span> + | <a href="http://portals.apache.org/pluto"; class="externalLink" title="Home">Home</a> > +Using the JSR 362 TCK + </div> + <div class="xright"><a href="../portlet-3.0-apidocs/index.html" title="Portlet 3.0 API">Portlet 3.0 API</a> | +<a href="../portlet-2.0-apidocs/index.html" title="Portlet 2.0 API">Portlet 2.0 API</a> | +<a href="../portlet-1.0-apidocs/index.html" title="Portlet 1.0 API">Portlet 1.0 API</a> | +<a href="http://jcp.org/en/jsr/detail?id=362"; class="externalLink" title="JSR 362 JCP Page">JSR 362 JCP Page</a> | +<a href="http://jcp.org/en/jsr/detail?id=286"; class="externalLink" title="JSR 286 JCP Page">JSR 286 JCP Page</a> | +<a href="http://jcp.org/en/jsr/detail?id=168"; class="externalLink" title="JSR 168 JCP Page">JSR 168 JCP Page</a> </div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="leftColumn"> + <div id="navcolumn"> + <h5>The Pluto Project</h5> + <ul> + <li class="none"><a href="../index.html" title="About Pluto">About Pluto</a></li> + <li class="none"><a href="../mission.html" title="Mission">Mission</a></li> + <li class="none"><a href="../download.html" title="Download">Download</a></li> + <li class="none"><a href="../news.html" title="News">News</a></li> + <li class="none"><a href="../security.html" title="Security">Security</a></li> + <li class="none"><a href="../status.html" title="Status">Status</a></li> + <li class="none"><a href="../architecture.html" title="Architecture">Architecture</a></li> + <li class="none"><a href="../resources.html" title="Resources">Resources</a></li> + <li class="none"><a href="../faq.html" title="FAQ">FAQ</a></li> + <li class="none"><a href="http://wiki.apache.org/portals/Pluto"; class="externalLink" title="Wiki">Wiki</a></li> + <li class="none"><a href="https://issues.apache.org/jira/browse/PLUTO"; class="externalLink" title="Issue Tracker (JIRA)">Issue Tracker (JIRA)</a></li> + <li class="none"><a href="../helping.html" title="Get Involved">Get Involved</a></li> + </ul> + <h5>Pluto 3.1</h5> + <ul> + <li class="none"><a href="../v310/mvcbean-portlets.html" title="MVCBean Portlets">MVCBean Portlets</a></li> + <li class="none"><a href="../v310/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v310/maven-archetypes.html" title="Maven Archetypes">Maven Archetypes</a></li> + <li class="none"><a href="../v310/deploying.html" title="Deploying Portlets">Deploying Portlets</a></li> + <li class="none"><a href="../v310/portlet-api.html" title="Portlet Concepts">Portlet Concepts</a></li> + <li class="none"><a href="../v310/v3Features.html" title="Version 3 Features">Version 3 Features</a></li> + <li class="none"><a href="../v310/tck.html" title="Using the TCK">Using the TCK</a></li> + <li class="none"><a href="../v310/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Pluto 3.0</h5> + <ul> + <li class="none"><a href="../v301/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v301/deploying.html" title="Deploying Portlets">Deploying Portlets</a></li> + <li class="none"><a href="../v301/portlet-api.html" title="Portlet Concepts">Portlet Concepts</a></li> + <li class="none"><a href="../v301/v3Features.html" title="Version 3 Features">Version 3 Features</a></li> + <li class="none"><a href="../v301/tck.html" title="Using the TCK">Using the TCK</a></li> + <li class="none"><a href="../v301/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Pluto 2.0</h5> + <ul> + <li class="none"><a href="../v20/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v20/deploying.html" title="Deploying">Deploying</a></li> + <li class="none"><a href="../v20/embedding.html" title="Embedding">Embedding</a></li> + <li class="none"><a href="../v20/release-notes.html" title="Release Notes">Release Notes</a></li> + <li class="none"><a href="../v20/app-servers.html" title="App Servers">App Servers</a></li> + <li class="none"><a href="../v20/powered.html" title="Powered By Pluto">Powered By Pluto</a></li> + </ul> + <h5>Pluto 1.1</h5> + <ul> + <li class="none"><a href="../v11/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v11/deploying.html" title="Deploying">Deploying</a></li> + <li class="none"><a href="../v11/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Subprojects</h5> + <ul> + <li class="none"><a href="../subprojects/subprojects.html" title="Overview">Overview</a></li> + </ul> + <h5>Project Info</h5> + <ul> + <li class="none"><a href="../project-summary.html" title="Project Summary">Project Summary</a></li> + <li class="none"><a href="../team-list.html" title="Project Team">Project Team</a></li> + <li class="none"><a href="../license.html" title="Project License">Project License</a></li> + <li class="none"><a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a></li> + <li class="none"><a href="../source-repository.html" title="Source Repository">Source Repository</a></li> + <li class="none"><a href="../issue-tracking.html" title="Issue Tracking">Issue Tracking</a></li> + </ul> + <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> + <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /> + </a> + </div> + </div> + <div id="bodyColumn"> + <div id="contentBox"> + + + + + <div class="section"> +<h2><a name="Using_the_JSR_362_TCK"></a>Using the JSR 362 TCK</h2> + <p> The JSR 362 Technology Compliance Kit (TCK) is intended to be used by portal vendors wishing to achieve JSR 362 compatibility for their product. If you do not meet this description, you do not need to read this section. </p> -<div class="section"><h3><a name="Overview"></a>Overview</h3> + + +<div class="section"> +<h3><a name="Overview"></a>Overview</h3> + <p> The TCK contains portlets and a test driver that are used to perform the compatibility test. The portlets contain the code that actually exercises the @@ -314,7 +180,10 @@ based on the test case name. From the point of view of the test driver there can be several relevant element IDs on the page for each test case: </p> -<ul><li> + +<ul> + +<li> "<testcasename>-setup" - Test setup link </li> <li> @@ -326,7 +195,8 @@ <li> "<testcasename>-details" - Test details field; provides failure reason </li> -</ul> + </ul> + <p> After accessing the page on which the test case is to be found, the test driver first looks for a setup link. If found, it clicks the link and waits for the @@ -342,13 +212,20 @@ details element IDs and analyzes the results string to determine test case success or failure. </p> -</div> -<div class="section"><h3><a name="Project_Structure"></a>Project Structure</h3> + </div> + + +<div class="section"> +<h3><a name="Project_Structure"></a>Project Structure</h3> + <p> - The TCK source code is located in the subdirectory <code>./pluto/portlet-tck_3.0</code>. + The TCK source code is located in the subdirectory <tt>./pluto/portlet-tck_3.0</tt>. The project consists of the following modules: </p> -<dl><dt> + +<dl> + +<dt> common </dt> <dd> @@ -361,7 +238,7 @@ deploy </dt> <dd> - The directory <code>deploy/target/deploy-files</code> contains the portlet war + The directory <tt>deploy/target/deploy-files</tt> contains the portlet war files and the page file to be deployed on the system under test. </dd> <dt> @@ -416,21 +293,29 @@ <dd> Modules with this naming scheme test v3.0 specific funtionality. </dd> -</dl> -</div> -<div class="section"><h3><a name="The_Page_File"></a>The Page File</h3> + </dl> + </div> + + +<div class="section"> +<h3><a name="The_Page_File"></a>The Page File</h3> + <p> The page file defines the page names for the TCK and the portlets expected to be on each page. This is an XML file in the form of a Pluto driver configuration file. The schema for this file is located in the Pluto project at the following location: </p> -<p><code>./pluto/pluto-portal-driver/src/main/resources/pluto-portal-driver-config.xsd</code></p> +<p> + <tt>./pluto/pluto-portal-driver/src/main/resources/pluto-portal-driver-config.xsd</tt> + </p> <p> After the TCK has been built, complete page file for the TCK pages is contained in the following file: </p> -<p><code>./pluto/portlet-tck_3.0/deploy/target/deploy-files/pluto-portal-driver-config.xml</code></p> +<p> + <tt>./pluto/portlet-tck_3.0/deploy/target/deploy-files/pluto-portal-driver-config.xml</tt> + </p> <p> It is expected that vendors will extract the portlet-to-page mapping information from the page file in order to create the necessary configuration files for @@ -442,24 +327,35 @@ The test driver searches for the page links by link text, so it is important that the links have the names defined in the page file. </p> -</div> -<div class="section"><h3><a name="Accessing_the_version_3.0.0_TCK_Source_Code"></a>Accessing the version 3.0.0 TCK Source Code</h3> + </div> + + +<div class="section"> +<h3><a name="Accessing_the_version_3.0.0_TCK_Source_Code"></a>Accessing the version 3.0.0 TCK Source Code</h3> + <p> The source code is located in the <a class="externalLink" href="https://github.com/apache/portals-pluto";>Apache Pluto repository</a>. </p> <p> First, use git to clone the repository: - <code>git clone https://github.com/apache/portals-pluto.git pluto</code></p> + <tt>git clone https://github.com/apache/portals-pluto.git pluto</tt> + </p> <p> Then switch into the 'pluto' directory and checkout the source for Pluto 3.0.0: </p> -<p><code>git checkout pluto-3.0.0</code></p> +<p> + <tt>git checkout pluto-3.0.0</tt> + </p> <p> The version 3.0.0 TCK source code is now located in the 'portlet-tck_3.0' directory. </p> -</div> -<div class="section"><h3><a name="Building_the_TCK"></a>Building the TCK</h3> + </div> + + +<div class="section"> +<h3><a name="Building_the_TCK"></a>Building the TCK</h3> + <p> Building the TCK produces the test portlets, a list of test cases in XML format, an XML-based page file containing the page configuration expected by the test @@ -469,34 +365,46 @@ To build portlet war files that do not contain any special configuration, use the command: </p> -<p><code>mvn clean install</code></p> +<p> + <tt>mvn clean install</tt> + </p> <p> To build portlet war files that are configured for deployment on Pluto, use the command: </p> -<p><code>mvn clean install -Ppluto</code></p> +<p> + <tt>mvn clean install -Ppluto</tt> + </p> <p> These commands can be executed either from the Pluto project base directory or - from the <code>./pluto/portlet-tck_3.0</code> directory. + from the <tt>./pluto/portlet-tck_3.0</tt> directory. </p> -</div> -<div class="section"><h3><a name="Deploying_the_TCK"></a>Deploying the TCK</h3> + </div> + + +<div class="section"> +<h3><a name="Deploying_the_TCK"></a>Deploying the TCK</h3> + <p> Use the page file which has the default - name of <code>deploy/target/deploy-files/pluto-portal-driver-config.xml</code> to create + name of <tt>deploy/target/deploy-files/pluto-portal-driver-config.xml</tt> to create pages for your system. - The WAR files in the <code>deploy/target/deploy-files</code> + The WAR files in the <tt>deploy/target/deploy-files</tt> contain the test portlet code. Deploy these files on your system. </p> <p> If you are testing with Apache Pluto, you can simply copy - the page file into the Pluto <code>webapps/pluto/WEB-INF</code> directory in order to set up the + the page file into the Pluto <tt>webapps/pluto/WEB-INF</tt> directory in order to set up the pages. To deploy the WAR files on Pluto, copy them into the Pluto webapps directory. </p> -</div> -<div class="section"><h3><a name="Running_the_TCK"></a>Running the TCK</h3> + </div> + + +<div class="section"> +<h3><a name="Running_the_TCK"></a>Running the TCK</h3> + <p> - Configure the parent POM file <code>./pluto/portlet-tck_3.0/pom.xml</code> to + Configure the parent POM file <tt>./pluto/portlet-tck_3.0/pom.xml</tt> to address your system under test. See the properties section in the pom.xml file. You can set the host name and port for the system under test, and can also select the browser to be used by the Selenium WebDriver code. Note, @@ -518,54 +426,76 @@ <p> Run the TCK by switching to the driver subdirectory and execute the command: </p> -<p><code>mvn test -Prun-tck</code></p> +<p> + <tt>mvn test -Prun-tck</tt> + </p> <p> If you want to run a subset of the tests, use the "-Dtest.module=" option. The driver will then only execute those tests whose test case name contains the specified string. For example, if you want to run the signature verification tests, use the command: </p> -<p><code>mvn test -Prun-tck -Dtest.module=SIG</code></p> +<p> + <tt>mvn test -Prun-tck -Dtest.module=SIG</tt> + </p> <p> You can also exclude specific tests by placing an exclamation point before the text to be matched. For example, if you want to exclude the signature verification tests, use the command: </p> -<p><code>mvn test -Prun-tck -Dtest.module=!SIG</code></p> +<p> + <tt>mvn test -Prun-tck -Dtest.module=!SIG</tt> + </p> <p> The 'test.dryrun' flag will cause the test cases to be listed without executing them. For example, the following command will list all of the test cases whose test case name contains 'ResourceResponse', but will not execute them: </p> -<p><code>mvn test -Prun-tck -Dtest.module=ResourceResponse -Dtest.dryrun=true</code></p> +<p> + <tt>mvn test -Prun-tck -Dtest.module=ResourceResponse -Dtest.dryrun=true</tt> + </p> <p> The test driver will wait for a response for a default time of 3 seconds. If this value proves to be too short, you can change it in the portlet-tck_3.0/POM.xml file, or you can specify a timeout value using the 'test-timeout' command line option. The timeout value is specified in seconds, as follows: </p> -<p><code>mvn test -Prun-tck -Dtest.module=ResourceResponse -Dtest.timeout=5</code></p> +<p> + <tt>mvn test -Prun-tck -Dtest.module=ResourceResponse -Dtest.timeout=5</tt> + </p> <p> The test driver has an ignore list containing test case names that are not required to pass in order for a portal product to be JSR 362 compliant. The ignore list is an XML file in properties file format located at: </p> -<p><code>portlet-tck_3.0/driver/src/main/resources/xml-resources/ignoredTestCases.xml</code></p> +<p> + <tt>portlet-tck_3.0/driver/src/main/resources/xml-resources/ignoredTestCases.xml</tt> + </p> <p> By default, the test driver will ignore and will not execute all test cases in the ignore list. If you wish to execute all test cases including those in the ignore list, set the command line flag 'test.ignore' to false: </p> -<p><code>mvn test -Prun-tck -Dtest.ignore=false</code></p> -</div> -<div class="section"><h3><a name="Passing_the_TCK"></a>Passing the TCK</h3> +<p> + <tt>mvn test -Prun-tck -Dtest.ignore=false</tt> + </p> + </div> + + +<div class="section"> +<h3><a name="Passing_the_TCK"></a>Passing the TCK</h3> + <p> TCK execution is self-policing. If you are a portal vendor and wish to claim JSR 362 compatibility for your product, you should be able to demonstrate that this TCK can be executed against your product with no errors. </p> -</div> -<div class="section"><h3><a name="Contesting_a_Test_Case"></a>Contesting a Test Case</h3> + </div> + + +<div class="section"> +<h3><a name="Contesting_a_Test_Case"></a>Contesting a Test Case</h3> + <p> When defining and implementing the TCK test cases, care was taken to assure proper implementation and to test only required functionality. @@ -577,7 +507,9 @@ <p> In either case, please open an issue at the Pluto Jira: </p> -<p><code>https://issues.apache.org/jira/browse/PLUTO/</code></p> +<p> + <tt>https://issues.apache.org/jira/browse/PLUTO/</tt> + </p> <p> Prefix the summary with 'TCK:' in order to allow TCK issues to be readily identified. Please be sure to specify the exact name(s) of the test case(s) in @@ -587,7 +519,9 @@ If you feel that the test case was implemented incorrectly, you may correct the implementation and issue a pull request through github here: </p> -<p><code>https://github.com/apache/portals-pluto/pulls</code></p> +<p> + <tt>https://github.com/apache/portals-pluto/pulls</tt> + </p> <p> If you feel that the test case is invalid as defined, you may update the ignore list and issue a pull request. @@ -596,31 +530,24 @@ If we agree that the test case is invalid or incorrectly implemented, we will fix it or integrate your fix into the Pluto master and version 3.0 branches. </p> -</div> -</div> - - </div> - </div> - <div class="clear"> - <hr/> - </div> - <div id="footer"> - <div class="xright">© - 2004-2018 - - Apache Software Foundation - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - </body> -</html> + </div> + </div> + + + + + </div> + </div> + <div class="clear"> + <hr/> + </div> + <div id="footer"> + <div class="xright"> + Copyright © 2004–2019 <a href="http://www.apache.org/";>Apache Software Foundation</a>. +All rights reserved. </div> + <div class="clear"> + <hr/> + </div> + </div> + </body> +</html> Modified: portals/site-live/pluto/v30/v3Features.html URL: http://svn.apache.org/viewvc/portals/site-live/pluto/v30/v3Features.html?rev=1858149&r1=1858148&r2=1858149&view=diff ============================================================================== --- portals/site-live/pluto/v30/v3Features.html (original) +++ portals/site-live/pluto/v30/v3Features.html Thu Apr 25 17:29:43 2019 @@ -1,260 +1,122 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> - - - - - - - - - - - -<html xmlns="http://www.w3.org/1999/xhtml";> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Pluto - Portlet API version 3.0 Overview</title> - <style type="text/css" media="all"> - @import url("../css/maven-base.css"); - @import url("../css/maven-theme.css"); - @import url("../css/site.css"); - </style> - <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - </head> - <body class="composite"> - <div id="banner"> - <a href="http://portals.apache.org/pluto/"; id="bannerLeft"> - - <img src="http://portals.apache.org/pluto/images/apache-portals.gif"; alt="" /> - - </a> - <span id="bannerRight"> - - <img src="http://portals.apache.org/pluto/images/banner.png"; alt="" /> - - </span> - <div class="clear"> - <hr/> - </div> - </div> - <div id="breadcrumbs"> - - - - - - - - - <div class="xleft"> - Last Published: 2018-06-22 - | - <a href="http://portals.apache.org/pluto"; class="externalLink">Home</a> - </div> - <div class="xright"> <a href="../portlet-3.0-apidocs/index.html">Portlet 3.0 API</a> - | - <a href="../portlet-2.0-apidocs/index.html">Portlet 2.0 API</a> - | - <a href="../portlet-1.0-apidocs/index.html">Portlet 1.0 API</a> - | - <a href="http://jcp.org/en/jsr/detail?id=362"; class="externalLink">JSR 362 JCP Page</a> - | - <a href="http://jcp.org/en/jsr/detail?id=286"; class="externalLink">JSR 286 JCP Page</a> - | - <a href="http://jcp.org/en/jsr/detail?id=168"; class="externalLink">JSR 168 JCP Page</a> - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - <div id="leftColumn"> - <div id="navcolumn"> - - - - - - - - - <h5>The Pluto Project</h5> - <ul> - - <li class="none"> - <a href="../index.html">About Pluto</a> - </li> - - <li class="none"> - <a href="../mission.html">Mission</a> - </li> - - <li class="none"> - <a href="../download.html">Download</a> - </li> - - <li class="none"> - <a href="../news.html">News</a> - </li> - - <li class="none"> - <a href="../security.html">Security</a> - </li> - - <li class="none"> - <a href="../status.html">Status</a> - </li> - - <li class="none"> - <a href="../architecture.html">Architecture</a> - </li> - - <li class="none"> - <a href="../resources.html">Resources</a> - </li> - - <li class="none"> - <a href="../faq.html">FAQ</a> - </li> - - <li class="none"> - <a href="http://wiki.apache.org/portals/Pluto"; class="externalLink">Wiki</a> - </li> - - <li class="none"> - <a href="https://issues.apache.org/jira/browse/PLUTO"; class="externalLink">Issue Tracker (JIRA)</a> - </li> - - <li class="none"> - <a href="../helping.html">Get Involved</a> - </li> - </ul> - <h5>Pluto 3.0</h5> - <ul> - - <li class="none"> - <a href="../v301/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v301/deploying.html">Deploying Portlets</a> - </li> - - <li class="none"> - <a href="../v301/portlet-api.html">Portlet Concepts</a> - </li> - - <li class="none"> - <a href="../v301/v3Features.html">Version 3 Features</a> - </li> - - <li class="none"> - <a href="../v301/tck.html">Using the TCK</a> - </li> - - <li class="none"> - <a href="../v301/release-notes.html">Release Notes</a> - </li> - </ul> - <h5>Pluto 2.0</h5> - <ul> - - <li class="none"> - <a href="../v20/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v20/deploying.html">Deploying</a> - </li> - - <li class="none"> - <a href="../v20/embedding.html">Embedding</a> - </li> - - <li class="none"> - <a href="../v20/release-notes.html">Release Notes</a> - </li> - - <li class="none"> - <a href="../v20/app-servers.html">App Servers</a> - </li> - - <li class="none"> - <a href="../v20/powered.html">Powered By Pluto</a> - </li> - </ul> - <h5>Pluto 1.1</h5> - <ul> - - <li class="none"> - <a href="../v11/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v11/deploying.html">Deploying</a> - </li> - - <li class="none"> - <a href="../v11/release-notes.html">Release Notes</a> - </li> - </ul> - <h5>Subprojects</h5> - <ul> - - <li class="none"> - <a href="../subprojects/subprojects.html">Overview</a> - </li> - </ul> - <h5>Project Info</h5> - <ul> - - <li class="none"> - <a href="../project-summary.html">Project Summary</a> - </li> - - <li class="none"> - <a href="../team-list.html">Project Team</a> - </li> - - <li class="none"> - <a href="../license.html">Project License</a> - </li> - - <li class="none"> - <a href="../mail-lists.html">Mailing Lists</a> - </li> - - <li class="none"> - <a href="../source-repository.html">Source Repository</a> - </li> - - <li class="none"> - <a href="../issue-tracking.html">Issue Tracking</a> - </li> - </ul> - <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> - <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img> - </a> - - - - - - - - - </div> - </div> - <div id="bodyColumn"> - <div id="contentBox"> - <div class="section"><h2><a name="Portlet_API_version_3.0_Overview"></a>Portlet API version 3.0 Overview</h2> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> +<!-- Generated by Apache Maven Doxia Site Renderer 1.8.1 from src/site/xdoc/v30/v3Features.xml at 2019-04-25 --> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + <title>Pluto – Portlet API version 3.0 Overview</title> + <style type="text/css" media="all"> + @import url("../css/maven-base.css"); + @import url("../css/maven-theme.css"); + @import url("../css/site.css"); + </style> + <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> + <meta http-equiv="Content-Language" content="en" /> + + </head> + <body class="composite"> + <div id="banner"> +<a href="http://portals.apache.org/pluto/"; id="bannerLeft"><img src="http://portals.apache.org/pluto/images/apache-portals.gif"; alt="Pluto"/></a> +<div id="bannerRight"> +<img src="http://portals.apache.org/pluto/images/banner.png"; alt=""/></div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="breadcrumbs"> + <div class="xleft"> + <span id="publishDate">Last Published: 2019-04-25</span> + | <a href="http://portals.apache.org/pluto"; class="externalLink" title="Home">Home</a> > +Portlet API version 3.0 Overview + </div> + <div class="xright"><a href="../portlet-3.0-apidocs/index.html" title="Portlet 3.0 API">Portlet 3.0 API</a> | +<a href="../portlet-2.0-apidocs/index.html" title="Portlet 2.0 API">Portlet 2.0 API</a> | +<a href="../portlet-1.0-apidocs/index.html" title="Portlet 1.0 API">Portlet 1.0 API</a> | +<a href="http://jcp.org/en/jsr/detail?id=362"; class="externalLink" title="JSR 362 JCP Page">JSR 362 JCP Page</a> | +<a href="http://jcp.org/en/jsr/detail?id=286"; class="externalLink" title="JSR 286 JCP Page">JSR 286 JCP Page</a> | +<a href="http://jcp.org/en/jsr/detail?id=168"; class="externalLink" title="JSR 168 JCP Page">JSR 168 JCP Page</a> </div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="leftColumn"> + <div id="navcolumn"> + <h5>The Pluto Project</h5> + <ul> + <li class="none"><a href="../index.html" title="About Pluto">About Pluto</a></li> + <li class="none"><a href="../mission.html" title="Mission">Mission</a></li> + <li class="none"><a href="../download.html" title="Download">Download</a></li> + <li class="none"><a href="../news.html" title="News">News</a></li> + <li class="none"><a href="../security.html" title="Security">Security</a></li> + <li class="none"><a href="../status.html" title="Status">Status</a></li> + <li class="none"><a href="../architecture.html" title="Architecture">Architecture</a></li> + <li class="none"><a href="../resources.html" title="Resources">Resources</a></li> + <li class="none"><a href="../faq.html" title="FAQ">FAQ</a></li> + <li class="none"><a href="http://wiki.apache.org/portals/Pluto"; class="externalLink" title="Wiki">Wiki</a></li> + <li class="none"><a href="https://issues.apache.org/jira/browse/PLUTO"; class="externalLink" title="Issue Tracker (JIRA)">Issue Tracker (JIRA)</a></li> + <li class="none"><a href="../helping.html" title="Get Involved">Get Involved</a></li> + </ul> + <h5>Pluto 3.1</h5> + <ul> + <li class="none"><a href="../v310/mvcbean-portlets.html" title="MVCBean Portlets">MVCBean Portlets</a></li> + <li class="none"><a href="../v310/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v310/maven-archetypes.html" title="Maven Archetypes">Maven Archetypes</a></li> + <li class="none"><a href="../v310/deploying.html" title="Deploying Portlets">Deploying Portlets</a></li> + <li class="none"><a href="../v310/portlet-api.html" title="Portlet Concepts">Portlet Concepts</a></li> + <li class="none"><a href="../v310/v3Features.html" title="Version 3 Features">Version 3 Features</a></li> + <li class="none"><a href="../v310/tck.html" title="Using the TCK">Using the TCK</a></li> + <li class="none"><a href="../v310/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Pluto 3.0</h5> + <ul> + <li class="none"><a href="../v301/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v301/deploying.html" title="Deploying Portlets">Deploying Portlets</a></li> + <li class="none"><a href="../v301/portlet-api.html" title="Portlet Concepts">Portlet Concepts</a></li> + <li class="none"><a href="../v301/v3Features.html" title="Version 3 Features">Version 3 Features</a></li> + <li class="none"><a href="../v301/tck.html" title="Using the TCK">Using the TCK</a></li> + <li class="none"><a href="../v301/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Pluto 2.0</h5> + <ul> + <li class="none"><a href="../v20/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v20/deploying.html" title="Deploying">Deploying</a></li> + <li class="none"><a href="../v20/embedding.html" title="Embedding">Embedding</a></li> + <li class="none"><a href="../v20/release-notes.html" title="Release Notes">Release Notes</a></li> + <li class="none"><a href="../v20/app-servers.html" title="App Servers">App Servers</a></li> + <li class="none"><a href="../v20/powered.html" title="Powered By Pluto">Powered By Pluto</a></li> + </ul> + <h5>Pluto 1.1</h5> + <ul> + <li class="none"><a href="../v11/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v11/deploying.html" title="Deploying">Deploying</a></li> + <li class="none"><a href="../v11/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Subprojects</h5> + <ul> + <li class="none"><a href="../subprojects/subprojects.html" title="Overview">Overview</a></li> + </ul> + <h5>Project Info</h5> + <ul> + <li class="none"><a href="../project-summary.html" title="Project Summary">Project Summary</a></li> + <li class="none"><a href="../team-list.html" title="Project Team">Project Team</a></li> + <li class="none"><a href="../license.html" title="Project License">Project License</a></li> + <li class="none"><a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a></li> + <li class="none"><a href="../source-repository.html" title="Source Repository">Source Repository</a></li> + <li class="none"><a href="../issue-tracking.html" title="Issue Tracking">Issue Tracking</a></li> + </ul> + <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> + <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /> + </a> + </div> + </div> + <div id="bodyColumn"> + <div id="contentBox"> + + + + + <div class="section"> +<h2><a name="Portlet_API_version_3.0_Overview"></a>Portlet API version 3.0 Overview</h2> + <p> This section presents some of the main new features introduced by JSR 362. JSR 362 Portlet Specification 3.0 introduces many improvements to the @@ -268,34 +130,46 @@ Specification, meaning that version 2.0 portlets can run on the version 3.0 portlet container. </p> + <p> Additional Resources: </p> -<ul><li> + +<ul> + +<li> The <a class="externalLink" href="http://jcp.org/en/jsr/detail?id=362";>Java Community Process JSR 362 page</a> will allow you to access the complete specification for full details. </li> + <li> The JavaOne 2016 presentation <a class="externalLink" href="https://static.rainfocus.com/oracle/oow16/sess/1462801563632001pOv8/ppt/JSR362-JavaOne-2016a.pdf";>"Portlet Specification 3.0 Is Here!"</a> provides a version 3.0 overview. </li> + <li> The <a href="../portlet-3.0-apidocs/index.html">Portlet API Version 3.0</a> page documents the portlet programming interface. </li> -</ul> -<div class="section"><h3><a name="Configuration_by_Annotation"></a>Configuration by Annotation</h3> + </ul> + + +<div class="section"> +<h3><a name="Configuration_by_Annotation"></a>Configuration by Annotation</h3> + <p> - The version 3.0 portlet API introduces the <code>@PortletApplication</code> - and <code>@PortletConfiguration</code> annotations to allow portlets to + The version 3.0 portlet API introduces the <tt>@PortletApplication</tt> + and <tt>@PortletConfiguration</tt> annotations to allow portlets to be configured without using the deployment descriptor. Note that the deployment descriptor can still be used. When both configuration annotations and a portlet deployment descriptor are present, values from the deployment descriptor override those provided by annotation. </p> + +<div> <pre> @PortletApplication( defaultNamespaceURI="https://www.java.net/", @@ -317,7 +191,12 @@ } ) </pre></div> -<div class="section"><h3><a name="Extended_Method_Annotations"></a>Extended Method Annotations</h3> + </div> + + +<div class="section"> +<h3><a name="Extended_Method_Annotations"></a>Extended Method Annotations</h3> + <p> Version 3 extends the idea of method annotations introduced with version 2. Portlet methods may now be located in classes that do not implement portlet @@ -325,34 +204,42 @@ Also, lifecycle methods belonging to a single portlet need not be in the same class. </p> + <p> - The extended method annotations <code>@HeaderMethod</code>, <code>@RenderMethod</code>, - and <code>@ServeResourceMethod</code> have relaxed method signature requirements + The extended method annotations <tt>@HeaderMethod</tt>, <tt>@RenderMethod</tt>, + and <tt>@ServeResourceMethod</tt> have relaxed method signature requirements as compared to the methods defined by the portlet interfaces. See the portlet API documentation for details. </p> <p> - Use of the extended method annotation <code>@RenderMethod</code> implicitly + Use of the extended method annotation <tt>@RenderMethod</tt> implicitly configures a portlet. No additional configuration is required. The following example defines a simple portlet render method. If this method were located in a class with a default constructor within a web application deployed on a version 3 portal, it would define and automatically configure a portlet by the name of "BeanPortletDemo". </p> + +<div> <pre> @RenderMethod(portletNames = "BeanPortletDemo") public String simpleRender() { return "Hello, World!"; } </pre></div> -<div class="section"><h3><a name="CDI_Support"></a>CDI Support</h3> + </div> + + +<div class="section"> +<h3><a name="CDI_Support"></a>CDI Support</h3> + <p> Version 3 provides support for CDI in several ways. Portlet classes are instantiated through the CDI container to enable dependency injection while respecting scope annotations on the portlet classes. Dependency injection supported in portlet filters and listeners as well as - in asynchronous threads started through the <code>PortletAsyncContext</code> + in asynchronous threads started through the <tt>PortletAsyncContext</tt> object. Many portlet artifacts have been made injectable - the request and response objects, parameter objects, the portlet configuration @@ -360,19 +247,28 @@ public String simpleRender() { </p> <p> Custom CDI scopes for portlets have also been introduced. - <ul><li> + </p> +<ul> + +<li> The portlet session scope - @PortletSessionScoped </li> + <li> The portlet request scope - @PortletRequestScoped </li> + <li> The render state scope - @RenderStateScoped </li> -</ul> -</p> -</div> -<div class="section"><h3><a name="Asynchronous_support"></a>Asynchronous support</h3> + </ul> + + </div> + + +<div class="section"> +<h3><a name="Asynchronous_support"></a>Asynchronous support</h3> + <p> The portlet programming model provides asynchronous support similar to that provided by servlets. @@ -383,7 +279,7 @@ public String simpleRender() { <p> Asynchronous processing must be started within original resource request. The asynchronous thread runs in context of original resource request, - providing that it is started through the <code>PortletAsyncContext#start(Runnable)</code> + providing that it is started through the <tt>PortletAsyncContext#start(Runnable)</tt> method. This means that CDI injection can be used within async thread in the same manner as for the original request. @@ -406,8 +302,13 @@ public String simpleRender() { The resource method then includes a JSP to produce output and completes asynchronous processing. </p> -<img src="../images/async.png" /></div> -<div class="section"><h3><a name="The_Portlet_Hub_JavaScript_API"></a>The Portlet Hub JavaScript API</h3> + <img src="../images/async.png" alt="" /> + </div> + + +<div class="section"> +<h3><a name="The_Portlet_Hub_JavaScript_API"></a>The Portlet Hub JavaScript API</h3> + <p> The portlet specification defines a JavaScript API that can be used by portlet code running on the browser to read and set render parameters, carry out portlet @@ -423,6 +324,7 @@ public String simpleRender() { The portal implementation is responsible for making the portlet hub module available on the portal page. </p> + <p> The following diagram illustrates portlet action processing initiated through the portlet hub. @@ -440,66 +342,69 @@ public String simpleRender() { The portlets can now use the portlet hub API to create resource URLs in order to retrieve information corresponding to the new render state. </p> -<img src="../images/hubaction.png" /><p> + <img src="../images/hubaction.png" alt="" /> + +<p> The main JavaScript functions provided by the portlet hub are listed below. </p> -<dl><dt><code> + +<dl> + +<dt><tt> Promise(PortletInit) register(<Portlet ID>) - </code></dt> + </tt></dt> <dd> Registers a portlet client designated by portlet ID with the Portlet Hub and returns object that provides access to remaining Portlet Hub functions. </dd> -<dt><code> +<dt><tt> ListenerID addEventListener(<listener type>, <listener method>) - </code></dt> + </tt></dt> <dd> The Portlet Hub informs Portlet Client of state changes by calling the event listener function and passing the updated portlet state. </dd> -<dt><code> +<dt><tt> Promise(url) createResourceUrl(<resource parameters>, <cacheability>, <resource ID>) - </code></dt> + </tt></dt> <dd> Creates a resource URL containing the current page / portlet state. The URL can be used with the framework of choice to retrieve the resource. </dd> -<dt><code> +<dt><tt> setPortletState(<new portlet state>) - </code></dt> + </tt></dt> <dd> Allows portlet client to set private and public parameters, portlet mode, window state </dd> -<dt><code> +<dt><tt> action(<action parameters>, <form element>) - </code></dt> + </tt></dt> <dd> Carries out a portlet action in Ajax mode (Ajax action) - </dd> -</dl> -<pre></pre></div> -</div> - - </div> - </div> - <div class="clear"> - <hr/> - </div> - <div id="footer"> - <div class="xright">© - 2004-2018 - - Apache Software Foundation - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - </body> -</html> + </dd></dl> + +<div> +<pre> + </pre></div> + </div> + + + + </div> + + + + </div> + </div> + <div class="clear"> + <hr/> + </div> + <div id="footer"> + <div class="xright"> + Copyright © 2004–2019 <a href="http://www.apache.org/";>Apache Software Foundation</a>. +All rights reserved. </div> + <div class="clear"> + <hr/> + </div> + </div> + </body> +</html>
![http://portals.apache.org/pluto/images/apache-portals.gif"](http://portals.apache.org/pluto/images/apache-portals.gif"){kind=link}
![http://portals.apache.org/pluto/images/banner.png"](http://portals.apache.org/pluto/images/banner.png"){kind=link}