DPML Notify

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

Author: mcconnell
Date: 2006-02-15 03:54:14 +0100 (Wed, 15 Feb 2006)
New Revision: 1096

Removed:
   trunk/main/metro/part/api/src/main/net/dpml/part/ComponentOperations.java
   trunk/main/metro/part/api/src/main/net/dpml/part/ProviderOperations.java
Modified:
   
trunk/main/depot/tools/builder/src/main/net/dpml/tools/tasks/FeatureTask.java
   trunk/main/metro/model/src/main/net/dpml/metro/ComponentContext.java
   trunk/main/metro/model/src/main/net/dpml/metro/ComponentHandler.java
   trunk/main/metro/model/src/main/net/dpml/metro/ComponentModel.java
   trunk/main/metro/model/src/main/net/dpml/metro/ComponentModelManager.java
   trunk/main/metro/model/src/main/net/dpml/metro/ContextModelManager.java
   trunk/main/metro/model/src/main/net/dpml/metro/PartsManager.java
   trunk/main/metro/model/src/main/net/dpml/metro/data/ComponentDirective.java
   
trunk/main/metro/model/src/main/net/dpml/metro/data/DeploymentDirective.java
   trunk/main/metro/model/src/main/net/dpml/metro/info/Composite.java
   trunk/main/metro/model/src/main/net/dpml/metro/info/Type.java
   trunk/main/metro/part/api/src/main/net/dpml/part/Component.java
   trunk/main/metro/part/api/src/main/net/dpml/part/Provider.java
Log:
checkstyle issue resolution
parts and model api improvement

Modified: 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/tasks/FeatureTask.java
===================================================================
--- 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/tasks/FeatureTask.java 
      2006-02-15 02:38:14 UTC (rev 1095)
+++ 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/tasks/FeatureTask.java 
      2006-02-15 02:54:14 UTC (rev 1096)
@@ -198,7 +198,8 @@
                 Artifact artifact = resource.getArtifact( m_type );
                 try
                 {
-                    File cached = (File) artifact.toURL().getContent( new 
Class[]{File.class});
+                    File cached = 
+                      (File) artifact.toURL().getContent( new 
Class[]{File.class} );
                     return cached.getCanonicalPath();
                 }
                 catch( Exception e )

Modified: trunk/main/metro/model/src/main/net/dpml/metro/ComponentContext.java
===================================================================
--- trunk/main/metro/model/src/main/net/dpml/metro/ComponentContext.java      
  2006-02-15 02:38:14 UTC (rev 1095)
+++ trunk/main/metro/model/src/main/net/dpml/metro/ComponentContext.java      
  2006-02-15 02:54:14 UTC (rev 1096)
@@ -36,6 +36,7 @@
    /**
     * Return the current controller.
     * @return the root system controller
+    * @exception RemoteException if a remote I/O error occurs
     */
     Controller getController() throws RemoteException;
     
@@ -46,6 +47,7 @@
     * @return the component handler
     * @exception Exception if an error occurs during component loading or 
establishment
     */
-    ComponentHandler createComponentHandler( ClassLoader anchor, URI uri ) 
throws Exception;
+    ComponentHandler createComponentHandler( 
+      ClassLoader anchor, URI uri ) throws Exception;
 }
 

Modified: trunk/main/metro/model/src/main/net/dpml/metro/ComponentHandler.java
===================================================================
--- trunk/main/metro/model/src/main/net/dpml/metro/ComponentHandler.java      
  2006-02-15 02:38:14 UTC (rev 1095)
+++ trunk/main/metro/model/src/main/net/dpml/metro/ComponentHandler.java      
  2006-02-15 02:54:14 UTC (rev 1096)
@@ -22,7 +22,6 @@
 import java.util.Map;
 
 import net.dpml.part.Component;
