com.sas.rio
Class MVAConnection

java.lang.Object
  |
  +--com.sas.rio.MVAConnection

All Implemented Interfaces:

public class MVAConnection

extends Object

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

Fields inherited from interface java.sql.Connection

TRANSACTION_NONE, TRANSACTION_READ_COMMITTED, TRANSACTION_READ_UNCOMMITTED, TRANSACTION_REPEATABLE_READ, TRANSACTION_SERIALIZABLE

Constructor Summary

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

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

MVAConnection(String url, 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.
Statement	createStatement() Creates a Statement object.
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.
Statement	createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability) Creates a Statement object that will generate ResultSet objects with the given type, concurrency, and holdability.
boolean	getAutoCommit() SAS software does not support transactions.
String	getCatalog() Gets the Connection's current catalog name.
int	getHoldability() Retrieves the current holdability of ResultSet objects created using this Connection object.
DatabaseMetaData	getMetaData() 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.
int	getTransactionIsolation() SAS software does not support transactions.
Map	getTypeMap() * Gets the type-map object associated with this connection.
SQLWarning	getWarnings() Gets the warning reported by calls on this Connection.
boolean	isClosed() Tests to see if a Connection is closed.
boolean	isReadOnly() SAS software does not support read-only connections.
String	nativeSQL(String sql) Returns the input string.
CallableStatement	prepareCall(String sql) Creates a CallableStatement object.
CallableStatement	prepareCall(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.
CallableStatement	prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) Creates a CallableStatement object that will generate ResultSet objects with the given type and concurrency.
PreparedStatement	prepareStatement(String sql) Creates a PreparedStatement object.
PreparedStatement	prepareStatement(String sql, int autoGeneratedKeys) Creates a default PreparedStatement object that has the capability to retrieve auto-generated keys.
PreparedStatement	prepareStatement(String sql, int[] columnIndexes) Creates a default PreparedStatement object capable of returning the auto-generated keys designated by the given array.
PreparedStatement	prepareStatement(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.
PreparedStatement	prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) Creates a PreparedStatement object that will generate ResultSet objects with the given type, concurrency, and holdability.
PreparedStatement	prepareStatement(String sql, String[] columnNames) Creates a default PreparedStatement object capable of returning the auto-generated keys designated by the given array.
void	releaseSavepoint(Savepoint savepoint) Removes the given Savepoint object from the current transaction.
void	rollback() SAS software does not support transactions.
void	rollback(Savepoint savepoint) Undoes all changes made after the given Savepoint object was set.
void	setAutoCommit(boolean autoCommit) Sets the auto-commit state.
void	setCatalog(String catalog) A sub-space of this Connection's database may be selected by setting a catalog name.
void	setHoldability(int holdability) Changes the holdability of ResultSet objects created using this Connection object to the given holdability.
void	setReadOnly(boolean readOnly) SAS software does not support read-only connections.
Savepoint	setSavepoint() Creates an unnamed savepoint in the current transaction and returns the new Savepoint object that represents it.
Savepoint	setSavepoint(String name) Creates a savepoint with the given name in the current transaction and returns the new Savepoint object that represents it.
void	setTransactionIsolation(int level) SAS software does not support transactions.
void	setTypeMap(Map map) * Install a type-map object as the default type-map for this connection.

Methods inherited from class java.lang.Object

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

Field Detail

Constructor Detail

MVAConnection

public MVAConnection(String url,
                     Properties info)
              throws 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 semi-colon 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, 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 dataset. If "applyFormats" is set to false (the default case) no formatting is applied.

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:

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

MVAConnection

public MVAConnection(com.sas.iom.SAS.IDataService sasDataService,
                     Properties info)
              throws 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 semi-colon delimited list of 'name filepath'.

Throws:

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

MVAConnection

public MVAConnection(com.sas.iom.SAS.IWorkspace sasWorkspace,
                     Properties info)
              throws 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 semi-colon delimited list of 'name filepath'.

Throws:

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

Method Detail

createStatement

public Statement createStatement()
                          throws 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 Connection

Returns:

a new Statement object

Throws:

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

prepareStatement

public PreparedStatement prepareStatement(String sql)
                                   throws 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 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:

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

prepareCall

public CallableStatement prepareCall(String sql)
                              throws 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 Connection

Parameters:

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

Returns:

A new CallableStatement object containing the pre-compiled SQL statement

Throws:

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

nativeSQL

public String nativeSQL(String sql)
                 throws SQLException

Returns the input string. The SQL is not optimized.

Specified by:

nativeSQL in interface Connection

Parameters:

sql - An input SQL string for optimization.

Returns:

An input string.

Throws:

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

setAutoCommit

public void setAutoCommit(boolean autoCommit)
                   throws SQLException

Sets the auto-commit state.

Specified by:

setAutoCommit in interface Connection

Parameters:

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

Throws:

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

getAutoCommit

public boolean getAutoCommit()
                      throws 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 Connection

Returns:

True.

Throws:

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

commit

public void commit()
            throws SQLException

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

Specified by:

commit in interface Connection

Throws:

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

rollback

public void rollback()
              throws SQLException

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

Specified by:

rollback in interface Connection

Throws:

SQLException - This exception is always thrown.

close

public void close()
           throws 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 Connection

Throws:

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

isClosed

public boolean isClosed()
                 throws SQLException

Tests to see if a Connection is closed.

Specified by:

isClosed in interface Connection

Returns:

true if the connection is closed; false if it's still open

Throws:

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

getMetaData

public DatabaseMetaData getMetaData()
                             throws SQLException

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 made available through a DatabaseMetaData object.

Specified by:

getMetaData in interface Connection

Returns:

