org.ballerinalang.database.sql

Class SQLDatasourceUtils

java.lang.Object

org.ballerinalang.database.sql.SQLDatasourceUtils

public class SQLDatasourceUtils
extends Object

Class contains utility methods for SQL Connector operations.

Since:

0.8.0

Field Summary

Fields

Modifier and Type	Field and Description
static String	POSTGRES_DATABASE_NAME
static String	POSTGRES_OID_COLUMN_TYPE_NAME

Constructor Summary

Constructors

Constructor and Description
SQLDatasourceUtils()

Method Summary

Modifier and Type	Method and Description
static void	cleanupResources(List<ResultSet> resultSets, Statement stmt, Connection conn, boolean connectionClosable) This will close database connection, statement and result sets.
static void	cleanupResources(ResultSet rs, Statement stmt, Connection conn, boolean connectionClosable) This will close database connection, statement and the resultset.
static void	cleanupResources(Statement stmt, Connection conn, boolean connectionClosable) This will close database connection and statement.
static String	createJDBCDbOptions(String propertiesBeginSymbol, String separator, Map<String,Value> dbOptions)
static BMap<String,BValue>	createMultiModeDBClient(Context context, String dbType, Struct clientEndpointConfig, String urlOptions)
static BMap<String,BValue>	createServerBasedDBClient(Context context, String dbType, Struct clientEndpointConfig, String urlOptions)
static BMap<String,BValue>	createSQLDBClient(Context context, Struct clientEndpointConfig)
static List<ColumnDefinition>	getColumnDefinitions(ResultSet rs)
static Connection	getDatabaseConnection(Context context, SQLDatasource datasource, boolean isSelectQuery)
static BError	getSQLConnectorError(Context context, Throwable throwable)
static String	getSQLType(BType value)
static String	getString(Array dataArray) This will retrieve the string value for the given array data.
static String	getString(Blob data) This will retrieve the string value for the given blob.
static String	getString(byte[] data) This will retrieve the string value for the given binary data.
static String	getString(Clob data) This will retrieve the string value for the given clob.
static String	getString(Date value)
static String	getString(Struct udt) This will retrieve the string value for the given struct data.
static void	handleErrorOnTransaction(Context context)
static void	setArrayValue(Connection conn, PreparedStatement stmt, BValue value, int index, int direction, int sqlType, String databaseProductName)
static void	setBigIntValue(PreparedStatement stmt, BValue value, int index, int direction, int sqlType)
static void	setBinaryValue(PreparedStatement stmt, BValue value, int index, int direction, int sqlType)
static void	setBlobValue(PreparedStatement stmt, BValue value, int index, int direction, int sqlType)
static void	setBooleanValue(PreparedStatement stmt, BValue value, int index, int direction, int sqlType)
static void	setClobValue(PreparedStatement stmt, BValue value, int index, int direction, int sqlType)
static void	setDateValue(PreparedStatement stmt, BValue value, int index, int direction, int sqlType)
static void	setDoubleValue(PreparedStatement stmt, BValue value, int index, int direction, int sqlType)
static void	setIntValue(PreparedStatement stmt, BValue value, int index, int direction, int sqlType)
static void	setNClobValue(PreparedStatement stmt, BValue value, int index, int direction, int sqlType)
static void	setNStringValue(PreparedStatement stmt, BValue value, int index, int direction, int sqlType)
static void	setNullObject(PreparedStatement stmt, int index)
static void	setNumericValue(PreparedStatement stmt, BValue value, int index, int direction, int sqlType)
static void	setRealValue(PreparedStatement stmt, BValue value, int index, int direction, int sqlType)
static void	setRefCursorValue(PreparedStatement stmt, int index, int direction, String databaseProductName)
static void	setSmallIntValue(PreparedStatement stmt, BValue value, int index, int direction, int sqlType)
static void	setStringValue(PreparedStatement stmt, BValue value, int index, int direction, int sqlType)
static void	setTimeStampValue(PreparedStatement stmt, BValue value, int index, int direction, int sqlType, Calendar utcCalendar)
static void	setTimeValue(PreparedStatement stmt, BValue value, int index, int direction, int sqlType, Calendar utcCalendar)
static void	setTinyIntValue(PreparedStatement stmt, BValue value, int index, int direction, int sqlType)
static void	setUserDefinedValue(Connection conn, PreparedStatement stmt, BValue value, int index, int direction, int sqlType)

