From do-not-reply at jboss.org Thu Aug 19 13:18:41 2010
Content-Type: multipart/mixed; boundary="===============8720941262327894231=="
MIME-Version: 1.0
From: do-not-reply at jboss.org
To: exo-jcr-commits at lists.jboss.org
Subject: [exo-jcr-commits] exo-jcr SVN: r2956 -
 jcr/trunk/docs/reference/en/src/main/docbook/en-US/modules/kernel.
Date: Thu, 19 Aug 2010 13:18:40 -0400
Message-ID: <201008191718.o7JHIeqU006978@svn01.web.mwc.hst.phx2.redhat.com>

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

Author: nfilotto
Date: 2010-08-19 13:18:39 -0400 (Thu, 19 Aug 2010)
New Revision: 2956

Modified:
   jcr/trunk/docs/reference/en/src/main/docbook/en-US/modules/kernel/config=
uration.xml
Log:
EXOJCR-842: commit patch (doc part)

Modified: jcr/trunk/docs/reference/en/src/main/docbook/en-US/modules/kernel=
/configuration.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
--- jcr/trunk/docs/reference/en/src/main/docbook/en-US/modules/kernel/confi=
guration.xml	2010-08-19 17:17:55 UTC (rev 2955)
+++ jcr/trunk/docs/reference/en/src/main/docbook/en-US/modules/kernel/confi=
guration.xml	2010-08-19 17:18:39 UTC (rev 2956)
@@ -1148,7 +1148,7 @@
           <envar>PortalContainerDefinition</envar> must be a class of type
           <envar>PortalContainerDefinitionChange</envar>. The product prop=
oses
           out of the box some implementations that we describe in the next=
 sub
-          sections. </para>
+          sections.</para>
 =

           <section>
             <title><envar>AddDependencies</envar></title>
@@ -1451,6 +1451,71 @@
           </section>
         </section>
       </section>
+
+      <section>
+        <title>Disable dynamically a portal container</title>
+
+        <para>It is possible to use <envar>component-plugin</envar> elemen=
ts
+        in order to dynamically disable one or several portal containers. =
In
+        the example below, we disable the portal container named
+        <envar>foo</envar>:</para>
+
+        <programlisting>&lt;external-component-plugins&gt;
+  &lt;!-- The full qualified name of the PortalContainerConfig --&gt;
+  &lt;target-component&gt;org.exoplatform.container.definition.PortalConta=
inerConfig&lt;/target-component&gt;
+  &lt;component-plugin&gt;
+    &lt;!-- The name of the plugin --&gt;
+    &lt;name&gt;Disable a PortalContainer&lt;/name&gt;
+    &lt;!-- The name of the method to call on the PortalContainerConfig in=
 order to register the changes on the PortalContainerDefinitions --&gt;
+    &lt;set-method&gt;registerDisablePlugin&lt;/set-method&gt;
+    &lt;!-- The full qualified name of the PortalContainerDefinitionDisabl=
ePlugin --&gt;
+    &lt;type&gt;org.exoplatform.container.definition.PortalContainerDefini=
tionDisablePlugin&lt;/type&gt;
+    &lt;init-params&gt;
+      &lt;!-- The list of the name of the portal containers to disable --&=
gt;
+      &lt;values-param&gt;
+        &lt;name&gt;names&lt;/name&gt;
+        &lt;value&gt;foo&lt;/value&gt;
+      &lt;/values-param&gt;
+    &lt;/init-params&gt;
+  &lt;/component-plugin&gt;
+&lt;/external-component-plugins&gt;</programlisting>
+
+        <table>
+          <title>Descriptions of the fields of a
+          <envar>PortalContainerDefinitionDisablePlugin</envar></title>
+
+          <tgroup cols=3D"2">
+            <tbody>
+              <row>
+                <entry>names</entry>
+
+                <entry>The list of the name of the portal containers to
+                disable.</entry>
+              </row>
+            </tbody>
+          </tgroup>
+        </table>
+
+        <para>To prevent any accesses to a web application corresponding to
+        <envar>PortalContainer</envar> that has been disabled, you need to
+        make sure that the following Http Filter (or a sub class of it) has
+        been added to your web.xml in first position as below:</para>
+
+        <programlisting>&lt;filter&gt;
+  &lt;filter-name&gt;PortalContainerFilter&lt;/filter-name&gt;
+  &lt;filter-class&gt;org.exoplatform.container.web.PortalContainerFilter&=
lt;/filter-class&gt;
+&lt;/filter&gt;  =

+
+&lt;filter-mapping&gt;
+  &lt;filter-name&gt;PortalContainerFilter&lt;/filter-name&gt;
+  &lt;url-pattern&gt;/*&lt;/url-pattern&gt;
+&lt;/filter-mapping&gt;</programlisting>
+
+        <note>
+          <para>It is only possible to disable a portal container when at
+          least one PortalContainerDefinition has been registered.</para>
+        </note>
+      </section>
     </section>
   </section>
 =



--===============8720941262327894231==--