com.sas.rio
Class MVAConnection

com.sas.rio.MVAConnection

All Implemented Interfaces:

java.sql.Connection, java.sql.Wrapper

public class MVAConnection
implements java.sql.Connection

A Connection represents a session with a specific database. Within the context of a Connection, SQL statements are executed and results are returned.

A Connection's database is able to provide information describing its tables, its supported SQL grammar, its stored procedures, the capabilities of this connection, etc. This information is obtained with the getMetaData method.

Note: By default the Connection automatically commits changes after executing each statement. If auto commit has been disabled, an explicit commit must be done or database changes will not be saved.

See Also:

DriverManager.getConnection(java.lang.String, java.util.Properties), Statement, ResultSet, DatabaseMetaData

Field Summary

protected int	resultSetConcurrency
protected int	resultSetType

Constructor Summary

MVAConnection(com.sas.iom.SAS.IDataService sasDataService, java.util.Properties info)
Constructs an MVAConnection object.

MVAConnection(com.sas.iom.SAS.IWorkspace sasWorkspace, java.util.Properties info)
Constructs an MVAConnection object.

MVAConnection(com.sas.rio.RIOUtil x, java.util.Properties info)

MVAConnection(java.lang.String url, java.util.Properties info)
Constructs an MVAConnection object.

Method Summary

void	clearWarnings() Clears the warnings.
void	close() In some cases, it is desirable to immediately release a Connection's database and JDBC resources instead of waiting for them to be automatically released; the close method provides this immediate release.
void	commit() Closes all the open Statement and PreparedStatement objects that are associated with this object.
java.sql.Array	createArrayOf(java.lang.String typeName, java.lang.Object[] elements) This method is not supported.
java.sql.Blob	createBlob() This method is not supported.
java.sql.Clob	createClob() This method is not supported.
java.sql.NClob	createNClob() This method is not supported.
java.sql.SQLXML	createSQLXML() This method is not supported.
java.sql.Statement	createStatement() Creates a Statement object.
java.sql.Statement	createStatement(int resultSetType, int resultSetConcurrency) Same as createStatement() above, but allows the default result set type and result set concurrency type to be overridden.
java.sql.Statement	createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability) The MVAConnection implementation of createStatement(int, int, int) throws a SQLFeatureNotSupportedException if the value provided for resultSetHoldability is not ResultSet.CLOSE_CURSORS_AT_COMMIT.
java.sql.Struct	createStruct(java.lang.String typeName, java.lang.Object[] attributes) The MVAConnection implementation of createStruct(String, Object[]) always throws a SQLFeatureNotSupportedException.
boolean	getAutoCommit() SAS software does not support transactions.
java.lang.String	getCatalog() The MVAConnection implementation of getCatalog always returns .
java.util.Properties	getClientInfo() The MVAConnection implementation of getClientInfo always returns an empty properties object.
java.lang.String	getClientInfo(java.lang.String name) The MVAConnection implementation of getClientInfo(String) always returns null.
int	getHoldability()
java.lang.String	getIdForLogger()
java.sql.DatabaseMetaData	getMetaData()
protected com.sas.rio.RIOUtil	getRioUtil()
int	getTransactionIsolation() SAS software does not support transactions.
java.util.Map<java.lang.String,java.lang.Class<?>>	getTypeMap() The MVAConnection implementation of getTypeMap() always throws a SQLFeatureNotSupportedException.
java.sql.SQLWarning	getWarnings() Gets the warning reported by calls on this Connection.
boolean	isClosed()
boolean	isReadOnly() The MVAConnection implementation of getReadOnly() always returns false.
boolean	isValid(int timeout)
boolean	isWrapperFor(java.lang.Class<?> iface)
java.lang.String	nativeSQL(java.lang.String sql) Returns the input string.
java.sql.CallableStatement	prepareCall(java.lang.String sql) Creates a CallableStatement object.
java.sql.CallableStatement	prepareCall(java.lang.String sql, int resultSetType, int resultSetConcurrency) Same as prepareCall() above, but allows the default result set type and result set concurrency type to be overridden.
java.sql.CallableStatement	prepareCall(java.lang.String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) Creates a CallableStatement object that will generate ResultSet objects with the given type and concurrency.
java.sql.PreparedStatement	prepareStatement(java.lang.String sql) Creates a PreparedStatement object.
java.sql.PreparedStatement	prepareStatement(java.lang.String sql, int autoGeneratedKeys) The MVAConnection implementation of prepareStatement(String, int) always throws SQLFeatureNotSupportedException.
java.sql.PreparedStatement	prepareStatement(java.lang.String sql, int[] columnIndexes) The MVAConnection implementation of prepareStatement(String, int[]) always throws SQLFeatureNotSupportedException.
java.sql.PreparedStatement	prepareStatement(java.lang.String sql, int resultSetType, int resultSetConcurrency) Same as prepareStatement() above, but allows the default result set type and result set concurrency type to be overridden.
java.sql.PreparedStatement	prepareStatement(java.lang.String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)
java.sql.PreparedStatement	prepareStatement(java.lang.String sql, java.lang.String[] columnNames) The MVAConnection implementation of prepareStatement(String, String[]) always throws SQLFeatureNotSupportedException.
void	releaseSavepoint(java.sql.Savepoint savepoint) The MVAConnection implementation of releaseSavepoint always throws SQLFeatureNotSupportedException.
void	rollback() SAS software does not support transactions.
void	rollback(java.sql.Savepoint savepoint) The MVAConnection implementation of rollback always throws SQLFeatureNotSupportedException.
void	setAutoCommit(boolean autoCommit) Sets the auto-commit state.
void	setCatalog(java.lang.String catalog) The MVAConnection implementation of setCatalog silently ignores the value provided for catalog.
void	setClientInfo(java.util.Properties properties) The MVAConnection implementation of setClientInfo(Properties) adds a warning to the Connection object for all properties provided.
void	setClientInfo(java.lang.String name, java.lang.String value) The MVAConnection implementation of setClientInfo(String, String) adds a warning to the Connection object for any property provided.
void	setHoldability(int holdability) The MVAConnection implementation of setHoldability(int) only supports ResultSet.CLOSE_CURSORS_AT_COMMIT for holdability.
void	setReadOnly(boolean readOnly) The MVAConnection implementation of setReadOnly(boolean) ignores the value of readOnly.
java.sql.Savepoint	setSavepoint() The MVAConnection implementation of setSavepoint() always throws SQLFeatureNotSupportedException.
java.sql.Savepoint	setSavepoint(java.lang.String name) The MVAConnection implementation of setSavepoint(String) always throws SQLFeatureNotSupportedException.
void	setTransactionIsolation(int level) SAS software does not support transactions.
void	setTypeMap(java.util.Map<java.lang.String,java.lang.Class<?>> map) The MVAConnection implementation of setTypeMap() always throws a SQLFeatureNotSupportedException.
<T> T	unwrap(java.lang.Class<T> iface)

