Author: chris.laprun(a)jboss.com
Date: 2008-07-18 12:28:33 -0400 (Fri, 18 Jul 2008)
New Revision: 11502
Modified:
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/wsrp.xml
Log:
- Added documentation on WSRP validation mode.
Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/wsrp.xml
===================================================================
--- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/wsrp.xml 2008-07-18
15:30:25 UTC (rev 11501)
+++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/wsrp.xml 2008-07-18
16:28:33 UTC (rev 11502)
@@ -956,5 +956,39 @@
</para>
</sect3>
</sect2>
+ <sect2 id="strict-mode">
+ <title>WSRP validation mode</title>
+ <para>The lack of conformance kit and the wording of the WSRP
specification leaves room for differing
+ interpretations, resulting in interoperability issues. It is therefore
possible to encounter issues when
+ using consumers from different vendors. We have experienced such issues and
have introduced a way to relax
+ the validation that our WSRP producer performs on the data provided by
consumers to help with
+ interoperability by accepting data that would normally be invalid. Note that
we only relax our validation
+ algorithm on aspects of the specification that are deemed harmless such as
invalid language codes.
+ </para>
+ <para>
+ By default, the WSRP producer is configured in strict mode. If you experience
issues with a given consumer,
+ you might want to try to relax the validation mode. This is accomplished by
editing
+
<filename>jboss-portal.sar/portal-wsrp.sar/META-INF/jboss-service.xml</filename>
and setting the value of
+ the <literal>UseStrictMode</literal> attribute to
<literal>false</literal> as shown below:
+
+ <programlisting><![CDATA[
+<!-- WSRP Producer implementation -->
+<mbean code="org.jboss.portal.wsrp.producer.WSRPProducerImpl"
+ name="portal.wsrp:service=WSRPProducer"
+ xmbean-dd=""
+
xmbean-code="org.jboss.portal.jems.as.system.JBossServiceModelMBean">
+ <xmbean/>
+ <depends optional-attribute-name="Invoker"
proxy-type="attribute">portal:service=PortletInvoker,type=Producer
+ </depends>
+ <depends optional-attribute-name="RegistrationManager"
proxy-type="attribute">
+ portal.wsrp:service=RegistrationManager,type=Producer
+ </depends>
+ <depends optional-attribute-name="ProducerConfigurationService"
proxy-type="attribute">
+ portal.wsrp:service=ProducerConfiguration
+ </depends>
+ <attribute name="UseStrictMode">true</attribute><!-- Set to
false to switch to lenient mode -->
+</mbean>]]></programlisting>
+ </para>
+ </sect2>
</sect1>
</chapter>