Author: ron.sigal(a)jboss.com
Date: 2009-05-13 01:47:42 -0400 (Wed, 13 May 2009)
New Revision: 5211
Modified:
remoting2/branches/2.x/docs/guide/en/chap5.xml
Log:
JBREM-1121: Added section about configuring socket factories by the InvokerLocator.
Modified: remoting2/branches/2.x/docs/guide/en/chap5.xml
===================================================================
--- remoting2/branches/2.x/docs/guide/en/chap5.xml 2009-05-13 05:29:47 UTC (rev 5210)
+++ remoting2/branches/2.x/docs/guide/en/chap5.xml 2009-05-13 05:47:42 UTC (rev 5211)
@@ -220,7 +220,7 @@
</section>
- <section>
+ <section id="section-declarative-configuration-mbeans"
xreflabel="Declarative configuration: MBeans">
<title>Declarative configuration: MBeans</title>
<para>One configuration option discussed in Section <xref
@@ -341,7 +341,7 @@
with a / (slash).</para>
</section>
- <section>
+ <section id="section-declarative-configuration-pojos"
xreflabel="Declarative configuration: POJOs">
<title>Declarative configuration: POJOs</title>
<para>The last configuration option discussed in Section <xref
@@ -4485,6 +4485,32 @@
of JBoss MBeans.)</para>
</section>
+ <section >
+ <title>Client side configuration from the JBoss Application
Server</title>
+
+ <para>As described in sections <xref
linkend="section-declarative-configuration-mbeans"/>
+ and <xref linkend="section-declarative-configuration-pojos"/>,
+ the declarative xml files used by the Application Server can be used to configure
the
+ client by way of the parameters included in the
<classname>InvokerLocator</classname>.
+ However, a peculiarity in the way socket factories are created on the client
+ restricts the parameters taken into consideration to those passed in the
+ configuration map passed to the
<classname>org.jboss.remoting.Client</classname>
+ constructor. The following two parameters, introduced in releases 2.4.0.SP1 and
+ 2.5.2, respectively, eliminate that restriction.</para>
+
+ <para><emphasis
role="bold">org.jboss.remoting.Remoting.SOCKET_FACTORY_NAME</emphasis>
(actual value
+ is 'socketFactory') - key for giving the name of the socket factory class
to be used
+ by clients.</para>
+
+ <para><emphasis
role="bold">org.jboss.remoting.Remoting.USE_ALL_SOCKET_FACTORY_PARAMS</emphasis>
(actual value
+ is 'useAllSocketFactoryParams') - key for indicating that all socket
factory parameters
+ in the <classname>InvokerLocator</classname> should be used by
clients.</para>
+
+ <para>Note that the parameter
<code>org.jboss.remoting.Remoting.CONFIG_OVERRIDES_LOCATOR</code>
+ (actual value "configOverridesLocator"), described in section
+ <xref linkend="section-org-jboss-remoting-Remoting"/>, is also
relevant.</para>
+ </section>
+
<section>
<title>Socket creation listeners</title>
@@ -5967,7 +5993,7 @@
</section>
- <section>
+ <section id="section-org-jboss-remoting-Remoting"
xreflabel="org.jboss.remoting.Remoting">
<title>org.jboss.remoting.Remoting</title>
<para><emphasis
role="bold">CUSTOM_SERVER_SOCKET_FACTORY</emphasis>
Show replies by date