org.trafodion.jdbc.t4

Class T4Driver

java.lang.Object

org.trafodion.jdbc.t4.T4Properties

org.trafodion.jdbc.t4.T4Driver

All Implemented Interfaces:

Driver

public class T4Driver
extends T4Properties
implements Driver

JDBC Type 4 Driver implementation.

Description: T4Driver is an implementation of the java.sql.Driver interface. The Java SQL framework allows for multiple database drivers to be loaded in single java program. The T4Driver can be loaded programatically by Class.forName("org.trafodion.jdbc.t4.T4Driver") or by passing -Djdbc.drivers=org.trafodion.jdbc.t4.T4Driver in the command line of the Java program.

Licensed to the Apache Software Foundation (ASF)

See Also:

DriverManager, Connection

Constructor Summary

Constructors

Constructor and Description
T4Driver() Instantiated by either Class.forName("org.trafodion.jdbc.t4.T4Driver") or by passing -Djdbc.drivers=org.trafodion.jdbc.t4.T4Driver property in the command line of the JDBC program.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	acceptsURL(String url) Retrieves whether the Type 4 driver determined that it can open a connection to the given URL.
Connection	connect(String url, Properties info) Attempts to make an NDCS connection to the given URL.
int	getMajorVersion() Retrieves the driver's major JDBC version number.
int	getMinorVersion() Gets the Type 4 driver's minor version number.
Logger	getParentLogger()
DriverPropertyInfo[]	getPropertyInfo(String url, Properties info) Gets information about the possible properties for the Type 4 driver.
boolean	jdbcCompliant() Returns whether the Type 4 driver is JDBC compliant.

Methods inherited from class org.trafodion.jdbc.t4.T4Properties

getApplicationName, getCertificateDir, getCertificateFile, getCertificateFileActive, getCompression, getCpuToUse, getDelayedErrorMode, getKeepAlive, getKeepRawFetchBuffer, getLogWriter, getProperties, getReplacementString, getRoleName, getSessionName, getSPJEnv, getTcpNoDelay, getTokenAuth, getUrl, setApplicationName, setCertificateDir, setCertificateFile, setCertificateFileActive, setCompression, setCompression, setCpuToUse, setCpuToUse, setDelayedErrorMode, setDelayedErrorMode, setKeepAlive, setKeepAlive, setKeepRawFetchBuffer, setKeepRawFetchBuffer, setLogWriter, setReplacementString, setRoleName, setSessionName, setSPJEnv, setSPJEnv, setTcp_NoDelay, setTcpNoDelay, setTokenAuth, setTokenAuth

Methods inherited from class java.lang.Object

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

Constructor Detail

T4Driver

public T4Driver()

Instantiated by either Class.forName("org.trafodion.jdbc.t4.T4Driver") or by passing -Djdbc.drivers=org.trafodion.jdbc.t4.T4Driver property in the command line of the JDBC program.

Method Detail

acceptsURL

public boolean acceptsURL(String url)
                   throws SQLException

Retrieves whether the Type 4 driver determined that it can open a connection to the given URL. Typically drivers return true if they recognize the subprotocol specified in the URL and false if they do not. For Type 4 driver to recognize the protocol, the URL must start with jdbc:t4jdbc.

Specified by:

acceptsURL in interface Driver

Parameters:

url - The URL of the database.

Returns:

true if the Type 4 driver recognizes the given URL; otherwise, false.

Throws:

SQLException

connect

public Connection connect(String url,
                 Properties info)
                   throws SQLException

Attempts to make an NDCS connection to the given URL. The Type 4 driver returns "null" when it determines that the driver is the wrong kind of driver to connect to the given URL. This occurence is common; for example, when the JDBC driver manager is requested to connect to a given URL, the driver manager it passes the URL to each loaded driver in turn. The Type 4 driver throws an SQLException when it has trouble connecting to NDCS. You can use the java.util.Properties argument to pass arbitrary string name-value pairs as connection arguments. Typically, you should include "user" and "password" properties in the Properties object.

Specified by:

connect in interface Driver

Parameters:

url - The URL string of format jdbc:t4jdbc://host:port/:

info - java.util.Properties object containing name-value pair.

Returns:

The TrafT4Connection object.

Throws:

SQLException - When an error occurs connecting to NDCS.

See Also:

T4Properties

getMajorVersion

public int getMajorVersion()

Retrieves the driver's major JDBC version number. For the Type 4 Driver, the number should be 3.

Specified by:

getMajorVersion in interface Driver

Returns:

3.

getMinorVersion

public int getMinorVersion()

Gets the Type 4 driver's minor version number. For the Type 4 driver, the number should be 11.

Specified by:

getMinorVersion in interface Driver

Returns:

11

getPropertyInfo

public DriverPropertyInfo[] getPropertyInfo(String url,
                                   Properties info)
                                     throws SQLException

Gets information about the possible properties for the Type 4 driver. The getPropertyInfo method is intended to allow a generic GUI tool to determine the properties that the tool should prompt from a human to get enough information to connect to NDCS. Depending on the values the human has supplied so far, additional values might be necessary, so you might need to iterate though several calls to the getPropertyInfo method.

Specified by:

getPropertyInfo in interface Driver

Parameters:

url - The URL of the database to which to connect

info - java.util.Properties object containing name-value pairs. The Type 4 driver ignores the Properties parameter passed to the driver.

Returns:

array of DriverPropertyInfo containing property details.

Throws:

SQLException

jdbcCompliant

public boolean jdbcCompliant()

Returns whether the Type 4 driver is JDBC compliant.

Specified by:

jdbcCompliant in interface Driver

Returns:

true

getParentLogger

public Logger getParentLogger()
                       throws SQLFeatureNotSupportedException

Specified by:

getParentLogger in interface Driver

Throws:

SQLFeatureNotSupportedException