DPML Notify

[mcconnell AT netcompartner.com]

Author: mcconnell
Date: Sun Jan 16 16:14:26 2005
New Revision: 1495

Modified:
   
development/main/central/site/src/docs/products/transit/technical/repository/index.xml
Log:
add info about creation of the plugin descriptor

Modified: 
development/main/central/site/src/docs/products/transit/technical/repository/index.xml
==============================================================================
--- 
development/main/central/site/src/docs/products/transit/technical/repository/index.xml
      (original)
+++ 
development/main/central/site/src/docs/products/transit/technical/repository/index.xml
      Sun Jan 16 16:14:26 2005
@@ -11,7 +11,8 @@
 
       <p>
         The repository service provides support for the construction of 
-        classloader chains, plugin classes, and plugin instantiation.
+        classloader descriptors, classloader chains, plugin class loading, 
+        and plugin instantiation.
       </p>
 
       <subsection name="Classloader Chain Creation">
@@ -35,7 +36,7 @@
         <p><i>Example classloader creation:</i></p>
         <pre>
 Repository repository = new <a 
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/repository/StandardLoader.html">StandardLoader()</a>;
-ClassLoader parent = getClass().getClassLoader();
+ClassLoader parent = getClass().getPluginClassLoader();
 URI uri = new URI( "@METRO-PLUGIN-URI@" );
 Classloader classloader = repository.getClassLoader( parent, uri );
 ....
@@ -44,6 +45,26 @@
 
       </subsection>
 
+      <subsection name="Plugin Descriptor Creation">
+
+        <p>
+          Some applications may require information about a plugin prior to 
loading the plugin. The 
+          <a 
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/repository/Plugin.html">Plugin</a>
+          class is an immutable datatype that serves this function.  It 
enables convinient access to 
+          the api, spi and impl URI sets, and information related to the 
declared main class or 
+          resource and namespec declarations.
+        </p>
+
+        <p><i>Example plugin descriptor creation:</i></p>
+        <pre>
+Repository repository = new StandardLoader();
+URI uri = new URI( "@METRO-PLUGIN-URI@" );
+<a 
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/repository/Plugin.html">Plugin</a>
 plugin = repository.getPluginDescriptor( uri );
+....
+        </pre>
+
+      </subsection>
+
     </section>
   </body>
 </document>