Differences between revisions 7 and 8
Revision 7 as of 2005-08-12 20:56:23
Size: 2972
Editor: wsall
Comment:
Revision 8 as of 2005-12-29 19:04:25
Size: 3537
Editor: 71-211-161-17
Comment:
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
The purpose of JSR-181 "Web Services Metadata for the Java Platform" is to simplify the authoring and deployment of Java Web Services. Beehive's "Web Services Metadata for the Java Platform" subproject (WSM) provides an implementation for JSR-181 as part of Apache’s Beehive open source effort. The purpose of JSR-181 "Web Services Metadata for the Java Platform" is to simplify the authoring and deployment of Java Web Services. Beehive's "Web Services Metadata for the Java Platform" subproject (WSM) provides an open source implementation of this specification that (when completed) can be used on on many web service deployment platforms.  Note, this project is also known as "WSM".
Line 8: Line 8:
After a quick summary of driving forces, this paper proposes requirements (based on JSR-181), phases in which they could be rolled out and a high-level overview over how the implementation could be approached. All considerations are based on JSR-175, JSR-181 and the terminology defined therein unless stated otherwise. Note, WSM '''is not''' another web service runtime. Rather, WSM is used to ''author'' web services that then execute atop a web service runtime. For example, users can write web services as annotated Java files and execute them atop Axis, Geronimo, and various other web service runtimes.
Line 10: Line 10:
== Documents == == Status ==
Line 12: Line 12:
Feature / specification proposals should be posted here for discussion. Documents that are substantially developed will be moved into svn and made available from the project web site. WSM has been undergoing substantial refactoring in the last few months and is getting closer to completion. The three areas left with sbustantial work include:

  * type mapping
  * .wsdd file generation
  * tools

The near-term priority for WSM is passing the JSR-181 TCK. This project has been alive for a long time, but it's still not shipped a usable 1.0. WSM needs to ship before adding substantial new features including additional tools, XMLBean support, and so on.

== Features ==

  * Support for authoring annotated web services that execute atop the Axis 1.x web service runtime

== Proposed Enhancements ==

  * Provide a tool for generating an annotated Java file given a WSDL (wsdl2ajava)
  * Support for Axis2
  * Support additional web service runtimes (Geronimo, WebLogic, etc)
  * Support drop-in deployment of annotated web services on the Axis runtime.
  * XMLBeans support in WSM: XmnBeansInWsm

== Glossary ==

 * Annotation Processor: A processor for JSR-175 annotations; the JSR-181 processor unless stated otherwise.
 * Annotated Web Service: A .java source file that complies with JSR-181 and uses JSR-175 metadata.
 * Web Service Runtime: The actual web service runtime on which an annotated web service executes. Such implementations might be Apache Axis, WebLogic, Geronimo, and so on.
 * WSDL (Web Service Definition Langugae): An XML instance document that defines the interface for a web service.
 * WSM: The TLA for this project.
 * XSD: An XML Schema file; schemas are often used in web services to define the message shape of a web service's inputs and outputs.
 * .class file: executable byte code derived from annotated Java Web Service files file through compilation.
 * .jws file: An Axis-specific Java web service.

