OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

sca-j message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: [sca-j] NEW ISSUE: Runtime behaviour not specified for incorrect @Init/@Destroysignature



RAISER: Simon Nash
 
TARGET: SCA Java Common Annotations and APIs
 
DESCRIPTION:

The Java Common Annotations and APIs spec says that @Init and @Destroy methods must be public, with a void return type and no arguments.  It does not specify the runtime behaviour if this rule is violated.  The specification should say whether or not the SCA runtime will invoke methods annotated with @Init and @Destroy that don't conform to the specification rules.

PROPOSAL:

The SCA runtime MUST invoke these methods if they conform to the stated rules, and MUST NOT invoke these methods if they don't conform to these rules.

Replace the following paragraph in section 8.10 of the 2/28 JavaCAA spec draft:
 
1116 The @Init annotation type is used to annotate a Java class method that is called when the scope
1117 defined for the local service implemented by the class starts. The method must have a void return
1118 value and no arguments. The annotated method must be public. The annotated method is called
1119 after all property and reference injection is complete.

by the following text:

The @Init annotation is used to denote a Java class method that is called when the scope defined for the
local service implemented by the class starts. The method MUST have a void return value and no arguments.
The annotated method MUST be public.

If there is a method that matches these criteria, the SCA runtime MUST call the annotated method after all
property and reference injection is complete.  A method annotated with @Init that does not match these
criteria MUST NOT be called by the SCA runtime.

Replace the following paragraph in section 8.7 of the 2/28 JavaCAA spec draft:

1054 The @Destroy annotation type is used to annotate a Java class method that will be called when
1055 the scope defined for the local service implemented by the class ends. The method must have a
1056 void return value and no arguments. The annotated method must be public.

by the following text:

The @Destroy annotation is used to denote a Java class method that is called when the scope defined for the
local service implemented by the class ends. The method MUST have a void return value and no arguments.
The annotated method MUST be public.

If there is a method that matches these criteria, the SCA runtime MUST call the annotated method.  A method
annotated with @Destroy that does not match these criteria MUST NOT be called by the SCA runtime.


Simon C. Nash, IBM Distinguished Engineer
Member of the IBM Academy of Technology
Tel. +44-1962-815156  Fax +44-1962-818999






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








[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]