Field Detail

resultSetType

protected int resultSetType

resultSetConcurrency

protected int resultSetConcurrency

Constructor Detail

MVAConnection

public MVAConnection(java.lang.String url,
                     java.util.Properties info)
              throws java.sql.SQLException

Constructs an MVAConnection object.

Parameters:

url - initial input url containing host and port information.

info - java.util.Properties object which contains:

userName

MVA server access user name

password

MVA server access password

librefs

a semicolon delimited list of 'name filepath'.

encryptionPolicy

whether or not JavaBridge should attempt to negotiate with the server over which encryption algorithm to use and what to do if the negotiations fail. Possible values:

none

do not use encryption. This is the default.

optional

attempt to use encryption but, if algorithm negotiation fails, continue with an unencrypted session

required

attempt to use encryption but, if algorithm negotiation fails, fail the connection

encryptionContent

specifies which messages should be encrypted if encryption is used. Possible values:

all

encrypt all messages. This is the default.

authentication

encrypt only messages that contain user name and password information.

encryptionAlgorithms

the list of algorithms you are willing to use in order of preference. Values in the list should be separated by commas and chosen from sasproprietary, rc2, rc4, aes, des, or tripledes. If no value is specified, then one of the server's favorite algorithms will be used.

applyFormats

specifies whether or not column formats are applied when retrieving data. If the value is true, all data is returned as Strings. For any column, the format used is the one defined on the column in the data set. If "applyFormats" is set to false (the default case) no formatting is applied.

segmentLength

Specifies the segment length value, in bytes, for character annotations when initially added to a SAS result set. This property is not used with result sets that already have annotations. The server uses the segment length to define the buffer width of character extended attribute values. These values can span multiple segments. The default value of the segment length is 256 bytes.

