com.sibvisions.rad.persist.jdbc
Class OracleDBAccess

java.lang.Object
  com.sibvisions.rad.persist.jdbc.DBAccess
      com.sibvisions.rad.persist.jdbc.OracleDBAccess

All Implemented Interfaces:

IDBAccess, ICloseable

public class OracleDBAccess
extends DBAccess

The OracleDBAccess is the implementation for Oracle databases.

See Also:

DBAccess

Field Summary

Fields inherited from class com.sibvisions.rad.persist.jdbc.DBAccess

LONGNVARCHAR, NCHAR, NCLOB, NVARCHAR, QUOTE, SQLXML

Constructor Summary

OracleDBAccess()
Constructs a new OracleDBAccess Object.

Method Summary

protected Object	convertDatabaseSpecificObjectToValue(ServerColumnMetaData pColumnMetaData, Object pValue) Enables the database specific implementation to handle/convert special objects.
protected Map<String,Object[]>	getAllowedValuesIntern(String pCatalog, String pSchema, String pTable) Gets the allowed values from a specific table.
String	getDatabaseSpecificLockStatement(String pWritebackTable, ServerMetaData pServerMetaData, ICondition pPKFilter) Returns the database specific statement to lock the specified row in the database.
protected Map<String,Object>	getDefaultValuesIntern(String pCatalog, String pSchema, String pTable) Gets all default column values of a specific table.
protected List<ForeignKey>	getForeignKeysIntern(String pCatalog, String pSchema, String pTable) Returns all Foreign Keys for the specified table.
protected Key	getPrimaryKeyIntern(String pCatalog, String pSchema, String pTable) It's gets all Primary Key columns and return it as String[].
protected String	getTableForSynonymIntern(String pSynomyn) Returns the full qualified table name incl. schema/catalog/db link for the given synonym.
protected TableInfo	getTableInfoIntern(String pWriteBackTable) Returns the meta data information for the specified query, and configures all columns with defaults.
protected List<Key>	getUniqueKeysIntern(String pCatalog, String pSchema, String pTable) It gets all columns for each Unique Key and return it.
Object[]	insertDatabaseSpecific(String pWriteBackTable, String pInsertStatement, ServerMetaData pServerMetaData, Object[] pNewDataRow, String pDummyColumn) Returns the newly inserted row from a Database specific insert statement.
void	open() It opens the database and stores the Connection object.
protected Object	translateDefaultValue(String pColumnName, int pDataType, String pDefaultValue) Translates a default value from a column to the datatype object.

Methods inherited from class com.sibvisions.rad.persist.jdbc.DBAccess

clearMetaData, clearMetaData, close, commit, convertValueToDatabaseSpecificObject, createIdentifier, createReplace, createWhereColumn, createWhereParam, debug, delete, error, executeFunction, executeProcedure, executeSql, executeStatement, executeUpdate, fetch, fetch, fetch, fetch, formatSQLException, formatSQLException, getAllowedValues, getAutomaticLinkColumnNameTranslation, getCloseQuoteCharacter, getColumnMetaData, getColumnMetaDataIntern, getColumnName, getConnection, getDBAccess, getDBAccess, getDBAccess, getDBProperties, getDBProperty, getDefaultAllowedValues, getDefaultLargeObjectLimit, getDefaultSchema, getDefaultValues, getDriver, getForeignKeys, getIdentifier, getLargeObjectLimit, getMaxColumnLength, getMaxTime, getMetaDataCacheOption, getOpenQuoteCharacter, getParameter, getPassword, getPreparedStatement, getPrimaryKey, getQueryTimeOut, getSelectStatement, getSQL, getTableForSynonym, getTableInfo, getUniqueKeys, getUrl, getUsername, getWhereClause, info, insert, insertAnsiSQL, isAutoCommit, isAutoQuote, isJdbc, isLogEnabled, isMetaDataCacheEnabled, isModified, isOpen, isTypeEqual, lockRow, lockRowInternal, quote, quoteAllways, registerDBAccessClass, removeDBSpecificQuotes, removeQuotes, rollback, setAutoCommit, setAutomaticLinkColumnNameTranslation, setColumnsToStore, setConnection, setDatabaseSpecificType, setDBProperties, setDBProperty, setDefaultLargeObjectLimit, setDefaultSchema, setDriver, setLargeObjectLimit, setMaxTime, setMetaDataCacheOption, setModified, setPassword, setQueryTimeOut, setQuoteCharacters, setUrl, setUsername, splitSchemaTable, supportsGetGeneratedKeys, toString, translateQuotes, translateValue, update, updateAnsiSQL, updateDatabaseSpecific

Methods inherited from class java.lang.Object

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

Constructor Detail

OracleDBAccess

public OracleDBAccess()

Constructs a new OracleDBAccess Object.

Method Detail

getDatabaseSpecificLockStatement

public String getDatabaseSpecificLockStatement(String pWritebackTable,
                                               ServerMetaData pServerMetaData,
                                               ICondition pPKFilter)
                                        throws DataSourceException

Returns the database specific statement to lock the specified row in the database.

Overrides:

getDatabaseSpecificLockStatement in class DBAccess

Parameters:

pWritebackTable - the table to use.

pServerMetaData - the MetaDataColumn array to use.

pPKFilter - the PK filter with the values to use.

Returns:

the database specific statement to lock the specified row in the database.

Throws:

DataSourceException - if some parts are missing for the statement

insertDatabaseSpecific

public Object[] insertDatabaseSpecific(String pWriteBackTable,
                                       String pInsertStatement,
                                       ServerMetaData pServerMetaData,
                                       Object[] pNewDataRow,
                                       String pDummyColumn)
                                throws DataSourceException