a DatabaseMetaData object for this Connection

Throws:

SQLException - This exception is thrown if an DatabaseMetaData object cannot be created.

setReadOnly

public void setReadOnly(boolean readOnly)
                 throws SQLException

SAS software does not support read-only connections. The input value is ignored.

Specified by:

setReadOnly in interface Connection

Parameters:

readOnly - This parameter is ignored.

Throws:

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

isReadOnly

public boolean isReadOnly()
                   throws SQLException

SAS software does not support read-only connections. The readOnly value is always False.

Specified by:

isReadOnly in interface Connection

Returns:

False.

Throws:

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

setCatalog

public void setCatalog(String catalog)
                throws SQLException

A sub-space of this Connection's database may be selected by setting a catalog name. If the driver does not support catalogs it will silently ignore this request. NOTE: SAS software does not support catalogs and so the catalog string will be silently ignored.

Specified by:

setCatalog in interface Connection

Throws:

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

getCatalog

public String getCatalog()
                  throws SQLException

Gets the Connection's current catalog name.

Specified by:

getCatalog in interface Connection

Returns:

NULL. SAS software does not support catalogs.

Throws:

SQLException - if a database-access error occurs.

setTransactionIsolation

public void setTransactionIsolation(int level)
                             throws SQLException

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

Specified by:

setTransactionIsolation in interface Connection

Parameters:

level - The transaction level.

Throws:

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

getTransactionIsolation

public int getTransactionIsolation()
                            throws SQLException

SAS software does not support transactions.

Specified by:

getTransactionIsolation in interface Connection

Returns:

java.sql.Connection.TRANSACTION_NONE.

Throws:

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

getWarnings

public SQLWarning getWarnings()
                       throws SQLException

Gets the warning reported by calls on this Connection.

Note: Subsequent warnings will be chained to this SQLWarning.

Specified by:

getWarnings in interface Connection

Returns:

The SQLWarning.

Throws:

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

clearWarnings

public void clearWarnings()
                   throws SQLException

Clears the warnings.

Specified by:

clearWarnings in interface Connection

Throws:

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

createStatement

public Statement createStatement(int resultSetType,
                                 int resultSetConcurrency)
                          throws 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 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:

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

prepareStatement

public PreparedStatement prepareStatement(String sql,
                                          int resultSetType,
                                          int resultSetConcurrency)
                                   throws 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 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:

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

prepareCall

public CallableStatement prepareCall(String sql,
                                     int resultSetType,
                                     int resultSetConcurrency)
                              throws 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 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:

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

getTypeMap

public Map getTypeMap()
               throws SQLException

* Gets the type-map object associated with this connection.

* By default, the map returned is empty. Method not supported.

JDBC 2.0

Specified by:

getTypeMap in interface Connection

Throws:

SQLException - This exception is always thrown as SAS software does not support user defined types.

setTypeMap

public void setTypeMap(Map map)
                throws SQLException

* Install a type-map object as the default type-map for this connection. Method not supported. JDBC 2.0

Specified by:

setTypeMap in interface Connection

Throws:

SQLException - This exception is always thrown as SAS software does not support user defined types.

createStatement

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

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

Specified by:

createStatement in interface Connection

Throws:

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

getHoldability

public int getHoldability()
                   throws SQLException

Retrieves the current holdability of ResultSet objects created using this Connection object. Empty method implementation for JDK1.4 compliance.

Specified by:

getHoldability in interface Connection

Throws:

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

prepareCall

public CallableStatement prepareCall(String sql,
                                     int resultSetType,
                                     int resultSetConcurrency,
                                     int resultSetHoldability)
                              throws 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 Connection

Throws:

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

prepareStatement

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

Creates a default PreparedStatement object that has the capability to retrieve auto-generated keys. Empty method implementation for JDK1.4 compliance.

Specified by:

prepareStatement in interface Connection

Throws:

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

prepareStatement

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

Creates a default PreparedStatement object capable of returning the auto-generated keys designated by the given array. Empty method implementation for JDK1.4 compliance.

Specified by:

prepareStatement in interface Connection

Throws:

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

prepareStatement

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

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

Specified by:

prepareStatement in interface Connection

Throws:

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

prepareStatement

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

Creates a default PreparedStatement object capable of returning the auto-generated keys designated by the given array. Empty method implementation for JDK1.4 compliance.

Specified by:

prepareStatement in interface Connection

Throws:

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

releaseSavepoint

public void releaseSavepoint(Savepoint savepoint)
                      throws SQLException

Removes the given Savepoint object from the current transaction. Empty method implementation for JDK1.4 compliance.

Specified by:

releaseSavepoint in interface Connection

Throws:

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

rollback

public void rollback(Savepoint savepoint)
              throws SQLException

Undoes all changes made after the given Savepoint object was set. Empty method implementation for JDK1.4 compliance.

Specified by:

rollback in interface Connection

Throws:

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

setHoldability

public void setHoldability(int holdability)
                    throws SQLException

Changes the holdability of ResultSet objects created using this Connection object to the given holdability. Empty method implementation for JDK1.4 compliance.

Specified by:

setHoldability in interface Connection

Throws:

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

setSavepoint

public Savepoint setSavepoint()
                       throws SQLException

Creates an unnamed savepoint in the current transaction and returns the new Savepoint object that represents it. Empty method implementation for JDK1.4 compliance.

Specified by:

setSavepoint in interface Connection

Throws:

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

setSavepoint

public Savepoint setSavepoint(String name)
                       throws SQLException

Creates a savepoint with the given name in the current transaction and returns the new Savepoint object that represents it. Empty method implementation for JDK1.4 compliance.

Specified by:

setSavepoint in interface Connection

Throws:

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