Introduction

This document lists changes made to the Database Explorer API/SPI.

Index of APIs

Database Explorer API

Incompatible changes by date

Fuller descriptions of all changes can be found below (follow links).

Not all deprecations are listed here, assuming that the deprecated APIs continue to essentially work. For a full deprecation list, please consult the Javadoc.

All changes by date

(Nov 1 '07) Made Database Explorer API stable
(Oct 5 '07) Allow user to save password
(Sep 12 '07) Added utility class for working with SQL identifiers
(Jun 17 '07) Added support for dragging and dropping nodes from the Database Explorer
(Jul 20 '06) Addded a method to open the NewConnectionDialog with an user and password pre-filled and methods which open the NewConnectionDialog and return the newly added database connection
(Mar 17 '06) Addded an utility method to fill a combo box with database connections
(Sep 12 '05) Initial version released

Changes by version

These API specification versions may be used to indicate that a module requires a certain API feature in order to function. For example, if you see here a feature you need which is labelled 1.20, your manifest should contain in its main attributes the line:

OpenIDE-Module-Module-Dependencies: org.netbeans.api.db.explorer > 1.20

(1.24) Made Database Explorer API stable
(1.23) Allow user to save password
(1.22) Added utility class for working with SQL identifiers
(1.21) Added support for dragging and dropping nodes from the Database Explorer
(1.19) Addded a method to open the NewConnectionDialog with an user and password pre-filled and methods which open the NewConnectionDialog and return the newly added database connection
(1.18) Addded an utility method to fill a combo box with database connections
(1.13) Initial version released

Changes by affected class

`org.netbeans.api.db.explorer.ConnectionManager`

(Jul 20 '06) Addded a method to open the NewConnectionDialog with an user and password pre-filled and methods which open the NewConnectionDialog and return the newly added database connection

`org.netbeans.api.db.explorer.support.DatabaseExplorerUIs`

(Mar 17 '06) Addded an utility method to fill a combo box with database connections

`org.netbeans.api.db.explorer.DatabaseMetaDataTransfer`

(Jun 17 '07) Added support for dragging and dropping nodes from the Database Explorer

`org.netbeans.api.db.sql.support.SQLIdentifiers`

(Sep 12 '07) Added utility class for working with SQL identifiers

Details of all changes by API and date

Database Explorer API

Made Database Explorer API stable

Nov 1 '07; API spec. version: 1.24; made by: abadea; issues: #120097
The stability level of the Database Explorer API is changed to stable.

Allow user to save password

Oct 5 '07; API spec. version: 1.23; made by: davidvc; issues: #87600
This change updated the connection DTD to 1.1, adding a password element. In the Database Explorer implementation, we allow the user to indicate they want to save the password. This works across invocations of the VM.

Added utility class for working with SQL identifiers

Sep 12 '07; API spec. version: 1.22; affected top-level classes: SQLIdentifiers; made by: davidvc; issues: #115075
This change adds a SQLIdentifiers.Quoter class which provides a utility method for quoting SQL identifiers.

Added support for dragging and dropping nodes from the Database Explorer

Jun 17 '07; API spec. version: 1.21; affected top-level classes: DatabaseMetaDataTransfer; made by: abadea; issues: #96200
This change adds a DatabaseMetaDataTransfer class which contains DataFlavors for database objects and nested classes representing those database objects during a drag and drop transfer.

Addded a method to open the NewConnectionDialog with an user and password pre-filled and methods which open the NewConnectionDialog and return the newly added database connection

Jul 20 '06; API spec. version: 1.19; affected top-level classes: ConnectionManager; made by: abadea; issues: #80629
This change adds a showAddConnectionDialog which opens the New Connection Dialog while pre-filling a specified database user and password. It also adds showAddConnectionDialogFromEventThread methods which are counterparts to the showAddConnectionDialog methods, with the difference that they return the newly added database connection, but must be called from the event dispatching thread.

Addded an utility method to fill a combo box with database connections

Mar 17 '06; API spec. version: 1.18; affected top-level classes: DatabaseExplorerUIs; made by: abadea; issues: #73713
This change adds the DatabaseExplorerUIs.connect() method, which populates a JComboBox with the list of connections from a ConnectionManager.

Initial version released

Sep 12 '05; API spec. version: 1.13; made by: abadea
First initial release of the Database Explorer API.