oracle.jdeveloper.offlinedb

Class OfflineDBObjectProvider

java.lang.Object

oracle.javatools.db.AbstractDBObjectProvider

oracle.jdeveloper.offlinedb.OfflineDBObjectProvider

All Implemented Interfaces:

DBObjectProvider

public abstract class OfflineDBObjectProvider
extends AbstractDBObjectProvider

Extension of DBObjectProvider for the offline projects. Instead of the object definitions being stored in a Database Dictionary they are stored as XML files in a Project.

See DBObjectProvider for a full list of the methods available. Where the offline database has specific behaviour for a method it will have doc included (overriden) for this class.

For more information on using the offlinedb read the package documentation.

See Also:

oracle.jdeveloper.offlinedb

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PROVIDER_TYPE Used to identify OfflineDBObjectProvider implementations when using DBObjectProviderFactory.

Fields inherited from class oracle.javatools.db.AbstractDBObjectProvider

CASE_SENSITIVE_NAME_POLICY, EMPTY_LIST, LOWER_CASE_NAME_POLICY, MIXED_CASE_NAME_POLICY, NEW_FROM_TEMPLATE_TYPE, TIMESTAMP_PROPERTY, UPPER_CASE_NAME_POLICY

Fields inherited from interface oracle.javatools.db.DBObjectProvider

