org.postgresql.jdbc

Class ClientLogicImpl

java.lang.Object

org.postgresql.jdbc.ClientLogicImpl

public class ClientLogicImpl
extends Object

Constructor Summary

Constructors

Constructor and Description
ClientLogicImpl()

Method Summary

Modifier and Type	Method and Description
protected void	close() closes the backend libpq connection - must be called when the java connectyion is closed.
Object[]	fetchDataFromQuery(String query) This method is being invoked from the client logic c++ code It is used to fetch data from the server regarding the client logic settings - cache manager
protected void	finalize() Standard java method
long	getHandle() getter function to get the handler
Object[]	linkClientLogic(String databaseName, PgConnection jdbcConn) Link between the Java PgConnection and the PGConn Client logic object
Object[]	prepareQuery(String query, String statement_name, int parameter_count) Prepare a statement on the backend side
Object[]	replaceErrorMessage(String originalMessage) Replace binary client logic values in an error message back to user input format For example changes unique constraint error message from: ...
Object[]	replaceStatementParams(String statementName, String[] paramValues) replace parameters values in prepared statement - to be called before binding the parameters and executing the statement
Object[]	runClientLogic(String processData, int dataType) Replace client logic field value with user input - used when receiving data in a resultset
Object[]	runQueryPostProcess() run post process on the backend, to free the client logic state machine when a query is done
Object[]	runQueryPreProcess(String originalQuery) Run the pre query, to replace client logic field values with binary format before sending the query to the database server
void	setHandle(long handle) setter function to set the handle

Methods inherited from class java.lang.Object

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

Constructor Detail

ClientLogicImpl

public ClientLogicImpl()

Method Detail

linkClientLogic

public Object[] linkClientLogic(String databaseName,
                                PgConnection jdbcConn)

Link between the Java PgConnection and the PGConn Client logic object

Parameters:

databaseName - the database name

jdbcConn - the JDBC connection to be later use to fetch data

Returns:

[0][0] - int status code - zero for success [0][1] - string status description [1] - long - instance handle to be re-used in future calls by the same connection

runQueryPreProcess

public Object[] runQueryPreProcess(String originalQuery)

Run the pre query, to replace client logic field values with binary format before sending the query to the database server

Parameters:

originalQuery - the query with potentially client logic values in user format

Returns:

array of objects [0][0] - int status code - zero for success [0][1] - string status description [1] - String - The modified query

runClientLogic

public Object[] runClientLogic(String processData,
                               int dataType)

Replace client logic field value with user input - used when receiving data in a resultset

Parameters:

processData - the data in binary format (hexa)

dataType - the oid (modid) of the original field type

Returns:

array of objects [0][0] - int status code - zero for success [0][1] - string status description [1] - String - The data in user format

runQueryPostProcess

public Object[] runQueryPostProcess()

run post process on the backend, to free the client logic state machine when a query is done

Returns:

array of objects [0][0] - int status code - zero for success [0][1] - string status description

prepareQuery

public Object[] prepareQuery(String query,
                             String statement_name,
                             int parameter_count)

Prepare a statement on the backend side

Parameters:

query - the statement query text

statement_name - the name on the the statement

parameter_count - number of parameters in the query

Returns:

array of objects [0][0] - int status code - zero for success [0][1] - string status description [1] - String - The modified query - to be used if the query had client logic fields in user format that have to be replaces with binary value

replaceStatementParams

public Object[] replaceStatementParams(String statementName,
                                       String[] paramValues)

replace parameters values in prepared statement - to be called before binding the parameters and executing the statement

Parameters:

statementName - the name of the statement

paramValues - array of parameters in user format

Returns:

array of objects [0][0] - int status code - zero for success [0][1] - string status description [1][0 ... parameter_count - 1] - array with the parameters value, if the parameter is not being replace a NULL apears otherwise the replaced value

replaceErrorMessage

public Object[] replaceErrorMessage(String originalMessage)

Replace binary client logic values in an error message back to user input format For example changes unique constraint error message from: ... Key (name)=(\xa1d4....) already exists. ... to: ... Key (name)=(John) already exists. ...

Parameters:

originalMessage - the error message received from the server

Returns:

array of objects [0][0] - int status code - zero for success [0][1] - string status description [1] - String - The modified message, may return empty string if the message has no client loic values in it

close

protected void close()

closes the backend libpq connection - must be called when the java connectyion is closed.

finalize

protected void finalize()

Standard java method

Overrides:

finalize in class Object

setHandle

public void setHandle(long handle)

setter function to set the handle

Parameters:

handle -

getHandle

public long getHandle()

getter function to get the handler

Returns:

fetchDataFromQuery

public Object[] fetchDataFromQuery(String query)

This method is being invoked from the client logic c++ code It is used to fetch data from the server regarding the client logic settings - cache manager

Parameters:

query - the query to incoke

Returns:

array of results in the following format [0] - array of column headers [1...n] - array of results