DPML Notify

[mcconnell at BerliOS <mcconnell AT mail.berlios.de>]

Author: mcconnell
Date: 2006-03-30 11:41:44 +0200 (Thu, 30 Mar 2006)
New Revision: 1300

Removed:
   trunk/main/central/src/docs/metro/runtime/models/categories.xml
   trunk/main/central/src/docs/metro/runtime/models/directives.xml
Modified:
   trunk/main/central/src/docs/metro/runtime/components/provider/index.xml
   trunk/main/central/src/docs/metro/runtime/components/provider/state.xml
   trunk/main/central/src/docs/metro/runtime/controller/index.xml
   trunk/main/central/src/docs/metro/runtime/index.xml
   trunk/main/central/src/docs/metro/runtime/models/index.xml
   trunk/main/depot/library/src/main/net/dpml/library/impl/DefaultLibrary.java
   
trunk/main/depot/library/src/test/net/dpml/library/impl/DuplicatesTestCase.java
Log:
improving documentation structure (cont.)

Modified: 
trunk/main/central/src/docs/metro/runtime/components/provider/index.xml
===================================================================
--- trunk/main/central/src/docs/metro/runtime/components/provider/index.xml   
  2006-03-30 09:04:47 UTC (rev 1299)
+++ trunk/main/central/src/docs/metro/runtime/components/provider/index.xml   
  2006-03-30 09:41:44 UTC (rev 1300)
@@ -16,8 +16,8 @@
       of service <tt>Provider</tt>(s).  The number of providers
       managed by a component is implementation dependent.  The reference
       implementation maintains providers relative to the associated 
-      <a href="../parts/lifestyle.html">lifestyle</a> and 
-      <a href="../parts/collection.html">collection</a> policies. For 
+      <a href="../../models/lifestyle.html">lifestyle</a> and 
+      <a href="../../models/collection.html">collection</a> policies. For 
       example, a component declaring the <tt>SINGLETON</tt> collection 
       policy will have a 0..1 <tt>Provider</tt> association.  The lifetime
       of the provider will be a function of the associated collection 

Modified: 
trunk/main/central/src/docs/metro/runtime/components/provider/state.xml
===================================================================
--- trunk/main/central/src/docs/metro/runtime/components/provider/state.xml   
  2006-03-30 09:04:47 UTC (rev 1299)
+++ trunk/main/central/src/docs/metro/runtime/components/provider/state.xml   
  2006-03-30 09:41:44 UTC (rev 1300)
@@ -79,9 +79,9 @@
         </p>
 
 <pre>Provider provider = component.getProvider();
-<font color="darkred">provider.apply( "stop" ); // invoke transition
-provider.exec( "timeout", new Object[]{"3000"} ); // execute operation
-provider.apply( "start" );</font> // invoke transition
+<font color="darkred">provider.apply( "stop" );</font> // invoke transition
+<font color="darkred">provider.exec( "timeout", new Object[]{"3000"} 
);</font> // execute operation
+<font color="darkred">provider.apply( "start" );</font> // invoke transition
 </pre>
 
       </subsection>

Modified: trunk/main/central/src/docs/metro/runtime/controller/index.xml
===================================================================
--- trunk/main/central/src/docs/metro/runtime/controller/index.xml      
2006-03-30 09:04:47 UTC (rev 1299)
+++ trunk/main/central/src/docs/metro/runtime/controller/index.xml      
2006-03-30 09:41:44 UTC (rev 1300)
@@ -19,7 +19,7 @@
       </p>
 
       <p>A reference to the default controller is resolved using the 
-      <tt>net.dpml.part.Controller</tt> interface:</p>
+      <tt>net.dpml.component.Controller</tt> interface:</p>
 
       <pre>Controller controller = <font 
color="darkred">Controller.STANDARD</font>;</pre>
 
@@ -29,7 +29,7 @@
       a brief discussion.</p>
 
       <p>
-      The <tt><a href="/api/dpml/@VERSION@/net/dpml/part/Controller.html">
+      The <tt><a 
href="/api/dpml/@VERSION@/net/dpml/component/Controller.html">
       Controller</a></tt> interface defines operations enabling:
       </p>
 
@@ -79,8 +79,8 @@
       
         <p>
         All controllers must implement the 