Note that the server's encryption policy is, by default, optional so no special action is needed to prepare an IOM BRIDGE server to use encryption. However, it is possible to set up the server so that encryption is required. Consult IOM BRIDGE server documentation for details.

Throws:

java.sql.SQLException - This exception is thrown if a ShareNetException is detected.

MVAConnection

public MVAConnection(com.sas.iom.SAS.IDataService sasDataService,
                     java.util.Properties info)
              throws java.sql.SQLException

Constructs an MVAConnection object.

Parameters:

sasDataService - IDataService object.

info - java.util.Properties object which contains:

userName

MVA server access user name

password

MVA server access password

librefs

a semicolon delimited list of 'name filepath'.

Throws:

java.sql.SQLException - This exception is thrown if a ShareNetException is detected.

MVAConnection

public MVAConnection(com.sas.iom.SAS.IWorkspace sasWorkspace,
                     java.util.Properties info)
              throws java.sql.SQLException

Constructs an MVAConnection object.

Parameters:

sasWorkspace - IWorkspace object.

info - java.util.Properties object which contains:

userName

MVA server access user name

password

MVA server access password

librefs

a semicolon delimited list of 'name filepath'.

Throws:

java.sql.SQLException - This exception is thrown if a ShareNetException is detected.

MVAConnection

public MVAConnection(com.sas.rio.RIOUtil x,
                     java.util.Properties info)
              throws java.sql.SQLException

Throws:

java.sql.SQLException

Method Detail

getIdForLogger

public java.lang.String getIdForLogger()

createStatement

public java.sql.Statement createStatement()
                                   throws java.sql.SQLException

Creates a Statement object. SQL statements without parameters are normally executed using Statement objects. If the same SQL statement is executed many times, it is more efficient to use a PreparedStatement JDBC 2.0 Result sets created using the returned Statement will have forward-only type, and read-only concurrency, by default.

Specified by:

createStatement in interface java.sql.Connection

Returns:

a new Statement object

Throws:

java.sql.SQLException - This exception is thrown if an MVAStatement object cannot be created.

prepareStatement

public java.sql.PreparedStatement prepareStatement(java.lang.String sql)
                                            throws java.sql.SQLException

Creates a PreparedStatement object. A SQL statement with or without IN parameters can be pre-compiled and stored in a PreparedStatement object. This object can then be used to efficiently execute this statement multiple times. JDBC 2.0 Result sets created using the returned PreparedStatement will have forward-only type, and read-only concurrency, by default.

Specified by:

prepareStatement in interface java.sql.Connection

Parameters:

sql - A SQL statement that may contain one or more '?' IN parameter placeholders.

Returns:

A new PreparedStatement object containing the pre-compiled statement.

Throws:

java.sql.SQLException - This exception is thrown if a PreparedStatement object cannot be created.

prepareCall

public java.sql.CallableStatement prepareCall(java.lang.String sql)
                                       throws java.sql.SQLException

Creates a CallableStatement object. JDBC 2.0 Result sets created using the returned CallableStatement will have forward-only type, and read-only concurrency, by default.

Specified by:

prepareCall in interface java.sql.Connection

Parameters:

sql - A SQL statement that may contain one or more '?' parameter place holders. Typically this statement is a JDBC function call escape string.

Returns:

A new CallableStatement object containing the pre-compiled SQL statement

Throws:

java.sql.SQLException - This exception is required by the interface but it is never thrown.

nativeSQL

public java.lang.String nativeSQL(java.lang.String sql)
                           throws java.sql.SQLException

Returns the input string. The SQL is not optimized.

Specified by:

nativeSQL in interface java.sql.Connection

Parameters:

sql - An input SQL string for optimization.

Returns:

An input string.

Throws:

java.sql.SQLException - This exception is required by the interface, but it is never thrown.

setAutoCommit

public void setAutoCommit(boolean autoCommit)
                   throws java.sql.SQLException

Sets the auto-commit state.

Specified by:

setAutoCommit in interface java.sql.Connection

Parameters:

autoCommit - This value must be True. SAS software does not support transactions.

Throws:

java.sql.SQLException - This exception is thrown if the value for autoCommit is False.

getAutoCommit

public boolean getAutoCommit()
                      throws java.sql.SQLException

