Skip to Content.
Sympa Menu

notify-dpml - r1096 - in trunk/main: depot/tools/builder/src/main/net/dpml/tools/tasks metro/model/src/main/net/dpml/metro metro/model/src/main/net/dpml/metro/data metro/model/src/main/net/dpml/metro/info metro/part/api/src/main/net/dpml/part

notify-dpml AT lists.ibiblio.org

Subject: DPML Notify

List archive

Chronological Thread  
  • From: mcconnell at BerliOS <mcconnell AT mail.berlios.de>
  • To: notify-dpml AT lists.ibiblio.org
  • Subject: r1096 - in trunk/main: depot/tools/builder/src/main/net/dpml/tools/tasks metro/model/src/main/net/dpml/metro metro/model/src/main/net/dpml/metro/data metro/model/src/main/net/dpml/metro/info metro/part/api/src/main/net/dpml/part
  • Date: Wed, 15 Feb 2006 03:56:23 +0100

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;
-
-}




  • r1096 - in trunk/main: depot/tools/builder/src/main/net/dpml/tools/tasks metro/model/src/main/net/dpml/metro metro/model/src/main/net/dpml/metro/data metro/model/src/main/net/dpml/metro/info metro/part/api/src/main/net/dpml/part, mcconnell at BerliOS, 02/14/2006

Archive powered by MHonArc 2.6.24.

Top of Page