DPML Notify

[mcconnell AT netcompartner.com]

Author: mcconnell
Date: Mon Jan 10 05:38:44 2005
New Revision: 1425

Modified:
   
development/main/central/site/src/docs/products/transit/concepts/plugins.xml
Log:
Update plugin info.

Modified: 
development/main/central/site/src/docs/products/transit/concepts/plugins.xml
==============================================================================
--- 
development/main/central/site/src/docs/products/transit/concepts/plugins.xml  
      (original)
+++ 
development/main/central/site/src/docs/products/transit/concepts/plugins.xml  
      Mon Jan 10 05:38:44 2005
@@ -55,6 +55,46 @@
 
       </subsection>
       
+      <subsection name="Plugin Management">
+
+        <p>
+        In addition to the structural classloader information - the meta file
+        may contain the declaration of a main class or and antlib resource 
and 
+        namespace. The antlib information is a special case used within the 
+        Magic build system to support dynamic task loading.  The main class 
+        declaration is the entry point for classic plugin class loading 
relative
+        to the established classloader.
+        </p>
+
+        <p>
+        The Transit repository service provides support for class creation 
and 
+        object instantiation.  Class creation is typically used by 
applications
+        that handle a particular semantics concerning a plugin model whereas 
+        the Tranit object instantiation provides a simple but flexible model 
+        suitable for control over selectable sub-system strategies (e.g. the 
+        loading of a logging system or application runtime).
+        </p>
+
+        <p>
+        The following code fragment demonstrates the creation of a plugin 
instance
+        using Transit's standard plugin loader.
+        </p>
+
+<source>
+  Repository repository = new StandardLoader();
+  ClassLoader parent = getClass().getClassLoader();
+  URI uri = new URI( "artifact:meta:dpml/examples/hello/hello-world#1.0.0" );
+  Object[] args = new Object[] { "Hello, World!" };
+  Object plugin = repository.getPlugin( parent, uri, args );
+</source>
+
+        <p>
+        Example of plugin loading and general plugin handling is provided 
+        under the <a href="/guide/transit/plugins/index.html">Transit 
Guide</a>.
+        </p>
+
+      </subsection>
+
     </section>
   </body>
 </document>