-import net.dpml.part.ComponentOperations;
 
 /**
  * Local interface through which a component implementation may 
@@ -40,18 +39,21 @@
     * component instance.
     *
     * @return the context map
+    * @exception RemoteException if a remote I/O error occurs
     */
     Map getContextMap() throws RemoteException;
     
    /**
     * Return the manager for the assigned component model.
     * @return the component model manager
+    * @exception RemoteException if a remote I/O error occurs
     */
     ComponentModelManager getComponentManager() throws RemoteException;
     
    /**
     * Return the internal parts manager.
     * @return the parts manager
+    * @exception RemoteException if a remote I/O error occurs
     */
     PartsManager getPartsManager() throws RemoteException;
 }

Modified: trunk/main/metro/model/src/main/net/dpml/metro/ComponentModel.java
===================================================================
--- trunk/main/metro/model/src/main/net/dpml/metro/ComponentModel.java  
2006-02-15 02:38:14 UTC (rev 1095)
+++ trunk/main/metro/model/src/main/net/dpml/metro/ComponentModel.java  
2006-02-15 02:54:14 UTC (rev 1096)
@@ -107,5 +107,6 @@
     * @return the categories
     * @exception RemoteException if a remote exception occurs
     */
-    CategoryDirective[] getCategoryDirectives() throws  RemoteException;}
+    CategoryDirective[] getCategoryDirectives() throws  RemoteException;
+}
 

Modified: 
trunk/main/metro/model/src/main/net/dpml/metro/ComponentModelManager.java
===================================================================
--- trunk/main/metro/model/src/main/net/dpml/metro/ComponentModelManager.java 
  2006-02-15 02:38:14 UTC (rev 1095)
+++ trunk/main/metro/model/src/main/net/dpml/metro/ComponentModelManager.java 
  2006-02-15 02:54:14 UTC (rev 1096)
@@ -38,12 +38,14 @@
    /**
     * Return the context model manager.
     * @return the context model manager
+    * @exception RemoteException if a remote I/O error occurs
     */
     ContextModelManager getContextManager() throws RemoteException;
     
    /**
     * Return the set of subsidiary component model keys.
     * @return the part keys
+    * @exception RemoteException if a remote I/O error occurs
     */
     String[] getPartKeys() throws RemoteException;
 
@@ -52,19 +54,23 @@
     * @param key the component part key
     * @return the component manager
     * @exception UnknownKeyException if the key is not recognized
+    * @exception RemoteException if a remote I/O error occurs
     * @see #getPartKeys()
     */
-    ComponentModelManager getComponentManager( String key ) throws 
UnknownKeyException, RemoteException;
+    ComponentModelManager getComponentManager( String key ) 
+      throws UnknownKeyException, RemoteException;
 
    /**
     * Set the component activation policy to the supplied value.
     * @param policy the new activation policy
+    * @exception RemoteException if a remote I/O error occurs
     */
     void setActivationPolicy( ActivationPolicy policy ) throws 
RemoteException;
 
    /**
     * Override the assigned collection policy.
     * @param policy the collection policy value
+    * @exception RemoteException if a remote I/O error occurs
     */
     void setCollectionPolicy( CollectionPolicy policy ) throws 
RemoteException;
 }

Modified: 
trunk/main/metro/model/src/main/net/dpml/metro/ContextModelManager.java
===================================================================
--- trunk/main/metro/model/src/main/net/dpml/metro/ContextModelManager.java   
  2006-02-15 02:38:14 UTC (rev 1095)
+++ trunk/main/metro/model/src/main/net/dpml/metro/ContextModelManager.java   
  2006-02-15 02:54:14 UTC (rev 1096)
@@ -27,7 +27,8 @@
 import net.dpml.lang.UnknownKeyException;
 
 /**
- * The ContextModelManager interface exposes a management view of a local 
context model 
+ * The ContextModelManager interface exposes a management view of 
+ * a local context model 
  *
  * @author <a href="@PUBLISHER-URL@">@PUBLISHER-NAME@</a>
  * @version @PROJECT-VERSION@
@@ -39,8 +40,10 @@
     * @param key the context entry key
     * @param directive the context entry directive
     * @exception UnknownKeyException if the key is unknown
+    * @exception RemoteException if a remote I/O error occurs
     */
