# Connection Exception Handler

###### Identifier:

org.eclipse.datatools.connectivity.ui.connectionExceptionHandler

###### Since:

[Enter the first release in which this extension point appears.]

###### Description:

Provides a ConnectionExceptionHandler. A ConnectionExceptionHandler must implement org.eclipse.datatools.connectivity.ui.status.IConnectionExceptionHandler. It is used to provide a useful message when an error has occurred. When a connection error occurs, the SQLException generated may not always contain useful information. A ConnectionExceptionHandler can take the exception and context and use it to generate a new SQLException that contains a better message. Since SQL codes vary by database vendor, implementers designate a class to generate the enhanced SQLException based on the vendor. This SQLException can be passed wrapped in Status object for proper handling.

###### Configuration Markup:

<!ELEMENT extension (handler+)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

<!ELEMENT handler EMPTY>

<!ATTLIST handler

vendor CDATA #REQUIRED

class CDATA #REQUIRED>

- vendor - The database platform vendor, for example, as defined in the base properties of a `org.eclipse.datatools.connectivity.IConnectionProfile`
- class - Fully qualified name of class that implements the org.eclipse.datatools.connectivity.ui.status.IConnectionExceptionHandler interface

###### Examples:

[Enter extension point usage example here.]

###### API Information:

[Enter API information here.]

###### Supplied Implementation:

[Enter information about supplied implementation of this extension point.]

Copyright (c) 2010 IBM Corporation 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 Contributors: IBM Corporation - initial API and implementation