From do-not-reply at jboss.org Thu Aug 19 13:12:19 2010
Content-Type: multipart/mixed; boundary="===============7839359291183535472=="
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: r2954 -
 jcr/branches/1.12.x/exo.jcr.docs/exo.jcr.docs.developer/reference/en/src/main/docbook/en-US/modules/kernel.
Date: Thu, 19 Aug 2010 13:12:18 -0400
Message-ID: <201008191712.o7JHCImt006794@svn01.web.mwc.hst.phx2.redhat.com>

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

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

Modified:
   jcr/branches/1.12.x/exo.jcr.docs/exo.jcr.docs.developer/reference/en/src=
/main/docbook/en-US/modules/kernel/container-configuration.xml
Log:
EXOJCR-842: commit patch (doc part)

Modified: jcr/branches/1.12.x/exo.jcr.docs/exo.jcr.docs.developer/reference=
/en/src/main/docbook/en-US/modules/kernel/container-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/branches/1.12.x/exo.jcr.docs/exo.jcr.docs.developer/reference/en/sr=
c/main/docbook/en-US/modules/kernel/container-configuration.xml	2010-08-19 =
17:11:10 UTC (rev 2953)
+++ jcr/branches/1.12.x/exo.jcr.docs/exo.jcr.docs.developer/reference/en/sr=
c/main/docbook/en-US/modules/kernel/container-configuration.xml	2010-08-19 =
17:12:18 UTC (rev 2954)
@@ -1471,6 +1471,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>
 =



--===============7839359291183535472==--