SAS software does not support transactions. All statements are committed individually. The current auto-commit state is always True.

Specified by:

getAutoCommit in interface java.sql.Connection

Returns:

True.

Throws:

SLQException - this exception is required by the interface, but it is never thrown.

java.sql.SQLException

commit

public void commit()
            throws java.sql.SQLException

Closes all the open Statement and PreparedStatement objects that are associated with this object.

Specified by:

commit in interface java.sql.Connection

Throws:

java.sql.SQLException - This exception is thrown if an exception occurred while outstanding statements were being closed.

rollback

public void rollback()
              throws java.sql.SQLException

SAS software does not support transactions. This method is not supported.

Specified by:

rollback in interface java.sql.Connection

Throws:

java.sql.SQLException - This exception is always thrown.

close

public void close()
           throws java.sql.SQLException

In some cases, it is desirable to immediately release a Connection's database and JDBC resources instead of waiting for them to be automatically released; the close method provides this immediate release.

Note: A Connection is automatically closed when it is garbage collected. Certain fatal errors also result in a closed Connection.

Specified by:

close in interface java.sql.Connection

Throws:

java.sql.SQLException - This exception is thrown if an error condition is detected.

isClosed

public boolean isClosed()
                 throws java.sql.SQLException

Specified by:

isClosed in interface java.sql.Connection

Throws:

java.sql.SQLException

getMetaData

public java.sql.DatabaseMetaData getMetaData()
                                      throws java.sql.SQLException

Specified by:

getMetaData in interface java.sql.Connection

Throws:

java.sql.SQLException

setReadOnly

public void setReadOnly(boolean readOnly)
                 throws java.sql.SQLException

The MVAConnection implementation of setReadOnly(boolean) ignores the value of readOnly. The IOM JDBC Driver does not support read only connections.

Specified by:

setReadOnly in interface java.sql.Connection

Throws:

java.sql.SQLException

isReadOnly

public boolean isReadOnly()
                   throws java.sql.SQLException

The MVAConnection implementation of getReadOnly() always returns false. The IOM JDBC Driver does not support read only connections.

Specified by:

isReadOnly in interface java.sql.Connection

Throws:

java.sql.SQLException

setCatalog

public void setCatalog(java.lang.String catalog)
                throws java.sql.SQLException

The MVAConnection implementation of setCatalog silently ignores the value provided for catalog. The IOM JDBC Driver does not support catalogs.

Specified by:

setCatalog in interface java.sql.Connection

Throws:

java.sql.SQLException

getCatalog

public java.lang.String getCatalog()
                            throws java.sql.SQLException

The MVAConnection implementation of getCatalog always returns . The IOM JDBC Driver does not support catalogs.

Specified by:

getCatalog in interface java.sql.Connection

Throws:

java.sql.SQLException

setTransactionIsolation

public void setTransactionIsolation(int level)
                             throws java.sql.SQLException

SAS software does not support transactions. The only valid input value is java.sql.Connection.TRANSACTION_NONE.

Specified by:

setTransactionIsolation in interface java.sql.Connection

Parameters:

level - The transaction level.

Throws:

java.sql.SQLException - This exception is thrown if the value of level is not valid.

getTransactionIsolation

public int getTransactionIsolation()
                            throws java.sql.SQLException

SAS software does not support transactions.

Specified by:

getTransactionIsolation in interface java.sql.Connection

Returns:

java.sql.Connection.TRANSACTION_NONE.

Throws:

java.sql.SQLException - This exception is required by the interface, but it is never thrown.

getWarnings

public java.sql.SQLWarning getWarnings()
                                throws java.sql.SQLException

Gets the warning reported by calls on this Connection.

Note: Subsequent warnings will be chained to this SQLWarning.

Specified by:

getWarnings in interface java.sql.Connection

Returns:

The SQLWarning.

Throws:

java.sql.SQLException - This exception is required by the interface but it is never thrown.

clearWarnings

public void clearWarnings()
                   throws java.sql.SQLException

Clears the warnings.

Specified by:

clearWarnings in interface java.sql.Connection

Throws:

java.sql.SQLException - This exception is required by the interface but it is never thrown.

createStatement

public java.sql.Statement createStatement(int resultSetType,
                                          int resultSetConcurrency)
                                   throws java.sql.SQLException

