net.as_development.asdk.db_service.impl.sql.generator

Class AnsiSqlGenerator

java.lang.Object

net.as_development.asdk.db_service.impl.sql.generator.AnsiSqlGenerator

All Implemented Interfaces:

ISqlGenerator

public class AnsiSqlGenerator
extends Object
implements ISqlGenerator

Generated sql statements are generic ones. They use real table and column names ... but place holder for values. Those statements can be used to create e.g. prepared statements then and reuse them by adding real entity values if required.

Nested Class Summary

Nested classes/interfaces inherited from interface net.as_development.asdk.db_service.ISqlGenerator

ISqlGenerator.ESqlError, ISqlGenerator.EStatementType

Field Summary

Fields

Modifier and Type	Field and Description
static String	ANSI_QUOTE
static int	BOOLEAN_FALSE
static int	BOOLEAN_TRUE
static int	MAX_STRING_LENGTH
static String	SQLTYPE_BOOLEAN
static String	SQLTYPE_BYTE
static String	SQLTYPE_CHAR
static String	SQLTYPE_DATE
static String	SQLTYPE_DOUBLE
static String	SQLTYPE_FLOAT
static String	SQLTYPE_INT
static String	SQLTYPE_LONG
static String	SQLTYPE_SHORT

Constructor Summary

Constructors

Constructor and Description
AnsiSqlGenerator()

Method Summary

Modifier and Type	Method and Description
String	createSql(ISqlGenerator.EStatementType eStatement, Row aMeta, IDBBackendQuery iQuery) create a new SQL statement for the given set of parameters.
Object	getValueFromResultSet(ResultSet aResult, String sColumn, Class<?> aType) extract an entity member value from the given result set.
Long	mapDate(Date aDate)
Date	mapDate(Long nDate) maps the given date/time-stamp (as long ms from the beginning of the world) to the corresponding Date object.
String	mapJavaTypeToSqlType(Column aColumn) map the given Java type of an entity member to the corresponding SQL type to be used within SQL statements.
ISqlGenerator.ESqlError	mapSqlExceptionToError(SQLException exSQL) map the given SQL exception to an suitable error code.
void	setValueOnPreparedStatement(PreparedStatement aSql, int nIndex, Class<?> aType, Object aValue) set the given value on the also given PreparedStatement.

Methods inherited from class java.lang.Object

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

Field Detail

ANSI_QUOTE

public static final String ANSI_QUOTE

See Also:

Constant Field Values

BOOLEAN_FALSE

public static final int BOOLEAN_FALSE

See Also:

Constant Field Values

BOOLEAN_TRUE

public static final int BOOLEAN_TRUE

See Also:

Constant Field Values

MAX_STRING_LENGTH

public static final int MAX_STRING_LENGTH

See Also:

Constant Field Values

SQLTYPE_CHAR

public static final String SQLTYPE_CHAR

See Also:

Constant Field Values

SQLTYPE_BOOLEAN

public static final String SQLTYPE_BOOLEAN

See Also:

Constant Field Values

SQLTYPE_BYTE

public static final String SQLTYPE_BYTE

See Also:

Constant Field Values

SQLTYPE_SHORT

public static final String SQLTYPE_SHORT

See Also:

Constant Field Values

SQLTYPE_INT

public static final String SQLTYPE_INT

See Also:

Constant Field Values

SQLTYPE_LONG

public static final String SQLTYPE_LONG

See Also:

Constant Field Values

SQLTYPE_FLOAT

public static final String SQLTYPE_FLOAT

See Also:

Constant Field Values

SQLTYPE_DOUBLE

public static final String SQLTYPE_DOUBLE

See Also:

Constant Field Values

SQLTYPE_DATE

public static final String SQLTYPE_DATE

See Also:

Constant Field Values

Constructor Detail

AnsiSqlGenerator

public AnsiSqlGenerator()

Method Detail

mapSqlExceptionToError

public ISqlGenerator.ESqlError mapSqlExceptionToError(SQLException exSQL)
                                               throws Exception

Description copied from interface: ISqlGenerator

map the given SQL exception to an suitable error code. Because such states depend from the real DB used here ... and ISqlGenerator implementation represent such 'real DB' ... it's up to this code to map those error states/codes.

Specified by:

mapSqlExceptionToError in interface ISqlGenerator

Parameters:

exSQL - [IN] the SQL exception to be 'translated' here.

Returns:

the corresponding internal error code.

Throws:

Exception

createSql

public String createSql(ISqlGenerator.EStatementType eStatement,
                        Row aMeta,
                        IDBBackendQuery iQuery)
                 throws Exception

Description copied from interface: ISqlGenerator

create a new SQL statement for the given set of parameters. Those statement must contain place holder instead of real values. Because it's used later in combination with a PreparedStatement instance.

Specified by:

createSql in interface ISqlGenerator

Parameters:

eStatement - [IN] describe the requested SQL statement.

aMeta - [IN] all meta data describing the entity more in detail.

iQuery - [IN, OPTIONAL] describe a SQL query more in detail. Can be null if no query is requested.

Returns:

the generated SQL statement containing place holder.

Throws:

Exception

mapJavaTypeToSqlType

public String mapJavaTypeToSqlType(Column aColumn)
                            throws Exception

Description copied from interface: ISqlGenerator

map the given Java type of an entity member to the corresponding SQL type to be used within SQL statements.

Specified by:

mapJavaTypeToSqlType in interface ISqlGenerator

Parameters:

aColumn - [IN] describe the entity member type.

Returns:

the corresponding SQL type.

Throws:

Exception

setValueOnPreparedStatement

public void setValueOnPreparedStatement(PreparedStatement aSql,
                                        int nIndex,
                                        Class<?> aType,
                                        Object aValue)
                                 throws Exception

Description copied from interface: ISqlGenerator

set the given value on the also given PreparedStatement.

Specified by:

setValueOnPreparedStatement in interface ISqlGenerator

Parameters:

aSql - [IN, OUT] the prepared statement where the value must be set.

nIndex - [IN] the position of the place holder which must be replaced within the prepared statement.

aType - [IN] the java type of the given value.

aValue - [IN] the value to be set on the prepared statement.

Throws:

Exception

getValueFromResultSet

public Object getValueFromResultSet(ResultSet aResult,
                                    String sColumn,
                                    Class<?> aType)
                             throws Exception

Description copied from interface: ISqlGenerator

extract an entity member value from the given result set.

Specified by:

getValueFromResultSet in interface ISqlGenerator

Parameters:

aResult - [IN] the result set where the value must be read from.

sColumn - [IN] the column where the value must be read from.

aType - [IN] the java type of this value so it's casted right.

Returns:

the value.

Throws:

Exception

mapDate

public Date mapDate(Long nDate)
             throws Exception

maps the given date/time-stamp (as long ms from the beginning of the world) to the corresponding Date object.

Parameters:

nDate - [IN] date/time stamp in ms from ...

Returns:

the corresponding Date object or null if nDate is null.

Throws:

Exception

mapDate

public Long mapDate(Date aDate)
             throws Exception

Throws:

Exception