[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
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 >
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]