Author: chris.laprun(a)jboss.com
Date: 2010-05-17 11:08:26 -0400 (Mon, 17 May 2010)
New Revision: 3106
Modified:
portal/trunk/docs/reference-guide/en/modules/WSRP.xml
Log:
- Fixed link to WSRP primer (thanks, Michal).
- Added note to specify that only portlet 2.0 can be made remotable (thanks, Matt).
- Added link to working around chunked encoding issue (thanks, Prabhat).
Modified: portal/trunk/docs/reference-guide/en/modules/WSRP.xml
===================================================================
--- portal/trunk/docs/reference-guide/en/modules/WSRP.xml 2010-05-17 11:28:58 UTC (rev
3105)
+++ portal/trunk/docs/reference-guide/en/modules/WSRP.xml 2010-05-17 15:08:26 UTC (rev
3106)
@@ -32,7 +32,7 @@
<para>More information on WSRP can be found on the
<ulink
url="http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wsrp...
website for WSRP</ulink>.
We suggest reading the
- <ulink
url="http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wsrp...
+ <ulink
url="http://www.oasis-open.org/committees/download.php/10539/wsrp-pr...
for a good, albeit technical, overview of WSRP.
</para>
</sect1>
@@ -178,6 +178,12 @@
<sect1>
<title>Making a portlet remotable</title>
+ <note>
+ <para>
+ Only JSR-286 (Portlet 2.0) portlets can be made remotable as the mechanism to
expose a portlet to WSRP
+ relies on a JSR-286-only functionality.
+ </para>
+ </note>
<para>&PRODUCT_NAME; does
<emphasis role="bold">NOT</emphasis>, by default, expose
local portlets for consumption
by remote WSRP consumers. In order to make a portlet remotely available, it must
be made "remotable" by marking
@@ -333,6 +339,18 @@
accomplished with a producer descriptor, though it is far easier to do so via
the configuration portlet.
</para>
+ <note>
+ <para>
+ Some WSRP producers do not support chunked encoding that is activated by
default by JBoss WS. If your
+ producer does not support chunked encoding, your consumer will not be able
to properly connect to the
+ producer. This will manifest itself with the following error:
+ <code>Caused by: org.jboss.ws.WSException: Invalid HTTP server
response [503] - Service Unavailable</code>.
+ Please see this GateIn's
+ <ulink
url="http://community.jboss.org/wiki/Workaroundwhenchunkedencodingis...
page</ulink>
+ for more details.
+ </para>
+ </note>
+
<sect3 id="consumer_gui">
<title>Using the configuration portlet</title>
<para>