org.eclipse.datatools.connectivity.oda.util.manifest
Class ExtensionManifest

java.lang.Object
  extended byorg.eclipse.datatools.connectivity.oda.util.manifest.ExtensionManifest

public class ExtensionManifest
extends java.lang.Object

Encapsulates access to the content of an ODA data source plug-in extension manifest.


Field Summary
static java.lang.String CLASS_ATTRIBUTE_NAME
           
 
Method Summary
 DataSetType getDataSetType(java.lang.String dataSetElementID)
          Returns the DataSetType instance that represents the dataSet element with the given ID defined in this data source extension.
 java.lang.String[] getDataSetTypeIDs()
          Returns an array of ids of the dataSet elements defined in this data source extension.
 DataSetType[] getDataSetTypes()
          Returns an array of DataSetType instances that represent the dataSet elements defined in this data source extension.
 java.lang.String getDataSourceDisplayName()
          Returns the display name of the data source element defined in the ODA data source extension.
 IConfigurationElement getDataSourceElement()
          Returns the configuration element of this extension's data source element.
 java.lang.String getDataSourceElementID()
          Returns the ID that uniquely identifies the dataSource element defined in the ODA data source extension.
 java.net.URL getDriverLocation()
          Returns the driver installation location.
 java.lang.String getExtensionID()
          Returns the ID that uniquely identifies this ODA data source extension in an ODA consumer application's environment.
 java.lang.String getNamespace()
          Returns the namespace associated with this ODA runtime driver.
 java.lang.String getOdaVersion()
          Returns the version of the org.eclipse.datatools.connectivity.oda interfaces for which this driver is developed.
 Property[] getProperties()
          Returns an array of Property instances that represent the properties defined by this data source extension.
 java.util.Properties getPropertiesVisibility()
          Returns a Properties collecton of property visibilty settings.
 RuntimeInterface getRuntimeInterface()
          Returns the runtime interface configuration.
 TraceLogging getTraceLogging()
          Returns the optional trace logging configuration for the driver.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

CLASS_ATTRIBUTE_NAME

public static final java.lang.String CLASS_ATTRIBUTE_NAME
See Also:
Constant Field Values
Method Detail

getNamespace

public java.lang.String getNamespace()
Returns the namespace associated with this ODA runtime driver.

Returns:
the namespace for the ODA driver, null if the driver does not have a namespace.

getExtensionID

public java.lang.String getExtensionID()
Returns the ID that uniquely identifies this ODA data source extension in an ODA consumer application's environment. This is the extension that implements the org.eclipse.datatools.connectivity.oda.dataSource extension point.
Since each data source extension has one and only one data source element, the element ID is used as the extension ID.

Returns:
the data source extension ID.

getDataSourceElementID

public java.lang.String getDataSourceElementID()
Returns the ID that uniquely identifies the dataSource element defined in the ODA data source extension.

Returns:
the data source element ID.

getDataSourceElement

public IConfigurationElement getDataSourceElement()
Returns the configuration element of this extension's data source element.

Returns:
a dataSource configuration element

getDriverLocation

public java.net.URL getDriverLocation()
                               throws java.io.IOException
Returns the driver installation location.

Returns:
the driver directory.
Throws:
java.io.IOException - if an IO error occurs.

getOdaVersion

public java.lang.String getOdaVersion()
Returns the version of the org.eclipse.datatools.connectivity.oda interfaces for which this driver is developed.

Returns:
The ODA interface version. Its format is as defined in the extension point schema.

getDataSourceDisplayName

public java.lang.String getDataSourceDisplayName()
Returns the display name of the data source element defined in the ODA data source extension. Defaults to element ID if no display name is specified. It can be used by an ODA consumer application's designer tool to display a list of ODA data source extensions.

Returns:
The display name of the ODA data source element.

getDataSetTypes

public DataSetType[] getDataSetTypes()
Returns an array of DataSetType instances that represent the dataSet elements defined in this data source extension.

Returns:
an array of data set types.

getDataSetTypeIDs

public java.lang.String[] getDataSetTypeIDs()
Returns an array of ids of the dataSet elements defined in this data source extension.

Returns:
an array of data set type IDs.

getDataSetType

public DataSetType getDataSetType(java.lang.String dataSetElementID)
                           throws OdaException
Returns the DataSetType instance that represents the dataSet element with the given ID defined in this data source extension. If the given data set element ID is null and the data source extension supports only one data set type, that data set element will be returned by default.

Parameters:
dataSetElementID - the id of the data set element.
Returns:
the data set element definition.
Throws:
OdaException - if there is no data set definition associated with the specified data set element ID, or if there are more than one data set elements that match the ID.

getTraceLogging

public TraceLogging getTraceLogging()
Returns the optional trace logging configuration for the driver.

Returns:
the trace logging configuration, or null if no trace logging configuration was specified.

getRuntimeInterface

public RuntimeInterface getRuntimeInterface()
Returns the runtime interface configuration.

Returns:
the runtime interface configuration.

getProperties

public Property[] getProperties()
Returns an array of Property instances that represent the properties defined by this data source extension. The collection includes both top-level properties and those in a group.

Returns:
an array of property definitions; an empty array is returned if no properties are defined.

getPropertiesVisibility

public java.util.Properties getPropertiesVisibility()
Returns a Properties collecton of property visibilty settings.

Returns:
Properties with the property name as key, and its visibility setting as value. An empty collection if no property visibility is defined.


Copyright © 2006 Actuate, IBM Corporation, Sybase, Inc. and others. All rights reserved.