Same as createStatement() above, but allows the default result set type and result set concurrency type to be overridden. If an invalid type or concurrency is passed, the values are defaulted to TYPE_FORWARD_ONLY and CONCUR_READ_ONLY. If an invalid scrolling type or concurrency is requested, then a valid scrolling type (or concurrency) is substituted, and a warning is generated. JDBC 2.0

Specified by:

createStatement in interface java.sql.Connection

Parameters:

resultSetType - a result set type, see ResultSet.TYPE_XXX

resultSetConcurrency - a concurrency type, see ResultSet.CONCUR_XXX

Returns:

a new Statement object

Throws:

java.sql.SQLException - This exception is thrown if a Statement object cannot be created.

prepareStatement

public java.sql.PreparedStatement prepareStatement(java.lang.String sql,
                                                   int resultSetType,
                                                   int resultSetConcurrency)
                                            throws java.sql.SQLException

Same as prepareStatement() above, but allows the default result set type and result set concurrency type to be overridden. If an invalid type or concurrency is passed, the values are defaulted to TYPE_FORWARD_ONLY and CONCUR_READ_ONLY. If an invalid scroll type or concurrency is requested, then the next closest scrolling/concurrency is substituted, and a warning is generated. JDBC 2.0

Specified by:

prepareStatement in interface java.sql.Connection

Parameters:

resultSetType - a result set type, see ResultSet.TYPE_XXX

resultSetConcurrency - a concurrency type, see ResultSet.CONCUR_XXX

Returns:

a new PreparedStatement object containing the pre-compiled SQL statement

Throws:

java.sql.SQLException - This exception is thrown if a PreparedStatement object cannot be created.

prepareCall

public java.sql.CallableStatement prepareCall(java.lang.String sql,
                                              int resultSetType,
                                              int resultSetConcurrency)
                                       throws java.sql.SQLException

Same as prepareCall() above, but allows the default result set type and result set concurrency type to be overridden. If an invalid type or concurrency is passed, the values are defaulted to TYPE_FORWARD_ONLY and CONCUR_READ_ONLY. If an invalid scroll type/concurrency is requested, the next closest scroll type/concurrency is substituted, and a warning is generated. JDBC 2.0

Specified by:

prepareCall in interface java.sql.Connection

Parameters:

resultSetType - a result set type, see ResultSet.TYPE_XXX

resultSetConcurrency - a concurrency type, see ResultSet.CONCUR_XXX

Returns:

a new CallableStatement object containing the pre-compiled SQL statement

Throws:

java.sql.SQLException - This exception is thrown if a CallableStatement object cannot be created.

getTypeMap

public java.util.Map<java.lang.String,java.lang.Class<?>> getTypeMap()
                                                              throws java.sql.SQLException

The MVAConnection implementation of getTypeMap() always throws a SQLFeatureNotSupportedException. Base SAS does not support SQL structured types.

Specified by:

getTypeMap in interface java.sql.Connection

Throws:

java.sql.SQLException

setTypeMap

public void setTypeMap(java.util.Map<java.lang.String,java.lang.Class<?>> map)
                throws java.sql.SQLException

The MVAConnection implementation of setTypeMap() always throws a SQLFeatureNotSupportedException. Base SAS does not support SQL structured types.

Specified by:

setTypeMap in interface java.sql.Connection

Throws:

java.sql.SQLException

getRioUtil

protected com.sas.rio.RIOUtil getRioUtil()

createStatement

public java.sql.Statement createStatement(int resultSetType,
                                          int resultSetConcurrency,
                                          int resultSetHoldability)
                                   throws java.sql.SQLException

The MVAConnection implementation of createStatement(int, int, int) throws a SQLFeatureNotSupportedException if the value provided for resultSetHoldability is not ResultSet.CLOSE_CURSORS_AT_COMMIT.

Specified by:

createStatement in interface java.sql.Connection

Throws:

java.sql.SQLException

getHoldability

public int getHoldability()
                   throws java.sql.SQLException

Specified by:

getHoldability in interface java.sql.Connection

Throws:

java.sql.SQLException

prepareCall

public java.sql.CallableStatement prepareCall(java.lang.String sql,
                                              int resultSetType,
                                              int resultSetConcurrency,
                                              int resultSetHoldability)
                                       throws java.sql.SQLException

