DPML Notify

[mcconnell AT dpml.net]

Author: mcconnell AT dpml.net
Date: Tue Jun 28 17:43:07 2005
New Revision: 2940

Added:
   
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/Manager.java
Removed:
   development/main/metro/part/src/main/net/dpml/part/manager/Manager.java
Modified:
   
development/main/metro/composition/control/src/main/net/dpml/composition/control/CompositionController.java
   
development/main/metro/composition/control/src/main/net/dpml/composition/model/ValueModel.java
   
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/AbstractComponent.java
   
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/ComponentController.java
   
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/ComponentEntry.java
   
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/PartsInvocationHandler.java
   
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/ValueController.java
   
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/ValueEntry.java
   
development/main/test/unit/simple/src/test/net/dpml/test/acme/CompositeTestCase.java
Log:
Move manager interface into the composition package.

Modified: 
development/main/metro/composition/control/src/main/net/dpml/composition/control/CompositionController.java
==============================================================================
--- 
development/main/metro/composition/control/src/main/net/dpml/composition/control/CompositionController.java
 (original)
+++ 
development/main/metro/composition/control/src/main/net/dpml/composition/control/CompositionController.java
 Tue Jun 28 17:43:07 2005
@@ -59,7 +59,6 @@
 import net.dpml.part.model.Model;
 import net.dpml.part.model.ModelException;
 import net.dpml.part.manager.Component;
-import net.dpml.part.manager.Manager;
 import net.dpml.part.part.Part;
 
 import net.dpml.transit.model.ContentModel;

Modified: 
development/main/metro/composition/control/src/main/net/dpml/composition/model/ValueModel.java
==============================================================================
--- 
development/main/metro/composition/control/src/main/net/dpml/composition/model/ValueModel.java
      (original)
+++ 
development/main/metro/composition/control/src/main/net/dpml/composition/model/ValueModel.java
      Tue Jun 28 17:43:07 2005
@@ -24,6 +24,7 @@
 import java.net.URI;
 
 import net.dpml.composition.runtime.ValueEntry; // <--------------- this is 
runtime
+import net.dpml.composition.runtime.Manager; // <--------------- this is 
runtime
 
 import net.dpml.composition.control.CompositionController;
 import net.dpml.composition.data.ValueDirective;
@@ -32,7 +33,6 @@
 import net.dpml.logging.Logger;
 
 import net.dpml.part.control.Controller;
-import net.dpml.part.manager.Manager;
 import net.dpml.part.manager.Component;
 import net.dpml.part.model.Model;
 import net.dpml.part.model.ModelException;

Modified: 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/AbstractComponent.java
==============================================================================
--- 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/AbstractComponent.java
     (original)
+++ 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/AbstractComponent.java
     Tue Jun 28 17:43:07 2005
@@ -26,7 +26,6 @@
 
 import net.dpml.logging.Logger;
 
-import net.dpml.part.manager.Manager;
 import net.dpml.part.manager.Component;
 import net.dpml.part.manager.AvailabilityEvent;
 import net.dpml.part.manager.AvailabilityListener;

Modified: 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/ComponentController.java
==============================================================================
--- 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/ComponentController.java
   (original)
+++ 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/ComponentController.java
   Tue Jun 28 17:43:07 2005
@@ -47,7 +47,6 @@
 import net.dpml.part.control.ControlException;
 import net.dpml.part.control.ControlRuntimeException;
 import net.dpml.part.control.Disposable;
-import net.dpml.part.manager.Manager;
 import net.dpml.part.manager.Component;
 import net.dpml.part.model.DuplicateKeyException;
 import net.dpml.part.state.State;

Modified: 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/ComponentEntry.java
==============================================================================
--- 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/ComponentEntry.java
        (original)
+++ 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/ComponentEntry.java
        Tue Jun 28 17:43:07 2005
@@ -54,7 +54,6 @@
 import net.dpml.part.manager.Component;
 import net.dpml.part.manager.AvailabilityEvent;
 import net.dpml.part.manager.AvailabilityListener;
