org.apache.torque.adapter
Class DBPostgres

java.lang.Object
  extended byorg.apache.torque.adapter.DB
      extended byorg.apache.torque.adapter.DBPostgres
All Implemented Interfaces:
IDMethod, java.io.Serializable

public class DBPostgres
extends DB

This is used to connect to PostgresQL databases. http://www.postgresql.org/

Version:
$Id: DBPostgres.java,v 1.16.2.4 2004/10/16 12:59:53 henning Exp $
Author:
Hakan Tandogan, Henning P. Schmiedehausen
See Also:
Serialized Form

Field Summary
 
Fields inherited from class org.apache.torque.adapter.DB
LIMIT_STYLE_DB2, LIMIT_STYLE_MYSQL, LIMIT_STYLE_NONE, LIMIT_STYLE_ORACLE, LIMIT_STYLE_POSTGRES, LIMIT_STYLE_SYBASE
 
Fields inherited from interface org.apache.torque.adapter.IDMethod
AUTO_INCREMENT, ID_BROKER, NATIVE, NO_ID_METHOD, SEQUENCE
 
Constructor Summary
protected DBPostgres()
          Empty constructor.
 
Method Summary
 java.lang.String getBooleanString(java.lang.Boolean b)
          Override the default behavior to associate b with null?
 java.lang.String getDateString(java.util.Date date)
          This method overrides the JDBC escapes used to format dates using a DateFormat.
 java.lang.String getIDMethodSQL(java.lang.Object name)
          Returns SQL used to get the most recently inserted primary key.
 java.lang.String getIDMethodType()
          Returns the constant from the IDMethod interface denoting which type of primary key generation method this type of RDBMS uses.
 int getLimitStyle()
          This method is used to chek whether the database supports limiting the size of the resultset.
 java.lang.String ignoreCase(java.lang.String in)
          This method is used to ignore case.
 void lockTable(java.sql.Connection con, java.lang.String table)
          Locks the specified table.
 boolean supportsNativeLimit()
          This method is used to chek whether the database natively supports limiting the size of the resultset.
 boolean supportsNativeOffset()
          This method is used to chek whether the database natively supports returning results starting at an offset position other than 0.
 java.lang.String toUpperCase(java.lang.String in)
          This method is used to ignore case.
 void unlockTable(java.sql.Connection con, java.lang.String table)
          Unlocks the specified table.
 
Methods inherited from class org.apache.torque.adapter.DB
escapeText, getStringDelimiter, ignoreCaseInOrderBy
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DBPostgres

protected DBPostgres()
Empty constructor.

Method Detail

toUpperCase

public java.lang.String toUpperCase(java.lang.String in)
This method is used to ignore case.

Specified by:
toUpperCase in class DB
Parameters:
in - The string to transform to upper case.
Returns:
The upper case string.

ignoreCase

public java.lang.String ignoreCase(java.lang.String in)
This method is used to ignore case.

Specified by:
ignoreCase in class DB
Parameters:
in - The string whose case to ignore.
Returns:
The string in a case that can be ignored.

getIDMethodType

public java.lang.String getIDMethodType()
Description copied from class: DB
Returns the constant from the IDMethod interface denoting which type of primary key generation method this type of RDBMS uses.

Specified by:
getIDMethodType in class DB
Returns:
IDMethod constant
See Also:
DB.getIDMethodType()

getIDMethodSQL

public java.lang.String getIDMethodSQL(java.lang.Object name)
Description copied from class: DB
Returns SQL used to get the most recently inserted primary key. Databases which have no support for this return null.

Specified by:
getIDMethodSQL in class DB
Parameters:
name - The name of the field (should be of type String).
Returns:
SQL to retreive the next database key.
See Also:
DB.getIDMethodSQL(Object)

lockTable

public void lockTable(java.sql.Connection con,
                      java.lang.String table)
               throws java.sql.SQLException
Locks the specified table.

Specified by:
lockTable in class DB
Parameters:
con - The JDBC connection to use.
table - The name of the table to lock.
Throws:
java.sql.SQLException - No Statement could be created or executed.

unlockTable

public void unlockTable(java.sql.Connection con,
                        java.lang.String table)
                 throws java.sql.SQLException
Unlocks the specified table.

Specified by:
unlockTable in class DB
Parameters:
con - The JDBC connection to use.
table - The name of the table to unlock.
Throws:
java.sql.SQLException - No Statement could be created or executed.

supportsNativeLimit

public boolean supportsNativeLimit()
This method is used to chek whether the database natively supports limiting the size of the resultset.

Overrides:
supportsNativeLimit in class DB
Returns:
True.

supportsNativeOffset

public boolean supportsNativeOffset()
This method is used to chek whether the database natively supports returning results starting at an offset position other than 0.

Overrides:
supportsNativeOffset in class DB
Returns:
True.

getLimitStyle

public int getLimitStyle()
This method is used to chek whether the database supports limiting the size of the resultset.

Overrides:
getLimitStyle in class DB
Returns:
LIMIT_STYLE_POSTGRES.

getBooleanString

public java.lang.String getBooleanString(java.lang.Boolean b)
Override the default behavior to associate b with null?

Overrides:
getBooleanString in class DB
Parameters:
b - the Boolean to format
Returns:
The proper date formatted String.
See Also:
DB.getBooleanString(Boolean)

getDateString

public java.lang.String getDateString(java.util.Date date)
This method overrides the JDBC escapes used to format dates using a DateFormat. This generates the timedate format defined in http://www.postgresql.org/docs/7.3/static/datatype-datetime.html which defined PostgreSQL dates as YYYY-MM-DD hh:mm:ss

Overrides:
getDateString in class DB
Parameters:
date - the date to format
Returns:
The properly formatted date String.


Copyright © 2000-2005 Apache Software Foundation. All Rights Reserved.