Find JSRs
Submit this Search


Ad Banner
 
 
 
 

Web Services for J2EE, Version 1.0 Change Log

Web Services for J2EE, Version 1.0

Change Log

Document last updated: 10/9/2002

Description

This document describes the set of change requests Proposed, Accepted, and Deferred per the JSPA section 4. These are changes to the Web Services for J2EE Version 1.0 specification and intended to result in a version of the specification for integration with J2EE 1.4.

Maintenance Lead

Jim Knutson, IBM

Feedback

Comments should be sent to wsee-spec-comments@us.ibm.com.

Proposed Changes

All changes to the final release must be listed here and approved by the EC.

Request Summary Specification Changes
1 Change version to 1.1 Title page, replace:
Version 1.0
With:
Version 1.1
Page 2, replace
Version: 1.0
With:
Version: 1.1
2 Add EJB 2.1 web services view. Itemize references to EJB remote interface/home interface requirements where the EJB 2.1 web services client view needs to be injected.

Section 3.10, item 1, replace:

The service provider implements the Web service business logic by implementing a stateless session EJB. The EJB�s remote interface method signatures must match the method signatures of the Service Endpoint Interface and must include all methods of the Service Endpoint Interface.

With:

The service provider implements the Web service business logic by creating a stateless session Bean that implements the methods of the Service Endpoint Interface as described in the Enterprise JavaBeans 2.1 specification.

Section 8.1 paragraph 6, replace:

In general, the deployment tool generates a servlet to handle parsing the incoming SOAP request, create a remote stateless session EJBObject and dispatch the request to the stateless session EJB. The methods of the SEI are described by the remote interface, the deployment tool can generate a servlet that dispatches to the remote interface of the EJB.

With:

In general, the deployment tool generates a servlet to handle parsing the incoming SOAP request, the servlet obtains a reference to an instance of an appropriate EJBObject and dispatches the request to the stateless session EJB.
3 Make EJB 2.0 based web services optional. Itemize references to EJB remote interface/home interface requirements that need to be made optional. Optional support for J2EE 1.3 based web services is accomplished by referring to the original Web Services for J2EE 1.0 specification.

Section 3.10 item 1, remove:

The EJB�s remote interface method signatures must match the method signatures of the Service Endpoint Interface and must include all methods of the Service Endpoint Interface.

Section 5.3.2.1.3, remove entire section:

5.3.2.1.3 Exposing an existing EJB
An existing Enterprise JavaBean may be used as a Service Implementation Bean if it meets the following requirements:
� The business methods of the EJB bean class that are exposed on the SEI must meet the Service Implementation Bean requirements defined in section 5.3.1.
� The Service Endpoint Interface methods must be a subset of the remote interface methods of the EJB and the SEI must meet the requirements described in the JAX-RPC specification for Java->WSDL mapping.
� The transaction attributes of the SEI methods must not include Mandatory.
The developer must package the Web service as described in section 5.4 and must specify an ejb-link from the port in the Web services deployment descriptor to the existing EJB.

Section 8.1, 3rd bullet, remove:

If the Service Implementation Bean is an EJB, the SEI methods are fully contained by the remote interface.
Section 8.2.9, bullet 7, remove:
If the Service Implementation Bean is an EJB, the SEI methods are not fully contained by the remote interface.
Add Appendix:
Optional support for J2EE 1.3 platforms

Web Services for J2EE Version 1.1 does not require support for applications built according to the Web Services for J2EE Version 1.0 specification. A vendor may optionally support Web Services for J2EE 1.0 by implementing that version of the specification. See the Web Services Version 1.0 Change Log for more details on the differences between the two specifications.

4 Add J2EE 1.4 based XML Schemas Create new Chapter 7 info with XML Schema specific info. Describe the general 1-1 mapping of DTD to XML Schema elements for most elements and detail where it isn't 1-1 and why.

Section 7.1.5, replace DTD with XML Schema

Section 7.2.2, 4th bullet, remove:

Scope. If the service reference is being defined within an EJB-JAR, the service-ref elements must be defined within a component-scoped-refs element so that the service-ref can be associated with a particular EJB. The association with the EJB is defined by the component-name element.

Section 7.2.2?, add note regarding service-endpoint declaration in EJB 2.1 deployment descriptor.

Section 7.2.5, replace DTD with XML Schema.

Section 7.3.5, replace DTD with XML Schema.

5 Make the DTD based schemas optional. See Appendix change in item 3.
6 Make Holders required for EJB container. Modify statement saying that Holders are optional for the EJB container to say they are optional only for an EJB 2.0 container.

Section 5.3, first definition list item, move the following to the appendix:

Support for OUT and IN/OUT parameters is optional for the EJB container.

Section 5.3, second definition list item, move the following to the appendix:

Support for Holder parameters is optional for the EJB container.

Section 5.3.1, move the last paragraph to the appendix:

JAX-RPC defines Holders as non-serializable classes which cannot be implemented by the remote interface of an Enterprise JavaBean. Therefore, support for an SEI which uses Holders for parameters is not required for Port components deployed in the EJB container
7 Make Handler support required for EJB container Remove statement saying that Handlers are optional for the EJB container.

Section 6.1, last paragraph, remove:

This specification makes Handler support in the EJB container optional due to the required EJB container changes that would be necessary to implement Handler support. It is expected that EJB Handler support will be made required in a future J2EE specification.

Section 6.2.4, last paragraph, remove:

A container provider is not required to support Handlers for Port component�s that run in the EJB container. It is expected this will be required when this specification is included in J2EE 1.4.
8 Change references to extension of J2EE 1.3 to include integration into J2EE 1.4 Chapter 2, last paragraph, remove:
The relation of this specification to J2EE 1.4 is defined in Appendix A.
Section 2.1.3, second bullet, replace:
The Web service deployment is supported on top of existing J2EE 1.3 environments.
With:

The Web service deployment is supported on J2EE 1.4 environments.

Appendix A, J2EE APIs, replace:

Enterprise JavaBeans 2.0 defines the programming model for implementing Web services which run in the EJB container.
Servlet 2.3 defines the packaging and container service model for implementing Web services which run in the servlet container.
J2EE 1.4, EJB 2.1, and Servlet 2.4 will include the Web services specification defined within this specification. An effort will be made to maintain compatibility and ease migration to J2EE 1.4, but there is no guarantee that compatibility will be ensured. A JSR 109 1.1 maintenance release will address XML Schema based deployment descriptors, the EJB 2.1 Web services view, as well as Holder and Handler class usage in the EJB container for use by J2EE 1.4

With:

Enterprise JavaBeans 2.1 defines the programming model for implementing Web services which run in the EJB container.

Servlet 2.4 defines the packaging and container service model for implementing Web services which run in the servlet container.

9 Clarify port address requirement. Section 4.2.2.4, replace:

The port address attribute may be absent from the WSDL or may be a dummy value.

with:

The port address location attribute may be absent from the WSDL or may be a dummy value.

Note: I looked at the Servlet 2.4 PFD and it doesn't appear that any change needs to be made to cover it.

Accepted Changes

Changes approved by the EC move to this section.

Deferred Changes

Changes deferred by the EC move to this section.