[ISSUE 39] Incorrect example in Java Component Implementation Spec v1.00 -Sec 1.2.4 -- PROPOSAL

[Mike Edwards <mike_edwards@uk.ibm.com>]

Folks,

Following up on an action item from
the F2F meeting of 11-13 November:

PROPOSAL to RESOLVE Issue 39:

Relates to sca-javaci-draft-20070926.doc

1) Replace lines 307 - 313 in section
5 with the following:

/** Additional property set through
a method

* - in this case there will be 2 Properties named

*   someProperty and anotherProperty

*   and 1 Reference named

*   someReference                                  

*/

public class Impl4 {

    private String someProperty;

    private SomeService someReference;

    @Constructor({"someProperty" "someReference"})

    public Impl4(String a, SomeService b) {...}

    @Property

    public void setAnotherProperty(int x) {...}

}

Relates to sca-javacaa-1.1-spec-cd01.doc

(This is added to the resolution since I noticed that the Java CAA spec example for @Constructor
is invalid since the NAME of the constructor parameter is unavailable for introspection in the general
case - this makes the requirement to add the name(s) of the references and properties mandatory
unless the parameters are ALL annotated with either @Property or @Reference)

2) Replace line 1032 with:
------------------------------

@Constructor({ "someProperty" })

------------------------------

3) Add the following text to the end of line 1023
-------------------------------
If the constructor method has parameters, names MUST be supplied for all of the constructor parameters
either:

a) By annotating every one of the parameters with either an @Reference or an @Property annotation
which MUST include a name
b) By providing a name for each of the constructor parameters in the parameter of the @Constructor
annotations [JCA85001]
--------------------------------

4) Add the following text after line 1019:
--------------------------------
There MUST only be one Constructor method annotated with @Constructor in a Java class
--------------------------------

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