to.etc.dbutil

Class OracleDB

java.lang.Object

to.etc.dbutil.BaseDB

to.etc.dbutil.OracleDB

public class OracleDB
extends BaseDB

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	OracleDB.IPrivilegedAction Action to execute as the privileged oracle user.

Field Summary

Fields

Modifier and Type	Field and Description
static org.slf4j.Logger	LOG

Constructor Summary

Constructors

Constructor and Description
OracleDB()

Method Summary

Modifier and Type	Method and Description
static Connection	allocateConnectionAs(DataSource otherSchemaDs, String otherUserName, Connection sourceConn) This allocates a connection to another user without that other-user's password, using an initial connection with DBA privileges.
protected String	getCheckString() Returns a SQL statement that is the cheapest way to check the validity of a connection.
protected int	getFullSequenceID(Connection dbc, String seqname) Uses a table sequence to generate a value.
protected Reader	getLobReader(Connection dbc, ResultSet rs, int col) Returns a Reader from the blob (clob) column specified.
protected Reader	getLobReader(Connection dbc, ResultSet rs, String col) Returns a Reader from the blob (clob) column specified.
protected InputStream	getLobStream(Connection dbc, ResultSet rs, int col) Returns an InputStream from the blob (clob) column specified.
protected InputStream	getLobStream(Connection dbc, ResultSet rs, String col) Returns an InputStream from the blob (clob) column specified.
protected int	getSequenceID(Connection dbc, String tablename) Uses a table sequence to generate a value.
boolean	oracleOuterJoin()
static void	recompileAll(Connection dbc, String schema, boolean invalidsonly, boolean charsemantics) Recompile all packages or only invalid packages for the specified schema.
static Object	runAsOtherSchemaUser(DataSource otherSchemaDs, String otherUserName, DataSource defaultDs, OracleDB.IPrivilegedAction paction) Execute the action passed using a connection that is logged in as the privileged user of other specified schema.
protected void	setBlob_old(Connection dbc, String table, String column, String where, InputStream is, int len) Writes a blob to the requested record.
protected void	setBlob(Connection dbc, String table, String column, String[] pkfields, Object[] key, InputStream is, int len) Writes a blob to the requested record.
protected void	setBlob(Connection dbc, String table, String column, String where, byte[][] data)
protected void	setBlob(Connection dbc, String table, String column, String where, InputStream is, int len) Writes a blob to the requested record.
static void	setCharSemantics(Connection dbc, boolean ischar) Set the database session to CHAR or BYTE semantics.
protected void	setClob(Connection dbc, String table, String column, String where, Reader r)
static void	updateSynonyms(DataSource ds, String owner, String... objectNames) This method creates public synonyms for all objects in a schema (except TYPE objects).

Methods inherited from class to.etc.dbutil.BaseDB

getName, streamCopy

Methods inherited from class java.lang.Object

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

Field Detail

LOG

public static org.slf4j.Logger LOG

Constructor Detail

OracleDB

public OracleDB()

Method Detail

getCheckString

protected String getCheckString()

Returns a SQL statement that is the cheapest way to check the validity of a connection.

Specified by:

getCheckString in class BaseDB

Returns:

getSequenceID

protected int getSequenceID(Connection dbc,
                            String tablename)
                     throws SQLException

Uses a table sequence to generate a value.

Specified by:

getSequenceID in class BaseDB

Parameters:

dbc - the connection

Returns:

the id

Throws:

SQLException - if the sequence could not be obtained

getFullSequenceID

protected int getFullSequenceID(Connection dbc,
                                String seqname)
                         throws SQLException

Uses a table sequence to generate a value.

Specified by:

getFullSequenceID in class BaseDB

Parameters:

dbc - the connection

Returns:

the id

Throws:

SQLException - if the sequence could not be obtained

setBlob

protected void setBlob(Connection dbc,
                       String table,
                       String column,
                       String where,
                       InputStream is,
                       int len)
                throws SQLException

Description copied from class: BaseDB

Writes a blob to the requested record.

Specified by:

setBlob in class BaseDB

Throws:

SQLException

setBlob

protected void setBlob(Connection dbc,
                       String table,
                       String column,
                       String where,
                       byte[][] data)
                throws SQLException

Overrides:

setBlob in class BaseDB

Throws:

SQLException

setBlob