-        <tt><a href="/api/dpml/@VERSION@/net/dpml/part/package-summary.html">
-        net.dpml.part</a></tt> package API.  Through reference this implies 
support for the 
+        <tt><a 
href="/api/dpml/@VERSION@/net/dpml/component/package-summary.html">
+        net.dpml.component</a></tt> package API.  Through reference this 
implies support for the 
         <tt><a 
href="/api/dpml/@VERSION@/net/dpml/state/package-summary.html">
         net.dpml.state</a></tt> package and a soft dependency on the 
protocol handlers
         defined within the 

Modified: trunk/main/central/src/docs/metro/runtime/index.xml
===================================================================
--- trunk/main/central/src/docs/metro/runtime/index.xml 2006-03-30 09:04:47 
UTC (rev 1299)
+++ trunk/main/central/src/docs/metro/runtime/index.xml 2006-03-30 09:41:44 
UTC (rev 1300)
@@ -43,7 +43,7 @@
             and the runtime system.
           </li>
           <li>
-            <a href="../directies/component/index.html">directive:</a> 
+            <a href="../directives/component/index.html">directive:</a> 
             an XML component definition referencable via the 
<tt>artifact</tt>
             uri using the <tt>part</tt> type identifier.  The part directive 
contains 
             the default deployment profile including the definition of 

Deleted: trunk/main/central/src/docs/metro/runtime/models/categories.xml
===================================================================
--- trunk/main/central/src/docs/metro/runtime/models/categories.xml     
2006-03-30 09:04:47 UTC (rev 1299)
+++ trunk/main/central/src/docs/metro/runtime/models/categories.xml     
2006-03-30 09:41:44 UTC (rev 1300)
@@ -1,54 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-
-<document>
-
-  <properties>
-    <author email="mcconnell AT dpml.net">Stephen McConnell</author>
-    <title>DPML Metro ClassLoader Categories</title>
-  </properties> 
-
-  <body>
-
-    <section name="ClassLoader Categories">
-
-      <p>
-      Component profiles include the defintion of a classloader chain.  The
-      chain is defined by a series of classloader directives.  Each 
classloader
-      directive is associated with a classloader category.  The following 
table 
-      list the available classloading categories and their respective 
semantics.
-      </p>
-
-      <table>
-
-        <tr>
-          <th>Category</th><th>Description</th>
-        </tr>
-
-        <tr>
-          <td><tt>PUBLIC</tt></td>
-          <td>A public classloader typically contains the public service API
-            of a component.
-          </td>
-        </tr>
-        <tr>
-          <td><tt>PROTECTED</tt></td>
-          <td>The protected classloader is created as a child of the public
-            classloader and is typically used as the parent classloader for 
-            component handlers that require access to parent componets (e.g.
-            during assembly processes).</td>
-        </tr>
-        <tr>
-          <td><tt>PRIVATE</tt></td>
-          <td>A private classloader is constructed as a child of the 
protected
-          classloader and is normally not exposed any forign controller or 
-          component.</td>
-        </tr>
-
-      </table>
-
-    </section>
-
-  </body>
-
-</document>
-

Deleted: trunk/main/central/src/docs/metro/runtime/models/directives.xml
===================================================================
--- trunk/main/central/src/docs/metro/runtime/models/directives.xml     
2006-03-30 09:04:47 UTC (rev 1299)
+++ trunk/main/central/src/docs/metro/runtime/models/directives.xml     
2006-03-30 09:41:44 UTC (rev 1300)
@@ -1,66 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-
-<document>
-
-  <properties>
-    <author email="mcconnell AT dpml.net">Stephen McConnell</author>
-    <title>DPML Metro Parts</title>
-  </properties> 
-
-  <body>
-
-    <section name="Component Datastructures">
-
-      <p>
-      A component part associates a component profile with a 
-      supporting controller.  The profile provides a description of a 
deployment
-      state of a component type. 
-      </p>
-
-      <subsection name="Component Directives">
-
-        <p>
-        The default component directive is the 
<tt>net.dpml.metro.data.ComponentDirective</tt> class.
-        The <tt>ComponentDirective</tt> contains information about the 
component  
-        classname (from which the component <a href="../types.html">type</a> 
-        can be resolved), a name that identifies the component within the 
scope of 
-        its parent, and a series of directives that deal with component 
-        configuration including the assignment of context entry values
-        and/or instructions to a container concerning value fullfillment.
-        </p>
-
-      </subsection>
-
-      <subsection name="Component Profile Creation">
-
-        <p>
-        A <a href="../../tasks/components/index.html">component</a> Ant Task 
handles the 
-        construction of externalized part artifacts based on a combination
-        of component type evaluation and information supplied under task 
attributes
-        and nested element.  Once created as an external artifact the part 
is network
-        resolvable and may be easily referenced by application handlers or 
by 
-        components as part of a composite component implementation strategy.
-        </p>
-
-      </subsection>
-
-      <subsection name="Technical Note">
-
-        <p>
-        Under the currrent implementation part properties are not evaluated. 
 The principal
