votorola.g.sql

Class Database

java.lang.Object

Database

@ThreadRestricted(value="holds this")
public final class Database
extends Object

An interface to a PostgreSQL relational database.

See Also:

Database.ConstructionContext

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Database.ConstructionContext A context for configuring a PostgreSQL database.

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAX_IDENTIFIER_LENGTH Maximum length of an SQL identifier, for PostgreSQL (default build).

Constructor Summary

Constructors

Constructor and Description
Database(Database.ConstructionContext cc) Partially constructs a Database.

Method Summary

Methods

Modifier and Type	Method and Description
Connection	connection() Returns the database connection of this interface.
void	ensureSchema(String name) Ensures the specified schema exists in this database, creating it if necessary.
boolean	equals(Object o) Returns true iff o is a database configured with the same name, server name, port and user.
int	hashCode()
void	init(org.postgresql.ds.PGSimpleDataSource s) Finishes constructing this Database.
void	logAndClearWarnings() Logs any warnings recorded in the connection, and clears them.
HashMap<String,PreparedStatement>	statementCache() A map of client-prepared statements for reuse with this database.

Methods inherited from class java.lang.Object

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

Field Detail

MAX_IDENTIFIER_LENGTH

public static final int MAX_IDENTIFIER_LENGTH

Maximum length of an SQL identifier, for PostgreSQL (default build).

See Also:

Constant Field Values

Constructor Detail

Database

public Database(Database.ConstructionContext cc)

Partially constructs a Database. This is relatively inexpensive. The result is suitable for a hashtable lookup and not much else. Call init(s) to complete it.

Method Detail

init

@ThreadSafe
public void init(org.postgresql.ds.PGSimpleDataSource s)
          throws SQLException

Finishes constructing this Database. This is relatively expensive.

Throws:

IllegalStateException - if init was already called.

SQLException

connection

@Warning(value="thread restricted object")
public Connection connection()

Returns the database connection of this interface. Do not close it.

ensureSchema

public void ensureSchema(String name)
                  throws SQLException

Ensures the specified schema exists in this database, creating it if necessary.

Throws:

SQLException

logAndClearWarnings

@ThreadSafe
public void logAndClearWarnings()

Logs any warnings recorded in the connection, and clears them.

statementCache

public HashMap<String,PreparedStatement> statementCache()

A map of client-prepared statements for reuse with this database.

equals

@ThreadSafe
public final boolean equals(Object o)

Returns true iff o is a database configured with the same name, server name, port and user.

Overrides:

equals in class Object

hashCode

@ThreadSafe
public final int hashCode()

Overrides:

hashCode in class Object