protected void setBlob(Connection dbc,
                       String table,
                       String column,
                       String[] pkfields,
                       Object[] key,
                       InputStream is,
                       int len)
                throws SQLException

Writes a blob to the requested record. Works for Oral and MYSQL.

Specified by:

setBlob in class BaseDB

Throws:

SQLException

setBlob_old

protected void setBlob_old(Connection dbc,
                           String table,
                           String column,
                           String where,
                           InputStream is,
                           int len)
                    throws Exception

Writes a blob to the requested record. Works for Oral and MYSQL.

Throws:

Exception

getLobReader

protected Reader getLobReader(Connection dbc,
                              ResultSet rs,
                              int col)
                       throws Exception

Returns a Reader from the blob (clob) column specified.

Specified by:

getLobReader in class BaseDB

Parameters:

rs -

col -

Returns:

Throws:

Exception

getLobReader

protected Reader getLobReader(Connection dbc,
                              ResultSet rs,
                              String col)
                       throws Exception

Returns a Reader from the blob (clob) column specified.

Specified by:

getLobReader in class BaseDB

Parameters:

rs -

col -

Returns:

Throws:

Exception

getLobStream

protected InputStream getLobStream(Connection dbc,
                                   ResultSet rs,
                                   int col)
                            throws Exception

Returns an InputStream from the blob (clob) column specified.

Specified by:

getLobStream in class BaseDB

Parameters:

rs -

col -

Returns:

Throws:

Exception

getLobStream

protected InputStream getLobStream(Connection dbc,
                                   ResultSet rs,
                                   String col)
                            throws Exception

Returns an InputStream from the blob (clob) column specified.

Specified by:

getLobStream in class BaseDB

Parameters:

rs -

col -

Returns:

Throws:

Exception

oracleOuterJoin

public boolean oracleOuterJoin()

Overrides:

oracleOuterJoin in class BaseDB

setClob

protected void setClob(Connection dbc,
                       String table,
                       String column,
                       String where,
                       Reader r)
                throws Exception

Specified by:

setClob in class BaseDB

Throws:

Exception

updateSynonyms

public static void updateSynonyms(@Nonnull
                                  DataSource ds,
                                  @Nonnull
                                  String owner,
                                  String... objectNames)

This method creates public synonyms for all objects in a schema (except TYPE objects).

Parameters:

ds -

owner -

objectNames -

runAsOtherSchemaUser

public static Object runAsOtherSchemaUser(@Nonnull
                                          DataSource otherSchemaDs,
                                          @Nonnull
                                          String otherUserName,
                                          @Nonnull
                                          DataSource defaultDs,
                                          @Nonnull
                                          OracleDB.IPrivilegedAction paction)
                                   throws Exception

Execute the action passed using a connection that is logged in as the privileged user of other specified schema. We do not know the password for this user AND we do not want to store that password: if we do that any change to the password would cause a problem. The solution implemented here is to use the privileged account and change the other schema user password to a known value; then we login using that password and obtain connection for execute the action. We restore the original password immediately after obtaining connection, even before privileged action is executed.

Parameters:

otherSchemaDs - DataSource for other schema.

otherUserName - Username - account that we use to run privileged action - we change its password temporary.

defaultDs - DataSource that we use for password manipulations.

paction - Privileged action that is executed under otherUserName account directly in otherSchemaDs.

Returns:

Throws:

Exception

allocateConnectionAs

@Nonnull
public static Connection allocateConnectionAs(@Nonnull
                                                       DataSource otherSchemaDs,
                                                       @Nonnull
                                                       String otherUserName,
                                                       @Nonnull
                                                       Connection sourceConn)
                                                throws Exception

This allocates a connection to another user without that other-user's password, using an initial connection with DBA privileges.

Parameters:

otherSchemaDs -

otherUserName -

sourceConn -

Returns:

Throws:

Exception

setCharSemantics

public static void setCharSemantics(@Nonnull
                                    Connection dbc,
                                    boolean ischar)
                             throws Exception

Set the database session to CHAR or BYTE semantics.

Parameters:

ischar -

Throws:

Exception

recompileAll

public static void recompileAll(@Nonnull
                                Connection dbc,
                                @Nonnull
                                String schema,
                                boolean invalidsonly,
                                boolean charsemantics)
                         throws Exception

Recompile all packages or only invalid packages for the specified schema.

Parameters:

dbc -

schema -

invalidsonly -

charsemantics -

Throws:

Exception