Author: julien(a)jboss.com Date: 2007-06-15 06:24:24 -0400 (Fri, 15 Jun 2007) New Revision: 7433 Modified: docs/trunk/referenceGuide/en/modules/configuration.xml Log: Document proxy unwrapping Modified: docs/trunk/referenceGuide/en/modules/configuration.xml =================================================================== --- docs/trunk/referenceGuide/en/modules/configuration.xml 2007-06-15 00:18:53 UTC (rev 7432) +++ docs/trunk/referenceGuide/en/modules/configuration.xml 2007-06-15 10:24:24 UTC (rev 7433) @@ -203,4 +203,20 @@ </para> </sect2> </sect1> + <sect1> + <title>Disabling dynamic proxy unwrapping</title> + <para>JBoss Portal use the JBoss Microkernel for the service infrastructure. The JBoss Microkernel provides + injection of services into other services, also known as wiring. Unfortunately it is only possible to inject + dynamic proxies that talks to the MBeanServer due to the fact the Microkernel is JMX based. The overhead + at runtime is minimal since the Microkernel implementation is highly optimized, however when it is used + with Java 5 a noticeable bottleneck appears due to the fact that the implementation + of the JMX API classes <emphasis>javax.management.*</emphasis> provided by the Java Platform performs synchronization. This does + not happen under JDK 1.4 since those classes are implemented by JBoss MX.</para> + <para>JBoss Portal services use a special kind of Model MBean called JBossServiceModelMBean which allows to + unwrap the injected dynamic proxies and replace them by the real POJO services. This allows to remove the + bottleneck with Java 5 and provide an extra boost of performances on JDK 1.4. By default that feature + is enabled but it is possible to disabled it using command line arguments.</para> + <programlisting><![CDATA[ +>run.sh -Dportal.kernel.no_proxies=false]]></programlisting> + </sect1> </chapter>