[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: Fw: [sca-j] package names
I think we need to give Mary some more of this picture, such as the existence of the previous API names and the inconvenience to SCA users if the names are changed. The case of existing code moving into a new "home" is not the same as when new APIs are created from scratch, because of the large body of existing code using the current package names. For example, a lot of APIs in the JDK that started life as javax.* did not get renamed to java.* when they moved from outside the JDK to inside the JDK. Similarly, the JDK has adopted APIs defined by other bodies and included them in the JDK without changing their names (e.g., org.omg.*, org.xml.*, org.w3c.*). For schema namespaces there is a valid technical reason for renaming in order to make the URIs dereferenceable at a site under OASIS control. This consideration does not apply to API names. Simon Simon C. Nash, IBM Distinguished Engineer Member of the IBM Academy of Technology Tel. +44-1962-815156 Fax +44-1962-818999 Bryan Aupperle <aupperle@us.ibm.com> 14/01/2008 13:29 To sca-j@lists.oasis-open.org cc Subject Fw: [sca-j] package names Mary's feedback. Bryan Aupperle, Ph.D. STSM, WebSphere Enterprise Platform Software Solution Architect Master Inventor Research Triangle Park, NC +1 919-254-7508 (T/L 444-7508) Internet Address: aupperle@us.ibm.com ----- Forwarded by Bryan Aupperle/Raleigh/IBM on 01/14/2008 08:29 AM ----- "Mary McRae" <mary.mcrae@oasis-open.org> Sent by: Mary McRae <marypmcrae@gmail.com> 12/13/2007 05:06 PM Please respond to <mary.mcrae@oasis-open.org> To Bryan Aupperle/Raleigh/IBM@IBMUS cc Subject RE: [sca-j] package names Thanks Bryan, for the info. I hadn?t considered actual executable code. I think replacing osoa with oasis is all that would be required; beyond that I would accept best practice. Most TCs aren?t involved in writing code, or it?s done as an external project and not part of the actual TC work product. I?m glad I asked the question! Mary From: Bryan Aupperle [mailto:aupperle@us.ibm.com] Sent: Thursday, December 13, 2007 4:34 PM To: mary.mcrae@oasis-open.org Subject: RE: [sca-j] package names Packages are a Java concept and are used partition the Java name space to eliminate collisions much the same way namespaces are used in XML. They are hierarchical in nature and there is a direct correspondence between the package name hierarchy and the directory structure in which the classes that belong to packages are stored in a file system. Some examples: java.lang.annotation javax.xml.xpath org.apache.xerces org.eclipse.sdk As I said below, the current one for SCA is org.osoa.sca, but I suspect that this will need to change. There is a similar concept is C++, which is prompting my query. C++ has a namespace construct. It is also hierarchical in nature insofar as one namespace can be nested in another. C++ namespaces have names that are valid C++ identifiers. Currently in C++ we use osoa::sca. I did not find anything in the OASIS material that provided any guidance on this. Bryan Aupperle, Ph.D. STSM, WebSphere Enterprise Platform Software Solution Architect Master Inventor Research Triangle Park, NC +1 919-254-7508 (T/L 444-7508) Internet Address: aupperle@us.ibm.com "Mary McRae" <mary.mcrae@oasis-open.org> Sent by: Mary McRae <marypmcrae@gmail.com> 12/13/2007 01:24 PM Please respond to <mary.mcrae@oasis-open.org> To Bryan Aupperle/Raleigh/IBM@IBMUS cc Subject RE: [sca-j] package names Hi Bryan, Not sure what you mean by ?package names? ? there are TC Admin-approved namespace and URI designs, if that?s what you?re referring to? If not, I?m happy to provide assistance. Regards, Mary From: Bryan Aupperle [mailto:aupperle@us.ibm.com] Sent: Thursday, December 13, 2007 12:11 PM To: sca-j@lists.oasis-open.org Subject: [sca-j] package names I know that this is a minor thing, but has there been any discussion about needing to change the package names from org.osoa.sca... to something else - potentially org.oasis.sca... or org.oasis-open.sca...? Bryan Aupperle, Ph.D. STSM, WebSphere Enterprise Platform Software Solution Architect Research Triangle Park, NC +1 919-254-7508 (T/L 444-7508) Internet Address: aupperle@us.ibm.com 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]