Returns the newly inserted row from a Database specific insert statement.
Database specific derivations of DBAccess need to implement it database specific.

Overrides:

insertDatabaseSpecific in class DBAccess

Parameters:

pWriteBackTable - the table to use for the insert

pInsertStatement - the SQL Statement to use for the insert

pServerMetaData - the meta data to use.

pNewDataRow - the new row (Object[]) with the values to insert

pDummyColumn - null, if all writeable columns are null, but for a correct INSERT it have to be minimum one column to use in the syntax.

Returns:

the newly inserted row from an Oracle Database.

Throws:

DataSourceException - if an Exception occur during insert to the storage

open

public void open()
          throws DataSourceException

It opens the database and stores the Connection object.

Overrides:

open in class DBAccess

Throws:

DataSourceException - if the database couldn't opened

getUniqueKeysIntern

protected List<Key> getUniqueKeysIntern(String pCatalog,
                                        String pSchema,
                                        String pTable)
                                 throws DataSourceException

It gets all columns for each Unique Key and return it.

Overrides:

getUniqueKeysIntern in class DBAccess

Parameters:

pCatalog - the catalog to use

pSchema - the schema to use

pTable - the table to use

Returns:

all columns for each Unique Key.

Throws:

DataSourceException - if an error occur during UK search process.

getPrimaryKeyIntern

protected Key getPrimaryKeyIntern(String pCatalog,
                                  String pSchema,
                                  String pTable)
                           throws DataSourceException

It's gets all Primary Key columns and return it as String[]. Gets all Primary Key columns and return it as list of Strings.

Overrides:

getPrimaryKeyIntern in class DBAccess

Parameters:

pCatalog - the catalog to use

pSchema - the schema to use

pTable - the table to use

Returns:

all Primary Key columns and return it as String[].

Throws:

DataSourceException - if an error occur during PK search process.

getForeignKeysIntern

protected List<ForeignKey> getForeignKeysIntern(String pCatalog,
                                                String pSchema,
                                                String pTable)
                                         throws DataSourceException

Returns all Foreign Keys for the specified table.

Overrides:

getForeignKeysIntern in class DBAccess

Parameters:

pCatalog - the catalog to use

pSchema - the schema to use

pTable - the table to use as base table.

Returns:

all Foreign Keys for the specified table.

Throws:

DataSourceException - if an error occur in determining the ForeignKeys.

getTableForSynonymIntern

protected String getTableForSynonymIntern(String pSynomyn)
                                   throws DataSourceException

Returns the full qualified table name incl. schema/catalog/db link for the given synonym. If pSynomyn is no synonym, then the pSynomyn string is returned.

Overrides:

getTableForSynonymIntern in class DBAccess

Parameters:

pSynomyn - the synonym to use.

Returns:

the full qualified table name incl. schema/catalog/db link for the given synonym.

Throws:

DataSourceException - if an error occur in determining the synonyms.

getDefaultValuesIntern

protected Map<String,Object> getDefaultValuesIntern(String pCatalog,
                                                    String pSchema,
                                                    String pTable)
                                             throws DataSourceException

Gets all default column values of a specific table.

Overrides:

getDefaultValuesIntern in class DBAccess

Parameters:

pCatalog - the catalog name

pSchema - the schema name

pTable - the table name

Returns:

a Hashtable with the column name as key and the default value as value. It only contains columns with a default value

Throws:

DataSourceException - if the database access throws an exception

translateDefaultValue

protected Object translateDefaultValue(String pColumnName,
                                       int pDataType,
                                       String pDefaultValue)
                                throws Exception

Translates a default value from a column to the datatype object.

Overrides:

translateDefaultValue in class DBAccess

Parameters:

pColumnName - the column name to translate

pDataType - the datatype of the column

pDefaultValue - the original default value from the database

Returns:

the default value with the datatype of the column or null if the default value is not valid

Throws:

Exception - if the type translation causes an error or the datatype is not supported

getAllowedValuesIntern

protected Map<String,Object[]> getAllowedValuesIntern(String pCatalog,
                                                      String pSchema,
                                                      String pTable)
                                               throws DataSourceException

Gets the allowed values from a specific table. The allowed values are defined through check constraints or other table related restrictions.

Overrides:

getAllowedValuesIntern in class DBAccess

Parameters:

pCatalog - the catalog name

pSchema - the schema name

pTable - the table to check

Returns:

a Hashtable with a column name as key and the allowed values as array of Objects or null if there are no allowed values

Throws:

DataSourceException - if the database access throws an exception

convertDatabaseSpecificObjectToValue

protected Object convertDatabaseSpecificObjectToValue(ServerColumnMetaData pColumnMetaData,
                                                      Object pValue)
                                               throws SQLException

Enables the database specific implementation to handle/convert special objects. Some databases have datatypes that are not defined in the standard. This datatypes have specific classes in the JDBC drivers. With this method it is possible to convert the values of specific JDBC driver classes into usable objects. We can not send any JDBC object to the client!

Overrides:

convertDatabaseSpecificObjectToValue in class DBAccess

Parameters:

pColumnMetaData - the column metadata

pValue - the read object

Returns:

the value to use

Throws:

SQLException - if it fails.

getTableInfoIntern

protected TableInfo getTableInfoIntern(String pWriteBackTable)
                                throws DataSourceException

Returns the meta data information for the specified query, and configures all columns with defaults.

Overrides:

getTableInfoIntern in class DBAccess

Parameters:

pWriteBackTable - the write back table to use for the isWriteable() state (Optional)

Returns:

the meta data for the specified query, and initials all columns.

Throws:

DataSourceException - if an Exception occur during getting the meta data or if the storage is not opened or if one columns SQL type is not supported