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

 


Help: OASIS Mailing Lists Help | MarkMail Help

sca-assembly message

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


Subject: Re: [sca-assembly] NEW ISSUE: Java classes do not follow standardcapitalization


Ok, so this is really a preference based on that wording.  Perhaps you're
arguing it is a convention which is encouraged by the spec which we should
also follow.  It is too strong to say that it's a standard.

I'm not opposed to the change, I just didn't understand the choice of the
word 'standard'.

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:      |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |Jim Marino <jim.marino@gmail.com>                                                                                                                 |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| To:        |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |OASIS Assembly <sca-assembly@lists.oasis-open.org>                                                                                                |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Date:      |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |01/12/2010 10:39 AM                                                                                                                               |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Subject:   |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |Re: [sca-assembly] NEW ISSUE:  Java classes do not follow standard capitalization                                                                 |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|





There are a number of classes in the General_Java contribution, e.g.
org.oasisopen.sca.test.service1Impl,
org.oasisopen.sca.test.service1Impl3, etc.

While these names are syntactically valid, the Java Language
Specification recommends otherwise. Section 6.8 of the JLS (Second
Edition), Naming Conventions, states:

"Names of class types should be descriptive nouns or noun phrases, not
overly long, in mixed case with the first letter of each word
capitalized."

Jim

P.S. Please note if you try and rename the files locally and commit
through Subversion, the latter is likely to throw an error as it does
not handle case changes well (this will happen with Unix systems, I
don't know what will happen with Windows systems). The changes need to
be done directly against the Subversion repository.

On Jan 12, 2010, at 2:11 PM, David Booz wrote:

> Which testcase is an example of this problem? Can someone point me
> to the
> standard where the correct usage is defined?  I was not aware of
> such a
> standard.
>
> 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:      |
> |------------>
>>
--------------------------------------------------------------------------------------------------------------------------------------------------|

>  |Mike Edwards
> <
> mike_edwards
> @uk
> .ibm
> .com
> >
>
|
>>
--------------------------------------------------------------------------------------------------------------------------------------------------|

> |------------>
> | To:        |
> |------------>
>>
--------------------------------------------------------------------------------------------------------------------------------------------------|

>  |OASIS Assembly <sca-assembly@lists.oasis-
> open
> .org
> >
>
|
>>
--------------------------------------------------------------------------------------------------------------------------------------------------|

> |------------>
> | Date:      |
> |------------>
>>
--------------------------------------------------------------------------------------------------------------------------------------------------|

>  |01/12/2010 04:08
> AM
>
|
>>
--------------------------------------------------------------------------------------------------------------------------------------------------|

> |------------>
> | Subject:   |
> |------------>
>>
--------------------------------------------------------------------------------------------------------------------------------------------------|

>  |Re: [sca-assembly] NEW ISSUE:  Java classes do not follow standard
> capitalization
>                                                                  |
>>
--------------------------------------------------------------------------------------------------------------------------------------------------|

>
>
>
>
>
>
> Logged as: http://www.osoa.org/jira/browse/ASSEMBLY-197
>
> 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
>
>
> From:   Jim Marino <jim.marino@gmail.com>
>
> To:     OASIS Assembly <sca-assembly@lists.oasis-open.org>
>
> Date:   11/01/2010 18:16
>
> Subject [sca-assembly] NEW ISSUE:  Java classes do not follow standard
> :       capitalization
>
>
>
>
>
>
>
> NEW ISSUE:   Java classes do not follow standard capitalization.
>
> TARGET: SCA Assembly Conformance Tests
>
> DESCRIPTION:
>
> Many Java test classes do not follow the standard Java capitalization
> scheme.
>
> PROPOSAL:
>
> Rename the classes. Since Subversion has problems with local
> modifications
> and capitalization, files will need to be renamed directly in the repo
> instead of through a check-in of local modifications.
>
>
>
>
>
>
>
>
>
> 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
>
>
>
>
>
>
>
>
>
>
>
>
>
>
> ---------------------------------------------------------------------
> 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]