svn commit: r517795 - in /incubator/tuscany/java/sca/kernel: core/src/main/java/org/apache/tuscany/core/implementation/java/JavaPhysicalComponentBuilder.java spi/src/main/java/org/apache/tuscany/spi/builder/physical/WireAttacher.java

[jm...@apache.org]

Author: jmarino
Date: Tue Mar 13 11:01:19 2007
New Revision: 517795

URL: http://svn.apache.org/viewvc?view=rev&rev=517795
Log:
javadoc additions

Modified:
    incubator/tuscany/java/sca/kernel/core/src/main/java/org/apache/tuscany/core/implementation/java/JavaPhysicalComponentBuilder.java
    incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/builder/physical/WireAttacher.java

Modified: incubator/tuscany/java/sca/kernel/core/src/main/java/org/apache/tuscany/core/implementation/java/JavaPhysicalComponentBuilder.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/kernel/core/src/main/java/org/apache/tuscany/core/implementation/java/JavaPhysicalComponentBuilder.java?view=diff&rev=517795&r1=517794&r2=517795
==============================================================================
--- incubator/tuscany/java/sca/kernel/core/src/main/java/org/apache/tuscany/core/implementation/java/JavaPhysicalComponentBuilder.java (original)
+++ incubator/tuscany/java/sca/kernel/core/src/main/java/org/apache/tuscany/core/implementation/java/JavaPhysicalComponentBuilder.java Tue Mar 13 11:01:19 2007
@@ -45,7 +45,8 @@
 import org.apache.tuscany.core.model.physical.java.JavaPhysicalWireTargetDefinition;
 
 /**
- * Java physical component builder.
+ * The physical component builder for Java implementation types. Responsible for creating the Component runtime artifact
+ * from a physical component definition
  *
  * @version $Rev$ $Date$
  * @param <T> the implementation class for the defined component

Modified: incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/builder/physical/WireAttacher.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/builder/physical/WireAttacher.java?view=diff&rev=517795&r1=517794&r2=517795
==============================================================================
--- incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/builder/physical/WireAttacher.java (original)
+++ incubator/tuscany/java/sca/kernel/spi/src/main/java/org/apache/tuscany/spi/builder/physical/WireAttacher.java Tue Mar 13 11:01:19 2007
@@ -26,7 +26,8 @@
 import org.apache.tuscany.spi.wire.Wire;
 
 /**
- * Abstraction for the wire attacher.
+ * Responsible for attaching a wire to a source and target component. The mechanism for perforing the attach is specific
+ * to the component implementation type.
  *
  * @version $Date$ $Revision$
  */
@@ -35,21 +36,23 @@
     PWTD extends PhysicalWireTargetDefinition> {
 
     /**
-     * Attaches the source to the component.
+     * Attaches a wire to a source component.
      *
-     * @param component Component.
-     * @param wire
-     * @param source    Source.
+     * @param component  the component.
+     * @param wire       the wire
+     * @param definition metadata for performing the attach.
+     * @throws WiringException if an exception occurs during the attach operation
      */
-    void attach(C component, Wire wire, PWSD source) throws WiringException;
+    void attach(C component, Wire wire, PWSD definition) throws WiringException;
 
     /**
-     * Attaches the target to the component.
+     * Attaches a wire to a target component.
      *
-     * @param component Component.
-     * @param wire
-     * @param target    Target.
+     * @param component  the component.
+     * @param wire       the wire
+     * @param definition metadata for performing the attach.
+     * @throws WiringException if an exception occurs during the attach operation
      */
-    void attach(C component, Wire wire, PWTD target) throws WiringException;
+    void attach(C component, Wire wire, PWTD definition) throws WiringException;
 
 }



---------------------------------------------------------------------
To unsubscribe, e-mail: tuscany-commits-unsubscribe@ws.apache.org
For additional commands, e-mail: tuscany-commits-help@ws.apache.org