CREATE_PRIVILEDGE, DELETE_PRIVILEDGE, MODIFY_PRIVILEDGE

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	OfflineDBObjectProvider(java.net.URL url)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canCreate(SystemObject object, boolean replace) Returns true if the schema for this object exists, and the file representing this object can be saved.
boolean	canDelete(SystemObject object, boolean cascade) Returns true if a delete operation on the given schema object is likely to succeed.
void	createObjects(SystemObject[] objects, boolean replace) Used to create (or replace) the given SystemObjects.
void	deleteObjects(SystemObject[] objects, boolean cascade) Deletes a set of objects together.
protected abstract boolean	ensureOpen() Tests whether this provider is closed, and therefore will not function.
protected abstract java.net.URL	findObjectURL(DBObjectID id) Finds the URL containing the given object ID.
static OfflineDBObjectProvider	findOrCreateProvider(Project p, java.net.URL url) Finds an existing, or creates a new, OfflineDBObjectProvider instance for the given URL.
static OfflineDBObjectProvider	findProvider(Project project, BaseObjectID objID) Iterates through the project's providers, and see if any contain a matching object id.
static OfflineDBObjectProvider	findProvider(Project p, java.lang.String id) Deprecated. replaced by findProviderByID(Project,String).
static OfflineDBObjectProvider	findProviderByID(Project p, java.lang.String id) Finds a provider by its ID in the given Project.
static OfflineDBObjectProvider	findProviderByName(Context c, java.lang.String name) Finds an Offline Database with the given name in the given Context.
static OfflineDBObjectProvider	findProviderByName(Project p, java.lang.String name) Finds an Offline Database with the given name in the context of the given Project.
static OfflineDBObjectProvider	getDBObjectProvider(Context c) Returns the provider for the given ide context.
abstract Schema	getDefaultSchema() Returns the default schema for this provider - this schema may not (yet) exist in the provider.
DBObject	getDefaultTemplateForType(java.lang.String type) Returns the default template object for the given type, or null if none defined.
protected java.util.logging.Logger	getLogger() Gets the logger to use in this provider.
java.lang.String	getName() Returns the name of this provider (from the provider's settings).
DBObject	getObject(OfflineDBObjectNode node) Retrieves the object from the given node ensuring that the object's ID is correctly setup for this provider.
SchemaObject	getObject(SchemaObjectNode node) Retrieves the SchemaObject from the given node ensuring that the object's ID is correctly setup for this provider.
abstract SystemObject	getObject(java.net.URL url) Retrieves the SchemaObject from the given URL ensuring that the object's ID is correctly setup for this provider.
protected <T extends SystemObject> T	getObjectImpl(DBObjectCriteria<T> criteria) getObject implementation for looking up a single object in the provider.
Node	getObjectNode(DBObjectID id) Gets the Node for the given object id if it exists within the current provider.
Node	getObjectNode(SystemObject obj) Gets the Node for the given object id if it exists within the current provider.
java.net.URL	getObjectURL(DBObjectID id) Gets the URL for the given object id if it exists within the current provider.
java.net.URL	getObjectURL(SystemObject obj) Gets the URL for the given object id if it exists within the current provider.
java.lang.Object	getProviderIdentifier() Gets the String that identifies this DBObjectProvider uniquely (within providers of the same type).
static java.util.Iterator<OfflineDBObjectProvider>	getProviderIterator(Project p) Returns an iterator over the providers in a project.
static java.util.Iterator<OfflineDBObjectProvider>	getProviderIterator(Project p, boolean incProjDeps) Returns an iterator over the providers in a project.
java.lang.String	getProviderType() Gets the String that identifies the type of DBObjectProvider this is an instance of.
Schema	getSchema(java.lang.String name, boolean incBuiltInSchemas) Offline specific method for retrieving the schema with a given name without looking through the built-in schemas.
abstract ProviderSettings	getSettings() Returns the current settings for this offline provider.
static java.lang.String	getUniqueProviderName(Project p, java.lang.String name) Returns a unique provier name for the given provider within the project based on the given base name.
abstract java.lang.String	getUniqueSchemaName(java.lang.String base) Returns a unique name for a schema within this provider given the base name.
java.net.URL	getURL() Returns the URL for this offline provider.
boolean	isDependentProvider(OfflineDBObjectProvider provider) Determines whether the given provider is in the dependency chain for this provider, i.e.
boolean	isEditable(DBObject object) Tests whether or not the object can be edited.
protected abstract <T extends SystemObject> java.util.Collection<T>	listAllObjects(DBObjectCriteria<T> criteria) Lists the objects by type, schema and name (can include wildcard '%') from this provide only, not its dependencies.
static java.util.List<OfflineDBObjectProvider>	listDBObjectProviders(Project p) Lists the providers that already exist on the given project's offline database source path.
static java.util.List<OfflineDBObjectProvider>	listDBObjectProviders(Project p, boolean incProjDeps) Lists the providers that already exist on the given project's offline database source path.
static java.lang.Iterable<java.net.URL>	listDBObjectProviderURLs(Project p, boolean incProjDeps) Lists the URLs of any OfflineDBObjectProviders in the given project.
protected <T extends SystemObject> java.util.Collection<T>	listObjectsImpl(DBObjectCriteria<T> criteria) Internal listObjects implementation.
protected <T extends SystemObject> T	loadObjectImpl(DBObjectCriteria<T> criteria) Creates a schema object by looking on the filesystem (using listAllObjects) for the appropriate filename.
protected DBObject	resolveID(DBObjectID id) Finds a given object by ID.
void	setDefaultTemplateForType(java.lang.String type, DBObject so) Sets the default template object for the given type.
protected void	setURL(java.net.URL newURL)
java.lang.String	toString()
void	undeleteObject(SchemaObject object) This method is not currently supported in the offline provider.
void	undeleteObjects(SchemaObject[] objects) This method is not currently supported in the offline provider.
void	updateSchema(Schema oldSchema, Schema newSchema) Updates the definition of a Schema.
void	validateObject(DBObject object) Validates the given object using the DBObjectValidator registered against that object's type.
void	validateObject(DBObject original, DBObject update) Validates the given object update using the DBObjectValidator registered against that object's type.
void	validateObjectProperty(DBObject original, DBObject update, java.lang.String property) Checks to see if the updated children of a given object are valid.
void	validateObjectProperty(DBObject object, java.lang.String property) Checks to see if the children of a given object are valid.

Methods inherited from class oracle.javatools.db.AbstractDBObjectProvider

addObjectListener, addObjectListener, addObjectListener, addProviderListener, addProviderListener, cacheObject, canUpdate, checkCachedObject, clearAllCaches, commitTransaction, commitTransaction, convertObject, createObject, createObjectFactory, createObjectManager, createSchema, deleteObject, deleteSchema, destroyCache, ensureSystemObjectListDifference, findObject, findObject, findSchema, fireObjectsAdded, fireObjectsAdded, fireObjectsRemoved, fireObjectsRemoved, fireObjectUpdated, fireProviderClosed, fireProviderDeleted, fireProviderOpened, fireProviderReloaded, fireSchemaAdded, fireSchemaObjectUpdated, fireSchemaRemoved, fireSchemaUpdated, getBuilderForType, getCachedTimestamp, getCascadeManager, getCasePolicy, getDataType, getDDLGenerator, getDefaultSchemaName, getDescription, getDiffEngine, getExistingTimestamp, getExternalName, getExternalName, getExternalTimestamp, getExternalTimestampImpl, getIdentifierQuoteString, getInternalName, getInternalName, getObject, getObject, getObjectFactory, getObjectManager, getOrCreateDataType, getPropertyManager, getQuotedNameCasePolicy, getSchema, getSchemaObjectExpanders, getTimestamp, getTimestamp, getUniqueName, getUniqueName, getUniqueNameTreatIndexAsSchemaObject, getValidatorForType, hasObjectPrivilege, hasPriviledge, hasSystemPrivilege, isClosed, isNewFromTemplateType, isRequestedObject, isRequestedObject, isValidName, isValidName, listObjects, listObjects, listObjects, listObjects, listObjects, listObjectsFromCache, listObjectsImpl, listObjectsImpl, listObjectTypes, listSchemas, listSchemas, listSupportedDataTypes, loadObjectImpl, loadObjectImpl, logEvent, markForLazyInit, markForLazyInit, normaliseType, putCachedTimestampKey, quoteIdentifier, registerBuilder, registerSchemaObjectExpander, registerType, registerValidator, removeObjectListener, removeProviderListener, removeProviderListener, resetObject, resetObject, resolveIDImpl, resolveReferenceID, resolveUnspecifiedTypeID, resumeTimestampQueries, supportsObjectType, supportsTimestamps, supportsTimestamps, suspendTimestampQueries, uncacheObject, updateObject, updateObjects, updateObjects, validateName, validateName, validateObject, validateObject, validateObjectProperty, validateObjectProperty, validateSchema, validateSchema, validateUniqueName, validateUniqueName

Methods inherited from class java.lang.Object

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

Methods inherited from interface oracle.javatools.db.DBObjectProvider

getDescriptor

Field Detail

PROVIDER_TYPE

public static final java.lang.String PROVIDER_TYPE

Used to identify OfflineDBObjectProvider implementations when using DBObjectProviderFactory.

See Also:

Constant Field Values

Constructor Detail

OfflineDBObjectProvider

protected OfflineDBObjectProvider(java.net.URL url)

Method Detail

getProviderType

public final java.lang.String getProviderType()

Description copied from interface: DBObjectProvider

Gets the String that identifies the type of DBObjectProvider this is an instance of. This is used by the DBObjectProviderFactory in conjunction with the identifier to find or create provider instances.

See Also:

DBObjectProvider.getProviderIdentifier(), DBObjectProviderFactory.findOrCreateProvider(String,Object)

getProviderIdentifier

public final java.lang.Object getProviderIdentifier()

Description copied from interface: DBObjectProvider

Gets the String that identifies this DBObjectProvider uniquely (within providers of the same type). This is used by the DBObjectProviderFactory in conjunction with the type to find or create provider instances. Note this is not a displayable name, it is an internal identifier for the provider (use getName() for a displayable String).

See Also:

DBObjectProvider.getProviderType(), DBObjectProviderFactory.findOrCreateProvider(String,Object), DBObjectProvider.getName()

getSettings

public abstract ProviderSettings getSettings()

Returns the current settings for this offline provider.

getURL

public final java.net.URL getURL()

Returns the URL for this offline provider.

setURL

protected final void setURL(java.net.URL newURL)

getName

public final java.lang.String getName()

Returns the name of this provider (from the provider's settings).

See Also:

getSettings()

getLogger

protected java.util.logging.Logger getLogger()

Description copied from class: AbstractDBObjectProvider

Gets the logger to use in this provider.

Overrides:

getLogger in class AbstractDBObjectProvider

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getObject

public final SchemaObject getObject(SchemaObjectNode node)
                             throws DBException

Retrieves the SchemaObject from the given node ensuring that the object's ID is correctly setup for this provider.

Throws:

DBException - is this is not possible - e.g. the given node is a duplicate on the database path for this provider.

getObject

public final DBObject getObject(OfflineDBObjectNode node)
                         throws DBException

Retrieves the object from the given node ensuring that the object's ID is correctly setup for this provider.

Throws:

DBException - is this is not possible - e.g. the given node is a duplicate on the database path for this provider.

getObject

public abstract SystemObject getObject(java.net.URL url)
                                throws DBException

Retrieves the SchemaObject from the given URL ensuring that the object's ID is correctly setup for this provider.

Throws:

DBException - if this is not possible.

findObjectURL

protected abstract java.net.URL findObjectURL(DBObjectID id)
                                       throws CancelledException

Finds the URL containing the given object ID. Used by all the getObjectURL and getObjectNode methods.

Throws:

CancelledException

getObjectURL

public final java.net.URL getObjectURL(DBObjectID id)

Gets the URL for the given object id if it exists within the current provider.

Parameters:

id - the DBObjectID to lookup

Returns:

the URL for the object with that ID (if one exists).

See Also:

getObjectURL(SystemObject)

getObjectURL

public final java.net.URL getObjectURL(SystemObject obj)

Gets the URL for the given object id if it exists within the current provider.

Parameters:

obj - the object to lookup

Returns:

the URL for the object (if one exists)

See Also:

getObjectURL(DBObjectID)

getObjectNode

public final Node getObjectNode(SystemObject obj)

Gets the Node for the given object id if it exists within the current provider.

Parameters:

obj - the object to lookup

Returns:

the Node for the object (if one exists).

See Also:

getObjectNode(DBObjectID), getObjectURL(SystemObject)

getObjectNode

public final Node getObjectNode(DBObjectID id)

Gets the Node for the given object id if it exists within the current provider.

Parameters:

id - the DBObjectID to lookup

Returns:

the URL for the object with that ID (if one exists).

See Also:

getObjectNode(SystemObject), getObjectURL(DBObjectID)

isEditable

public boolean isEditable(DBObject object)

Description copied from interface: DBObjectProvider

Tests whether or not the object can be edited.

Specified by:

isEditable in interface DBObjectProvider

Overrides:

isEditable in class AbstractDBObjectProvider

canCreate

public boolean canCreate(SystemObject object,
                boolean replace)

Returns true if the schema for this object exists, and the file representing this object can be saved. If the object already exists, true is only returned if replace is also true, and the object's file is writable.

Parameters:

object - the SystemObject describing the object to create

replace - whether to replace an existing object. If replace is false and the object exists, canCreate must return false.

Returns:

whether the create will succeed.

canDelete

public boolean canDelete(SystemObject object,
                boolean cascade)

Returns true if a delete operation on the given schema object is likely to succeed.

Parameters:

object - the object to check

cascade - whether to assume a cascading delete should be used.

Returns:

whether the delete, if attempted, would succeed.

createObjects

public final void createObjects(SystemObject[] objects,
                 boolean replace)
                         throws DBException

Used to create (or replace) the given SystemObjects. If replacing - the name, Schema and type of each object must be identical to the original. To replace the object, updateObjects() is used to prevent observers losing their subjects.

Update messages are fired to any observers following the outcome of the operation.

Note: if you call this method with an object whose Schema hasn't explicitly been retrieved from the getSchema() method then one of two things will happen:

• if a schema exists with the same name (CASE SENSITVE) then that will replace the object's schema and be used.
• if no schema exists with the same name a DBException will be thrown

Parameters:

objects - the SystemObject[] describing the objects to create.

replace - whether to replace an existing objects. If replace is false and the object exists, createObjects will fail.

Throws:

DBException - if an error is encountered creating the objects.

See Also:

DBObjectProvider.createObjects(oracle.javatools.db.SystemObject[], boolean)

deleteObjects

public final void deleteObjects(SystemObject[] objects,
                 boolean cascade)
                         throws DBException

Deletes a set of objects together. Use to delete a number of inter-dependent objects. If an element in the array is null it is ignored.

Parameters:

objects - the objects to delete

cascade - whether to delete dependent objects

Throws:

DBException - if an error is encountered performing the delete

updateSchema

public final void updateSchema(Schema oldSchema,
                Schema newSchema)
                        throws DBException

Description copied from interface: DBObjectProvider

Updates the definition of a Schema.

Specified by:

updateSchema in interface DBObjectProvider

Overrides:

updateSchema in class AbstractDBObjectProvider

Parameters:

oldSchema - the old version of the schema

newSchema - the new version of the schema

Throws:

DBException - if the update fails

undeleteObject

public void undeleteObject(SchemaObject object)
                    throws DBException

This method is not currently supported in the offline provider.

Parameters:

object - the object to be undeleted

Throws:

DBException - if an error is encountered performing the undelete

undeleteObjects

public void undeleteObjects(SchemaObject[] objects)
                     throws DBException

This method is not currently supported in the offline provider.

Parameters:

objects - the objects to be undeleted

Throws:

DBException - if an error is encountered performing the undelete

validateObject

public void validateObject(DBObject object)
                    throws ValidationException

Validates the given object using the DBObjectValidator registered against that object's type. A ValidationException is thrown if the object fails to validate, or if no DBObjectValidator is registered for that object type.

Specified by:

validateObject in interface DBObjectProvider

Overrides:

validateObject in class AbstractDBObjectProvider

Parameters:

object - The object to validate

Throws:

ValidationException - if the object is not valid. The exception will describe the validation failure. A MissingValidatorException is thrown if the provider has no validator for the given object type.

validateObject

public void validateObject(DBObject original,
                  DBObject update)
                    throws ValidationException

Validates the given object update using the DBObjectValidator registered against that object's type. A ValidationException is thrown if the update fails to validate, or if no DBObjectValidator is registered for that object type.

Specified by:

validateObject in interface DBObjectProvider

Overrides:

validateObject in class AbstractDBObjectProvider

Parameters:

original - the original object

update - the updated object to validate

Throws:

ValidationException - if the updated object is not valid. The exception will describe the validation failure. A MissingValidatorException is thrown if the provider has no validator for the given object type.

validateObjectProperty

public void validateObjectProperty(DBObject original,
                          DBObject update,
                          java.lang.String property)
                            throws ValidationException

Description copied from interface: DBObjectProvider

Checks to see if the updated children of a given object are valid. If the object has no children of the given type a MissingValidatorException will be thrown. This is a convinience method to perform validation to a specific property on an object - all properties will be validated if DBObjectProvider.validateObject(DBObject,DBObject)is called.

Specified by:

validateObjectProperty in interface DBObjectProvider

Overrides:

validateObjectProperty in class AbstractDBObjectProvider

Parameters:

original - The original version of the edited object

update - The edited object to validate

property - An identifier for a specific property to validate

Throws:

ValidationException - if the object is not valid. The exception will describe the validation failure. A MissingValidatorExceptionis thrown if the provider has no validator for the given object type, or property.

validateObjectProperty

public void validateObjectProperty(DBObject object,
                          java.lang.String property)
                            throws ValidationException

Description copied from interface: DBObjectProvider

Checks to see if the children of a given object are valid. If the object has no children of the given type a MissingValidatorException will be thrown. This is a convinience method to perform validation to a specific property on an object - all properties will be validated if DBObjectProvider.validateObject(DBObject)is called.

Specified by:

validateObjectProperty in interface DBObjectProvider

Overrides:

validateObjectProperty in class AbstractDBObjectProvider

Parameters:

object - The object to validate

property - An identifier for a specific property to validate

Throws:

ValidationException - if the object is not valid. The exception will describe the validation failure. A MissingValidatorException is thrown if the provider has no validator for the given object type, or property.

isDependentProvider

public boolean isDependentProvider(OfflineDBObjectProvider provider)

Determines whether the given provider is in the dependency chain for this provider, i.e. whether objects in the given provider can be accessed by the current provider. For convenience, if the given provider is the same as the current provider, this method returns true.

Given the dependency chain PARENT and CHILD, where CHILD lists PARENT as one of its dependencies, calling isDependentProvider on CHILD and passing in PARENT will return true. Calling it on PARENT and passing in CHILD will return false.

Parameters:

provider - the provider to compare with

Returns:

true if the given provider is the same as the current provider or if it somewhere in the dependency chain

getSchema

public final Schema getSchema(java.lang.String name,
               boolean incBuiltInSchemas)
                       throws DBException

Offline specific method for retrieving the schema with a given name without looking through the built-in schemas.

Parameters:

name - the schema to search for

incBuiltInSchemas - whether to search the built-in schemas, e.g. complex type schemas, PUBLIC schema for synonyms etc.

Returns:

a schema if one is found.

Throws:

DBException

See Also:

AbstractDBObjectProvider.getSchema(java.lang.String)

getDefaultSchema

public abstract Schema getDefaultSchema()

Returns the default schema for this provider - this schema may not (yet) exist in the provider.

getUniqueSchemaName

public abstract java.lang.String getUniqueSchemaName(java.lang.String base)

Returns a unique name for a schema within this provider given the base name.

getObjectImpl

protected <T extends SystemObject> T getObjectImpl(DBObjectCriteria<T> criteria)
                                        throws DBException

Description copied from class: AbstractDBObjectProvider

getObject implementation for looking up a single object in the provider. The criteria might include more than one type, but the method is only expected to return a single object. If this has been called with too ambiguous a criteria set then it will simply return the first object that it finds that matches.

Overrides:

getObjectImpl in class AbstractDBObjectProvider

Parameters:

criteria - the lookup criteria

Returns:

an object that matches the criteria

Throws:

DBException

resolveID

protected DBObject resolveID(DBObjectID id)
                      throws DBException

Finds a given object by ID. API clients should use id.resolveID().

Overrides:

resolveID in class AbstractDBObjectProvider

Parameters:

id - the id to resolve by finding an object that matches it.

Returns:

a resolved object, or null if no object can be found.

Throws:

DBException

See Also:

DBObjectID.resolveID()

loadObjectImpl

protected <T extends SystemObject> T loadObjectImpl(DBObjectCriteria<T> criteria)
                                         throws DBException

Creates a schema object by looking on the filesystem (using listAllObjects) for the appropriate filename.

Overrides:

loadObjectImpl in class AbstractDBObjectProvider

Parameters:

criteria - the criteria for the object we want to load

Returns:

an object matching the given criteria

Throws:

DBException

listObjectsImpl

protected <T extends SystemObject> java.util.Collection<T> listObjectsImpl(DBObjectCriteria<T> criteria)
                                                                throws DBException

Description copied from class: AbstractDBObjectProvider

Internal listObjects implementation. All listObjects methods call through to this method and all subclasses must implement it to list the objects in the underlying metadata that match the given criteria. When listing object information and creating SystemObject implementations to return, the cache of objects in the provider should be checked and any cached object reused rather than creating new instances for any list call.

Specified by:

listObjectsImpl in class AbstractDBObjectProvider

Parameters:

criteria - the listing criteria

Returns:

all objects that match the given criteria

Throws:

DBException

listAllObjects

protected abstract <T extends SystemObject> java.util.Collection<T> listAllObjects(DBObjectCriteria<T> criteria)

Lists the objects by type, schema and name (can include wildcard '%') from this provide only, not its dependencies. Additionally built in object types etc are not included.

If the accepts parameter is not null then each object is tested using it once opened. If the object is aceepted then the iteration is stopped and just that object is returned in the Collection. This allows a "search" for an object to jump out and not load all the objects.

See Also:

AbstractDBObjectProvider.listObjects(DBObjectCriteria)

For internal use only. Application developers should not use this

ensureOpen

protected abstract boolean ensureOpen()

Tests whether this provider is closed, and therefore will not function. A provider is closed when it is uncached from the DBObjectProviderFactory which happens as a result of its Project being closed. Listeners to a provider will have been notified.

Calling this method will attempt to reinitialize the provider. Do not call it unless the provider is expected to function.

Returns:

false if the provider has been closed and cannot be reopened

For internal use only. Application developers should not use this

getDefaultTemplateForType

public DBObject getDefaultTemplateForType(java.lang.String type)

Description copied from class: AbstractDBObjectProvider

Returns the default template object for the given type, or null if none defined.

Specified by:

getDefaultTemplateForType in interface DBObjectProvider

Overrides:

getDefaultTemplateForType in class AbstractDBObjectProvider

setDefaultTemplateForType

public void setDefaultTemplateForType(java.lang.String type,
                             DBObject so)

Description copied from class: AbstractDBObjectProvider

Sets the default template object for the given type. Default (online) implementation throws a RuntimeException.

Specified by:

setDefaultTemplateForType in interface DBObjectProvider

Overrides:

setDefaultTemplateForType in class AbstractDBObjectProvider

getDBObjectProvider

public static final OfflineDBObjectProvider getDBObjectProvider(Context c)

Returns the provider for the given ide context. The context must contain a node that is underneath a provider, or this will return null. If null is returned and a provider file is expected (e.g. you are requesting from a table node) then the user can be alerted by using ProviderWizard.showMissingProviderError(oracle.ide.Context, java.lang.String)

listDBObjectProviders

public static final java.util.List<OfflineDBObjectProvider> listDBObjectProviders(Project p)

Lists the providers that already exist on the given project's offline database source path. This will load all the providers, if you are searching for a specific provider then use getProviderIterator(Project) instead. Providers from dependent projects are included in the list.

See Also:

getProviderIterator(Project)

listDBObjectProviders

public static final java.util.List<OfflineDBObjectProvider> listDBObjectProviders(Project p,
                                                            boolean incProjDeps)

Lists the providers that already exist on the given project's offline database source path. This will load all the providers, if you are searching for a specific provider then use getProviderIterator(Project) instead.

Parameters:

p - the project to look in

incProjDeps - whether to search the project's dependencies as well.

See Also:

getProviderIterator(Project)

getProviderIterator

public static final java.util.Iterator<OfflineDBObjectProvider> getProviderIterator(Project p)

Returns an iterator over the providers in a project. This is faster than using listDBObjectProviders(Project) if you are searching because it doesn't load all the providers unless you keep iterating. Providers from dependent projects are included.

Returns:

an iterator of providers which could contain null elements if there is a problem loading a provider at a particular url.

See Also:

listDBObjectProviders(Project)

getProviderIterator

public static final java.util.Iterator<OfflineDBObjectProvider> getProviderIterator(Project p,
                                                              boolean incProjDeps)

Returns an iterator over the providers in a project. This is faster than using listDBObjectProviders(Project) if you are searching because it doesn't load all the providers unless you keep iterating. Providers from dependent projects are optionally included.

Parameters:

p - the project to look in

incProjDeps - whether to search the project's dependencies as well.

Returns:

an iterator of providers which could contain null elements if there is a problem loading a provider at a particular url.

See Also:

listDBObjectProviders(Project)

getUniqueProviderName

public static final java.lang.String getUniqueProviderName(Project p,
                                     java.lang.String name)

Returns a unique provier name for the given provider within the project based on the given base name.

findProvider

@Deprecated
public static final OfflineDBObjectProvider findProvider(Project p,
                                              java.lang.String id)

Deprecated. replaced by findProviderByID(Project,String).

findProviderByName

public static final OfflineDBObjectProvider findProviderByName(Context c,
                                         java.lang.String name)

Finds an Offline Database with the given name in the given Context.

Parameters:

c - the context to search

name - the name of the offline database to find

Returns:

an Offline Database, or null if one doesn't exist with the given name.

findProviderByName

public static final OfflineDBObjectProvider findProviderByName(Project p,
                                         java.lang.String name)

Finds an Offline Database with the given name in the context of the given Project.

Parameters:

p - the project to search

name - the name of the offline database to find

Returns:

an Offline Database, or null if one doesn't exist with the given name.

findProviderByID

public static final OfflineDBObjectProvider findProviderByID(Project p,
                                       java.lang.String id)

Finds a provider by its ID in the given Project. Once found it is cached (weakly) against the ID for quicker retrieval next time.

The ID isn't used by the DBObjectProviderFactory - because the URL is required to retrieve the provider succefully. The ID is provider as a mechanism to uniquely identify a provider within the context of a project.

Parameters:

p - the project to search in

id - the id of the provider

Returns:

a provider if one can be found, or null otherwise

See Also:

ProviderSettings.getID(), getProviderIterator(oracle.ide.model.Project)

findProvider

public static final OfflineDBObjectProvider findProvider(Project project,
                                   BaseObjectID objID)

Iterates through the project's providers, and see if any contain a matching object id. This is potentially very time consuming and should be avoided if at all possible. Wherever possible cache provider's by their own id and look them up using the appropriate findProvider method.

Parameters:

project - the project to search in

objID - the id of an object you expect to find in your provider. This needs its type and guid set, but not the provider obviously.

Returns:

a provider that contains the given object id.

See Also:

findProvider(oracle.ide.model.Project, java.lang.String)

listDBObjectProviderURLs

public static java.lang.Iterable<java.net.URL> listDBObjectProviderURLs(Project p,
                                                        boolean incProjDeps)

Lists the URLs of any OfflineDBObjectProviders in the given project.

Parameters:

p - the project to look in

incProjDeps - whether to include dependencies of the project

Returns:

an iterable of urls for offline database provider nodes.

findOrCreateProvider

public static OfflineDBObjectProvider findOrCreateProvider(Project p,
                                           java.net.URL url)
                                                    throws DBException

Finds an existing, or creates a new, OfflineDBObjectProvider instance for the given URL.

Parameters:

p - the containing Project

url - the url for the offline database

Returns:

an OfflineDBObjectProvider for the URL - note if the URl is new this might not be saved.

Throws:

DBException

See Also:

ProviderWizard