oracle.jdeveloper.db
Class AppDatabaseConnectionEditor

java.lang.Object
  oracle.jdeveloper.db.AppDatabaseConnectionEditor

public class AppDatabaseConnectionEditor
extends java.lang.Object

Launcher for the database connection editor on an application's connections. Call the editConnection methods to launch the dialog for editing connections, optionally specifying the name of the connection to initially select in the editor. This is different to DatabaseConnectionEditor because it includes the Context and understands Applications.

To create a custom launcher on which defaults can be changed, use DatabaseConnectionEditor.createLauncher()

Since:

11

Method Summary

static DatabaseConnectionEditorLauncher	createLauncher(Context context) Creates a new launcher for creating/editing connections that, by default, will only create connections in the current application.
static java.lang.String	editConnection(java.lang.String connName) Launches the connection editor to create or edit a connection in the current application.
static java.lang.String	editConnection(java.lang.String connName, Context context) Launches the connection editor to create or edit a connection in the current application
static java.lang.String	editConnection(java.lang.String connName, Context context, boolean forceStore) Launches the connection editor to create/edit a connection in the current application.
static java.lang.String	editConnection(java.lang.String connName, Context context, Connections conns) Deprecated. - use DatabaseConnectionEditor#createLauncher and customise

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

createLauncher

public static DatabaseConnectionEditorLauncher createLauncher(Context context)

Creates a new launcher for creating/editing connections that, by default, will only create connections in the current application.

Parameters:

context - the IDE context containing the application

Returns:

a launcher for creating and editing database connections

Throws:

java.lang.IllegalStateException - if the given context contains no application.

editConnection

public static java.lang.String editConnection(java.lang.String connName)

Launches the connection editor to create or edit a connection in the current application.

Parameters:

connName - the name of the connection to edit, or null to create a new connection.

editConnection

public static java.lang.String editConnection(java.lang.String connName,
                                              Context context)

Launches the connection editor to create or edit a connection in the current application

Parameters:

connName - the name of the connection to edit, or null to create a new connection.

context - the IDE Context to use to determine the application (Workspace)

editConnection

public static java.lang.String editConnection(java.lang.String connName,
                                              Context context,
                                              boolean forceStore)

Launches the connection editor to create/edit a connection in the current application. Optionally allows the user to create a connection in the RP instead.

Parameters:

context - the IDE Context to use to determine the application (Workspace)

forceStore - whether to force the user to create a new connection in the current connection store only (e.g. restrict to only create in app resources. If this is false care should be taken interpreting the returned new connection name.

Returns:

the name of the newly created or edited connection.

editConnection

@Deprecated
public static java.lang.String editConnection(java.lang.String connName,
                                                         Context context,
                                                         Connections conns)

Deprecated. - use DatabaseConnectionEditor#createLauncher and customise

Launches the connection editor. This is a utility method that calls #launchEditor(String,Context,Connections) on an editor instance.

See Also:

editConnection(String,Context)