Author: jkaputin
Date: Sun Sep 11 16:25:40 2005
New Revision: 280211
URL: http://svn.apache.org/viewcvs?rev=280211&view=rev
Log:
Changed the name 'DescriptionComponent' to
'DescriptionImpl' to more accurately reflect that this
class implements the Description interface.
Also updated the Javadoc comments to differentiate a
Description component and a <description> element and
the need for separate implementations of both.
Added:
incubator/woden/java/src/org/apache/woden/internal/wsdl20/DescriptionImpl.java
- copied, changed from r208642,
incubator/woden/java/src/org/apache/woden/internal/wsdl20/DescriptionComponent.java
Removed:
incubator/woden/java/src/org/apache/woden/internal/wsdl20/DescriptionComponent.java
Modified:
incubator/woden/java/src/org/apache/woden/wsdl20/Description.java
Copied:
incubator/woden/java/src/org/apache/woden/internal/wsdl20/DescriptionImpl.java
(from r208642,
incubator/woden/java/src/org/apache/woden/internal/wsdl20/DescriptionComponent.java)
URL:
http://svn.apache.org/viewcvs/incubator/woden/java/src/org/apache/woden/internal/wsdl20/DescriptionImpl.java?p2=incubator/woden/java/src/org/apache/woden/internal/wsdl20/DescriptionImpl.java&p1=incubator/woden/java/src/org/apache/woden/internal/wsdl20/DescriptionComponent.java&r1=208642&r2=280211&rev=280211&view=diff
==============================================================================
---
incubator/woden/java/src/org/apache/woden/internal/wsdl20/DescriptionComponent.java
(original)
+++
incubator/woden/java/src/org/apache/woden/internal/wsdl20/DescriptionImpl.java
Sun Sep 11 16:25:40 2005
@@ -12,15 +12,22 @@
import org.apache.woden.wsdl20.TypeDefinition;
/**
- * This class implements the Description component from the WSDL Component
- * Model, as described in the WSDL 2.0 specification. It presents an abstract
- * view of a WSDL document. That is, a 'flattened' view of the WSDL that
ignores
- * any underlying XML document composition imposed by <import> or <include>
- * elements and elimates the need to 'walk' the XML tree to access the WSDL
content.
+ * This class provides the implementation for a Description component from
+ * the WSDL Component Model, as described in the WSDL 2.0 specification.
+ * <p>
+ * Note: this class is different to the other WSDL implementation classes,
+ * which all implement two Java interfaces; a component model interface and
the
+ * interface for the corresponding WSDL element. Different implementations
+ * are used for the Description component and for the <wsdl:description>
+ * element because the latter exposes the composite structure of imported and
+ * included WSDL documents, while the Description component 'flattens' this
+ * structure into an abstract view of the WSDL. A separate implementation
+ * class, <code>DescriptionElementImpl</code>, exists to represent
+ * the <wsdl:description> element.
*
* @author [EMAIL PROTECTED]
*/
-public class DescriptionComponent implements Description {
+public class DescriptionImpl implements Description {
/* (non-Javadoc)
* @see org.apache.woden.wsdl20.Description#getInterfaces()
Modified: incubator/woden/java/src/org/apache/woden/wsdl20/Description.java
URL:
http://svn.apache.org/viewcvs/incubator/woden/java/src/org/apache/woden/wsdl20/Description.java?rev=280211&r1=280210&r2=280211&view=diff
==============================================================================
--- incubator/woden/java/src/org/apache/woden/wsdl20/Description.java (original)
+++ incubator/woden/java/src/org/apache/woden/wsdl20/Description.java Sun Sep
11 16:25:40 2005
@@ -6,10 +6,15 @@
/**
* This interface represents the Description component from the WSDL Component
- * Model, as described in the WSDL 2.0 specification. It declares an abstract
- * view of a WSDL document. That is, a 'flattened' view of the WSDL that
ignores
- * any underlying XML document composition imposed by <import> or <include>
- * elements and elimates the need to 'walk' the XML tree to access the WSDL
content.
+ * Model, as described in the WSDL 2.0 specification. It provides an abstract
+ * view of a WSDL document by flattening the composite document structure
created
+ * by the use of <wsdl:import> or <wsdl:include> into a single
top-level
+ * WSDL Description containing all of the inlined, imported or included WSDL
content.
+ * In doing so, it elimates the need to 'walk' the XML tree to access the WSDL
content.
+ * This also means that a Description component may not correspond 1-to-1
+ * to a lt;wsdl:description> element in XML (i.e. it may contain WSDL
content
+ * from composite WSDL documents, each with its own <wsdl:description>.
root
+ * element).
*
* @author [EMAIL PROTECTED]
*/
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]