[jboss-cvs] JBossAS SVN: r78974 - projects/aop/trunk/aop/docs/reference/reference/en/modules.

[jboss-cvs-commits at lists.jboss.org]

Author: flavia.rainone at jboss.com
Date: 2008-09-30 21:53:53 -0400 (Tue, 30 Sep 2008)
New Revision: 78974

Modified:
   projects/aop/trunk/aop/docs/reference/reference/en/modules/running.xml
Log:
[JBAOP-574] Added a small section to Section 2 (Regular Java Applications) of chapter 11
(RunningAspectizedApplications) stating the requirement that must be followed by user-defined classloaders.

Modified: projects/aop/trunk/aop/docs/reference/reference/en/modules/running.xml
===================================================================
--- projects/aop/trunk/aop/docs/reference/reference/en/modules/running.xml	2008-10-01 00:45:53 UTC (rev 78973)
+++ projects/aop/trunk/aop/docs/reference/reference/en/modules/running.xml	2008-10-01 01:53:53 UTC (rev 78974)
@@ -396,6 +396,24 @@
             in the "Improving Loadtime Performance" subsection, except the pruning of classes.
          </para>
       </sect2>
+      <sect2>
+         <title>User-Defined ClassLoaders</title>
+         <para>
+            In order to be compatible with JBoss AOP, the ClassLoader responsible for loading your application's classes must be able to find class files
+            as resources. This means that, given the name of a class that is in the classpath of your application, the methods below must all return the
+            URL(s) of the corresponding class file(s):
+           <programlisting>
+public URL getResource(String name)
+public Enumeration&lt;URL&gt; getResources(String name) throws IOException
+public Enumeration&lt;URL&gt; getResourceAsStream(String name) throws IOException
+            </programlisting>
+         </para>
+         <para>
+            Usually, there is no need to be concerned about this, as the ClassLoader implementations of Sun's JVM and JRockit follow the requirement
+            above. On the other hand, if the application is being run with a user-defined ClassLoader, it is necessary to make sure the ClassLoader
+            follows this important requirement.
+         </para>
+      </sect2>
    </sect1>