-    void setEntryDirective( String key, Directive directive ) throws 
UnknownKeyException, RemoteException;
+    void setEntryDirective( String key, Directive directive ) 
+      throws UnknownKeyException, RemoteException;
     
    /**
     * Apply an array of tagged directive as an atomic operation.  
Application of 
@@ -48,9 +51,11 @@
     * 'all-or-nothing' policy.
     *
     * @param directives an array of part references
-    * @exception UnknownKeyException if a key within the array does not 
match a key within
-    *   the context model.
+    * @exception UnknownKeyException if a key within the array does not 
match a 
+    *     key within the context model.
+    * @exception RemoteException if a remote I/O error occurs
     */
-    void setEntryDirectives( PartReference[] directives ) throws 
UnknownKeyException, RemoteException;
+    void setEntryDirectives( PartReference[] directives ) 
+      throws UnknownKeyException, RemoteException;
 
 }

Modified: trunk/main/metro/model/src/main/net/dpml/metro/PartsManager.java
===================================================================
--- trunk/main/metro/model/src/main/net/dpml/metro/PartsManager.java    
2006-02-15 02:38:14 UTC (rev 1095)
+++ trunk/main/metro/model/src/main/net/dpml/metro/PartsManager.java    
2006-02-15 02:54:14 UTC (rev 1096)
@@ -19,7 +19,6 @@
 package net.dpml.metro;
 
 import net.dpml.part.ControlException;
-import net.dpml.part.Service;
 
 import net.dpml.lang.UnknownKeyException;
 

Modified: 
trunk/main/metro/model/src/main/net/dpml/metro/data/ComponentDirective.java
===================================================================
--- 
trunk/main/metro/model/src/main/net/dpml/metro/data/ComponentDirective.java 
2006-02-15 02:38:14 UTC (rev 1095)
+++ 
trunk/main/metro/model/src/main/net/dpml/metro/data/ComponentDirective.java 
2006-02-15 02:54:14 UTC (rev 1096)
@@ -202,6 +202,7 @@
     * @param parameters the default parameters
     * @param config the default configuration
     * @param classloader the component classloader directive
