About JCP
Get Involved
Community Resources
Community News
FAQ
Contact Us

|
 |
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.
|