1
/*-------------------------------------------------------------------------
3
* Copyright (c) 2003-2005, PostgreSQL Global Development Group
6
* $PostgreSQL: pgjdbc/org/postgresql/core/BaseConnection.java,v 1.15 2005/08/01 06:54:14 oliver Exp $
8
*-------------------------------------------------------------------------
10
package org.postgresql.core;
13
import org.postgresql.PGConnection;
14
import org.postgresql.jdbc2.TimestampUtils;
17
* Driver-internal connection interface. Application code should not use
20
public interface BaseConnection extends PGConnection, Connection
23
* Cancel the current query executing on this connection.
25
* @throws SQLException if something goes wrong.
27
public void cancelQuery() throws SQLException;
30
* Execute a SQL query that returns a single resultset.
31
* Never causes a new transaction to be started regardless of the autocommit setting.
33
* @param s the query to execute
34
* @return the (non-null) returned resultset
35
* @throws SQLException if something goes wrong.
37
public ResultSet execSQLQuery(String s) throws SQLException;
40
* Execute a SQL query that does not return results.
41
* Never causes a new transaction to be started regardless of the autocommit setting.
43
* @param s the query to execute
44
* @throws SQLException if something goes wrong.
46
public void execSQLUpdate(String s) throws SQLException;
49
* Get the QueryExecutor implementation for this connection.
51
* @return the (non-null) executor
53
public QueryExecutor getQueryExecutor();
56
* Construct and return an appropriate object for the given
57
* type and value. This only considers the types registered via
58
* {@link org.postgresql.PGConnection#addDataType(String,Class)} and
59
* {@link org.postgresql.PGConnection#addDataType(String,String)}.
61
* If no class is registered as handling the given type, then a generic
62
* {@link org.postgresql.util.PGobject} instance is returned.
64
* @param type the backend typename
65
* @param value the type-specific string representation of the value
66
* @return an appropriate object; never null.
67
* @throws SQLException if something goes wrong
69
public Object getObject(String type, String value) throws SQLException;
72
public String getJavaClass(int oid) throws SQLException;
75
* Look up the postgresql type name for a given oid. This is the
76
* inverse of {@link #getPGType(String)}.
78
* @param oid the type's OID
79
* @return the server type name for that OID, or null if unknown
80
* @throws SQLException if something goes wrong
82
public String getPGType(int oid) throws SQLException;
85
* Look up the oid for a given postgresql type name. This is the
86
* inverse of {@link #getPGType(int)}.
88
* @param pgTypeName the server type name to look up
89
* @return oid the type's OID, or 0 if unknown
90
* @throws SQLException if something goes wrong
92
public int getPGType(String pgTypeName) throws SQLException;
95
* Look up the SQL typecode for a given type oid.
97
* @param oid the type's OID
98
* @return the SQL typecode (a constant from {@link java.sql.Types}) for the type
99
* @throws SQLException if something goes wrong
101
public int getSQLType(int oid) throws SQLException;
104
* Look up the SQL typecode for a given postgresql type name.
106
* @param pgTypeName the server type name to look up
107
* @return the SQL typecode (a constant from {@link java.sql.Types}) for the type
108
* @throws SQLException if something goes wrong
110
public int getSQLType(String pgTypeName) throws SQLException;
113
* Check if we should use driver behaviour introduced in a particular
114
* driver version. This defaults to behaving as the actual driver's version
115
* but can be overridden by the "compatible" URL parameter.
117
* @param ver the driver version to check
118
* @return true if the driver's behavioural version is at least "ver".
119
* @throws SQLException if something goes wrong
121
public boolean haveMinimumCompatibleVersion(String ver);
124
* Check if we have at least a particular server version.
126
* @param ver the server version to check
127
* @return true if the server version is at least "ver".
128
* @throws SQLException if something goes wrong
130
public boolean haveMinimumServerVersion(String ver);
133
* Encode a string using the database's client_encoding
134
* (usually UNICODE, but can vary on older server versions).
135
* This is used when constructing synthetic resultsets (for
136
* example, in metadata methods).
138
* @param str the string to encode
139
* @return an encoded representation of the string
140
* @throws SQException if something goes wrong.
142
public byte[] encodeString(String str) throws SQLException;
144
// Ew. Quick hack to give access to the connection-specific utils implementation.
145
public TimestampUtils getTimestampUtils();
added
removed
org/postgresql/core/BaseConnection.java
