sca-j message
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
--
[Date Index]
| [Thread Index]
| [List Home]
Subject: [NEW ISSUE] SCA Java Specifications do not Adequately Define theComponentType of a Java implementation
- From: Mike Edwards <mike_edwards@uk.ibm.com>
- To: "OASIS Java" <sca-j@lists.oasis-open.org>
- Date: Mon, 4 Aug 2008 13:20:23 +0100
Raiser: Mike Edwards
Target: Java C&I sca-javaci-draft-20070926.pdf
(is this a first for this spec??)
Description:
<Note: I believe that a description
of componentType belongs strictly with the component implementation specifications
and would be different (say) for Spring,
EJBs (JEE) and POJOs - so I've raised this against the Java POJO spec...
we may need to do the same for the other
specs>
The component type of a Java Component
Implementation is not described adequately.
In particular, there is no rigorous
set of (compliance testable) rules that relate the content of a Java POJO
implementation
class to its (implied, derived) component
type.
There are some examples in lines 71-78,
97-105, and 120-130. But there are no definitive or normative
statements.
There are no statements in Sections
3 and 4 relating to References and Properties in component types.
Section 8 has some rules about deriving
component type for an unannotated Java class - but:
- it only covers references and properties.
Services are (confusingly) discussed elsewhere.
- it is not clear whether "unannotated"
means "absolutely no @Reference or @Property annotations " or
"parts of a class that are not annotated"
(ie if there is at least one @Reference
or @Property annotation on a class, does that mean that it is treated as
"annotated" and there is no
search for anything not annotated -
or does a search for unannotated entities still take place?)
- it does not lay down rules for the
generation of component type information from the discovered unannotated
features of the class
Proposal:
1) Add a new section to the specification
with the title "The Component Type of a Java Component Implementation"
- this section will provide normative
detail on the component type of a Java component
2) Clarify the contents of Section 8
a) Make it clear that any @Reference
or @Property annotation in a Java class means that the whole class is regarded
as "annotated" and that
only annotated features of the class
contribute to the component type. Only classes with no @Reference
or @Property annotations
are treated according to the rules of
"unannotated implementation"
b) Add in the material about unannotated
services here.
b) Upgrade the description of the rules
for an unanotated implementation to be explicit about the component type
elements
that correspond to the various features
of the class.
Here is a marked up version of the Java
C&I specification that attempts to make this proposal concrete:
Yours, Mike.
Strategist - Emerging Technologies, SCA & SDO.
Co Chair OASIS SCA Assembly TC.
IBM Hursley Park, Mail Point 146, Winchester, SO21 2JN, Great Britain.
Phone & FAX: +44-1962-818014 Mobile: +44-7802-467431
Email: mike_edwards@uk.ibm.com
Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number
741598.
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6
3AU
sca-javaci-draft-20070926_IssueXX.doc
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
--
[Date Index]
| [Thread Index]
| [List Home]