Methods inherited from class java.lang.Object

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

Field Detail

POSTGRES_DATABASE_NAME

public static final String POSTGRES_DATABASE_NAME

See Also:

Constant Field Values

POSTGRES_OID_COLUMN_TYPE_NAME

public static final String POSTGRES_OID_COLUMN_TYPE_NAME

See Also:

Constant Field Values

Constructor Detail

SQLDatasourceUtils

public SQLDatasourceUtils()

Method Detail

setIntValue

public static void setIntValue(PreparedStatement stmt,
                               BValue value,
                               int index,
                               int direction,
                               int sqlType)

setSmallIntValue

public static void setSmallIntValue(PreparedStatement stmt,
                                    BValue value,
                                    int index,
                                    int direction,
                                    int sqlType)

setStringValue

public static void setStringValue(PreparedStatement stmt,
                                  BValue value,
                                  int index,
                                  int direction,
                                  int sqlType)

setNStringValue

public static void setNStringValue(PreparedStatement stmt,
                                   BValue value,
                                   int index,
                                   int direction,
                                   int sqlType)

setDoubleValue

public static void setDoubleValue(PreparedStatement stmt,
                                  BValue value,
                                  int index,
                                  int direction,
                                  int sqlType)

setNumericValue

public static void setNumericValue(PreparedStatement stmt,
                                   BValue value,
                                   int index,
                                   int direction,
                                   int sqlType)

setBooleanValue

public static void setBooleanValue(PreparedStatement stmt,
                                   BValue value,
                                   int index,
                                   int direction,
                                   int sqlType)

setTinyIntValue

public static void setTinyIntValue(PreparedStatement stmt,
                                   BValue value,
                                   int index,
                                   int direction,
                                   int sqlType)

setBigIntValue

public static void setBigIntValue(PreparedStatement stmt,
                                  BValue value,
                                  int index,
                                  int direction,
                                  int sqlType)

setRealValue

public static void setRealValue(PreparedStatement stmt,
                                BValue value,
                                int index,
                                int direction,
                                int sqlType)

setDateValue

public static void setDateValue(PreparedStatement stmt,
                                BValue value,
                                int index,
                                int direction,
                                int sqlType)

setTimeStampValue

public static void setTimeStampValue(PreparedStatement stmt,
                                     BValue value,
                                     int index,
                                     int direction,
                                     int sqlType,
                                     Calendar utcCalendar)

setTimeValue

public static void setTimeValue(PreparedStatement stmt,
                                BValue value,
                                int index,
                                int direction,
                                int sqlType,
                                Calendar utcCalendar)

setBinaryValue

public static void setBinaryValue(PreparedStatement stmt,
                                  BValue value,
                                  int index,
                                  int direction,
                                  int sqlType)

setBlobValue

public static void setBlobValue(PreparedStatement stmt,
                                BValue value,
                                int index,
                                int direction,
                                int sqlType)

setClobValue

public static void setClobValue(PreparedStatement stmt,
                                BValue value,
                                int index,
                                int direction,
                                int sqlType)

setNClobValue

public static void setNClobValue(PreparedStatement stmt,
                                 BValue value,
                                 int index,
                                 int direction,
                                 int sqlType)

setRefCursorValue

public static void setRefCursorValue(PreparedStatement stmt,
                                     int index,
                                     int direction,
                                     String databaseProductName)