-        purpose of the properties field is to support a degree of 
flexibility when dealing 
-        with future implementations of the Metro system.  As such, users 
should assume that
-        property names commencing with <tt>dpml</tt> are reserved for future 
use by the 
-        DPML.
-        </p>
-
-      </subsection>
-
-    </section>
-
-  </body>
-
-</document>
-
-
-

Modified: trunk/main/central/src/docs/metro/runtime/models/index.xml
===================================================================
--- trunk/main/central/src/docs/metro/runtime/models/index.xml  2006-03-30 
09:04:47 UTC (rev 1299)
+++ trunk/main/central/src/docs/metro/runtime/models/index.xml  2006-03-30 
09:41:44 UTC (rev 1300)
@@ -52,12 +52,9 @@
       <subsection name="ComponentModel">
 
       <p>
-      The <a 
href="/api/dpml/@VERSION@/net/dpml/metro/model/ComponentModel.html">
+      The <a href="/api/dpml/@VERSION@/net/dpml/metro/ComponentModel.html">
       net.dpml.metro.ComponentModel</a> interface exposes information about 
       a component configuration.
-      The <a 
href="/api/dpml/@VERSION@/net/dpml/metro/model/MutableComponentModel.html">
-      net.dpml.metro.MutableComponentModel</a> interface 
-      includes additional operations dealing with model changes.
       </p>
 
       <p>
@@ -81,13 +78,10 @@
       <subsection name="ContextModel">
 
       <p>
-      The <a 
href="/api/dpml/@VERSION@/net/dpml/metro/model/ContextModel.html">
+      The <a href="/api/dpml/@VERSION@/net/dpml/metro/ContextModel.html">
       net.dpml.metro.ContextModel</a> interface 
       exposes information about a context settings - specifically the 
-      binding of context keys to context value directives.  The 
-      <a 
href="/api/dpml/@VERSION@/net/dpml/metro/model/MutableContextModel.html">
-      net.dpml.metroMutableContextModel</a> provides support for context 
entry 
-      modification.
+      binding of context keys to context value directives.
       </p>
 
       </subsection>

Modified: 
trunk/main/depot/library/src/main/net/dpml/library/impl/DefaultLibrary.java
===================================================================
--- 
trunk/main/depot/library/src/main/net/dpml/library/impl/DefaultLibrary.java 
2006-03-30 09:04:47 UTC (rev 1299)
+++ 
trunk/main/depot/library/src/main/net/dpml/library/impl/DefaultLibrary.java 
2006-03-30 09:41:44 UTC (rev 1300)
@@ -41,7 +41,6 @@
 import net.dpml.transit.Artifact;
 
 import net.dpml.lang.Logger;
-import net.dpml.lang.DuplicateKeyException;
 
 /**
  * Utility class used for construction of a module model from an XML source.

Modified: 
trunk/main/depot/library/src/test/net/dpml/library/impl/DuplicatesTestCase.java
===================================================================
--- 
trunk/main/depot/library/src/test/net/dpml/library/impl/DuplicatesTestCase.java
     2006-03-30 09:04:47 UTC (rev 1299)
+++ 
trunk/main/depot/library/src/test/net/dpml/library/impl/DuplicatesTestCase.java
     2006-03-30 09:41:44 UTC (rev 1300)
@@ -20,12 +20,6 @@
 
 import java.io.File;
 
-import net.dpml.library.info.LibraryDirective;
-import net.dpml.library.info.ModuleDirective;
-import net.dpml.library.info.ResourceDirective;
-import net.dpml.library.info.TypeDirective;
-import net.dpml.library.impl.DefaultLibrary;
-
 import net.dpml.lang.Logger;
 
 import net.dpml.transit.monitor.LoggingAdapter;