Public Review of 'SCA-J Common Annotations and APIs' and 'POJO Component Implementation' v1.1 - 15 day review

[Mary McRae <mary.mcrae@oasis-open.org>]

To OASIS members, Public Announce Lists:

The OASIS Service Component Architecture / J (SCA-J) TC has recently approved the following specifications as a Committee Specification Drafts and approved them for public review:

Service Component Architecture SCA-J Common Annotations and APIs Specification Version 1.1
Service Component Architecture POJO Component Implementation Specification Version 1.1

The SCA-J Common Annotations and APIs specification defines a Java syntax for programming concepts defined in the SCA Assembly Model Specification. It specifies a set of APIs and annotations that can be used by Java-based artifacts described by other SCA specifications such as the POJO Component Implementation Specification [JAVA_CI]. Specifically, this specification covers: 
1. Implementation metadata for specifying component services, references, and properties 
2. A client and component API 
3. Metadata for asynchronous services 
4. Metadata for callbacks 
5. Definitions of standard component implementation scopes 
6. Java to WSDL and WSDL to Java mappings 
7. Security policy annotations 
Note that other Java-based SCA specifications can choose to implement their own mappings of assembly model concepts using native APIs and idioms when appropriate. 

The POJO Component Implementation specification extends the SCA Assembly Model by defining how a Java class provides an implementation of an SCA component, including its various attributes such as services, references, and properties and how that class is used in SCA as a component implementation type. It requires all the annotations and APIs as defined by the SCA-J Common Annotations and APIs specification. This specification also details the use of metadata and the Java API defined in the context of a Java class used as a component implementation type. 

The public review starts today, 23 November 2010, and ends 8 December 2010. These specifications were previously submitted for a 60-day public review on 8 June 2009[1]; as well as a 15-day public review on 9 March 2010[2]; this 15-day review is limited in scope to changes made from the previous review. All changes are highlighted in the accompanying diff version.

This is an open invitation to comment. We strongly encourage feedback from potential users, developers and others, whether OASIS members or not, for the sake of improving the interoperability and quality of OASIS work.

More non-normative information about the specification and the technical committee may be found at the public home page of the TC at:
http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=sca-j. Comments may be submitted to the TC by any person through the use of the OASIS TC Comment Facility which can be located via the button marked "Send A Comment" at the top of that page, or directly at:
http://www.oasis-open.org/committees/comments/index.php?wg_abbrev=sca-j.

Submitted comments (for this work as well as other works of that TC) are publicly archived and can be viewed at:
http://lists.oasis-open.org/archives/sca-j-comment/. All comments submitted to OASIS are subject to the OASIS Feedback License, which ensures that the feedback you provide carries the same obligations at least as the obligations of the TC members.

The specification document and related files are available here:

Service Component Architecture SCA-J Common Annotations and APIs Specification Version 1.1
Diff version noting changes:
http://docs.oasis-open.org/opencsa/sca-j/sca-javacaa-1.1-spec-cd04-csprd03-diff.pdf
Editable Source:
http://docs.oasis-open.org/opencsa/sca-j/sca-javacaa-1.1-spec-csprd03.doc
PDF:
http://docs.oasis-open.org/opencsa/sca-j/sca-javacaa-1.1-spec-csprd03.pdf
HTML:
http://docs.oasis-open.org/opencsa/sca-j/sca-javacaa-1.1-spec-csprd03.html

Related Files:
Compiled Java API:
http://docs.oasis-open.org/opencsa/sca-j/sca-caa-apis-1.1-csd05.jar
Downloadable Javadoc:
http://docs.oasis-open.org/opencsa/sca-j/sca-j-caa-javadoc-1.1-csd05.zip
Hosted Javadoc:
http://docs.oasis-open.org/opencsa/sca-j/javadoc/index.html
Java Artifacts:
http://docs.oasis-open.org/opencsa/sca-j/sca-j-common-annotations-and-apis-1.1-csd05.zip


Service Component Architecture POJO Component Implementation Specification Version 1.1
Diff version noting changes or change log:
http://docs.oasis-open.org/opencsa/sca-j/sca-javaci-1.1-spec-cd02-csprd03-diff.pdf
Editable Source:
http://docs.oasis-open.org/opencsa/sca-j/sca-javaci-1.1-spec-csprd03.doc
PDF:
http://docs.oasis-open.org/opencsa/sca-j/sca-javaci-1.1-spec-csprd03.pdf
HTML:
http://docs.oasis-open.org/opencsa/sca-j/sca-javaci-1.1-spec-csprd03.html

Schema:
http://docs.oasis-open.org/opencsa/sca-j/sca-contribution-java-1.1-csd03.xsd
http://docs.oasis-open.org/opencsa/sca-j/sca-implementation-java-1.1-csd03.xsd

OASIS and the SCA-J TC welcome your comments.


Mary P McRae
Director, Standards Development
Technical Committee Administrator
OASIS: Advancing open standards for the information society
email: mary.mcrae@oasis-open.org 
web: www.oasis-open.org
twitter: @fiberartisan #oasisopen
phone: 1.603.232.9090


[1] http://lists.oasis-open.org/archives/tc-announce/200906/msg00004.html
[2] http://lists.oasis-open.org/archives/tc-announce/201003/msg00007.html;
     http://lists.oasis-open.org/archives/tc-announce/201003/msg00008.html