setArrayValue

public static void setArrayValue(Connection conn,
                                 PreparedStatement stmt,
                                 BValue value,
                                 int index,
                                 int direction,
                                 int sqlType,
                                 String databaseProductName)

setNullObject

public static void setNullObject(PreparedStatement stmt,
                                 int index)

setUserDefinedValue

public static void setUserDefinedValue(Connection conn,
                                       PreparedStatement stmt,
                                       BValue value,
                                       int index,
                                       int direction,
                                       int sqlType)

cleanupResources

public static void cleanupResources(List<ResultSet> resultSets,
                                    Statement stmt,
                                    Connection conn,
                                    boolean connectionClosable)

This will close database connection, statement and result sets.

Parameters:

resultSets - SQL result sets

stmt - SQL statement

conn - SQL connection

connectionClosable - Whether the connection is closable or not. If the connection is not closable this method will not release the connection. Therefore to avoid connection leaks it should have been taken care of externally.

cleanupResources

public static void cleanupResources(ResultSet rs,
                                    Statement stmt,
                                    Connection conn,
                                    boolean connectionClosable)

This will close database connection, statement and the resultset.

Parameters:

rs - SQL resultset

stmt - SQL statement

conn - SQL connection

connectionClosable - Whether the connection is closable or not. If the connection is not closable this method will not release the connection. Therefore to avoid connection leaks it should have been taken care of externally.

cleanupResources

public static void cleanupResources(Statement stmt,
                                    Connection conn,
                                    boolean connectionClosable)

This will close database connection and statement.

Parameters:

stmt - SQL statement

conn - SQL connection

connectionClosable - Whether the connection is closable or not. If the connection is not closable this method will not release the connection. Therefore to avoid connection leaks it should have been taken care of externally.

getSQLType

public static String getSQLType(BType value)

getString

public static String getString(Clob data)

This will retrieve the string value for the given clob.

Parameters:

data - clob data

Returns:

string value

getString

public static String getString(Blob data)

This will retrieve the string value for the given blob.

Parameters:

data - blob data

Returns:

string value

getString

public static String getString(byte[] data)

This will retrieve the string value for the given binary data.

Parameters:

data - binary data

Returns:

string value

getString

public static String getString(Date value)

getString

public static String getString(Array dataArray)
                        throws SQLException

This will retrieve the string value for the given array data.

Parameters:

dataArray - data

Returns:

string value

Throws:

SQLException - sql exception when reading result set

getString

public static String getString(Struct udt)
                        throws SQLException

This will retrieve the string value for the given struct data.

Parameters:

udt - struct

Returns:

string value

Throws:

SQLException - sql exception when reading result set

getSQLConnectorError

public static BError getSQLConnectorError(Context context,
                                          Throwable throwable)

handleErrorOnTransaction

public static void handleErrorOnTransaction(Context context)

createServerBasedDBClient

public static BMap<String,BValue> createServerBasedDBClient(Context context,
                                                            String dbType,
                                                            Struct clientEndpointConfig,
                                                            String urlOptions)

createSQLDBClient

public static BMap<String,BValue> createSQLDBClient(Context context,
                                                    Struct clientEndpointConfig)

createMultiModeDBClient

public static BMap<String,BValue> createMultiModeDBClient(Context context,
                                                          String dbType,
                                                          Struct clientEndpointConfig,
                                                          String urlOptions)

getColumnDefinitions

public static List<ColumnDefinition> getColumnDefinitions(ResultSet rs)
                                                   throws SQLException

Throws:

SQLException

getDatabaseConnection

public static Connection getDatabaseConnection(Context context,
                                               SQLDatasource datasource,
                                               boolean isSelectQuery)
                                        throws SQLException

Throws:

SQLException

createJDBCDbOptions

public static String createJDBCDbOptions(String propertiesBeginSymbol,
                                         String separator,
                                         Map<String,Value> dbOptions)