You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tuscany.apache.org by jm...@apache.org on 2007/03/04 22:25:05 UTC
svn commit: r514477 - in
/incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi:
databinding/ deployer/ implementation/java/ model/ model/physical/
services/discovery/ wire/
Author: jmarino
Date: Sun Mar 4 13:25:04 2007
New Revision: 514477
URL: http://svn.apache.org/viewvc?view=rev&rev=514477
Log:
cleanup Javadoc
Modified:
incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/DataBinding.java
incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/DataPipe.java
incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/TransformationContext.java
incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/TransformerRegistry.java
incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/deployer/ContentTypeDescriber.java
incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/deployer/DeploymentContext.java
incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/implementation/java/ImplementationProcessorService.java
incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/DeployedArtifact.java
incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/Operation.java
incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/physical/PhysicalChangeSet.java
incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/physical/PhysicalOperationDefinition.java
incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/services/discovery/DiscoveryException.java
incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/services/discovery/ResponseListener.java
incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/wire/InvocationChain.java
incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/wire/TargetInvoker.java
Modified: incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/DataBinding.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/DataBinding.java?view=diff&rev=514477&r1=514476&r2=514477
==============================================================================
--- incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/DataBinding.java (original)
+++ incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/DataBinding.java Sun Mar 4 13:25:04 2007
@@ -27,14 +27,14 @@
public interface DataBinding {
/**
* The name of a databinding should be case-insensitive and unique
- *
+ *
* @return The name of the databinding
*/
String getName();
/**
* Introspect a java class or interface to create a DataType model
- *
+ *
* @param javaType The java class or interface to be introspected
* @return The DataType or null if the java type is not supported by this databinding
*/
@@ -42,7 +42,7 @@
/**
* Introspect the data to figure out the corresponding data type
- *
+ *
* @param value The object to be checked
* @return The DataType or null if the java type is not supported by this databinding
*/
@@ -50,19 +50,22 @@
/**
* Provide a WrapperHandler for this databinding
+ *
* @return A wrapper handler which can handle wrapping/wrapping for this databinding
*/
WrapperHandler getWrapperHandler();
/**
* Make a copy of the object for "pass-by-value" semantics
- * @param source object to copy
+ *
+ * @param object object to copy
* @return copy of the object passed in as argument
*/
Object copy(Object object);
-
+
/**
* Get the type mapper for simple types
+ *
* @return The databinding-specific simple type mapper
*/
SimpleTypeMapper getSimpleTypeMapper();
Modified: incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/DataPipe.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/DataPipe.java?view=diff&rev=514477&r1=514476&r2=514477
==============================================================================
--- incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/DataPipe.java (original)
+++ incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/DataPipe.java Sun Mar 4 13:25:04 2007
@@ -20,7 +20,7 @@
/**
* Data pipe allows a data source pushes data into its sink and pipe the data into its result
- *
+ *
* @param <S> The data binding type of the sink
* @param <R> The data binding type of the result
*/
@@ -29,15 +29,15 @@
/**
* Returns a sink (for example, java.io.OutputStream, java.io.Writer or org.xml.sax.ContentHandler) to receive data
* pushed by the source
- *
+ *
* @return The sink to consume data
*/
S getSink();
/**
* Returns the data populated by the sink
- *
- * @return
+ *
+ * @return R the result
*/
R getResult();
Modified: incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/TransformationContext.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/TransformationContext.java?view=diff&rev=514477&r1=514476&r2=514477
==============================================================================
--- incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/TransformationContext.java (original)
+++ incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/TransformationContext.java Sun Mar 4 13:25:04 2007
@@ -24,48 +24,47 @@
/**
* Context for data transformation
- *
*/
public interface TransformationContext {
/**
* Get the source data type
- *
- * @return
+ *
+ * @return the source data type
*/
DataType getSourceDataType();
/**
* Get the target data type
- *
- * @return
+ *
+ * @return the target datatype
*/
DataType getTargetDataType();
/**
* Set the source data type
- *
- * @param sourceDataType
+ *
+ * @param sourceDataType the source data type
*/
void setSourceDataType(DataType sourceDataType);
/**
* Set the target data type
- *
- * @param targetDataType
+ *
+ * @param targetDataType the target data type
*/
void setTargetDataType(DataType targetDataType);
/**
* Get the classloader
- *
- * @return
+ *
+ * @return the classloader
*/
ClassLoader getClassLoader();
/**
* Get a map of metadata
- *
- * @return
+ *
+ * @return the map of metadata
*/
Map<Class<?>, Object> getMetadata();
Modified: incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/TransformerRegistry.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/TransformerRegistry.java?view=diff&rev=514477&r1=514476&r2=514477
==============================================================================
--- incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/TransformerRegistry.java (original)
+++ incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/databinding/TransformerRegistry.java Sun Mar 4 13:25:04 2007
@@ -26,7 +26,7 @@
public interface TransformerRegistry {
/**
* Register a transformer
- *
+ *
* @param sourceDataBinding
* @param targetDataBinding
* @param weight
@@ -39,37 +39,35 @@
/**
* Register a transformer
- *
+ *
* @param transformer
*/
void registerTransformer(Transformer transformer);
/**
* Unregister a transformer
- *
+ *
* @param sourceDataBinding
* @param targetDataBinding
- * @return
+ * @return true if sucessfully unregistered
*/
boolean unregisterTransformer(String sourceDataBinding, String targetDataBinding);
/**
- * Get the direct Transformer which can transform data from source type to
- * result type
- *
+ * Get the direct Transformer which can transform data from source type to result type
+ *
* @param sourceDataBinding
* @param targetDataBinding
- * @return
+ * @return the transformer
*/
Transformer getTransformer(String sourceDataBinding, String targetDataBinding);
/**
- * Get the a chain of Transformers which can transform data from source type
- * to result type
- *
+ * Get the a chain of Transformers which can transform data from source type to result type
+ *
* @param sourceDataBinding
* @param targetDataBinding
- * @return
+ * @return the list of transformers
*/
List<Transformer> getTransformerChain(String sourceDataBinding, String targetDataBinding);
}
Modified: incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/deployer/ContentTypeDescriber.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/deployer/ContentTypeDescriber.java?view=diff&rev=514477&r1=514476&r2=514477
==============================================================================
--- incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/deployer/ContentTypeDescriber.java (original)
+++ incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/deployer/ContentTypeDescriber.java Sun Mar 4 13:25:04 2007
@@ -23,14 +23,14 @@
/**
* Provide content type for a given resource
- *
+ *
* @version $Rev$ $Date$
*/
-public interface ContentTypeDescriber {
+public interface ContentTypeDescriber {
/**
- * @param resourceURL
- * @param defaultContentType
- * @return
+ * @param resourceURL the resource url
+ * @param defaultContentType the default content type
+ * @return the content type
*/
String getContentType(URL resourceURL, String defaultContentType);
}
Modified: incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/deployer/DeploymentContext.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/deployer/DeploymentContext.java?view=diff&rev=514477&r1=514476&r2=514477
==============================================================================
--- incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/deployer/DeploymentContext.java (original)
+++ incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/deployer/DeploymentContext.java Sun Mar 4 13:25:04 2007
@@ -85,7 +85,7 @@
/**
* Sets if the autowire is enabled for the current deployment.
*
- * @return true Sets if the autowire is enabled for the current deployment
+ * @param autowire true if autowire is enabled
*/
void setAutowire(boolean autowire);
Modified: incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/implementation/java/ImplementationProcessorService.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/implementation/java/ImplementationProcessorService.java?view=diff&rev=514477&r1=514476&r2=514477
==============================================================================
--- incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/implementation/java/ImplementationProcessorService.java (original)
+++ incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/implementation/java/ImplementationProcessorService.java Sun Mar 4 13:25:04 2007
@@ -84,7 +84,8 @@
List<String> injectionNames) throws ProcessingException;
/**
- * Returns true if {@link @Autowire}, {@link @Property}, or {@link @Reference} are present in the given array
+ * Returns true if <code>@Property</code> or <code>@Reference</code> are present in the given array
+ * @return true if one of the annotations are present
*/
boolean injectionAnnotationsPresent(Annotation[][] annots);
Modified: incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/DeployedArtifact.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/DeployedArtifact.java?view=diff&rev=514477&r1=514476&r2=514477
==============================================================================
--- incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/DeployedArtifact.java (original)
+++ incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/DeployedArtifact.java Sun Mar 4 13:25:04 2007
@@ -26,7 +26,7 @@
/**
* Representation of a deployed artifact
- *
+ *
* @version $Rev$ $Date$
*/
public class DeployedArtifact extends ModelObject {
@@ -34,14 +34,14 @@
protected final URI uri;
protected URL location;
/**
- * The map keeps all the model objects loaded/introspected from this artifact. The objects
- * are keyed by the java type of the model such as javax.wsdl.ModelObject. The value is also
- * a map with namespace as the key and the model object as the value.
+ * The map keeps all the model objects loaded/introspected from this artifact. The objects are keyed by the java
+ * type of the model such as javax.wsdl.ModelObject. The value is also a map with namespace as the key and the model
+ * object as the value.
*/
protected Map<Class, Map<String, Object>> modelObjects = new HashMap<Class, Map<String, Object>>();
/**
- * @param uri
+ * @param uri the artifact uri
*/
public DeployedArtifact(URI uri) {
super();
@@ -58,7 +58,8 @@
/**
* Get the absolute URI as the unique id for the artifact
- * @return
+ *
+ * @return the uri for the artifact
*/
public URI getUri() {
return uri;
Modified: incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/Operation.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/Operation.java?view=diff&rev=514477&r1=514476&r2=514477
==============================================================================
--- incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/Operation.java (original)
+++ incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/Operation.java Sun Mar 4 13:25:04 2007
@@ -72,8 +72,8 @@
* @param faultTypes the data type of faults raised by the operation
* @param nonBlocking if the operation is non-blocking
* @param dataBinding the data-binding type required by the operation
- * @param sequence the conversational attributes of the operation, {@link NO_CONVERSATION}, {@link
- * CONVERSATION_CONTINUE}, or {@link CONVERSATION_END}
+ * @param sequence the conversational attributes of the operation {@link #CONVERSATION_CONTINUE}, or {@link
+ * #CONVERSATION_END}
*/
public Operation(final String name,
final DataType<List<DataType<T>>> inputType,
@@ -197,8 +197,8 @@
}
/**
- * Returns the sequence the operation is called in a conversation, {@link NO_CONVERSATION}, {@link
- * CONVERSATION_CONTINUE}, or {@link CONVERSATION_END}
+ * Returns the sequence the operation is called in a conversation, {@link #CONVERSATION_CONTINUE}, or {@link
+ * #CONVERSATION_END}
*
* @return the sequence the operation is called in a conversation
*/
@@ -207,8 +207,8 @@
}
/**
- * Sets the sequence the operation is called in a conversation, {@link NO_CONVERSATION}, {@link
- * CONVERSATION_CONTINUE}, or {@link CONVERSATION_END}
+ * Sets the sequence the operation is called in a conversation, {@link #CONVERSATION_CONTINUE}, or {@link
+ * #CONVERSATION_END}
*/
public void setConversationSequence(int conversationSequence) {
this.conversationSequence = conversationSequence;
Modified: incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/physical/PhysicalChangeSet.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/physical/PhysicalChangeSet.java?view=diff&rev=514477&r1=514476&r2=514477
==============================================================================
--- incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/physical/PhysicalChangeSet.java (original)
+++ incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/physical/PhysicalChangeSet.java Sun Mar 4 13:25:04 2007
@@ -56,7 +56,7 @@
/**
* Adds a physical component definition to the physical change set.
- * @param physicalComponentDefinition Physical component definition.
+ * @param componentDefinition Physical component definition.
*/
public void addComponentDefinition(PhysicalComponentDefinition componentDefinition) {
componentDefinitions.add(componentDefinition);
Modified: incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/physical/PhysicalOperationDefinition.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/physical/PhysicalOperationDefinition.java?view=diff&rev=514477&r1=514476&r2=514477
==============================================================================
--- incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/physical/PhysicalOperationDefinition.java (original)
+++ incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/model/physical/PhysicalOperationDefinition.java Sun Mar 4 13:25:04 2007
@@ -28,55 +28,58 @@
/**
* Represents an operation.
- *
- * @version $Revision$ $Date$
- *
- * TODO Discuss with Jeremy/Jim on how to model MEPs, INOUT parameters, faults etc
*
+ * @version $Revision$ $Date$
+ * <p/>
+ * TODO Discuss with Jeremy/Jim on how to model MEPs, INOUT parameters, faults etc
*/
public class PhysicalOperationDefinition extends ModelObject {
-
+
// Parameters
private List<Class<?>> parameterTypes = new LinkedList<Class<?>>();
-
+
// Return
private Class<?> returnType;
-
+
// Name of the operation
private String name;
-
+
// Callback
private boolean callback;
-
+
// Interceptors defined against the operation
private Set<PhysicalInterceptorDefinition> interceptors = new HashSet<PhysicalInterceptorDefinition>();
-
+
/**
* Returns the parameter types for this operation.
+ *
* @return Parameter types.
*/
public List<Class<?>> getParameters() {
return Collections.unmodifiableList(parameterTypes);
}
-
+
/**
* Adds a parameter type.
+ *
* @param parameter Parameter type to be added.
*/
public void addParameter(Class<?> parameter) {
parameterTypes.add(parameter);
}
-
+
/**
* Gets the return type for this operation.
+ *
* @return Return type for this operation.
*/
public Class<?> getReturnType() {
return returnType;
}
-
+
/**
* Sets the return type for this operation.
+ *
* @param returnType Return type for this operation.
*/
public void setReturnType(Class<?> returnType) {
@@ -85,6 +88,7 @@
/**
* Returns the interceptor definitions available for this operation.
+ *
* @return Inteceptor definitions for this operation.
*/
public Set<PhysicalInterceptorDefinition> getInterceptors() {
@@ -93,7 +97,8 @@
/**
* Adds an interceptor definition to the operation.
- * @param interceptors Interceptor definition to be added.
+ *
+ * @param interceptor Interceptor definition to be added.
*/
public void addInterceptor(PhysicalInterceptorDefinition interceptor) {
interceptors.add(interceptor);
@@ -101,6 +106,7 @@
/**
* Gets the name of the operation.
+ *
* @return Operation name.
*/
public String getName() {
@@ -109,6 +115,7 @@
/**
* Sets the name of the operation.
+ *
* @param name Operation name.
*/
public void setName(String name) {
@@ -117,6 +124,7 @@
/**
* Checks whether the operation is a callback.
+ *
* @return True if this is a callback.
*/
public boolean isCallback() {
@@ -125,11 +133,12 @@
/**
* Sets whether this is a callback operation or not.
+ *
* @param callback True if this is a callback.
*/
public void setCallback(boolean callback) {
this.callback = callback;
}
-
+
}
Modified: incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/services/discovery/DiscoveryException.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/services/discovery/DiscoveryException.java?view=diff&rev=514477&r1=514476&r2=514477
==============================================================================
--- incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/services/discovery/DiscoveryException.java (original)
+++ incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/services/discovery/DiscoveryException.java Sun Mar 4 13:25:04 2007
@@ -22,15 +22,15 @@
/**
* Checked exception thrown during discovery operations.
- *
- * @version $Revision$ $Date$
*
+ * @version $Revision$ $Date$
*/
@SuppressWarnings("serial")
public class DiscoveryException extends TuscanyException {
/**
* Initialises the exception message.
+ *
* @param message Message for the exception.
*/
public DiscoveryException(String message) {
@@ -39,7 +39,8 @@
/**
* Initialises the exception root cause.
- * @param message Root cause for the exception.
+ *
+ * @param cause Root cause for the exception.
*/
public DiscoveryException(Throwable cause) {
super(cause);
Modified: incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/services/discovery/ResponseListener.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/services/discovery/ResponseListener.java?view=diff&rev=514477&r1=514476&r2=514477
==============================================================================
--- incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/services/discovery/ResponseListener.java (original)
+++ incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/services/discovery/ResponseListener.java Sun Mar 4 13:25:04 2007
@@ -21,19 +21,18 @@
import javax.xml.stream.XMLStreamReader;
/**
- * Message listener for propogating callbacks. Response listeners handle
- * async meesages that are received in response to a request message that was
- * originally sent.
- *
- * @version $Revision$ $Date$
+ * Message listener for propogating callbacks. Response listeners handle async meesages that are received in response to
+ * a request message that was originally sent.
*
+ * @version $Revision$ $Date$
*/
public interface ResponseListener {
-
+
/**
* Callback for propogating async messages.
- * @param content Message content.
- * @param An optional message id if this was in response to a message that was sent.
+ *
+ * @param content Message content.
+ * @param messageId optional message id if this was in response to a message that was sent.
*/
void onResponse(XMLStreamReader content, int messageId);
Modified: incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/wire/InvocationChain.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/wire/InvocationChain.java?view=diff&rev=514477&r1=514476&r2=514477
==============================================================================
--- incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/wire/InvocationChain.java (original)
+++ incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/wire/InvocationChain.java Sun Mar 4 13:25:04 2007
@@ -23,13 +23,13 @@
/**
* A wire consists of 1..n invocation chains associated with the operations of its source service contract.
* <p/>
- * Invocation chains may contain {@link Interceptor}s that process invocations in an around-style manner. Invocation
- * chains are also associated with a {@TargetInvoker} which is responsible for dispatching on the target service
- * provider.
+ * Invocation chains may contain </ode>Interceptors</code> that process invocations in an around-style manner.
+ * Invocation chains are also associated with a <code>TargetInvoker</code> which is responsible for dispatching on the
+ * target service provider.
* <p/>
- * A {@link Message} is used to pass data associated with an invocation through the chain. The TargetInvoker is passed
- * with the Message through the interceptor stack, if one is present. At last interceptor in the stack, must call the
- * TargetInvoker.
+ * A <code>Message</code> is used to pass data associated with an invocation through the chain. The TargetInvoker is
+ * passed with the Message through the interceptor stack, if one is present. At last interceptor in the stack, must call
+ * the TargetInvoker.
* <p/>
* In certain circumstances, the TargetInvoker may be cached in the source-side proxy. Caching allows various
* optimizations such as avoiding target instance resolution when the client-side lifecycle scope is a shorter duration
Modified: incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/wire/TargetInvoker.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/wire/TargetInvoker.java?view=diff&rev=514477&r1=514476&r2=514477
==============================================================================
--- incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/wire/TargetInvoker.java (original)
+++ incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/wire/TargetInvoker.java Sun Mar 4 13:25:04 2007
@@ -41,9 +41,9 @@
* flowed such as in non-proxied wires.
*
* @param payload the invocation payload, typically an array of parameters
- * @param sequence if the invocation is part of a conversation, the sequence. Valid values are {@link NONE} for
- * non-conversational, {@link START} to begin a conversation, {@link CONTINUE} to continue a
- * conversation, or {@link END} to end a conversation
+ * @param sequence if the invocation is part of a conversation, the sequence. Valid values are {@link #NONE} for
+ * non-conversational, {@link #START} to begin a conversation, {@link #CONTINUE} to continue a
+ * conversation, or {@link #END} to end a conversation
* @throws InvocationTargetException
*/
Object invokeTarget(final Object payload, final short sequence) throws InvocationTargetException;
---------------------------------------------------------------------
To unsubscribe, e-mail: tuscany-commits-unsubscribe@ws.apache.org
For additional commands, e-mail: tuscany-commits-help@ws.apache.org