From jboss-remoting-commits at lists.jboss.org Wed Jul 18 22:33:25 2012
Content-Type: multipart/mixed; boundary="===============8269665799904328110=="
MIME-Version: 1.0
From: jboss-remoting-commits at lists.jboss.org
To: jboss-remoting-commits at lists.jboss.org
Subject: [jboss-remoting-commits] JBoss Remoting SVN: r6455 -
 remoting2/branches/2.2/docs/guide/en.
Date: Wed, 18 Jul 2012 22:33:24 -0400
Message-ID: <201207190233.q6J2XOMn000990@svn01.web.mwc.hst.phx2.redhat.com>

--===============8269665799904328110==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: ron.sigal(a)jboss.com
Date: 2012-07-18 22:33:24 -0400 (Wed, 18 Jul 2012)
New Revision: 6455

Modified:
   remoting2/branches/2.2/docs/guide/en/chap5.xml
Log:
JBREM-1306: Add discussion of new parameter "useDefaultSslSocketFactory".

Modified: remoting2/branches/2.2/docs/guide/en/chap5.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- remoting2/branches/2.2/docs/guide/en/chap5.xml	2012-07-19 02:24:31 UTC =
(rev 6454)
+++ remoting2/branches/2.2/docs/guide/en/chap5.xml	2012-07-19 02:33:24 UTC =
(rev 6455)
@@ -2,7 +2,7 @@
 <chapter id=3D"chapter-configuration" xreflabel=3D"Configuration">
   <title>Configuration</title>
 =

-  <para>This covers the configuration for JBoss Remoting discovery,
+  <para>This chapter covers the configuration for JBoss Remoting discovery,
   connectors, marshallers, and transports. All the configuration properties
   specified can be set either via calls to the object itself, including via
   JMX (so can be done via the JMX or Web console), or via a JBoss AS servi=
ce
@@ -1486,7 +1486,6 @@
       Invoker uses an <classname>SSLServerSocket</classname> by default,
       created by an <classname>SSLServerSocketFactory</classname>. See sec=
tion
       <xref linkend=3D"section-socket-factories" /> for more information.<=
/para>
-    </section>
 =

     <section>
       <title>HTTP(S) Client Invoker - proxy and basic authentication</titl=
e>
@@ -1609,7 +1608,23 @@
       <classname>SocketFactory</classname> configuration.
       =

       </para>
-
+     </section>
+       =

+     <section>
+         <title>HTTPS client socket factory configuration</title>
+         =

+         <para>If a socket factory is not passed into the HTTPS client inv=
oker, it will use =

+         <classname>org.jboss.remoting.security.SSLSocketBuilder</classnam=
e> to create one.
+         However, it might be desirable to allow it to fall back to a defa=
ult socket factory
+         passed into HttpsURLConnection. As of release 2.5.4.SP4, a config=
uration parameter is
+         available to allow that to happen.
+         </para>
+         =

+        <para><emphasis role=3D"bold">useDefaultSslSocketFactory</emphasis=
> - If the parameter is
+        set to "true", <methodname>HTTPSClientInvoker.createSocketFactory(=
)</methodname>
+        will call <methodname>HttpsURLConnection.getDefaultSSLSocketFactor=
y()</methodname>
+        instead of trying to build a socket factory.</para>
+     </section>
     </section>
 =

     <section>
@@ -6846,6 +6861,11 @@
     used by the http client invoker. The value should be the fully qualifi=
ed
     classname of class that implements javax.net.ssl.HostnameVerifier and =
has
     a void constructor.</para>
+    =

+    <para><emphasis role=3D"bold">USE_DEFAULT_SSL_SOCKET_FACTORY</emphasis=
> (actual value is
+    'useDefaultSslSocketFactory') - if set to true, then HTTPSClientInvoke=
r.createSocketFactory()
+    will call HttpsURLConnection.getDefaultSSLSocketFactory() instead of t=
rying to build a SocketFactory.
+    </para>
 =

     <para></para>
 =



--===============8269665799904328110==--