Jump to: navigation, search

Difference between revisions of "COSMOS API Cleanup"

(COSMOS API Cleanup - Housecleaning)
(COSMOS API Cleanup - Housecleaning)
 
(36 intermediate revisions by 3 users not shown)
Line 3: Line 3:
 
This wiki page was constructed in response to https://bugs.eclipse.org/bugs/show_bug.cgi?id=218558.  In preparation for releasing COSMOS 1.0, committers are required to ensure API guidelines are met.  In COSMOS there are three types of APIs:
 
This wiki page was constructed in response to https://bugs.eclipse.org/bugs/show_bug.cgi?id=218558.  In preparation for releasing COSMOS 1.0, committers are required to ensure API guidelines are met.  In COSMOS there are three types of APIs:
 
<br/><br/>
 
<br/><br/>
# <b>Internal</b> - Indicated by having a package name that contains the keyword 'internal' (e.g. org.eclipse.cosmos.dc.cmdbf.services.internal)
+
# <b>Internal</b> - Indicated by having a package name that contains the keyword <b>'internal'</b> (e.g. org.eclipse.cosmos.dc.cmdbf.services.internal)
# <b>Provisional</b> - Indicated by having the annotation '@provisional' included in the class comment
+
# <b>Provisional</b> - Indicated by having a package name that contains the keyword <b>'provisional'</b> (e.g. org.eclipse.cosmos.dc.cmdbf.services.provisional.metadata.transform)
 
# <b>Public</b> - Any API that does not fall under (1) or (2)
 
# <b>Public</b> - Any API that does not fall under (1) or (2)
 
<br/><br/>
 