-import net.dpml.part.manager.Manager;
 import net.dpml.part.model.Model;
 
 /**

Added: 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/Manager.java
==============================================================================
--- (empty file)
+++ 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/Manager.java
       Tue Jun 28 17:43:07 2005
@@ -0,0 +1,81 @@
+/* 
+ * Copyright 2005 Stephen J. McConnell.
+ *
+ * Licensed  under the  Apache License,  Version 2.0  (the "License");
+ * you may not use  this file  except in  compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed  under the  License is distributed on an "AS IS" BASIS,
+ * WITHOUT  WARRANTIES OR CONDITIONS  OF ANY KIND, either  express  or
+ * implied.
+ * 
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.dpml.composition.runtime;
+
+import net.dpml.part.control.Control;
+import net.dpml.part.model.ResourceUnavailableException;
+import net.dpml.part.manager.Component;
+import net.dpml.part.state.State;
+
+/**
+ * The Manager interface is an interface representing a component controller.
+ *
+ * @author <a href="mailto:dev-dpml AT lists.ibiblio.org";>The Digital Product 
Meta Library</a>
+ */
+public interface Manager extends Control
+{
+   /**
+    * Return an instance of the component type represented 
+    * by the supplied model.
+    * 
+    * @param component the component model
+    * @param policy the proxy creation policy
+    * @return the resolved instance
+    */
+    Object resolve( Component component, boolean policy ) throws Exception;
+
+   /**
+    * Applies a state transition identified by a supplied transition key.
+    *
+    * @param instance the component instance to which the transition is to 
be applied
+    * @param key the key identifying the transition to apply to the 
component's controller
+    * @return the state resulting from the transition
+    * @exception if a transition error occurs
+    */
+    State apply( Component instance, String key ) throws Exception;
+
+   /**
+    * Executes an operation identified by a supplied operation key.
+    *
+    * @param instance the component instance to which the operation is to be 
executed against
+    * @param key the key identifying the operation to execute 
+    * @exception if a transition error occurs
+    */
+    void execute( Component instance, String key ) throws Exception;
+
+   /**
+    * Release a reference to an object managed by the instance.
+    * 
+    * @param instance the instance to release
+    */
+    void release( Object instance );
+
+   /**
+    * Initialize the component.  
+    * @param component the component 
+    */
+    void initialize( Component component ) throws Exception;
+
+   /**
+    * Termination of the component.
+    * @param component the component 
+    */
+    void terminate( Component component );
+
+}

Modified: 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/PartsInvocationHandler.java
==============================================================================
--- 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/PartsInvocationHandler.java
        (original)
+++ 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/PartsInvocationHandler.java
        Tue Jun 28 17:43:07 2005
@@ -32,7 +32,6 @@
 import net.dpml.part.control.Controller;
 import net.dpml.part.control.DelegationException;
 import net.dpml.part.manager.Component;
-import net.dpml.part.manager.Manager;
 import net.dpml.part.model.Model;
 
 /**

Modified: 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/ValueController.java
==============================================================================
--- 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/ValueController.java
       (original)
+++ 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/ValueController.java
       Tue Jun 28 17:43:07 2005
@@ -24,7 +24,6 @@
 
 import net.dpml.composition.control.CompositionController;
 
-import net.dpml.part.manager.Manager;
 import net.dpml.part.manager.Component;
 import net.dpml.part.state.NoSuchOperationException;
 import net.dpml.part.state.NoSuchTransitionException;

Modified: 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/ValueEntry.java
==============================================================================
--- 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/ValueEntry.java
    (original)
+++ 
development/main/metro/composition/control/src/main/net/dpml/composition/runtime/ValueEntry.java
    Tue Jun 28 17:43:07 2005
@@ -30,7 +30,6 @@
 import net.dpml.logging.Logger;
 
 import net.dpml.part.control.Controller;
-import net.dpml.part.manager.Manager;
 import net.dpml.part.manager.Component;
 import net.dpml.part.model.Model;
 import net.dpml.part.model.ModelException;

Modified: 
development/main/test/unit/simple/src/test/net/dpml/test/acme/CompositeTestCase.java
==============================================================================
--- 
development/main/test/unit/simple/src/test/net/dpml/test/acme/CompositeTestCase.java
        (original)
+++ 
development/main/test/unit/simple/src/test/net/dpml/test/acme/CompositeTestCase.java
        Tue Jun 28 17:43:07 2005
@@ -27,7 +27,6 @@
 
 import net.dpml.part.control.Controller;
 import net.dpml.part.model.Model;
-import net.dpml.part.manager.Manager;
 import net.dpml.part.manager.Component;
 
 import net.dpml.metro.central.MetroHelper;