== References ==

 * [http://java.sun.com/j2se/1.5.0/docs/guide/apt/index.html APT] Sun Microsystems Annotation Processing Tool (APT).
 * [http://ws.apache.org/axis/ Axis] Apache Software Foundation. Web Services – Axis.
 * [http://www.jcp.org/en/jsr/detail?id=101 JSR-101] R. Chinnici. Java APIs for XML based RPC.
 * [http://www.jcp.org/en/jsr/detail?id=109 JSR-109] J. Knutson. Implementing Enterprise Web Services.
 * [http://www.jcp.org/en/jsr/detail?id=175 JSR-175] G. Bracha. A Metadata Facility for the Java Programming Language.
 * [http://www.jcp.org/en/jsr/detail?id=181 JSR-181] M. Mihic, J. Trezzo. Web Services Metadata for the Java Platform.

== Archive ==

Old documents are linked here:
Line 18: Line 60:

== Terminology ==

 * Annotated Java Web Service file: Java Web Services file in the sense of JSR-181, with annotations.
 * .class file: executable byte code derived from annotated Java Web Service files file through compilation.
 * .jws file: Java Web Services file in the sense of the Apache Axis project, without annotations.
 * Processor: the JSR-181 processor unless stated otherwise.
 * Runtime: The system that executes a Java Web Service, e.g. Apache Axis on Tomcat.
 * Service definition file: WSDL service description file.
 * .wsdl file: synonymous for service definition file.
 * WSM: the JSR-181 implementation as proposed herein.
 * .xsd file: XML schema definition file; used for type and message definitions, for instance.

== Open Issues ==

Issues not yet addressed in this proposal:
 * Identify a minimum list of error checks to be performed by the processor
 * Identify interesting target runtimes
 * Technology Compatibility Kit (TCK): the final decision whether the TCK is developed as part of the Beehive project rests with the JSR-181 expert group

== Discussions ==

 * XMLBeans support in WSM: XmnBeansInWsm

== References ==

[Apt] Sun Microsystems. Annotation Processing Tool (apt). http://java.sun.com/j2se/1.5.0/docs/guide/apt/index.html.

[Axis] Apache Software Foundation. Web Services – Axis. http://ws.apache.org/axis/.

[JSR-101] R. Chinnici. Java APIs for XML based RPC. http://www.jcp.org/en/jsr/detail?id=101.

[JSR-109] J. Knutson. Implementing Enterprise Web Services. http://www.jcp.org/en/jsr/detail?id=109.

[JSR-175] G. Bracha. A Metadata Facility for the Java Programming Language. http://www.jcp.org/en/jsr/detail?id=175.

[JSR-181] M. Mihic, J. Trezzo. Web Services Metadata for the Java Platform. http://www.jcp.org/en/jsr/detail?id=181.

Beehive Metadata for Web Services

The purpose of JSR-181 "Web Services Metadata for the Java Platform" is to simplify the authoring and deployment of Java Web Services. Beehive's "Web Services Metadata for the Java Platform" subproject (WSM) provides an open source implementation of this specification that (when completed) can be used on on many web service deployment platforms. Note, this project is also known as "WSM".

Note, WSM is not another web service runtime. Rather, WSM is used to author web services that then execute atop a web service runtime. For example, users can write web services as annotated Java files and execute them atop Axis, Geronimo, and various other web service runtimes.

Status

WSM has been undergoing substantial refactoring in the last few months and is getting closer to completion. The three areas left with sbustantial work include:

  • type mapping
  • .wsdd file generation
  • tools

The near-term priority for WSM is passing the JSR-181 TCK. This project has been alive for a long time, but it's still not shipped a usable 1.0. WSM needs to ship before adding substantial new features including additional tools, XMLBean support, and so on.

Features

  • Support for authoring annotated web services that execute atop the Axis 1.x web service runtime

Proposed Enhancements

  • Provide a tool for generating an annotated Java file given a WSDL (wsdl2ajava)
  • Support for Axis2
  • Support additional web service runtimes (Geronimo, WebLogic, etc)

  • Support drop-in deployment of annotated web services on the Axis runtime.
  • XMLBeans support in WSM: XmnBeansInWsm

Glossary

  • Annotation Processor: A processor for JSR-175 annotations; the JSR-181 processor unless stated otherwise.
  • Annotated Web Service: A .java source file that complies with JSR-181 and uses JSR-175 metadata.
  • Web Service Runtime: The actual web service runtime on which an annotated web service executes. Such implementations might be Apache Axis, WebLogic, Geronimo, and so on.

  • WSDL (Web Service Definition Langugae): An XML instance document that defines the interface for a web service.
  • WSM: The TLA for this project.
  • XSD: An XML Schema file; schemas are often used in web services to define the message shape of a web service's inputs and outputs.
  • .class file: executable byte code derived from annotated Java Web Service files file through compilation.
  • .jws file: An Axis-specific Java web service.

References

Archive

Old documents are linked here:

Web_Services (last edited 2009-09-20 23:24:38 by localhost)