<br/><br/>
COSMOS 1.0 does not plan to release any public APIs.  All classes are expected to fall under (1) or (2).  Provisional classes MUST be thoroughly commented.  A recent (April 4th, 2008) manual code scan revealed the following plug-ins to be in violation of the guideline.  Package/classes expected to be provisional are indicated by <font color="orange">orange</font> and expected internal APIs are indicated by <font color="red">red</font>.  The final verdict of what should be internal or provisional is made by the component owner.
+
Please see [http://wiki.eclipse.org/COSMOS_API_Contract COSMOS API Contract] for more details.  COSMOS 1.0 does not plan to release any public APIs.  All classes are expected to fall under (1) or (2).  Provisional classes MUST be thoroughly commented.  A recent (April 17, 2008) manual code scan revealed the following plug-ins to be in violation of the guideline.  Package/classes expected to be provisional are indicated by <font color="orange">orange</font> and expected internal APIs are indicated by <font color="red">red</font>.  The final verdict of what should be internal or provisional is made by the component owner.
  
<br/>
+
== Archiving unused code ==
<font color="purple">
+
 
<Ruth>
+
In i11, there will be a new module added to COSMOS' CVS called ('archive') that will contain all plug-ins that are no longer needed.
# Ali, can we look into Bill's bugzilla for this as well? He talks about deprecating any bundles and code that are no longer used, so we should identify those and delete them rather than comment them. [https://bugs.eclipse.org/bugs/show_bug.cgi?id=220776 220776]
+
# Question: Looks like COSMOS does not use experimental APIs in COSMOS. What are the COSMOS guidelines for using provisional vs experimental? [http://www.eclipse.org/projects/dev_process/eclipse-quality.php Eclipse Quality Guidelines]
+
</Ruth>
+
</font>
+
<br/>
+
  
 
<br/><br/>
 
<br/><br/>
Line 29: Line 24:
 
<tr>
 
<tr>
 
<td>
 
<td>
org.eclipse.cosmos.common
+
org.eclipse.cosmos.aperi.mdr.ws
 
</td>
 
</td>
 
<td>
 
<td>
 
<ul>
 
<ul>
<li><font color="red">org.eclipse.cosmos.common</font></li>
+
<li><font color="red">org.eclipse.cosmos.aperi.mdr.ws</font></li>
<li><font color="orange">org.eclipse.cosmos.common.exceptions</font></li>
+
<li><font color="red">org.eclipse.cosmos.aperi.mdr.ws.db</font></li>
 
</ul>
 
</ul>
 
</td>
 
</td>
<td>Hubert Leung</td>
+
<td>Bill Muldoon</td>
 
<td><b><font color="red">No</font></b></td>
 
<td><b><font color="red">No</font></b></td>
</tr>
+
</tr>
 
<tr>
 
<tr>
 
<td>
 
<td>
org.eclipse.cosmos.dc.birt.helper
+
org.eclipse.cosmos.common
</td>
+
<td><ul><li><font color="orange">org.eclipse.cosmos.dc.birt.helper</font></li>
+
</ul>
+
</td>
+
+
<td>Sheldon Lee-Loy</td>
+
<td><b><font color="red">No</font></b></td>
+
+
</tr>
+
<tr>
+
<td>
+
+
org.eclipse.cosmos.dc.broker</td>
+
<td>
+
 
+
<ul>
+
<li><font color="black">org.eclipse.cosmos.dc.broker</font></li>
+
<ul>
+
<li><font color="red">Broker.java</font></li>
+
<li><font color="red">CustomSimpleServiceGroup.java</font></li>
+
<li><font color="orange">IBroker.java</font></li>
+
</ul>
+
</ul>
+
</td>
+
<td>Hubert Leung</td>
+
<td><b><font color="red">No</font></b></td>
+
</tr>
+
<tr>
+
<td>
+
org.eclipse.cosmos.dc.broker.client
+
 
</td>
 
</td>
 
<td>
 
<td>
 
<ul>
 
<ul>
<li><font color="black">org.eclipse.cosmos.dc.broker.client</font></li>
+
<li><font color="red">org.eclipse.cosmos.common</font></li>
<ul>
+
<li><font color="orange">org.eclipse.cosmos.common.exceptions</font></li>
<li><font color="red">Activator.java</font></li>
+
<li><font color="red">BrokerClient.java</font></li>
+
<li><font color="orange">IBrokerClient.java</font></li>
+
</ul>
+
 
</ul>
 
</ul>
 
</td>
 
</td>
<td>Hubert Leung</td>
+
<td>Bill Muldoon</td>
 
<td><b><font color="red">No</font></b></td>
 
<td><b><font color="red">No</font></b></td>
</tr>
+
</tr>
<tr>
+
<td>
+
org.eclipse.cosmos.dc.common
+
</td>
+
<td>
+
<ul>
+
<li><font color="red">org.eclipse.cosmos.dc.common</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.common.api</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.common.api.impl</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.common.domain</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.common.registry</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.common.registry.impl</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.common.registry.impl</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.common.spi</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.common.spi.descriptor</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.common.spi.impl</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.runtime</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.runtime.osgi</font></li>
+
</ul>
+
</td>
+
<td>Joel Hawkins</td>
+
<td><b><font color="red">No</font></b></td>
+
</tr>
+
 
<tr>
 
<tr>
 
<td>
 
<td>
org.eclipse.cosmos.dc.dataManager
+
org.eclipse.cosmos.dc.broker.core
 
</td>
 
</td>
 
<td>
 
<td>
 
<ul>
 
<ul>
<li><font color="red">org.eclipse.cosmos.dc.dataManager</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.broker.ws</font></li>
<li><font color="orange">org.eclipse.cosmos.dc.dataManager.impl</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.broker.ws.persistence</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.broker.ws.client</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.broker.ws.datamodel</font></li>
 
</ul>
 
</ul>
 
</td>
 
</td>
Line 125: Line 65:
 
<tr>
 
<tr>
 
<td>
 
<td>
org.eclipse.cosmos.dc.dataManager.client
+
org.eclipse.cosmos.dc.cmdbf.services
 
</td>
 
</td>
 
<td>
 
<td>
 
<ul>
 
<ul>
<li><font color="black">org.eclipse.cosmos.dc.dataManager.client</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.cmdbfservice</font></li>
<ul>
+
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.common</font></li>
<li><font color="red">Activator.java</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.transform</font></li>
<li><font color="orange">DataManagerClient.java</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.transform.artifacts</font></li>
</ul>
+
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.metadata.transform</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.metadata.transform.input.artifacts</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.query.transform</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.query.transform.artifacts</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.query.transform.input.artifacts</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.query.transform.response.artifacts</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.query.service</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.query.service.impl</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.deregistration.transform</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.deregistration.transform.input.artifacts</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.deregistration.transform.output.artifacts</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.registration.transform</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.registration.transform.input.artifacts</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.registration.transform.output.artifacts</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.common</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.deregistration.service</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.deregistration.service.impl</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.registration.service</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.services.registration.service.impl</font></li>
 
</ul>
 
</ul>
 
</td>
 
</td>
<td>Hubert Leung</td>
+
<td>Ali Mehregani</td>
<td><b><font color="red">No</font></b></td>
+
</tr>
+
<tr>
+
<td>
+
org.eclipse.cosmos.dc.dataManager.common
+
</td>
+
<td>
+
<ul>
+
<li><font color="orange">org.eclipse.cosmos.dc.dataManager.api</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.dataManager.common</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.dataManager.exception</font></li>
+
</ul>
+
</td>
+
<td>Hubert Leung</td>
+
 
<td><b><font color="red">No</font></b></td>
 
<td><b><font color="red">No</font></b></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
 
<td>
 
<td>
org.eclipse.cosmos.dc.local.domain
+
org.eclipse.cosmos.dc.cmdbf.ws
 
</td>
 
</td>
 
<td>
 
<td>
 
<ul>
 
<ul>
<li><font color="red">org.eclipse.cosmos.dc.local.domain</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.exception</font></li>
</ul>
+
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.query.client</font></li>
</td>
+
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.query.ws</font></li>
<td>Joel Hawkins</td>
+
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.receiver</font></li>
<td><b><font color="red">No</font></b></td>
+
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.registration.client</font></li>
</tr>
+
<li><font color="orange">org.eclipse.cosmos.dc.cmdbf.registration.ws</font></li>
<tr>
+
<td>
+
org.eclipse.cosmos.dc.local.registry
+
</td>
+
<td>
+
<ul>
+
<li><font color="red">org.eclipse.cosmos.dc.local.registry</font></li>
+
</ul>
+
</td>
+
<td>Joel Hawkins</td>
+
<td><b><font color="red">No</font></b></td>
+
</tr>
+
<tr>
+
<td>
+
org.eclipse.cosmos.dc.logging.datamgr (Is this necessary?)
+
</td>
+
<td>
+
<ul>
+
<li><font color="red">org.eclipse.cosmos.dc.logging.datamgr</font></li>
+
 
</ul>
 
</ul>
 
</td>
 
</td>
 
<td>Hubert Leung</td>
 
<td>Hubert Leung</td>
 
<td><b><font color="red">No</font></b></td>
 
<td><b><font color="red">No</font></b></td>
</tr>
+
</tr>
 
<tr>
 
<tr>
 
<td>
 
<td>
org.eclipse.cosmos.dc.logging.datamgr.client
+
org.eclipse.cosmos.dc.datamanager.ws
 
</td>
 
</td>
 
<td>
 
<td>
 
<ul>
 
<ul>
<li><font color="red">org.eclipse.cosmos.dc.logging.datamgr.client</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.datamanager.ws</font></li>
 
</ul>
 
</ul>
 
</td>
 
</td>
 
<td>Hubert Leung</td>
 
<td>Hubert Leung</td>
 
<td><b><font color="red">No</font></b></td>
 
<td><b><font color="red">No</font></b></td>
</tr>
+
</tr>
+
 
<tr>
 
<tr>
 
<td>
 
<td>
org.eclipse.cosmos.dc.logging.datamgr.common
+
org.eclipse.cosmos.dc.logging.datamgr.ws
 
</td>
 
</td>
 
<td>
 
<td>
 
<ul>
 
<ul>
<li><font color="red">org.eclipse.cosmos.dc.logging.datamgr.api</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.logging.datamgr.axis</font></li>
<li><font color="red">org.eclipse.cosmos.dc.logging.datamgr.common</font></li>
+
 
</ul>
 
</ul>
 
</td>
 
</td>
<td>Hubert Leung</td>
+
<td>John Todd</td>
 
<td><b><font color="red">No</font></b></td>
 
<td><b><font color="red">No</font></b></td>
 
</tr>
 
</tr>
 
 
<tr>
 
<tr>
 
<td>
 
<td>
org.eclipse.cosmos.dc.logging.datamgr.web
+
org.eclipse.cosmos.dc.logging.datamgr.ws.client
 
</td>
 
</td>
 
<td>
 
<td>
 
<ul>
 
<ul>
<li><font color="red">org.eclipse.cosmos.dc.logging.datamgr</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.logging.datamgr.ws.client</font></li>
 
</ul>
 
</ul>
 
</td>
 
</td>
<td>Hubert Leung</td>
+
<td>John Todd</td>
 
<td><b><font color="red">No</font></b></td>
 
<td><b><font color="red">No</font></b></td>
</tr>
+
</tr>
+
 
<tr>
 
<tr>
 
<td>
 
<td>
org.eclipse.cosmos.dc.management.domain
+
org.eclipse.cosmos.dc.service.finder
 
</td>
 
</td>
 
<td>
 
<td>
 
<ul>
 
<ul>
<li><font color="black">org.eclipse.cosmos.dc.management.domain</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.service.finder</font></li>
<ul>
+
<li><font color="orange">org.eclipse.cosmos.dc.service.finder.datamodel</font></li>
<li><font color="orange">IManagementDomain.java</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.service.finder.client</font></li>
<li><font color="red">ManagementDomain.java</font></li>
+
<li><font color="red">ManagementDomainRegistry.java</font></li>
+
</ul>
+
 
</ul>
 
</ul>
 
</td>
 
</td>
 
<td>Hubert Leung</td>
 
<td>Hubert Leung</td>
 
<td><b><font color="red">No</font></b></td>
 
<td><b><font color="red">No</font></b></td>
</tr>
+
</tr>
+
 
<tr>
 
<tr>
 
<td>
 
<td>
org.eclipse.cosmos.dc.management.domain.client
+
org.eclipse.cosmos.dc.stat.datamgr.ws
 
</td>
 
</td>
 
<td>
 
<td>
 
<ul>
 
<ul>
<li><font color="black">org.eclipse.cosmos.dc.management.domain.client</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.stat.datamgr.axis</font></li>
<ul>
+
<li><font color="red">Activator.java</font></li>
+
<li><font color="orange">IManagementDomainClient.java</font></li>
+
<li><font color="red">ManagementDomainClient.java</font></li>
+
</ul>
+
 
</ul>
 
</ul>
 
</td>
 
</td>
<td>Hubert Leung</td>
+
<td>John Todd</td>
 
<td><b><font color="red">No</font></b></td>
 
<td><b><font color="red">No</font></b></td>
 
</tr>
 
</tr>
 
<tr>
 
<td>
 
org.eclipse.cosmos.dc.mdr
 
</td>
 
<td>
 
<ul>
 
<li><font color="red">org.eclipse.cosmos.dc.mdr</font></li>
 
<li><font color="orange">org.eclipse.cosmos.dc.mdr.impl</font></li>
 
</ul>
 
</td>
 
<td>Hubert Leung</td>
 
<td><b><font color="red">No</font></b></td>
 
</tr>
 
 
 
<tr>
 
<tr>
 
<td>
 
<td>
org.eclipse.cosmos.dc.mdr.client
+
org.eclipse.cosmos.dc.stat.datamgr.ws.client
 
</td>
 
</td>
 
<td>
 
<td>
 
<ul>
 
<ul>
<li><font color="black">org.eclipse.cosmos.dc.mdr.client</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.stat.datamgr.ws.client</font></li>
<ul>
+
<li><font color="red">Activator.java</font></li>
+
<li><font color="orange">MdrClient.java</font></li>
+
</ul>
+
 
</ul>
 
</ul>
 
</td>
 
</td>
<td>Hubert Leung</td>
+
<td>John Todd</td>
 
<td><b><font color="red">No</font></b></td>
 
<td><b><font color="red">No</font></b></td>
 
</tr>
 
</tr>
 
 
<tr>
 
<tr>
 
<td>
 
<td>
org.eclipse.cosmos.dc.mdr.common
+
org.eclipse.cosmos.dc.stat.datamgr.ws.common
 
</td>
 
</td>
 
<td>
 
<td>
 
<ul>
 
<ul>
<li><font color="orange">org.eclipse.cosmos.dc.mdr.api</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.stat.datamgr.ws.common</font></li>
<li><font color="red">org.eclipse.cosmos.dc.mdr.common</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.mdr.exception</font></li>
+
 
</ul>
 
</ul>
 
</td>
 
</td>
<td>Hubert Leung</td>
+
<td>John Todd</td>
<td><b><font color="red">No</font></b></td>
+
</tr>
+
+
<tr>
+
<td>
+
org.eclipse.cosmos.dc.mgmt.common (Is this necessary?)
+
</td>
+
<td>
+
<ul>
+
<li><font color="orange">org.eclipse.cosmos.dc.mgmt.annotations</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.mgmt.api</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.mgmt.binding</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.mgmt.common</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.mgmt.common.util</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.mgmt.osgi</font></li>
+
</ul>
+
</td>
+
<td>Joel Hawkins</td>
+
<td><b><font color="red">No</font></b></td>
+
</tr>
+
+
<tr>
+
<td>
+
org.eclipse.cosmos.dc.mgmt.wsdm (Is this necessary?)
+
</td>
+
<td>
+
<ul>
+
<li><font color="orange">org.eclipse.cosmos.dc.mgmt.provisional.wsdm.capabilities</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.mgmt.provisional.wsdm.impl</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.mgmt.provisional.wsdm.impl.info</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.mgmt.provisional.wsdm.persistence</font></li>
+
<li><font color="orange">org.eclipse.cosmos.dc.mgmt.provisional.wsdm.util</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.mgmt.serializer</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.mgmt.wsdm.osgi</font></li>
+
</ul>
+
</td>
+
<td>Joel Hawkins</td>
+
<td><b><font color="red">No</font></b></td>
+
</tr>
+
+
<tr>
+
<td>
+
org.eclipse.cosmos.dc.remote.wsdm (Is this necessary?)
+
</td>
+
<td>
+
<ul>
+
<li><font color="red">org.eclipse.cosmos.dc.remote.wsdm</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.remote.wsdm.api</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.remote.wsdm.registry</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.remote.wsdm.spec</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.remote.wsdm.spi</font></li>
+
</ul>
+
</td>
+
<td>Joel Hawkins</td>
+
<td><b><font color="red">No</font></b></td>
+
</tr>
+
+
<tr>
+
<td>
+
org.eclipse.cosmos.dc.sample.components
+
</td>
+
<td>
+
<ul>
+
<li><font color="red">org.eclipse.cosmos.dc.sample.components</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.sample.components.filter</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.sample.components.persistence.sql</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.sample.components.query</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.sample.components.sink</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.sample.components.sink.cbe</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.sample.components.sink.cbe.wrapper</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.sample.components.source</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.sample.persistence.impl</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.sample.types</font></li>
+
+
</ul>
+
</td>
+
<td>Joel Hawkins</td>
+
<td><b><font color="red">No</font></b></td>
+
</tr>
+
+
<tr>
+
<td>
+
org.eclipse.cosmos.dc.sample.configurations (Is this necessary?)
+
</td>
+
<td>
+
<ul>
+
<li><font color="red">org.eclipse.cosmos.dc.sample.configurations</font></li>
+
</ul>
+
</td>
+
<td>Joel Hawkins</td>
+
<td><b><font color="red">No</font></b></td>
+
</tr>
+
+
<tr>
+
<td>
+
org.eclipse.cosmos.dc.sample.jpa (Is this necessary?)
+
</td>
+
<td>
+
<ul>
+
<li><font color="red">org.eclipse.cosmos.dc.sample.jpa</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.sample.jpa.cbe.entity</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.sample.jpa.query</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.sample.jpa.sink</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.sample.jpa.stat.entity</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.sample.jpa.wef.entity</font></li>
+
</ul>
+
</td>
+
<td>Joel Hawkins</td>
+
<td><b><font color="red">No</font></b></td>
+
</tr>
+
+
<tr>
+
<td>
+
org.eclipse.cosmos.dc.spec
+
</td>
+
<td>
+
<ul>
+
<li><font color="red">org.eclipse.cosmos.dc.spec</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.spec.capabilitiy</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.spec.types</font></li>
+
</ul>
+
</td>
+
<td>Joel Hawkins</td>
+
<td><b><font color="red">No</font></b></td>
+
</tr>
+
+
<tr>
+
<td>
+
org.eclipse.cosmos.dc.stat.datamgr (Is this necessary?)
+
</td>
+
<td>
+
<ul>
+
<li><font color="red">org.eclipse.cosmos.dc.stat.datamgr</font></li>
+
</ul>
+
</td>
+
<td>Hubert Leung</td>
+
<td><b><font color="red">No</font></b></td>
+
</tr>
+
+
<tr>
+
<td>
+
org.eclipse.cosmos.dc.stat.datamgr.client
+
</td>
+
<td>
+
<ul>
+
<li><font color="red">org.eclipse.cosmos.dc.stat.datamgr.client</font></li>
+
</ul>
+
</td>
+
<td>Hubert Leung</td>
+
<td><b><font color="red">No</font></b></td>
+
</tr>
+
+
<tr>
+
<td>
+
org.eclipse.cosmos.dc.stat.datamgr.common
+
</td>
+
<td>
+
<ul>
+
<li><font color="red">org.eclipse.cosmos.dc.stat.datamgr.api</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.stat.datamgr.common</font></li>
+
</ul>
+
</td>
+
<td>Hubert Leung</td>
+
<td><b><font color="red">No</font></b></td>
+
</tr>
+
+
<tr>
+
<td>
+
org.eclipse.cosmos.dc.stat.datamgr.web
+
</td>
+
<td>
+
<ul>
+
<li><font color="red">org.eclipse.cosmos.dc.stat.datamgr</font></li>
+
</ul>
+
</td>
+
<td>Hubert Leung</td>
+
<td><b><font color="red">No</font></b></td>
+
</tr>
+
+
<tr>
+
<td>
+
org.eclipse.cosmos.dc.tptp.agentcontroller
+
</td>
+
<td>
+
<ul>
+
<li><font color="red">org.eclipse.cosmos.dc.tptp.agent</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.tptp.agent.component</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.tptp.agentcontroller</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.tptp.agentcontroller.internal</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.tptp.console</font></li>
+
</ul>
+
</td>
+
<td>Hubert Leung</td>
+
<td><b><font color="red">No</font></b></td>
+
</tr>
+
+
<tr>
+
<td>
+
org.eclipse.cosmos.dc.tptp.gla.components
+
</td>
+
<td>
+
<ul>
+
<li><font color="red">org.eclipse.cosmos.dc.tptp.gla.components</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.tptp.gla.components.source</font></li>
+
<li><font color="red">org.eclipse.cosmos.dc.tptp.gla.components.transform</font></li>
+
</ul>
+
</td>
+
<td>Hubert Leung</td>
+
<td><b><font color="red">No</font></b></td>
+
</tr>
+
+
<tr>
+
<td>
+
org.eclipse.cosmos.example.mdr.web
+
</td>
+
<td>
+
<ul>
+
<li><font color="red">org.eclipse.cosmos.example.mdr.web</font></li>
+
</ul>
+
</td>
+
<td>Hubert Leung</td>
+
 
<td><b><font color="red">No</font></b></td>
 
<td><b><font color="red">No</font></b></td>
 
</tr>
 
</tr>
 
</table>
 
</table>
+
<br/>
<h2>Data Visualization</h2>
+
 
 +
=== Archived Bundles ===
 +
The following plug-ins will be archived:
 +
 
 +
#org.eclipse.cosmos.dc.birt.helper
 +
#org.eclipse.cosmos.dc.broker
 +
#org.eclipse.cosmos.dc.broker.client
 +
#org.eclipse.cosmos.dc.common
 +
#org.eclipse.cosmos.dc.dataManager
 +
#org.eclipse.cosmos.dc.dataManager.client
 +
#org.eclipse.cosmos.dc.dataManager.common
 +
#org.eclipse.cosmos.dc.local.domain
 +
#org.eclipse.cosmos.dc.local.registry
 +
#org.eclipse.cosmos.dc.logging.datamgr
 +
#org.eclipse.cosmos.dc.logging.datamgr.client
 +
#org.eclipse.cosmos.dc.logging.datamgr.common
 +
#org.eclipse.cosmos.dc.logging.datamgr.web
 +
#org.eclipse.cosmos.dc.management.domain
 +
#org.eclipse.cosmos.dc.management.domain.client
 +
#org.eclipse.cosmos.dc.mdr
 +
#org.eclipse.cosmos.dc.mdr.client
 +
#org.eclipse.cosmos.dc.mdr.common
 +
#org.eclipse.cosmos.dc.mdr.registration
 +
#org.eclipse.cosmos.dc.mdr.registration.client
 +
#org.eclipse.cosmos.dc.mdr.registration.common
 +
#org.eclipse.cosmos.dc.remote.wsdm
 +
#org.eclipse.cosmos.dc.sample.components
 +
#org.eclipse.cosmos.dc.sample.configurations
 +
#org.eclipse.cosmos.dc.sample.jpa
 +
#org.eclipse.cosmos.dc.spec
 +
#org.eclipse.cosmos.dc.stat.datamgr
 +
#org.eclipse.cosmos.dc.stat.datamgr.client
 +
#org.eclipse.cosmos.dc.stat.datamgr.common
 +
#org.eclipse.cosmos.dc.stat.datamgr.web
 +
#org.eclipse.cosmos.dc.tptp.agentcontroller
 +
#org.eclipse.cosmos.dc.tptp.gla.components
 +
#org.eclipse.cosmos.example.mdr.web
 +
#org.eclipse.cosmos.management.common
 +
#org.eclipse.cosmos.management.wsdm
 +
#org.eclipse.cosmos.tptp.dependencies
 +
 
 +
 
 +
=== Re-structuring ===
 +
 
 +
<table border="1" width="100%">
 +
<tr>
 +
  <th>Plug-ins</th>
 +
  <th>Description</th>
 +
  <th>Assignee</th>
 +
  <th>Complete</th>
 +
</tr>
 +
 
 +
<tr>
 +
  <td>
 +
* org.eclipse.cosmos.dc.stat.datamgr.ws
 +
* org.eclipse.cosmos.dc.stat.datamgr.ws.client
 +
* org.eclipse.cosmos.dc.stat.datamgr.ws.common
 +
  </td>
 +
 
 +
  <td>Merge 3 plug-ins into one</td>
 +
  <td>John Todd</td>
 +
  <td><font color="red">No</font></td>
 +
</tr>
 +
 
 +
<tr>
 +
  <td>
 +
* org.eclipse.cosmos.dc.logging.datamgr.ws
 +
* org.eclipse.cosmos.dc.logging.datamgr.ws.client
 +
  </td>
 +
  <td> Merge 2 plug-ins into one</td>
 +
  <td> John Todd</td>
 +
  <td><font color="red">No</font></td>
 +
</tr>
 +
</table>
 +
 
 +
<h2>Data Visualization</h2>
 
<table border="1" width="100%">
 
<table border="1" width="100%">
 
<tr>
 
<tr>
Line 544: Line 288:
 
<tr>
 
<tr>
 
<td>
 
<td>
org.eclipse.cosmos.dr.drs.service.handler
+
org.eclipse.cosmos.dr.web.ui.viewer
 
</td>
 
</td>
 
<td>
 
<td>
 
<ul>
 
<ul>
<li><font color="orange">org.eclipse.cosmos.provisional.dr.drs.service.handler.cmdbf</font></li>
+
<li><font color="red">org.eclipse.cosmos.dr.web.ui.viewer</font></li>
<li><font color="orange">org.eclipse.cosmos.provisional.dr.drs.service.handler.common</font></li>
+
 
</ul>
 
</ul>
 
</td>
 
</td>
 
<td>Sheldon Lee-Loy</td>
 
<td>Sheldon Lee-Loy</td>
 
<td><b><font color="red">No</font></b></td>
 
<td><b><font color="red">No</font></b></td>
</tr>
+
</tr>
+
<tr>
+
<td>
+
org.eclipse.cosmos.dr.ps.common
+
</td>
+
<td>
+
<ul>
+
<li><font color="orange">org.eclipse.cosmos.provisional.dr.ps.common</font></li>
+
</ul>
+
</td>
+
<td>Sheldon Lee-Loy</td>
+
<td><b><font color="red">No</font></b></td>
+
</tr>
+
 
</table>
 
</table>
+
 
<h2>Management Enablement</h2>
+
=== Archived Bundles ===
 +
The following plug-ins will be archived:
 +
#org.eclipse.cosmos.dr.build
 +
#org.eclipse.cosmos.dr.drs.service.handler.php
 +
#org.eclipse.cosmos.dr.gvs.report.viewer
 +
#org.eclipse.cosmos.examples.e2e.dr.gvs.report.viewer
 +
 
 +
=== Restructuring ===
 +
The DV bundles are split between the data reporting and the examples/end2end directories.  Sheldon has agreed to move all core components from the example module (if any) to the data-reporting module.
 +
 
 +
<h2>Management Enablement</h2>
 
<table border="1" width="100%">
 
<table border="1" width="100%">
 
<tr>
 
<tr>
Line 586: Line 326:
 
<ul>
 
<ul>
 
<li><font color="orange">org.eclipse.cosmos.me.dmtoolkit.common</font></li>
 
<li><font color="orange">org.eclipse.cosmos.me.dmtoolkit.common</font></li>
<li><font color="red">org.eclipse.jface.snippets.viewers (was this copied from JFace?)</font></li>
 
 
</ul>
 
</ul>
 
</td>
 
</td>
Line 593: Line 332:
 
</tr>
 
</tr>
 
 
<tr>
+
<tr>
 
<td>
 
<td>
 
org.eclipse.cosmos.me.dmtoolkit.j2ee
 
org.eclipse.cosmos.me.dmtoolkit.j2ee
Line 656: Line 395:
 
</tr>
 
</tr>
 
</table>
 
</table>
+
 
<h2>Resource Modeling</h2>
+
 
 +
=== Re-structuring ===
 +
 
 +
The toolkit plug-ins can reside under one plug-in:
 +
This will reduce 2 plug-ins into one.
 +
 
 +
org.eclipse.cosmos.me.dmtoolkit
 +
  |__ org.eclipse.cosmos.me.dmtoolkit.common
 +
  |__ org.eclipse.cosmos.me.dmtoolkit.j2ee
 +
 
 +
<h2>Resource Modeling</h2>
 
<table border="1" width="100%">
 
<table border="1" width="100%">
 
<tr>
 
<tr>
Line 667: Line 416:
 
<tr>
 
<tr>
 
<td>
 
<td>
org.eclipse.cosmos.rm.sml.mdr (Is this necessary?)
+
org.eclipse.cosmos.rm.repository
 
</td>
 
</td>
 
<td>
 
<td>
 
<ul>
 
<ul>
<li><font color="red">org.eclipse.cosmos.rm.sml.mdr</font></li>
+
<li><font color="orange">org.eclipse.cosmos.rm.repository.core</font></li>
<li><font color="red">org.eclipse.cosmos.rm.sml.mdr.impl</font></li>
+
<li><font color="orange">org.eclipse.cosmos.rm.repository.exception</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.rm.repository.operations</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.rm.repository.operations.cmdbf</font></li>
 +
<li><font color="orange">org.eclipse.cosmos.rm.repository.resource</font></li>
 
</ul>
 
</ul>
 
</td>
 
</td>
<td>Hubert Leung</td>
+
<td>Ali Mehregani</td>
 
<td><b><font color="red">No</font></b></td>
 
<td><b><font color="red">No</font></b></td>
</tr>
+
</tr>
+
 
<tr>
 
<tr>
 
<td>
 
<td>
org.eclipse.cosmos.rm.sml.mdr.web
+
org.eclipse.cosmos.rm.sml.mdr.ws
 
</td>
 
</td>
 
<td>
 
<td>
 
<ul>
 
<ul>
<li><font color="red">org.eclipse.cosmos.rm.sml.mdr</font></li>
+
<li><font color="red">org.eclipse.cosmos.rm.sml.mdr.ws</font></li>
<li><font color="red">org.eclipse.cosmos.rm.sml.mdr.impl</font></li>
+
 
</ul>
 
</ul>
 
</td>
 
</td>
Line 693: Line 443:
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
<br/>
 +
 +
=== Archived Bundles ===
 +
 +
The following plug-ins will be archived:
 +
 +
#org.eclipse.cosmos.rm.sml.mdr
 +
#org.eclipse.cosmos.rm.sml.mdr.web
 +
 +
== Defects ==
 +
The following defects have been opened to handle the work required for this effort:
 +
<table border="1" width="50%">
 +
<tr>
 +
<th>Bug</th>
 +
<th>Owner</th>
 +
</tr>
 +
 +
<tr>
 +
<td>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=229959 229959]</td>
 +