+    * @param parts the component internal parts
     */
     public ComponentDirective(
            final String name,

Modified: 
trunk/main/metro/model/src/main/net/dpml/metro/data/DeploymentDirective.java
===================================================================
--- 
trunk/main/metro/model/src/main/net/dpml/metro/data/DeploymentDirective.java  
      2006-02-15 02:38:14 UTC (rev 1095)
+++ 
trunk/main/metro/model/src/main/net/dpml/metro/data/DeploymentDirective.java  
      2006-02-15 02:54:14 UTC (rev 1096)
@@ -80,6 +80,7 @@
     * @param activation the activation policy
     * @param categories logging category directives
     * @param classloader the classloader directive
+    * @param parts the internal component parts
     */
     public DeploymentDirective( 
       final String name, ActivationPolicy activation, CategoriesDirective 
categories, 

Modified: trunk/main/metro/model/src/main/net/dpml/metro/info/Composite.java
===================================================================
--- trunk/main/metro/model/src/main/net/dpml/metro/info/Composite.java  
2006-02-15 02:38:14 UTC (rev 1095)
+++ trunk/main/metro/model/src/main/net/dpml/metro/info/Composite.java  
2006-02-15 02:54:14 UTC (rev 1096)
@@ -19,25 +19,12 @@
 
 package net.dpml.metro.info;
 
-import java.beans.Encoder;
-import java.beans.XMLEncoder;
-import java.beans.XMLDecoder;
-import java.beans.ExceptionListener;
-import java.beans.Expression;
-import java.beans.DefaultPersistenceDelegate;
 import java.io.Serializable;
-import java.io.InputStream;
-import java.io.OutputStream;
-import java.io.BufferedInputStream;
-import java.io.IOException;
-import java.net.URI;
-import java.net.URL;
 
 import net.dpml.part.Directive;
-import net.dpml.state.State;
 
 /**
- *
+ * Abstract base class for composite entities.
  * @author <a href="@PUBLISHER-URL@">@PUBLISHER-NAME@</a>
  * @version @PROJECT-VERSION@
  */

Modified: trunk/main/metro/model/src/main/net/dpml/metro/info/Type.java
===================================================================
--- trunk/main/metro/model/src/main/net/dpml/metro/info/Type.java       
2006-02-15 02:38:14 UTC (rev 1095)
+++ trunk/main/metro/model/src/main/net/dpml/metro/info/Type.java       
2006-02-15 02:54:14 UTC (rev 1096)
@@ -33,7 +33,6 @@
 import java.net.URI;
 import java.net.URL;
 
-import net.dpml.part.Directive;
 import net.dpml.state.State;
 
 /**

Modified: trunk/main/metro/part/api/src/main/net/dpml/part/Component.java
===================================================================
--- trunk/main/metro/part/api/src/main/net/dpml/part/Component.java     
2006-02-15 02:38:14 UTC (rev 1095)
+++ trunk/main/metro/part/api/src/main/net/dpml/part/Component.java     
2006-02-15 02:54:14 UTC (rev 1096)
@@ -18,7 +18,9 @@
 
 package net.dpml.part;
 
+import java.lang.reflect.InvocationTargetException;
 import java.rmi.Remote;
+import java.rmi.RemoteException;
 
 /**
  * The Component represents a remote interface to a runtime component type.
@@ -26,7 +28,77 @@
  * @author <a href="@PUBLISHER-URL@">@PUBLISHER-NAME@</a>
  * @version @PROJECT-VERSION@
  */
-public interface Component extends Remote, ComponentOperations
+public interface Component extends Remote
 {
+   /**
+    * Return a handler capable of supporting the requested service.
+    * @param service the service descriptor
+    * @return a component matching the requested service
+    * @exception ServiceNotFoundException if no component could found
+    * @exception RemoteException if a remote I/O occurs
+    */
+    Component lookup( Service service ) throws ServiceNotFoundException, 
RemoteException;
+    
+   /**
+    * Return true if this handler is a candidate for the supplied service 
definition.
+    * @param service the service descriptor
+    * @return true if this is a candidate
+    * @exception RemoteException if a remote exception occurs
+    */
+    boolean isaCandidate( Service service ) throws RemoteException;
+    
+   /**
+    * Get the activation policy.  If the activation policy is STARTUP, an 
implementation
+    * a handler shall immidiately activation a runtime instance.  If the 
policy is on DEMAND
+    * an implementation shall defer activiation until an explicit request is 
received.  If 
+    * the policy if SYSTEM activation may occur at the discretion of an 
implementation.
+    *
+    * @return the activation policy
+    * @exception RemoteException if a remote exception occurs
+    * @see ActivationPolicy#SYSTEM
+    * @see ActivationPolicy#STARTUP
+    * @see ActivationPolicy#DEMAND
+    */
+    ActivationPolicy getActivationPolicy() throws RemoteException;
+    
+   /**
+    * Initiate activation of a runtime handler.
+    * @exception ControlException if an activation error occurs
+    * @exception InvocationTargetException if the component declares 
activation on startup
+    *    and a implementation source exception occured
+    * @exception RemoteException if a remote exception occurs
+    */
+    void activate() throws ControlException, InvocationTargetException, 
RemoteException;
+    
+   /**
+    * Returns the active status of the handler.
+    * @return TRUE if the handler has been activated otherwise FALSE
+    * @exception RemoteException if a remote exception occurs
+    */
+    boolean isActive() throws RemoteException;
+    
+   /**
+    * Return the number of instances currently under management.
+    * @return the instance count.
+    * @exception RemoteException if a remote exception occurs
+    */
+    int size() throws RemoteException;
+    
+   /**
+    * Return a reference to a instance of the component handled by the 
handler.
+    * @return the instance holder
+    * @exception InvocationTargetException if the component instantiation 
process 
+    *  is on demand and an target invocation error occurs
+    * @exception ControlException if the component could not be established 
due to a controller 
+    *  related error
+    * @exception RemoteException if a remote exception occurs
+    */
+    Provider getProvider() throws ControlException, 
InvocationTargetException, RemoteException;
+    
+   /**
+    * Deactivate the handler.
+    * @exception RemoteException if a remote exception occurs
+    */
+    void deactivate() throws RemoteException;
 }
 

Deleted: 
trunk/main/metro/part/api/src/main/net/dpml/part/ComponentOperations.java
===================================================================
--- trunk/main/metro/part/api/src/main/net/dpml/part/ComponentOperations.java 
  2006-02-15 02:38:14 UTC (rev 1095)
+++ trunk/main/metro/part/api/src/main/net/dpml/part/ComponentOperations.java 
  2006-02-15 02:54:14 UTC (rev 1096)
@@ -1,104 +0,0 @@
-/*
- * Copyright (c) 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.part;
-
-import java.lang.reflect.InvocationTargetException;
-import java.rmi.RemoteException;
-
-/**
- * The ComponentOperations represents the set of operations shared between 
- * local and remote component users.
- *
- * @author <a href="@PUBLISHER-URL@">@PUBLISHER-NAME@</a>
- * @version @PROJECT-VERSION@
- */
-public interface ComponentOperations
-{
-   /**
-    * Return a handler capable of supporting the requested service.
-    * @param service the service descriptor
-    * @return a component matching the requested service
-    * @exception ServiceNotFoundException if no component could found
-    * @exception RemoteException if a remote I/O occurs
-    */
-    Component lookup( Service service ) throws ServiceNotFoundException, 
RemoteException;
-    
-   /**
-    * Return true if this handler is a candidate for the supplied service 
definition.
-    * @param service the service descriptor
-    * @return true if this is a candidate
-    * @exception RemoteException if a remote exception occurs
-    */
-    boolean isaCandidate( Service service ) throws RemoteException;
-    
-   /**
-    * Get the activation policy.  If the activation policy is STARTUP, an 
implementation
-    * a handler shall immidiately activation a runtime instance.  If the 
policy is on DEMAND
-    * an implementation shall defer activiation until an explicit request is 
received.  If 
-    * the policy if SYSTEM activation may occur at the discretion of an 
implementation.
-    *
-    * @return the activation policy
-    * @exception RemoteException if a remote exception occurs
-    * @see ActivationPolicy#SYSTEM
-    * @see ActivationPolicy#STARTUP
-    * @see ActivationPolicy#DEMAND
-    */
-    ActivationPolicy getActivationPolicy() throws RemoteException;
-    
-   /**
-    * Initiate activation of a runtime handler.
-    * @exception ControlException if an activation error occurs
-    * @exception InvocationTargetException if the component declares 
activation on startup
-    *    and a implementation source exception occured
-    * @exception RemoteException if a remote exception occurs
-    */
-    void activate() throws ControlException, InvocationTargetException, 
RemoteException;
-    
-   /**
-    * Returns the active status of the handler.
-    * @return TRUE if the handler has been activated otherwise FALSE
-    * @exception RemoteException if a remote exception occurs
-    */
-    boolean isActive() throws RemoteException;
-    
-   /**
-    * Return the number of instances currently under management.
-    * @return the instance count.
-    * @exception RemoteException if a remote exception occurs
-    */
-    int size() throws RemoteException;
-    
-   /**
-    * Return a reference to a instance of the component handled by the 
handler.
-    * @return the instance holder
-    * @exception InvocationTargetException if the component instantiation 
process 
-    *  is on demand and an target invocation error occurs
-    * @exception ControlException if the component could not be established 
due to a controller 
-    *  related error
-    * @exception RemoteException if a remote exception occurs
-    */
-    Provider getProvider() throws ControlException, 
InvocationTargetException, RemoteException;
-    
-   /**
-    * Deactivate the handler.
-    * @exception RemoteException if a remote exception occurs
-    */
-    void deactivate() throws RemoteException;
-}
-

Modified: trunk/main/metro/part/api/src/main/net/dpml/part/Provider.java
===================================================================
--- trunk/main/metro/part/api/src/main/net/dpml/part/Provider.java      
2006-02-15 02:38:14 UTC (rev 1095)
+++ trunk/main/metro/part/api/src/main/net/dpml/part/Provider.java      
2006-02-15 02:54:14 UTC (rev 1096)
@@ -19,13 +19,87 @@
 package net.dpml.part;
 
 import java.rmi.Remote;
+import java.rmi.RemoteException;
+import java.lang.reflect.InvocationTargetException;
 
+import net.dpml.state.State;
+import net.dpml.state.StateListener;
+import net.dpml.state.UnknownOperationException;
+import net.dpml.state.UnknownTransitionException;
+
 /**
  * Provider holder.
  *
  * @author <a href="@PUBLISHER-URL@">@PUBLISHER-NAME@</a>
  * @version @PROJECT-VERSION@
  */
-public interface Provider extends Remote, ProviderOperations
+public interface Provider extends Remote
 {
+   /**
+    * Returns the current state of the control.
+    * @return the current runtime state
+    * @exception RemoteException if a remote I/O error occurs
+    */
+    State getState() throws RemoteException;
+    
+   /**
+    * Add a state listener to the control.
+    * @param listener the state listener
+    * @exception RemoteException if a remote I/O error occurs
+    */
+    void addStateListener( StateListener listener ) throws RemoteException;
+
+   /**
+    * Remove a state listener from the control.
+    * @param listener the state listener
+    * @exception RemoteException if a remote I/O error occurs
+    */
+    void removeStateListener( StateListener listener ) throws 
RemoteException;
+    
+   /**
+    * Return the runtime value associated with this instance.
+    * @param isolate if TRUE the value returned is a proxy exposing the 
+    *    service interfaces declared by the component type otherwise 
+    *    the instance value is returned.
+    * @return the value
+    * @exception RemoteException if a remote I/O error occurs
+    */
+    Object getValue( boolean isolate ) throws RemoteException;
+    
+   /**
+    * Apply a transition to the instance.
+    * @param key the transition name
+    * @return the state established as a result of applying the transition
+    * @exception UnknownTransitionException if the supplied key does not map 
to an available transition
+    * @exception InvocationTargetException if an invocation error occurs
+    * @exception RemoteException if a remote I/O error occurs
+    */
+    State apply( String key ) 
+      throws UnknownTransitionException, InvocationTargetException, 
RemoteException;
+    
+   /**
+    * Invoke an operation on the instance.
+    * @param name the operation name
+    * @param args operation arguments
+    * @return the result of the operation invocation
+    * @exception UnknownOperationException if the supplied key does not map 
to an available operation
+    * @exception InvocationTargetException if an invocation error occurs
+    * @exception RemoteException if a remote I/O error occurs
+    */
+    Object exec( String name, Object[] args ) 
+      throws UnknownOperationException, InvocationTargetException, 
RemoteException;
+    
+   /**
+    * Invoke an operation on the instance.
+    * @param method the operation name
+    * @param args operation arguments
+    * @return the result of the operation invocation
+    * @exception UnknownOperationException if the supplied key does not map 
to an available operation
+    * @exception InvocationTargetException if an invocation error occurs
+    * @exception IllegalStateException if the component state does not 
expose the operation
+    * @exception RemoteException if a remote I/O error occurs
+    */
+    Object invoke( String method, Object[] args ) 
+      throws UnknownOperationException, InvocationTargetException, 
+      IllegalStateException, RemoteException;
 }

Deleted: 
trunk/main/metro/part/api/src/main/net/dpml/part/ProviderOperations.java
===================================================================
--- trunk/main/metro/part/api/src/main/net/dpml/part/ProviderOperations.java  
  2006-02-15 02:38:14 UTC (rev 1095)
+++ trunk/main/metro/part/api/src/main/net/dpml/part/ProviderOperations.java  
  2006-02-15 02:54:14 UTC (rev 1096)
@@ -1,108 +0,0 @@
-/*
- * Copyright 2004 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.part;
-
-import java.rmi.RemoteException;
-import java.lang.reflect.InvocationTargetException;
-
-import net.dpml.state.State;
-import net.dpml.state.StateListener;
-import net.dpml.state.UnknownOperationException;
-import net.dpml.state.UnknownTransitionException;
-
-/**
- * ProviderOperations interface defines the set of operations 
- * common between local and remote provider consumers.
- *
- * @author <a href="@PUBLISHER-URL@">@PUBLISHER-NAME@</a>
- * @version @PROJECT-VERSION@
- */
-public interface ProviderOperations
-{
-    //-------------------------------------------------------------------
-    // implementation
-    //-------------------------------------------------------------------
-
-   /**
-    * Returns the current state of the control.
-    * @return the current runtime state
-    * @exception RemoteException if a remote I/O error occurs
-    */
-    State getState() throws RemoteException;
-    
-   /**
-    * Add a state listener to the control.
-    * @param listener the state listener
-    * @exception RemoteException if a remote I/O error occurs
-    */
-    void addStateListener( StateListener listener ) throws RemoteException;
-
-   /**
-    * Remove a state listener from the control.
-    * @param listener the state listener
-    * @exception RemoteException if a remote I/O error occurs
-    */
-    void removeStateListener( StateListener listener ) throws 
RemoteException;
-    
-   /**
-    * Return the runtime value associated with this instance.
-    * @param isolate if TRUE the value returned is a proxy exposing the 
-    *    service interfaces declared by the component type otherwise 
-    *    the instance value is returned.
-    * @return the value
-    * @exception RemoteException if a remote I/O error occurs
-    */
-    Object getValue( boolean isolate ) throws RemoteException;
-    
-   /**
-    * Apply a transition to the instance.
-    * @param key the transition name
-    * @return the state established as a result of applying the transition
-    * @exception UnknownTransitionException if the supplied key does not map 
to an available transition
-    * @exception InvocationTargetException if an invocation error occurs
-    * @exception RemoteException if a remote I/O error occurs
-    */
-    State apply( String key ) 
-      throws UnknownTransitionException, InvocationTargetException, 
RemoteException;
-    
-   /**
-    * Invoke an operation on the instance.
-    * @param name the operation name
-    * @param args operation arguments
-    * @return the result of the operation invocation
-    * @exception UnknownOperationException if the supplied key does not map 
to an available operation
-    * @exception InvocationTargetException if an invocation error occurs
-    * @exception RemoteException if a remote I/O error occurs
-    */
-    Object exec( String name, Object[] args ) 
-      throws UnknownOperationException, InvocationTargetException, 
RemoteException;
-    
-   /**
-    * Invoke an operation on the instance.
-    * @param method the operation name
-    * @param args operation arguments
-    * @return the result of the operation invocation
-    * @exception UnknownOperationException if the supplied key does not map 
to an available operation
-    * @exception InvocationTargetException if an invocation error occurs
-    * @exception RemoteException if a remote I/O error occurs
-    */
-    Object invoke( String method, Object[] args ) 
-      throws UnknownOperationException, InvocationTargetException, 
IllegalStateException, RemoteException;
-    
-}