Creates a CallableStatement object that will generate ResultSet objects with the given type and concurrency. Empty method implementation for JDK1.4 compliance.

Specified by:

prepareCall in interface java.sql.Connection

Throws:

java.sql.SQLException - This exception is always thrown to indicate the method is not implemented.

prepareStatement

public java.sql.PreparedStatement prepareStatement(java.lang.String sql,
                                                   int autoGeneratedKeys)
                                            throws java.sql.SQLException

The MVAConnection implementation of prepareStatement(String, int) always throws SQLFeatureNotSupportedException. The IOM JDBC driver does not support auto-generated keys.

Specified by:

prepareStatement in interface java.sql.Connection

Throws:

java.sql.SQLException

prepareStatement

public java.sql.PreparedStatement prepareStatement(java.lang.String sql,
                                                   int[] columnIndexes)
                                            throws java.sql.SQLException

The MVAConnection implementation of prepareStatement(String, int[]) always throws SQLFeatureNotSupportedException. The IOM JDBC driver does not support auto-generated keys.

Specified by:

prepareStatement in interface java.sql.Connection

Throws:

java.sql.SQLException

prepareStatement

public java.sql.PreparedStatement prepareStatement(java.lang.String sql,
                                                   int resultSetType,
                                                   int resultSetConcurrency,
                                                   int resultSetHoldability)
                                            throws java.sql.SQLException

Specified by:

prepareStatement in interface java.sql.Connection

Throws:

java.sql.SQLException

prepareStatement

public java.sql.PreparedStatement prepareStatement(java.lang.String sql,
                                                   java.lang.String[] columnNames)
                                            throws java.sql.SQLException

The MVAConnection implementation of prepareStatement(String, String[]) always throws SQLFeatureNotSupportedException. The IOM JDBC driver does not support auto-generated keys.

Specified by:

prepareStatement in interface java.sql.Connection

Throws:

java.sql.SQLException

releaseSavepoint

public void releaseSavepoint(java.sql.Savepoint savepoint)
                      throws java.sql.SQLException

The MVAConnection implementation of releaseSavepoint always throws SQLFeatureNotSupportedException. The IOM JDBC driver does not support transactions.

Specified by:

releaseSavepoint in interface java.sql.Connection

Throws:

java.sql.SQLException

rollback

public void rollback(java.sql.Savepoint savepoint)
              throws java.sql.SQLException

The MVAConnection implementation of rollback always throws SQLFeatureNotSupportedException. The IOM JDBC driver does not support transactions.

Specified by:

rollback in interface java.sql.Connection

Throws:

java.sql.SQLException

setHoldability

public void setHoldability(int holdability)
                    throws java.sql.SQLException

The MVAConnection implementation of setHoldability(int) only supports ResultSet.CLOSE_CURSORS_AT_COMMIT for holdability.

Specified by:

setHoldability in interface java.sql.Connection

Throws:

java.sql.SQLException

setSavepoint

public java.sql.Savepoint setSavepoint()
                                throws java.sql.SQLException

The MVAConnection implementation of setSavepoint() always throws SQLFeatureNotSupportedException. The IOM JDBC driver does not support transactions.

Specified by:

setSavepoint in interface java.sql.Connection

Throws:

java.sql.SQLException

setSavepoint

public java.sql.Savepoint setSavepoint(java.lang.String name)
                                throws java.sql.SQLException

The MVAConnection implementation of setSavepoint(String) always throws SQLFeatureNotSupportedException. The IOM JDBC driver does not support transactions.

Specified by:

setSavepoint in interface java.sql.Connection

Throws:

java.sql.SQLException

createClob

public java.sql.Clob createClob()
                         throws java.sql.SQLException

This method is not supported.

Constructs an object that implements the Clob interface. The object returned initially contains no data. The setAsciiStream, setCharacterStream and setString methods of the Clob interface may be used to add data to the Clob.

Specified by:

createClob in interface java.sql.Connection

Throws:

java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:

1.6

createBlob

public java.sql.Blob createBlob()
                         throws java.sql.SQLException

This method is not supported.

Constructs an object that implements the Blob interface. The object returned initially contains no data. The setBinaryStream and setBytes methods of the Blob interface may be used to add data to the Blob.

Specified by:

createBlob in interface java.sql.Connection

Throws:

java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:

1.6

createNClob