<td>Ali Mehregani</td>
 +
</tr>
 +
 +
<tr>
 +
<td>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=229962 229962] </td>
 +
<td>David Whiteman</td>
 +
</tr>
 +
 +
<tr>
 +
<td>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=229958 229958] </td>
 +
<td>Hubert Leung</td>
 +
</tr>
 +
 +
<tr>
 +
<td>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=229964 229964]</td>
 +
<td>Joel Hawkins</td>
 +
</tr>
 +
 +
<tr>
 +
<td>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=229961 229961]</td>
 +
<td>Sheldon Lee-Loy</td>
 +
</tr>
 +
 +
<tr>
 +
<td>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=229960 229960]</td>
 +
<td>John Todd</td>
 +
</tr>
 +
 +
<tr>
 +
<td>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=229957 229957]</td>
 +
<td>Bill Muldoon</td>
 +
</tr>
 +
</table>
  
 
== Open Questions/Concerns ==
 
== Open Questions/Concerns ==
Harm Sluiman:
+
<b>Harm Sluiman:</b>
  
 
It seems the package provisional idea is being skipped and that is the most common form of provisional in Eclipse. Note TPTP introduced the concept of javadoc provisional only as a transient state where api was stable but behavior was not and testing or documentation was not complete. If you only have one provisional state, I strongly suggest you use the package variant.
 
