You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beehive.apache.org by Apache Wiki <wi...@apache.org> on 2005/12/29 20:04:30 UTC
[Beehive Wiki] Update of "Web Services" by EddieOneil
Dear Wiki user,
You have subscribed to a wiki page or wiki category on "Beehive Wiki" for change notification.
The following page has been changed by EddieOneil:
http://wiki.apache.org/beehive/Web_Services
------------------------------------------------------------------------------
= 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 implementation for JSR-181 as part of Apaches 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".
- 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.
- == Documents ==
+ == Status ==
- 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:
* JSR-181 Project Plan (Proposal): Jsr181ProjectPlan
* General Proposal: Jsr181Impl
* Requirements for JSR-181 Implementation: Jsr181Requirements
* Architecture for JSR-181 Implementation (Proposal): Jsr181ImplArchitecture
- == 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.
-