[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Fw: [sca-j] ISSUE 212: @Service vs. @WebService name conflicts
Getting back on the list now. Bryan and I have been tweaking the proposed
wording for Java-212, notably the normative text in the CAA spec. Here's
the latest proposal that would replace JCA100028.
The value of the name attribute of the @WebService annotation MUST be used
to define the name an SCA service when there is no @Service annotation
present in the SCA component implementation. [JCA1000xx]
The value of the name attribute of the @WebService annotation MUST be used
to define the name an SCA service when the @Service annotation is present
without the names attribute and indicates that the Java interface or class
annotated with the @WebService annotation defines an SCA service interface.
[ JCA1000xx]
If you read the full email chain you'll see how we got here. Any opinions?
Dave Booz
STSM, BPM and SCA Architecture
Co-Chair OASIS SCA-Policy TC and SCA-J TC
"Distributed objects first, then world hunger"
Poughkeepsie, NY (845)-435-6093 or 8-295-6093
e-mail:booz@us.ibm.com
----- Forwarded by David Booz/Poughkeepsie/IBM on 10/13/2010 05:22 PM -----
|------------>
| From: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|Bryan Aupperle/Raleigh/IBM |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| To: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|David Booz/Poughkeepsie/IBM@IBMUS |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Date: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|10/13/2010 02:48 PM |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Subject: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|Re: [sca-j] ISSUE 212: @Service vs. @WebService name conflicts |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
I generally prefer normative statements that are a single sentence, but the
second option is easier to read. Either is an improvement over my tweak.
Bryan Aupperle, Ph.D.
STSM, WebSphere Enterprise Platform Software Solution Architect
WW Center of Excellence for Enterprise Systems & Banking Center of
Excellence Application Integration Architect
Master Inventor
Research Triangle Park, NC
+1 919-254-7508 (T/L 444-7508)
Internet Address: aupperle@us.ibm.com
|------------>
| From: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|David Booz/Poughkeepsie/IBM |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| To: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|Bryan Aupperle/Raleigh/IBM |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Date: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|10/13/2010 02:31 PM |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Subject: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|Re: [sca-j] ISSUE 212: @Service vs. @WebService name conflicts |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
Yours is better than mine...
How about another tweak:
The value of the name attribute of the @WebService annotation MUST be used
to define the name an SCA service when there is no @Service annotation
present in the SCA component implementation or when the @Service annotation
is present without the names attribute and indicates that the Java
interface or class annotated with the @WebService annotation defines an SCA
service interface.
or this:
The value of the name attribute of the @WebService annotation MUST be used
to define the name an SCA service when there is no @Service annotation
present in the SCA component implementation.
The value of the name attribute of the @WebService annotation MUST be used
to define the name an SCA service when the @Service annotation is present
without the names attribute and indicates that the Java interface or class
annotated with the @WebService annotation defines an SCA service interface.
Dave Booz
STSM, BPM and SCA Architecture
Co-Chair OASIS SCA-Policy TC and SCA-J TC
"Distributed objects first, then world hunger"
Poughkeepsie, NY (845)-435-6093 or 8-295-6093
e-mail:booz@us.ibm.com
|------------>
| From: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|Bryan Aupperle/Raleigh/IBM |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| To: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|David Booz/Poughkeepsie/IBM@IBMUS |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Date: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|10/13/2010 02:14 PM |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Subject: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|Re: [sca-j] ISSUE 212: @Service vs. @WebService name conflicts |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
Slight modification, but overall I like it.
The value of the name attribute of the @WebService annotation MUST be used
to define the name an SCA service when there is no @Service annotation
present in the SCA component implementation or when the @Service annotation
is present and indicates that the Java interface or class annotated with
the @WebService annotation defines an SCA service but the names attribute
of the @Service annotation is not specified.
Bryan Aupperle, Ph.D.
STSM, WebSphere Enterprise Platform Software Solution Architect
WW Center of Excellence for Enterprise Systems & Banking Center of
Excellence Application Integration Architect
Master Inventor
Research Triangle Park, NC
+1 919-254-7508 (T/L 444-7508)
Internet Address: aupperle@us.ibm.com
|------------>
| From: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|David Booz/Poughkeepsie/IBM |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| To: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|Bryan Aupperle/Raleigh/IBM@IBMUS |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Date: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|10/13/2010 02:03 PM |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Subject: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|Re: [sca-j] ISSUE 212: @Service vs. @WebService name conflicts |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
Here's the two normative statements in CAA.
The name of a service with an interface defined by a Java interface or
class annotated with the @WebService annotation with its name attribute set
MUST be the value of the name attribute of the annotation. [JCA100023]
If a service is named by both name attribute of a @Service annotation and
the name attribute of a @WebService annotation and the name attribute
values differ, an SCA Runtime MUST use the value from the name attribute of
the @Service annotation. [JCA100028]
I think what we're after is something like this:
The value of the name attribute of the @Webservice annotation MUST be used
to define the name an SCA service when there is no @Service annotation
present in the SCA component implementation or when the @Service annotation
is present and indicates that the Java interface or class annotated with
the @WebService annotation defines an SCA service but the @Service
annotation does not provide a service name.
It's a mouthful. What do you think?
Dave Booz
STSM, BPM and SCA Architecture
Co-Chair OASIS SCA-Policy TC and SCA-J TC
"Distributed objects first, then world hunger"
Poughkeepsie, NY (845)-435-6093 or 8-295-6093
e-mail:booz@us.ibm.com
|------------>
| From: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|Bryan Aupperle/Raleigh/IBM@IBMUS |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| To: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|sca-j@lists.oasis-open.org |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Date: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|10/11/2010 03:42 PM |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Subject: |
|------------>
>--------------------------------------------------------------------------------------------------------------------------------------------------|
|Re: [sca-j] ISSUE 212: @Service vs. @WebService name conflicts |
>--------------------------------------------------------------------------------------------------------------------------------------------------|
Here is a revised proposal based on the discussion on today's call. Since
the test case is now positive, there is no need to update
tuscany-oasis-sca-tests-errors.properties.
[1]
https://www.oasis-open.org/apps/org/workgroup/sca-j/download.php/39730/Issue%20212b.zip
[2]
http://tools.oasis-open.org/version-control/browse/wsvn/sca-j/TestCases/?rev=201&sc=1
Bryan Aupperle, Ph.D.
STSM, WebSphere Enterprise Platform Software Solution Architect
WW Center of Excellence for Enterprise Systems & Banking Center of
Excellence Application Integration Architect
Research Triangle Park, NC
+1 919-254-7508 (T/L 444-7508)
Internet Address: aupperle@us.ibm.com
From: Bryan Aupperle/Raleigh/IBM@IBMUS
To: sca-j@lists.oasis-open.org
Date: 09/24/2010 09:26 AM
Subject: [sca-j] ISSUE 212: @Service vs. @WebService name conflicts
I have uploaded a proposal for Issue 212 base on the discussion in Monday's
call [1]. It includes an additional normative statement in the CAA spec,
with a corresponding Test Assertion and TestCase and comments in the CI
spec including a reference to the CAA spec. The bulk of the test artifacts
for the test case are available [2]. The updated version of
tuscany-oasis-sca-tests-errors.properties is not ready yet. Tuscany needs
to add a test for this mismatch and until that is done I do not know what
the error message will be.
[1]
https://www.oasis-open.org/apps/org/workgroup/sca-j/download.php/39538/Issue%20212.zip
[2]
http://tools.oasis-open.org/version-control/browse/wsvn/sca-j/TestCases/?rev=199&sc=1
Bryan Aupperle, Ph.D.
STSM, WebSphere Enterprise Platform Software Solution Architect
WW Center of Excellence for Enterprise Systems & Banking Center of
Excellence Application Integration Architect
Research Triangle Park, NC
+1 919-254-7508 (T/L 444-7508)
Internet Address: aupperle@us.ibm.com
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]