public java.sql.NClob createNClob()
                           throws java.sql.SQLException

This method is not supported.

Constructs an object that implements the NClob interface. The object returned initially contains no data. The setAsciiStream, setCharacterStream and setString methods of the NClob interface may be used to add data to the NClob.

Specified by:

createNClob in interface java.sql.Connection

Throws:

java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:

1.6

createSQLXML

public java.sql.SQLXML createSQLXML()
                             throws java.sql.SQLException

This method is not supported.

Constructs an object that implements the SQLXML interface. The object returned initially contains no data. The createXmlStreamWriter object and setString method of the SQLXML interface may be used to add data to the SQLXML object.

Specified by:

createSQLXML in interface java.sql.Connection

Throws:

java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:

1.6

isValid

public boolean isValid(int timeout)
                throws java.sql.SQLException

Specified by:

isValid in interface java.sql.Connection

Throws:

java.sql.SQLException

setClientInfo

public void setClientInfo(java.lang.String name,
                          java.lang.String value)
                   throws java.sql.SQLClientInfoException

The MVAConnection implementation of setClientInfo(String, String) adds a warning to the Connection object for any property provided. The IOM JDBC Driver does not support the ability to set or retrieve client info properties.

Specified by:

setClientInfo in interface java.sql.Connection

Throws:

java.sql.SQLClientInfoException

setClientInfo

public void setClientInfo(java.util.Properties properties)
                   throws java.sql.SQLClientInfoException

The MVAConnection implementation of setClientInfo(Properties) adds a warning to the Connection object for all properties provided. The IOM JDBC Driver does not support the ability to set or retrieve client info properties.

Specified by:

setClientInfo in interface java.sql.Connection

Throws:

java.sql.SQLClientInfoException

getClientInfo

public java.lang.String getClientInfo(java.lang.String name)
                               throws java.sql.SQLException

The MVAConnection implementation of getClientInfo(String) always returns null. The IOM JDBC Driver does not support the ability to set or retrieve client info properties.

Specified by:

getClientInfo in interface java.sql.Connection

Throws:

java.sql.SQLException

getClientInfo

public java.util.Properties getClientInfo()
                                   throws java.sql.SQLException

The MVAConnection implementation of getClientInfo always returns an empty properties object. The IOM JDBC Driver does not support the ability to set or retrieve client info properties.

Specified by:

getClientInfo in interface java.sql.Connection

Throws:

java.sql.SQLException

createArrayOf

public java.sql.Array createArrayOf(java.lang.String typeName,
                                    java.lang.Object[] elements)
                             throws java.sql.SQLException

This method is not supported.

Factory method for creating Array objects.

Note: When createArrayOf is used to create an array object that maps to a primitive data type, then it is implementation-defined whether the Array object is an array of that primitive data type or an array of Object.

Note: The JDBC driver is responsible for mapping the elements Object array to the default JDBC SQL type defined in java.sql.Types for the given class of Object. The default mapping is specified in Appendix B of the JDBC specification. If the resulting JDBC type is not the appropriate type for the given typeName then it is implementation defined whether an SQLException is thrown or the driver supports the resulting conversion.

Specified by:

createArrayOf in interface java.sql.Connection

Parameters:

typeName - the SQL name of the type the elements of the array map to. The typeName is a database-specific name which may be the name of a built-in type, a user-defined type or a standard SQL type supported by this database. This is the value returned by Array.getBaseTypeName

elements - the elements that populate the returned object

Returns:

an Array object whose elements map to the specified SQL type

Throws:

java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:

1.6

createStruct

public java.sql.Struct createStruct(java.lang.String typeName,
                                    java.lang.Object[] attributes)
                             throws java.sql.SQLException

The MVAConnection implementation of createStruct(String, Object[]) always throws a SQLFeatureNotSupportedException. Base SAS does not support SQL structured types.

Specified by:

createStruct in interface java.sql.Connection

Throws:

java.sql.SQLException

unwrap

public <T> T unwrap(java.lang.Class<T> iface)
         throws java.sql.SQLException

Specified by:

unwrap in interface java.sql.Wrapper

Throws:

java.sql.SQLException

isWrapperFor

public boolean isWrapperFor(java.lang.Class<?> iface)
                     throws java.sql.SQLException

Specified by:

isWrapperFor in interface java.sql.Wrapper

Throws:

java.sql.SQLException