Mappings
Identifier:
org.eclipse.datatools.connectivity.sqm.core.mappings
Since:
DTP 1.7, June 2009
Description:
Provides a metadata-driven way to map a connection profile provider ID or a vendor/version combination to a driver category ID.
EXPERIMENTAL. This class or interface has been added
as part of a work in progress. There is no guarantee that this API will
work or that it will remain the same. Please do not use this API
without consulting with the DTP Connectivity team.
Configuration Markup:
<!ELEMENT extension (providerIDtoDriverCategoryID)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED
>
<!ELEMENT providerIDtoDriverCategoryID EMPTY>
<!ATTLIST providerIDtoDriverCategoryID
providerID CDATA #REQUIRED
driverCategoryID CDATA #REQUIRED
>
Map a connection profile provider ID to a driver category ID. If mapped for a particular provider ID, this will override the mapping used in the wizard page and property page classes used for the ExtensibleProfileDetailsWizardPage and ExtensibleProfileDetailsWizardPage
- providerID - Connection Profile Provider ID. This maps to the provider ID defined in the connection profile extension point.
- driverCategoryID - Driver Category ID maps to the category id specified in the driver templates extension.
Examples:
An example of use of this mapping can be seen in the org.eclipse.datatools.connectivity.ui plug-in in the o.e.d.connectivity.ui.wizards package for the ExtensibleProfileDetailsPropertyPage and ExtensibleProfileDetailsWizardPage.
API Information:
Currently this can be accessed from the SQMServices (o.e.d.connectivity.sqm.core.SQMServices) via the method:
public static ProviderIDMappingRegistry getProviderIDMappingRegistry();
From there you can access the Provider ID in a number of ways:
public String getCategoryIDforProviderID ( String providerID );
public String getProviderIDforDriverCategoryID ( String driverCategoryID );
public String getProviderIDforVendorVersion ( String vendor, String version);
So you'll be able to get a driver category ID for a connection profile provider ID, a connection profile provider ID from a driver category ID, and a connection profile provider ID from a vendor/version.
Copyright 2009 Sybase, Inc. and others.
All rights reserved. This program and the accompanying materials are made
available under the terms of the Eclipse Public License v1.0 which
accompanies this distribution, and is available at
http://www.eclipse.org/legal/epl-v10.html