It seems the package provisional idea is being skipped and that is the most common form of provisional in Eclipse. Note TPTP introduced the concept of javadoc provisional only as a transient state where api was stable but behavior was not and testing or documentation was not complete. If you only have one provisional state, I strongly suggest you use the package variant.
  
<font color="green">Will be discussed in the next architecture call</font>
+
<font color="green">COSMOS decided to indicate provisional APIs by including the 'provisional' keyword in the package name</font>
  
 +
<b>Ruth Lee</b>
 +
# Ali, can we look into Bill's bugzilla for this as well? He talks about deprecating any bundles and code that are no longer used, so we should identify those and delete them rather than comment them. [https://bugs.eclipse.org/bugs/show_bug.cgi?id=220776 220776]
 +
# Question: Looks like COSMOS does not use experimental APIs in COSMOS. What are the COSMOS guidelines for using provisional vs experimental? [http://www.eclipse.org/projects/dev_process/eclipse-quality.php Eclipse Quality Guidelines]
  
  
[[Category:COSMOS_Development_Guide]]
+
<font color="green">
 +
Regarding bug [https://bugs.eclipse.org/bugs/show_bug.cgi?id=220776 220776]: <br/>
 +
>1. Deprecate any bundles and code that are no longer used. <br/>
 +
> a. DC assemblies <br/>
 +
> b. the "old" annotations <br/>
 +
Addressed <br/><br/>
 +
 
 +
>2. Re-organize the directory structure to group logically related bundles together <br/>
 +
> a. The Example MDR bundle for OSGI is in the Examples directory but the Example MDR for the web is in the DC directory. They should reside together. <br/>
 +
Addressed <br/><br/>
 +
 
 +
> b. All data managers should be grouped into a single directory. <br/>
 +
Addressed <br/><br/>
 +
 
 +
> c. The BIRT helper bundle belongs in the data reporting (not in DC)<br/>
 +
Addressed<br/><br/>
 +
 
 +
> d. All the CMDBf components (CMDBf services, tooling, registration example, and the MDRs) belong in the same directory <br/>
 +
Addressed<br/><br/>
 +
 
 +
> e. The DV bundles are split between the data reporting and the examples/end2end directories <br/>
 +
Addressed<br/><br/>
 +
 
 +
> f. We have a common tests directory with subdirectories for each subproject. Should we move each of these subdirectories into a tests directory under their respective subprojects?<br/>
 +
Community collectively decided to keep the current structure<br/><br/>
 +
 
 +
Second question has already been raised by Harm and will be discussed during the next architecture call
 +
 
 +
</font>
 +
 
 +
[[Category:COSMOS]]

Latest revision as of 09:13, 13 May 2008

COSMOS API Cleanup - Housecleaning

This wiki page was constructed in response to https://bugs.eclipse.org/bugs/show_bug.cgi?id=218558. In preparation for releasing COSMOS 1.0, committers are required to ensure API guidelines are met. In COSMOS there are three types of APIs:

  1. Internal - Indicated by having a package name that contains the keyword 'internal' (e.g. org.eclipse.cosmos.dc.cmdbf.services.internal)
  2. Provisional - Indicated by having a package name that contains the keyword 'provisional' (e.g. org.eclipse.cosmos.dc.cmdbf.services.provisional.metadata.transform)
  3. Public - Any API that does not fall under (1) or (2)



Please see COSMOS API Contract for more details. COSMOS 1.0 does not plan to release any public APIs. All classes are expected to fall under (1) or (2). Provisional classes MUST be thoroughly commented. A recent (April 17, 2008) manual code scan revealed the following plug-ins to be in violation of the guideline. Package/classes expected to be provisional are indicated by orange and expected internal APIs are indicated by red. The final verdict of what should be internal or provisional is made by the component owner.

Archiving unused code

In i11, there will be a new module added to COSMOS' CVS called ('archive') that will contain all plug-ins that are no longer needed.



Data Collection

Violating Plug-ins Packages/Classes Assignee Complete

org.eclipse.cosmos.aperi.mdr.ws

  • org.eclipse.cosmos.aperi.mdr.ws
  • org.eclipse.cosmos.aperi.mdr.ws.db
Bill Muldoon No

org.eclipse.cosmos.common

  • org.eclipse.cosmos.common
  • org.eclipse.cosmos.common.exceptions
Bill Muldoon No

org.eclipse.cosmos.dc.broker.core

  • org.eclipse.cosmos.dc.broker.ws
  • org.eclipse.cosmos.dc.broker.ws.persistence
  • org.eclipse.cosmos.dc.broker.ws.client
  • org.eclipse.cosmos.dc.broker.ws.datamodel
Hubert Leung No

org.eclipse.cosmos.dc.cmdbf.services

  • org.eclipse.cosmos.dc.cmdbf.services.cmdbfservice
  • org.eclipse.cosmos.dc.cmdbf.services.common
  • org.eclipse.cosmos.dc.cmdbf.services.transform
  • org.eclipse.cosmos.dc.cmdbf.services.transform.artifacts
  • org.eclipse.cosmos.dc.cmdbf.services.metadata.transform
  • org.eclipse.cosmos.dc.cmdbf.services.metadata.transform.input.artifacts
  • org.eclipse.cosmos.dc.cmdbf.services.query.transform
  • org.eclipse.cosmos.dc.cmdbf.services.query.transform.artifacts
  • org.eclipse.cosmos.dc.cmdbf.services.query.transform.input.artifacts
  • org.eclipse.cosmos.dc.cmdbf.services.query.transform.response.artifacts
  • org.eclipse.cosmos.dc.cmdbf.services.query.service
  • org.eclipse.cosmos.dc.cmdbf.services.query.service.impl
  • org.eclipse.cosmos.dc.cmdbf.services.deregistration.transform
  • org.eclipse.cosmos.dc.cmdbf.services.deregistration.transform.input.artifacts
  • org.eclipse.cosmos.dc.cmdbf.services.deregistration.transform.output.artifacts
  • org.eclipse.cosmos.dc.cmdbf.services.registration.transform
  • org.eclipse.cosmos.dc.cmdbf.services.registration.transform.input.artifacts
  • org.eclipse.cosmos.dc.cmdbf.services.registration.transform.output.artifacts
  • org.eclipse.cosmos.dc.cmdbf.services.common
  • org.eclipse.cosmos.dc.cmdbf.services.deregistration.service
  • org.eclipse.cosmos.dc.cmdbf.services.deregistration.service.impl
  • org.eclipse.cosmos.dc.cmdbf.services.registration.service
  • org.eclipse.cosmos.dc.cmdbf.services.registration.service.impl
Ali Mehregani No

org.eclipse.cosmos.dc.cmdbf.ws

  • org.eclipse.cosmos.dc.cmdbf.exception
  • org.eclipse.cosmos.dc.cmdbf.query.client
  • org.eclipse.cosmos.dc.cmdbf.query.ws
  • org.eclipse.cosmos.dc.cmdbf.receiver
  • org.eclipse.cosmos.dc.cmdbf.registration.client
  • org.eclipse.cosmos.dc.cmdbf.registration.ws
Hubert Leung No

org.eclipse.cosmos.dc.datamanager.ws

  • org.eclipse.cosmos.dc.datamanager.ws
Hubert Leung No

org.eclipse.cosmos.dc.logging.datamgr.ws

  • org.eclipse.cosmos.dc.logging.datamgr.axis
John Todd No

org.eclipse.cosmos.dc.logging.datamgr.ws.client

  • org.eclipse.cosmos.dc.logging.datamgr.ws.client
John Todd No

org.eclipse.cosmos.dc.service.finder

  • org.eclipse.cosmos.dc.service.finder
  • org.eclipse.cosmos.dc.service.finder.datamodel
  • org.eclipse.cosmos.dc.service.finder.client
Hubert Leung No

org.eclipse.cosmos.dc.stat.datamgr.ws

  • org.eclipse.cosmos.dc.stat.datamgr.axis
John Todd No

org.eclipse.cosmos.dc.stat.datamgr.ws.client

  • org.eclipse.cosmos.dc.stat.datamgr.ws.client
John Todd No

org.eclipse.cosmos.dc.stat.datamgr.ws.common

  • org.eclipse.cosmos.dc.stat.datamgr.ws.common
John Todd No


Archived Bundles

The following plug-ins will be archived:

  1. org.eclipse.cosmos.dc.birt.helper
  2. org.eclipse.cosmos.dc.broker
  3. org.eclipse.cosmos.dc.broker.client
  4. org.eclipse.cosmos.dc.common
  5. org.eclipse.cosmos.dc.dataManager
  6. org.eclipse.cosmos.dc.dataManager.client
  7. org.eclipse.cosmos.dc.dataManager.common
  8. org.eclipse.cosmos.dc.local.domain
  9. org.eclipse.cosmos.dc.local.registry
  10. org.eclipse.cosmos.dc.logging.datamgr
  11. org.eclipse.cosmos.dc.logging.datamgr.client
  12. org.eclipse.cosmos.dc.logging.datamgr.common
  13. org.eclipse.cosmos.dc.logging.datamgr.web
  14. org.eclipse.cosmos.dc.management.domain
  15. org.eclipse.cosmos.dc.management.domain.client
  16. org.eclipse.cosmos.dc.mdr
  17. org.eclipse.cosmos.dc.mdr.client
  18. org.eclipse.cosmos.dc.mdr.common
  19. org.eclipse.cosmos.dc.mdr.registration
  20. org.eclipse.cosmos.dc.mdr.registration.client
  21. org.eclipse.cosmos.dc.mdr.registration.common
  22. org.eclipse.cosmos.dc.remote.wsdm
  23. org.eclipse.cosmos.dc.sample.components
  24. org.eclipse.cosmos.dc.sample.configurations
  25. org.eclipse.cosmos.dc.sample.jpa
  26. org.eclipse.cosmos.dc.spec
  27. org.eclipse.cosmos.dc.stat.datamgr
  28. org.eclipse.cosmos.dc.stat.datamgr.client
  29. org.eclipse.cosmos.dc.stat.datamgr.common
  30. org.eclipse.cosmos.dc.stat.datamgr.web
  31. org.eclipse.cosmos.dc.tptp.agentcontroller
  32. org.eclipse.cosmos.dc.tptp.gla.components
  33. org.eclipse.cosmos.example.mdr.web
  34. org.eclipse.cosmos.management.common
  35. org.eclipse.cosmos.management.wsdm
  36. org.eclipse.cosmos.tptp.dependencies


Re-structuring

Plug-ins Description Assignee Complete
  • org.eclipse.cosmos.dc.stat.datamgr.ws
  • org.eclipse.cosmos.dc.stat.datamgr.ws.client
  • org.eclipse.cosmos.dc.stat.datamgr.ws.common
Merge 3 plug-ins into one John Todd No
  • org.eclipse.cosmos.dc.logging.datamgr.ws
  • org.eclipse.cosmos.dc.logging.datamgr.ws.client
Merge 2 plug-ins into one John Todd No

Data Visualization

Violating Plug-ins Packages/Classes Assignee Complete

org.eclipse.cosmos.dr.web.ui.viewer

  • org.eclipse.cosmos.dr.web.ui.viewer
Sheldon Lee-Loy No

Archived Bundles

The following plug-ins will be archived:

  1. org.eclipse.cosmos.dr.build
  2. org.eclipse.cosmos.dr.drs.service.handler.php
  3. org.eclipse.cosmos.dr.gvs.report.viewer
  4. org.eclipse.cosmos.examples.e2e.dr.gvs.report.viewer

Restructuring

The DV bundles are split between the data reporting and the examples/end2end directories. Sheldon has agreed to move all core components from the example module (if any) to the data-reporting module.

Management Enablement

Violating Plug-ins Packages/Classes Assignee Complete

org.eclipse.cosmos.me.dmtoolkit.common

  • org.eclipse.cosmos.me.dmtoolkit.common
David Whiteman No

org.eclipse.cosmos.me.dmtoolkit.j2ee

  • org.eclipse.cosmos.me.dmtoolkit.j2ee
  • org.eclipse.cosmos.me.dmtoolkit.j2ee.delegates
  • org.eclipse.cosmos.me.dmtoolkit.j2ee.factory
  • org.eclipse.cosmos.me.dmtoolkit.j2ee.ui
  • org.eclipse.cosmos.me.dmtoolkit.j2ee.util
David Whiteman No

org.eclipse.cosmos.me.management.common

  • org.eclipse.cosmos.me.management.annotations
  • org.eclipse.cosmos.me.management.api
  • org.eclipse.cosmos.me.management.binding
  • org.eclipse.cosmos.me.management.common
  • org.eclipse.cosmos.me.management.common.info
  • org.eclipse.cosmos.me.management.common.util
  • org.eclipse.cosmos.me.management.osgi
  • org.eclipse.cosmos.me.management.web
Joel Hawkins No

org.eclipse.cosmos.me.management.wsdm

  • org.eclipse.cosmos.me.management.provisional.wsdm
  • org.eclipse.cosmos.me.management.provisional.wsdm.annotations
  • org.eclipse.cosmos.me.management.provisional.wsdm.capabilities
  • org.eclipse.cosmos.me.management.provisional.wsdm.capabilities.impl
  • org.eclipse.cosmos.me.management.provisional.wsdm.faults
  • org.eclipse.cosmos.me.management.provisional.wsdm.impl
  • org.eclipse.cosmos.me.management.provisional.wsdm.impl.info
  • org.eclipse.cosmos.me.management.provisional.wsdm.persistence
  • org.eclipse.cosmos.me.management.provisional.wsdm.util
  • org.eclipse.cosmos.me.management.provisional.wsrf.capabilities
  • org.eclipse.cosmos.me.management.provisional.wsrf.capabilities.impl
  • org.eclipse.cosmos.me.management.provisional.wsrf.faults
  • org.eclipse.cosmos.me.management.wsdm.osgi
  • org.eclipse.cosmos.me.management.wsdm.web
Joel Hawkins No


Re-structuring

The toolkit plug-ins can reside under one plug-in: This will reduce 2 plug-ins into one.

org.eclipse.cosmos.me.dmtoolkit
  |__ org.eclipse.cosmos.me.dmtoolkit.common
  |__ org.eclipse.cosmos.me.dmtoolkit.j2ee

Resource Modeling

Violating Plug-ins Packages/Classes Assignee Complete

org.eclipse.cosmos.rm.repository

  • org.eclipse.cosmos.rm.repository.core
  • org.eclipse.cosmos.rm.repository.exception
  • org.eclipse.cosmos.rm.repository.operations
  • org.eclipse.cosmos.rm.repository.operations.cmdbf
  • org.eclipse.cosmos.rm.repository.resource
Ali Mehregani No

org.eclipse.cosmos.rm.sml.mdr.ws

  • org.eclipse.cosmos.rm.sml.mdr.ws
Hubert Leung No


Archived Bundles

The following plug-ins will be archived:

  1. org.eclipse.cosmos.rm.sml.mdr
  2. org.eclipse.cosmos.rm.sml.mdr.web

Defects

The following defects have been opened to handle the work required for this effort:

Bug Owner
229959 Ali Mehregani
229962 David Whiteman
229958 Hubert Leung
229964 Joel Hawkins
229961 Sheldon Lee-Loy
229960 John Todd
229957 Bill Muldoon

Open Questions/Concerns

Harm Sluiman:

It seems the package provisional idea is being skipped and that is the most common form of provisional in Eclipse. Note TPTP introduced the concept of javadoc provisional only as a transient state where api was stable but behavior was not and testing or documentation was not complete. If you only have one provisional state, I strongly suggest you use the package variant.

COSMOS decided to indicate provisional APIs by including the 'provisional' keyword in the package name

Ruth Lee

  1. Ali, can we look into Bill's bugzilla for this as well? He talks about deprecating any bundles and code that are no longer used, so we should identify those and delete them rather than comment them. 220776
  2. Question: Looks like COSMOS does not use experimental APIs in COSMOS. What are the COSMOS guidelines for using provisional vs experimental? Eclipse Quality Guidelines


Regarding bug 220776:
>1. Deprecate any bundles and code that are no longer used.
> a. DC assemblies
> b. the "old" annotations
Addressed

>2. Re-organize the directory structure to group logically related bundles together
> a. The Example MDR bundle for OSGI is in the Examples directory but the Example MDR for the web is in the DC directory. They should reside together.
Addressed

> b. All data managers should be grouped into a single directory.
Addressed

> c. The BIRT helper bundle belongs in the data reporting (not in DC)
Addressed

> d. All the CMDBf components (CMDBf services, tooling, registration example, and the MDRs) belong in the same directory
Addressed

> e. The DV bundles are split between the data reporting and the examples/end2end directories
Addressed

> f. We have a common tests directory with subdirectories for each subproject. Should we move each of these subdirectories into a tests directory under their respective subprojects?
Community collectively decided to keep the current structure

Second question has already been raised by Harm and will be discussed during the next architecture call