Date: 2004-09-21T16:43:57
Editor: MichaelMerz <[EMAIL PROTECTED]>
Wiki: Apache Beehive Wiki
Page: Jsr181Impl
URL: http://wiki.apache.org/beehive/Jsr181Impl
no comment
Change Log:
------------------------------------------------------------------------------
@@ -1,44 +1,22 @@
-== Abstract ==
-
-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.
-
-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.
-
-This paper is intended as a basis for further discussions in the Beehive
developer community.
-
-== 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.
-
-== General Proposal ==
-
-=== Goals ===
+= Goals =
Provide an implementation of WSM.
It can be RI for JSR 181.
My point: how about developing both RI and TCK for JSR 181 in an open manner
within Beehive? It can help Beehive WSM developers to be more effectively
test-driven.
-=== Requirements ===
+= Requirements =
Web-services-platform-neutral design.
For the purpose, Beehive WSM APIs are invented so that any web services
platforms such as Axis and BEA WebLogic can make use of Beehive WSM seamlessly.
-=== Code bases ===
+= Code bases =
a. JSR 181 API (mostly annotation types) from JSR-181 official site
NB: Cliff, please check out if we can import them to Beehive SVN and
update them without any (legal) conflict. If not, we can make a clean-room
implementation for that.
* WSM for Axis from ws-axis/contrib
-=== Constructs ===
+= Constructs =
a. JSR 181 standard annnotation types
* Beehive WSM API
@@ -47,15 +25,7 @@
* An implementation of (b) for Geronimo (J2EE-JSR-109-targeted)
* Test cases (including TCK)
-== Requirements Analysis ==
-
-For a detailed discussion of requirements for the Behive JSR-181
implementation see Jsr181Requirements.
-
-== Architecture Proposal ==
-
-For a detailed discussion of the proposed architecture for the JSR-181
implementation see Jsr181ImplArchitecture.
-
-== Directory Structure ==
+= Directory Structure =
* wsm
* src - root for source files
@@ -80,30 +50,3 @@
* reflection
* wsdl
-== Documentation ==
-
-TBD.
-
-== 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 and schedules for those 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
-
-== Unit Testing: Test Cases ==
-
-TBD.
-
-== 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.
