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: Re: Fw: [sca-j] ISSUE 212: @Service vs. @WebService name conflicts

I think the two statements below can replace JCA100023 (so the first statement below would be the new text for JCA100023 and the second would be JCA100028).  This would mean some adjustments to the current and proposed test assertions and test cases.

Test Assertions:
        JCA-TA-11022 - Prerequisites change to: @name attribute of the @WebService annotation is set and the Java class or Java interface is used to define a service for an implementation class that is not annotated with @Service
        JCA-TA-11026 - Prerequisites change to: Java class or Java interface annotated with @WebService is used to define a service for an implementation class that is annotated with @Service with a names attribute

Test Cases:
        JCA_11018_TestCase - Description changes to: Tests that  where a Java interface or class has an @WebService annotation with the @name attribute set  the name of an SCA interface defined by the Java interface for a implementation class with no @Service annotation is the value @name attribute

Test Artifacts
        Update the descriptions in JCA_11018_TestCase.java and Test_JCA_11018.composite to be consistent with the updated description in JCA_11010_TestCase

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: Anish Karmarkar <Anish.Karmarkar@oracle.com>
To: sca-j@lists.oasis-open.org
Date: 10/18/2010 01:39 AM
Subject: Re: Fw: [sca-j] ISSUE 212: @Service vs. @WebService name conflicts




On 10/13/2010 2:27 PM, David Booz wrote:
>
> 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?
>

I like separating them as two normative statements as drafted above.
Easier to read/parse. Two comments:
1) Don't we need a "if present" after "... of the @Webservice annotation".
2) nit: I assume there is an "of" after "... MUST be used to define the
name"

-Anish
--

> 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
>
>
>
>
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe from this mail list, you must leave the OASIS TC that
> generates this mail.  Follow this link to all your TCs in OASIS at:
> https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
>

---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail.  Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php



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