[jboss-cvs] JBossAS SVN: r65082 - in projects/microcontainer/trunk/docs/gettingstarted/en-US/src/main/docbook: modules and 1 other directory.

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

Author: alesj
Date: 2007-09-05 07:43:46 -0400 (Wed, 05 Sep 2007)
New Revision: 65082

Modified:
   projects/microcontainer/trunk/docs/gettingstarted/en-US/src/main/docbook/master.xml
   projects/microcontainer/trunk/docs/gettingstarted/en-US/src/main/docbook/modules/classloader.xml
Log:
Initial classloader docs.

Modified: projects/microcontainer/trunk/docs/gettingstarted/en-US/src/main/docbook/master.xml
===================================================================
--- projects/microcontainer/trunk/docs/gettingstarted/en-US/src/main/docbook/master.xml	2007-09-05 11:37:32 UTC (rev 65081)
+++ projects/microcontainer/trunk/docs/gettingstarted/en-US/src/main/docbook/master.xml	2007-09-05 11:43:46 UTC (rev 65082)
@@ -65,9 +65,6 @@
    <xi:include href="modules/mbeans.xml"
                xml:base="./"
                xmlns:xi="http://www.w3.org/2001/XInclude"/>
-   <xi:include href="modules/classloader.xml"
-               xml:base="./"
-               xmlns:xi="http://www.w3.org/2001/XInclude"/>
    <xi:include href="modules/managed.xml"
                xml:base="./"
                xmlns:xi="http://www.w3.org/2001/XInclude"/>
@@ -77,6 +74,9 @@
    <xi:include href="modules/deployers.xml"
                xml:base="./"
                xmlns:xi="http://www.w3.org/2001/XInclude"/>
+   <xi:include href="modules/classloader.xml"
+               xml:base="./"
+               xmlns:xi="http://www.w3.org/2001/XInclude"/>
    <xi:include href="modules/osgi.xml"
                xml:base="./"
                xmlns:xi="http://www.w3.org/2001/XInclude"/>

Modified: projects/microcontainer/trunk/docs/gettingstarted/en-US/src/main/docbook/modules/classloader.xml
===================================================================
--- projects/microcontainer/trunk/docs/gettingstarted/en-US/src/main/docbook/modules/classloader.xml	2007-09-05 11:37:32 UTC (rev 65081)
+++ projects/microcontainer/trunk/docs/gettingstarted/en-US/src/main/docbook/modules/classloader.xml	2007-09-05 11:43:46 UTC (rev 65082)
@@ -6,6 +6,45 @@
    <title>Classloader module</title>
 
    <para>
-      Classloader ...
+      Introducing fine grained classloading in Micorcontainer's IoC, better aspect integration, new
+      <xref linkend="vfs"/> and <xref linkend="deployers"/> projects, it was all set to also redo the whole
+      classloding layer for the new Kernel and transitively JBoss5 application server.
+      Whole new Classloder module was created to somehow fix the old API mistakes and to allow clean and plugable way
+      for existing extensions of default classloading. This extensions range from old concepts of Servlet classloading,
+      runtime AOP weaving, and all the way to new <xref linkend="osgi"/>.
    </para>
+
+   <para>
+      When designing new API for Classloading, we wanted to expose as little as possible.
+      The concept there was to hide all the "nitty gritty" details and reduce the amount of API users need to
+      apply in order to get required behaviour.
+      When you were normally dealing with concrete ClassLoader classes, we reduced the implementation detail to
+      only needing to implement your own ClassLoaderPolicy. This includes things like what packages you export,
+      what you import, how to get resources and other things related to defining classes.
+      We'll show the example of the policy later on.
+   </para>
+
+   <para>
+      Additionally, the idea of a LoaderRepository is replaced with a ClassLoaderDomain
+      and a ClassLoaderSystem acting as a factory and a repository of domains.
+      Each ClassLoaderSystem has a "default domain".
+   </para>
+
+   <programlisting>
+      ClassLoaderSystem system = ClassLoaderSystem.getInstance();
+
+      // Define classloader policy
+      MyClassLoaderPolicy myPolicy = ...
+
+      // Register with the default domain,
+      // there are other methods to create
+      // and register with different domains
+      ClassLoader cl = system.registerClassLoaderPolicy(myPolicy);
+   </programlisting>
+
+   <para>
+      This is a simple example of what it falls down to, to create your own Classloader instance that will
+      behave accordingly to the classloader policy.
+   </para>
+
 </chapter>