[Jboss-cvs] JBossAS SVN: r55458 - trunk/ejb3/src/main/javax/jws

[jboss-cvs-commits at lists.jboss.org]

Author: thomas.diesler at jboss.com
Date: 2006-08-09 18:04:07 -0400 (Wed, 09 Aug 2006)
New Revision: 55458

Modified:
   trunk/ejb3/src/main/javax/jws/WebService.java
Log:
Update to jsr181 2.0

Modified: trunk/ejb3/src/main/javax/jws/WebService.java
===================================================================
--- trunk/ejb3/src/main/javax/jws/WebService.java	2006-08-09 19:59:23 UTC (rev 55457)
+++ trunk/ejb3/src/main/javax/jws/WebService.java	2006-08-09 22:04:07 UTC (rev 55458)
@@ -40,45 +40,73 @@
 {
 
    /**
-    * The name of the Web Service.  Used as the name of the wsdl:portType when mapped to WSDL 1.1.
-    * Defaults to the simple name of the Java class or interface
+    * The name of the Web Service.
+    * Used as the name of the wsdl:portType when mapped to WSDL 1.1.
+    * Specification Default:
+    *   The simple name of the Java class or interface. 
     */
    String name() default "";
 
    /**
-    * The XML namespace used for the WSDL and XML elements generated from this Web Service.
+    * The port name of the Web Service.
+    * Used as the name of the wsdl:port when mapped to WSDL 1.1.
+    * This member-value is not allowed on endpoint interfaces.
+    * Specification Default:
+    *   @WebService.name + ”Port”. 
     */
+   String portName() default "";
+
+   /**
+    * If the @WebService.targetNamespace annotation is on a service endpoint interface, the targetNamespace is used for the 
+    * namespace for the wsdl:portType (and associated XML elements).
+    * 
+    * If the @WebService.targetNamespace annotation is on a service implementation bean that does NOT reference a service 
+    * endpoint interface (through the endpointInterface attribute), the targetNamespace is used for both the wsdl:portType 
+    * and the wsdl:service (and associated XML elements).
+    * 
+    * If the @WebService.targetNamespace annotation is on a service implementation bean that does reference a service 
+    * endpoint interface (through the endpointInterface attribute), the targetNamespace is used for only the wsdl:service 
+    * (and associated XML elements). 
+    */
    String targetNamespace() default "";
 
    /**
-    * The service name of the Web Service.  Used as the name of the wsdl:service when mapped to WSDL 1.1.
-    * Not allowed on interfaces.  Defaults to the simple name of the Java class + “Service".
+    * The service name of the Web Service.
+    * 
+    * Used as the name of the wsdl:service when mapped to WSDL 1.1.
+    * 
+    * This member-value is not allowed on endpoint interfaces.
+    * 
+    * Specification Default:
+    *   The simple name of the Java class + “Service". 
     */
    String serviceName() default "";
 
    /**
-    * The location of a pre-defined WSDL describing the service.  The wsdlLocation is a URL (relative or absolute)
-    * that refers to a pre-existing WSDL file.  The presence of a wsdlLocation value indicates that the service
-    * implementation bean is implementing a pre-defined WSDL contract.  The JSR-181 tool should instead feedback
-    * if the service implementation bean is inconsistent with the portType and bindings declared in this WSDL. Note
-    * that a single WSDL file might contain multiple portTypes and multiple bindings.  The annotations on the service
-    * implementation bean determine the specific portType and bindings that correspond to the Web Service.
+    * The location of a pre-defined WSDL describing the service.
+    * 
+    * The wsdlLocation is a URL (relative or absolute) that refers to a pre-existing WSDL file. 
+    * The presence of a wsdlLocation value indicates that the service implementation bean is implementing a 
+    * pre-defined WSDL contract. The JSR-181 tool MUST provide feedback if the service implementation bean is 
+    * inconsistent with the portType and bindings declared in this WSDL. Note that a single WSDL file might 
+    * contain multiple portTypes and multiple bindings. The annotations on the service implementation bean 
+    * determine the specific portType and bindings that correspond to the Web Service. 
     */
    String wsdlLocation() default "";
 
    /**
-    * The complete name of the service endpoint interface defining the service’s abstract Web Service contract.   This
-    * annotation allows the developer to separate the interface contract from the implementation.  If this annotation
-    * is present, the service endpoint interface is used to determine the abstract WSDL contract (portType and
-    * bindings). The service endpoint interface may include JSR-181 annotations to customize the mapping from Java to
-    * WSDL.  The service implementation bean may implement the service endpoint interface, but is not required to do
-    * so.
-    *
-    * If this annotation is not present, the Web Service contract will be generated from annotations on the service
-    * implementation bean itself.  If a service endpoint interface is required by the target environment, it will be
-    * generated into an implementation-defined package with an implementation defined name.
+    * The complete name of the service endpoint interface defining the service’s abstract Web Service contract.
+    * 
+    * This annotation allows the developer to separate the interface contract from the implementation. 
+    * If this annotation is present, the service endpoint interface is used to determine the abstract 
+    * WSDL contract (portType and bindings). The service endpoint interface MAY include JSR-181 annotations 
+    * to customize the mapping from Java to WSDL.
+    * 
+    * The service implementation bean MAY implement the service endpoint interface, but is not REQUIRED to do so.
+    * If this member-value is not present, the Web Service contract is generated from annotations on the service 
+    * implementation bean. If a service endpoint interface is required by the target environment, it will be generated into an implementation-defined package with an implementation- defined name
+    * 
+    * This member-value is not allowed on endpoint interfaces. 
     */
    String endpointInterface() default "";
-}
-
-;
+};