org.apache.derby.impl.jdbc

Class Util

java.lang.Object

org.apache.derby.impl.jdbc.Util

public abstract class Util
extends java.lang.Object

This class understands the message protocol and looks up SQLExceptions based on keys, so that the Local JDBC driver's messages can be localized. REMIND: May want to investigate putting some of this in the protocol side, for the errors that any Derby JDBC driver might return. The ASSERT mechanism is a wrapper of the basic services, to ensure that failed asserts at this level will behave well in a JDBC environment.

Constructor Summary

Constructors

Constructor and Description
Util()

Method Summary

Modifier and Type	Method and Description
static void	ASSERT(EmbedConnection conn, boolean mustBeTrue, java.lang.String msg) Mimic SanityManager.ASSERT in a JDBC-friendly way, and providing system cleanup for JDBC failures.
static void	checkForSupportedDataType(int dataType) Checks whether a data type is supported and raises a SQLException if it isn't.
static void	checkSupportedRaiseStandard(int dataType) Checks whether a data type is supported and raises a StandardException if it isn't.
static java.sql.SQLException	generateCsSQLException(StandardException se)
static java.sql.SQLException	generateCsSQLException(java.lang.String error, java.lang.Object... args)
static java.sql.SQLException	javaException(java.lang.Throwable t)
static void	logAndThrowSQLException(java.sql.SQLException se) Log SQLException to the error log if the severity exceeds the logSeverityLevel and then throw it.
static void	logSQLException(java.sql.SQLException se) Log an SQLException to the error log or to the console if there is no error log available.
static java.sql.SQLException	noCurrentConnection()
static java.sql.SQLException	notImplemented()
static java.sql.SQLException	notImplemented(java.lang.String feature)
static java.sql.SQLException	policyNotReloaded(java.lang.Throwable t)
static int[]	squashLongs(long[] longs) Squash an array of longs into an array of ints
static java.lang.String	typeName(int jdbcType)

Methods inherited from class java.lang.Object

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

Constructor Detail

Util

public Util()

Method Detail

logAndThrowSQLException

public static void logAndThrowSQLException(java.sql.SQLException se)
                                    throws java.sql.SQLException

Log SQLException to the error log if the severity exceeds the logSeverityLevel and then throw it. This method can be used for logging JDBC exceptions to derby.log DERBY-1191.

Parameters:

se - SQLException to log and throw

Throws:

java.sql.SQLException

logSQLException

public static void logSQLException(java.sql.SQLException se)

Log an SQLException to the error log or to the console if there is no error log available. This method could perhaps be optimized to have a static shared ErrorStringBuilder and synchronize the method, but this works for now.

Parameters:

se - SQLException to log

ASSERT

public static void ASSERT(EmbedConnection conn,
                          boolean mustBeTrue,
                          java.lang.String msg)
                   throws java.sql.SQLException

Mimic SanityManager.ASSERT in a JDBC-friendly way, and providing system cleanup for JDBC failures. We need the connection to do cleanup...

Throws:

java.sql.SQLException - the exception

checkForSupportedDataType

public static void checkForSupportedDataType(int dataType)
                                      throws java.sql.SQLException

Checks whether a data type is supported and raises a SQLException if it isn't.

Throws:

java.sql.SQLException

checkSupportedRaiseStandard

public static void checkSupportedRaiseStandard(int dataType)
                                        throws StandardException

Checks whether a data type is supported and raises a StandardException if it isn't.

Throws:

StandardException

generateCsSQLException

public static java.sql.SQLException generateCsSQLException(java.lang.String error,
                                                           java.lang.Object... args)

generateCsSQLException

public static java.sql.SQLException generateCsSQLException(StandardException se)

noCurrentConnection

public static java.sql.SQLException noCurrentConnection()

javaException

public static java.sql.SQLException javaException(java.lang.Throwable t)

policyNotReloaded

public static java.sql.SQLException policyNotReloaded(java.lang.Throwable t)

notImplemented

public static java.sql.SQLException notImplemented()

notImplemented

public static java.sql.SQLException notImplemented(java.lang.String feature)

squashLongs

public static int[] squashLongs(long[] longs)

Squash an array of longs into an array of ints

typeName

public static java.lang.String typeName(int jdbcType)