monetdb-java: src/main/java/nl/cwi/monetdb/jdbc/MonetConnection.java annotate

annotate src/main/java/nl/cwi/monetdb/jdbc/MonetConnection.java @ 278:1d6062d94377

Reduce duplicate code.

author	Martin van Dinther <martin.van.dinther@monetdbsolutions.com>
date	Thu, 18 Jul 2019 13:19:25 +0200 (2019-07-18)
parents	4880267d0fe1
children	e5b99c929a2d

rev	line source
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1 /*
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2 * This Source Code Form is subject to the terms of the Mozilla Public
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3 * License, v. 2.0. If a copy of the MPL was not distributed with this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	4 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	5 *
261 d4baf8a4b43a Update Copyright year to 2019 Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 249 diff changeset	6 * Copyright 1997 - July 2008 CWI, August 2008 - 2019 MonetDB B.V.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	7 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	8
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	9 package nl.cwi.monetdb.jdbc;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	10
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	11 import java.io.File;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	12 import java.io.IOException;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	13 import java.net.SocketException;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	14 import java.net.SocketTimeoutException;
225 5ddb1f20d5d5 Socket may also throw an UnknownHostException. Add it to MapiSocket.connect() and catch it in MonetConnection(Properties props). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 219 diff changeset	15 import java.net.UnknownHostException;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	16 import java.sql.CallableStatement;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	17 import java.sql.Connection;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	18 import java.sql.DatabaseMetaData;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	19 import java.sql.PreparedStatement;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	20 import java.sql.ResultSet;
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 186 diff changeset	21 import java.sql.SQLClientInfoException;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	22 import java.sql.SQLException;
266 eefa7f625673 Resolve javadoc errors: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 262 diff changeset	23 import java.sql.SQLFeatureNotSupportedException;
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	24 import java.sql.SQLNonTransientConnectionException;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	25 import java.sql.SQLWarning;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	26 import java.sql.Savepoint;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	27 import java.sql.Statement;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	28 import java.util.ArrayList;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	29 import java.util.Calendar;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	30 import java.util.HashMap;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	31 import java.util.List;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	32 import java.util.Map;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	33 import java.util.Map.Entry;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	34 import java.util.Properties;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	35 import java.util.WeakHashMap;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	36 import java.util.concurrent.Executor;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	37 import java.util.concurrent.locks.Condition;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	38 import java.util.concurrent.locks.Lock;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	39 import java.util.concurrent.locks.ReentrantLock;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	40
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	41 import nl.cwi.monetdb.jdbc.types.INET;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	42 import nl.cwi.monetdb.jdbc.types.URL;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	43 import nl.cwi.monetdb.mcl.MCLException;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	44 import nl.cwi.monetdb.mcl.io.BufferedMCLReader;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	45 import nl.cwi.monetdb.mcl.io.BufferedMCLWriter;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	46 import nl.cwi.monetdb.mcl.net.MapiSocket;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	47 import nl.cwi.monetdb.mcl.parser.HeaderLineParser;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	48 import nl.cwi.monetdb.mcl.parser.MCLParseException;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	49 import nl.cwi.monetdb.mcl.parser.StartOfHeaderParser;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	50
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	51 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	52 * A {@link Connection} suitable for the MonetDB database.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	53 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	54 * This connection represents a connection (session) to a MonetDB
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	55 * database. SQL statements are executed and results are returned within
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	56 * the context of a connection. This Connection object holds a physical
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	57 * connection to the MonetDB database.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	58 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	59 * A Connection object's database should able to provide information
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	60 * describing its tables, its supported SQL grammar, its stored
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	61 * procedures, the capabilities of this connection, and so on. This
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	62 * information is obtained with the getMetaData method.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	63 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	64 * Note: By default a Connection object is in auto-commit mode, which
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	65 * means that it automatically commits changes after executing each
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	66 * statement. If auto-commit mode has been disabled, the method commit
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	67 * must be called explicitly in order to commit changes; otherwise,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	68 * database changes will not be saved.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	69 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	70 * The current state of this connection is that it nearly implements the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	71 * whole Connection interface.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	72 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	73 * @author Fabian Groffen
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	74 * @author Martin van Dinther
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	75 * @version 1.3
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	76 */
164 7c9e386fe49a As of Java 1.7 implementations of JDBC interfaces Connection, Statement, PreparedStatement, Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 144 diff changeset	77 public class MonetConnection
7c9e386fe49a As of Java 1.7 implementations of JDBC interfaces Connection, Statement, PreparedStatement, Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 144 diff changeset	78 extends MonetWrapper
7c9e386fe49a As of Java 1.7 implementations of JDBC interfaces Connection, Statement, PreparedStatement, Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 144 diff changeset	79 implements Connection, AutoCloseable
7c9e386fe49a As of Java 1.7 implementations of JDBC interfaces Connection, Statement, PreparedStatement, Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 144 diff changeset	80 {
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	81 /** the successful processed input properties */
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	82 private final Properties conn_props = new Properties();
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	83
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	84 /** The hostname to connect to */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	85 private final String hostname;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	86 /** The port to connect on the host to */
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	87 private int port = 0;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	88 /** The database to use (currently not used) */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	89 private final String database;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	90 /** The username to use when authenticating */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	91 private final String username;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	92 /** The password to use when authenticating */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	93 private final String password;
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	94
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	95 /** A connection to mserver5 using a TCP socket */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	96 private final MapiSocket server;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	97 /** The Reader from the server */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	98 private final BufferedMCLReader in;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	99 /** The Writer to the server */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	100 private final BufferedMCLWriter out;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	101
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	102 /** A StartOfHeaderParser declared for reuse. */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	103 private StartOfHeaderParser sohp = new StartOfHeaderParser();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	104
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	105 /** Whether this Connection is closed (and cannot be used anymore) */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	106 private boolean closed;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	107
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	108 /** Whether this Connection is in autocommit mode */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	109 private boolean autoCommit = true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	110
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	111 /** The stack of warnings for this Connection object */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	112 private SQLWarning warnings = null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	113 /** The Connection specific mapping of user defined types to Java
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	114 * types */
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	115 private Map<String,Class<?>> typeMap = new HashMap<String,Class<?>>() {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	116 private static final long serialVersionUID = 1L;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	117 {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	118 put("inet", INET.class);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	119 put("url", URL.class);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	120 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	121 };
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	122
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	123 // See javadoc for documentation about WeakHashMap if you don't know what
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	124 // it does !!!NOW!!! (only when you deal with it of course)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	125 /** A Map containing all (active) Statements created from this Connection */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	126 private Map<Statement,?> statements = new WeakHashMap<Statement, Object>();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	127
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	128 /** The number of results we receive from the server at once */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	129 private int curReplySize = -1; // the server by default uses -1 (all)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	130
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	131 /** A template to apply to each query (like pre and post fixes), filled in constructor */
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	132 public final String[] queryTempl = new String[3]; // pre, post, sep
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	133
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	134 /** A template to apply to each command (like pre and post fixes), filled in constructor */
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	135 private final String[] commandTempl = new String[3]; // pre, post, sep
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	136
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	137 /** the SQL language */
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	138 private static final int LANG_SQL = 0;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	139 /** the MAL language (officially NOT supported) */
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	140 private static final int LANG_MAL = 3;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	141 /** an unknown language */
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	142 private static final int LANG_UNKNOWN = -1;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	143 /** The language which is used */
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	144 private final int lang;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	145
175 8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	146 /** Whether or not BLOB is mapped to Types.VARBINARY instead of Types.BLOB within this connection */
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	147 private boolean treatBlobAsVarBinary = false;
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	148 /** Whether or not CLOB is mapped to Types.VARCHAR instead of Types.CLOB within this connection */
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	149 private boolean treatClobAsVarChar = false;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	150
219 4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	151 // Internal cache for determining if system table sys.privilege_codes (new as of Jul2017 release) exists on server
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	152 private boolean queriedPrivilege_codesTable = false;
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	153 private boolean hasPrivilege_codesTable = false;
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	154
215 71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	155 // Internal cache for determining if system table sys.comments (new as of Mar2018 release) exists on server
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	156 private boolean queriedCommentsTable = false;
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	157 private boolean hasCommentsTable = false;
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	158
271 4880267d0fe1 Added implementation of java.sql.CallableStatement interface, test program and updated the ChangeLog and release notes. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 266 diff changeset	159 /** The last set query timeout on the server as used by Statement, PreparedStatement and CallableStatement */
249 46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 243 diff changeset	160 protected int lastSetQueryTimeout = 0; // 0 means no timeout, which is the default on the server
46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 243 diff changeset	161
215 71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	162
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	163 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	164 * Constructor of a Connection for MonetDB. At this moment the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	165 * current implementation limits itself to storing the given host,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	166 * database, username and password for later use by the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	167 * createStatement() call. This constructor is only accessible to
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	168 * classes from the jdbc package.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	169 *
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	170 * @param props a Property hashtable holding the properties needed for connecting
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	171 * @throws SQLException if a database error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	172 * @throws IllegalArgumentException is one of the arguments is null or empty
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	173 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	174 MonetConnection(Properties props)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	175 throws SQLException, IllegalArgumentException
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	176 {
184 e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	177 // for debug: System.out.println("New connection object. Received properties are: " + props.toString());
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	178 // get supported property values from the props argument.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	179 // When a value is found add it to the internal conn_props list for use by getClientInfo().
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	180 this.hostname = props.getProperty("host");
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	181 if (this.hostname != null)
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	182 conn_props.setProperty("host", this.hostname);
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	183
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	184 String port_prop = props.getProperty("port");
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	185 if (port_prop != null) {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	186 try {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	187 this.port = Integer.parseInt(port_prop);
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	188 } catch (NumberFormatException e) {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	189 addWarning("Unable to parse port number from: " + port_prop, "M1M05");
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	190 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	191 conn_props.setProperty("port", Integer.toString(this.port));
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	192 }
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	193
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	194 this.database = props.getProperty("database");
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	195 if (this.database != null)
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	196 conn_props.setProperty("database", this.database);
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	197
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	198 this.username = props.getProperty("user");
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	199 if (this.username != null)
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	200 conn_props.setProperty("user", this.username);
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	201
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	202 this.password = props.getProperty("password");
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	203 if (this.password != null)
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	204 conn_props.setProperty("password", this.password);
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	205
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	206 String language = props.getProperty("language");
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	207 if (language != null)
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	208 conn_props.setProperty("language", language);
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	209
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	210 boolean debug = false;
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	211 String debug_prop = props.getProperty("debug");
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	212 if (debug_prop != null) {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	213 debug = Boolean.parseBoolean(debug_prop);
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	214 conn_props.setProperty("debug", Boolean.toString(debug));
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	215 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	216
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	217 String hash = props.getProperty("hash");
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	218 if (hash != null)
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	219 conn_props.setProperty("hash", hash);
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	220
175 8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	221 String treatBlobAsVarBinary_prop = props.getProperty("treat_blob_as_binary");
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	222 if (treatBlobAsVarBinary_prop != null) {
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	223 treatBlobAsVarBinary = Boolean.parseBoolean(treatBlobAsVarBinary_prop);
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	224 conn_props.setProperty("treat_blob_as_binary", Boolean.toString(treatBlobAsVarBinary));
178 dd12348c41cf Improvement: only extend typeMap when the property was set to true. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 175 diff changeset	225 if (treatBlobAsVarBinary)
dd12348c41cf Improvement: only extend typeMap when the property was set to true. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 175 diff changeset	226 typeMap.put("blob", Byte[].class);
175 8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	227 }
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	228
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	229 String treatClobAsVarChar_prop = props.getProperty("treat_clob_as_varchar");
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	230 if (treatClobAsVarChar_prop != null) {
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	231 treatClobAsVarChar = Boolean.parseBoolean(treatClobAsVarChar_prop);
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	232 conn_props.setProperty("treat_clob_as_varchar", Boolean.toString(treatClobAsVarChar));
178 dd12348c41cf Improvement: only extend typeMap when the property was set to true. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 175 diff changeset	233 if (treatClobAsVarChar)
dd12348c41cf Improvement: only extend typeMap when the property was set to true. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 175 diff changeset	234 typeMap.put("clob", String.class);
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	235 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	236
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	237 int sockTimeout = 0;
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	238 String so_timeout_prop = props.getProperty("so_timeout");
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	239 if (so_timeout_prop != null) {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	240 try {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	241 sockTimeout = Integer.parseInt(so_timeout_prop);
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	242 if (sockTimeout < 0) {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	243 addWarning("Negative socket timeout not allowed. Value ignored", "M1M05");
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	244 sockTimeout = 0;
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	245 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	246 } catch (NumberFormatException e) {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	247 addWarning("Unable to parse socket timeout number from: " + so_timeout_prop, "M1M05");
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	248 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	249 conn_props.setProperty("so_timeout", Integer.toString(sockTimeout));
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	250 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	251
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	252 // check mandatory input arguments
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	253 if (hostname == null \|\| hostname.isEmpty())
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	254 throw new IllegalArgumentException("Missing or empty host name");
225 5ddb1f20d5d5 Socket may also throw an UnknownHostException. Add it to MapiSocket.connect() and catch it in MonetConnection(Properties props). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 219 diff changeset	255 if (port <= 0 \|\| port > 65535)
5ddb1f20d5d5 Socket may also throw an UnknownHostException. Add it to MapiSocket.connect() and catch it in MonetConnection(Properties props). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 219 diff changeset	256 throw new IllegalArgumentException("Invalid port number: " + port + ". It should not be " + (port < 0 ? "negative" : (port > 65535 ? "larger than 65535" : "0")));
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	257 if (username == null \|\| username.isEmpty())
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	258 throw new IllegalArgumentException("Missing or empty user name");
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	259 if (password == null \|\| password.isEmpty())
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	260 throw new IllegalArgumentException("Missing or empty password");
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	261 if (language == null \|\| language.isEmpty()) {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	262 // fallback to default language: sql
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	263 language = "sql";
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	264 addWarning("No language specified, defaulting to 'sql'", "M1M05");
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	265 }
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	266
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	267 server = new MapiSocket();
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	268 if (hash != null)
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	269 server.setHash(hash);
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	270 if (database != null)
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	271 server.setDatabase(database);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	272 server.setLanguage(language);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	273
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	274 // we're debugging here... uhm, should be off in real life
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	275 if (debug) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	276 try {
278 1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	277 String fname = props.getProperty("logfile", "monet_" + System.currentTimeMillis() + ".log");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	278 File f = new File(fname);
25 5ec116ba7d71 When single character use faster version of indexOf(<char>) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 8 diff changeset	279 int ext = fname.lastIndexOf('.');
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	280 if (ext < 0)
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	281 ext = fname.length();
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	282 String pre = fname.substring(0, ext);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	283 String suf = fname.substring(ext);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	284
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	285 for (int i = 1; f.exists(); i++) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	286 f = new File(pre + "-" + i + suf);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	287 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	288
278 1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	289 server.debug(f.getAbsolutePath()); // enable logging on the MapiSocket level
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	290 } catch (IOException ex) {
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	291 throw new SQLNonTransientConnectionException("Opening logfile failed: " + ex.getMessage(), "08M01");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	292 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	293 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	294
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	295 try {
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	296 List<String> warnings = server.connect(hostname, port, username, password);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	297 for (String warning : warnings) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	298 addWarning(warning, "01M02");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	299 }
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	300
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	301 // apply NetworkTimeout value from legacy (pre 4.1) driver
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	302 // so_timeout calls
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	303 server.setSoTimeout(sockTimeout);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	304
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	305 in = server.getReader();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	306 out = server.getWriter();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	307
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	308 String error = in.waitForPrompt();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	309 if (error != null)
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	310 throw new SQLNonTransientConnectionException((error.length() > 6) ? error.substring(6) : error, "08001");
225 5ddb1f20d5d5 Socket may also throw an UnknownHostException. Add it to MapiSocket.connect() and catch it in MonetConnection(Properties props). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 219 diff changeset	311 } catch (UnknownHostException e) {
5ddb1f20d5d5 Socket may also throw an UnknownHostException. Add it to MapiSocket.connect() and catch it in MonetConnection(Properties props). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 219 diff changeset	312 throw new SQLNonTransientConnectionException("Unknown Host (" + hostname + "): " + e.getMessage(), "08006");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	313 } catch (IOException e) {
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	314 throw new SQLNonTransientConnectionException("Unable to connect (" + hostname + ":" + port + "): " + e.getMessage(), "08006");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	315 } catch (MCLParseException e) {
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	316 throw new SQLNonTransientConnectionException(e.getMessage(), "08001");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	317 } catch (MCLException e) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	318 String[] connex = e.getMessage().split("\n");
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	319 SQLException sqle = new SQLNonTransientConnectionException(connex[0], "08001", e);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	320 for (int i = 1; i < connex.length; i++) {
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	321 sqle.setNextException(new SQLNonTransientConnectionException(connex[1], "08001"));
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	322 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	323 throw sqle;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	324 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	325
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	326 // we seem to have managed to log in, let's store the
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	327 // language used and language specific query templates
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	328 if ("sql".equals(language)) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	329 lang = LANG_SQL;
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	330
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	331 queryTempl[0] = "s"; // pre
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	332 queryTempl[1] = "\n;"; // post
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	333 queryTempl[2] = "\n;\n"; // separator
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	334
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	335 commandTempl[0] = "X"; // pre
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	336 commandTempl[1] = null; // post
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	337 commandTempl[2] = "\nX"; // separator
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	338 } else if ("mal".equals(language)) {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	339 lang = LANG_MAL;
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	340
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	341 queryTempl[0] = null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	342 queryTempl[1] = ";\n";
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	343 queryTempl[2] = ";\n";
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	344
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	345 commandTempl[0] = null; // pre
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	346 commandTempl[1] = null; // post
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	347 commandTempl[2] = null; // separator
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	348 } else {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	349 lang = LANG_UNKNOWN;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	350 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	351
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	352 // the following initialisers are only valid when the language is SQL...
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	353 if (lang == LANG_SQL) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	354 // enable auto commit
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	355 setAutoCommit(true);
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	356
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	357 // set our time zone on the server
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	358 Calendar cal = Calendar.getInstance();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	359 int offset = cal.get(Calendar.ZONE_OFFSET) + cal.get(Calendar.DST_OFFSET);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	360 offset /= (60 * 1000); // milliseconds to minutes
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	361 String tz = offset < 0 ? "-" : "+";
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	362 tz += (Math.abs(offset) / 60 < 10 ? "0" : "") + (Math.abs(offset) / 60) + ":";
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	363 offset -= (offset / 60) * 60;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	364 tz += (offset < 10 ? "0" : "") + offset;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	365 sendIndependentCommand("SET TIME ZONE INTERVAL '" + tz + "' HOUR TO MINUTE");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	366 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	367
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	368 // we're absolutely not closed, since we're brand new
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	369 closed = false;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	370 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	371
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	372 //== methods of interface Connection
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	373
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	374 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	375 * Clears all warnings reported for this Connection object. After a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	376 * call to this method, the method getWarnings returns null until a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	377 * new warning is reported for this Connection object.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	378 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	379 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	380 public void clearWarnings() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	381 warnings = null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	382 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	383
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	384 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	385 * Releases this Connection object's database and JDBC resources
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	386 * immediately instead of waiting for them to be automatically
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	387 * released. All Statements created from this Connection will be
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	388 * closed when this method is called.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	389 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	390 * Calling the method close on a Connection object that is already
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	391 * closed is a no-op.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	392 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	393 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	394 public void close() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	395 synchronized (server) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	396 for (Statement st : statements.keySet()) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	397 try {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	398 st.close();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	399 } catch (SQLException e) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	400 // better luck next time!
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	401 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	402 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	403 // close the socket
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	404 server.close();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	405 // close active SendThread if any
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	406 if (sendThread != null) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	407 sendThread.shutdown();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	408 sendThread = null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	409 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	410 // report ourselves as closed
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	411 closed = true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	412 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	413 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	414
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	415 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	416 * Makes all changes made since the previous commit/rollback
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	417 * permanent and releases any database locks currently held by this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	418 * Connection object. This method should be used only when
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	419 * auto-commit mode has been disabled.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	420 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	421 * @throws SQLException if a database access error occurs or this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	422 * Connection object is in auto-commit mode
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	423 * @see #setAutoCommit(boolean)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	424 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	425 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	426 public void commit() throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	427 // note: can't use sendIndependentCommand here because we need
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	428 // to process the auto_commit state the server gives
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	429 sendTransactionCommand("COMMIT");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	430 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	431
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	432 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	433 * Creates a Statement object for sending SQL statements to the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	434 * database. SQL statements without parameters are normally
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	435 * executed using Statement objects. If the same SQL statement is
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	436 * executed many times, it may be more efficient to use a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	437 * PreparedStatement object.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	438 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	439 * Result sets created using the returned Statement object will by
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	440 * default be type TYPE_FORWARD_ONLY and have a concurrency level of
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	441 * CONCUR_READ_ONLY.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	442 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	443 * @return a new default Statement object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	444 * @throws SQLException if a database access error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	445 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	446 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	447 public Statement createStatement() throws SQLException {
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	448 return createStatement(ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY, ResultSet.HOLD_CURSORS_OVER_COMMIT);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	449 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	450
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	451 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	452 * Creates a Statement object that will generate ResultSet objects
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	453 * with the given type and concurrency. This method is the same as
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	454 * the createStatement method above, but it allows the default
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	455 * result set type and concurrency to be overridden.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	456 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	457 * @param resultSetType a result set type; one of
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	458 * ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	459 * or ResultSet.TYPE_SCROLL_SENSITIVE
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	460 * @param resultSetConcurrency a concurrency type; one of
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	461 * ResultSet.CONCUR_READ_ONLY or ResultSet.CONCUR_UPDATABLE
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	462 * @return a new Statement object that will generate ResultSet objects with
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	463 * the given type and concurrency
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	464 * @throws SQLException if a database access error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	465 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	466 @Override
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	467 public Statement createStatement(int resultSetType, int resultSetConcurrency) throws SQLException {
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	468 return createStatement(resultSetType, resultSetConcurrency, ResultSet.HOLD_CURSORS_OVER_COMMIT);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	469 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	470
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	471 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	472 * Creates a Statement object that will generate ResultSet objects
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	473 * with the given type, concurrency, and holdability. This method
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	474 * is the same as the createStatement method above, but it allows
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	475 * the default result set type, concurrency, and holdability to be
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	476 * overridden.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	477 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	478 * @param resultSetType one of the following ResultSet constants:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	479 * ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	480 * or ResultSet.TYPE_SCROLL_SENSITIVE
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	481 * @param resultSetConcurrency one of the following ResultSet
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	482 * constants: ResultSet.CONCUR_READ_ONLY or
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	483 * ResultSet.CONCUR_UPDATABLE
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	484 * @param resultSetHoldability one of the following ResultSet
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	485 * constants: ResultSet.HOLD_CURSORS_OVER_COMMIT or
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	486 * ResultSet.CLOSE_CURSORS_AT_COMMIT
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	487 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	488 * @return a new Statement object that will generate ResultSet
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	489 * objects with the given type, concurrency, and holdability
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	490 * @throws SQLException if a database access error occurs or the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	491 * given parameters are not ResultSet constants indicating type,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	492 * concurrency, and holdability
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	493 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	494 @Override
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	495 public Statement createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	496 try {
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	497 Statement ret = new MonetStatement(this, resultSetType, resultSetConcurrency, resultSetHoldability);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	498 // store it in the map for when we close...
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	499 statements.put(ret, null);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	500 return ret;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	501 } catch (IllegalArgumentException e) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	502 throw new SQLException(e.toString(), "M0M03");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	503 }
271 4880267d0fe1 Added implementation of java.sql.CallableStatement interface, test program and updated the ChangeLog and release notes. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 266 diff changeset	504 // we don't have to catch SQLException because that is declared to be thrown
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	505 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	506
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	507 /**
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	508 * Retrieves the current auto-commit mode for this Connection object.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	509 *
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	510 * @return the current state of this Connection object's auto-commit mode
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	511 * @see #setAutoCommit(boolean)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	512 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	513 @Override
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	514 public boolean getAutoCommit() {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	515 return autoCommit;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	516 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	517
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	518 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	519 * Retrieves this Connection object's current catalog name.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	520 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	521 * @return the current catalog name or null if there is none
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	522 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	523 @Override
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	524 public String getCatalog() {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	525 // MonetDB does NOT support catalogs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	526 return null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	527 }
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	528
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	529 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	530 * Retrieves the current holdability of ResultSet objects created
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	531 * using this Connection object.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	532 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	533 * @return the holdability, one of
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	534 * ResultSet.HOLD_CURSORS_OVER_COMMIT or
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	535 * ResultSet.CLOSE_CURSORS_AT_COMMIT
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 186 diff changeset	536 * @see #setHoldability(int)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	537 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	538 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	539 public int getHoldability() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	540 // TODO: perhaps it is better to have the server implement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	541 // CLOSE_CURSORS_AT_COMMIT
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	542 return ResultSet.HOLD_CURSORS_OVER_COMMIT;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	543 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	544
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	545 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	546 * Retrieves a DatabaseMetaData object that contains metadata about
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	547 * the database to which this Connection object represents a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	548 * connection. The metadata includes information about the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	549 * database's tables, its supported SQL grammar, its stored
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	550 * procedures, the capabilities of this connection, and so on.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	551 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	552 * @throws SQLException if the current language is not SQL
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	553 * @return a DatabaseMetaData object for this Connection object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	554 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	555 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	556 public DatabaseMetaData getMetaData() throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	557 if (lang != LANG_SQL)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	558 throw new SQLException("This method is only supported in SQL mode", "M0M04");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	559
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	560 return new MonetDatabaseMetaData(this);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	561 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	562
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	563 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	564 * Retrieves this Connection object's current transaction isolation
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	565 * level.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	566 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	567 * @return the current transaction isolation level, which will be
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	568 * Connection.TRANSACTION_SERIALIZABLE
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	569 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	570 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	571 public int getTransactionIsolation() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	572 return TRANSACTION_SERIALIZABLE;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	573 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	574
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	575 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	576 * Retrieves the Map object associated with this Connection object.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	577 * Unless the application has added an entry, the type map returned
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	578 * will be empty.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	579 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	580 * @return the java.util.Map object associated with this Connection
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	581 * object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	582 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	583 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	584 public Map<String,Class<?>> getTypeMap() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	585 return typeMap;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	586 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	587
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	588 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	589 * Retrieves the first warning reported by calls on this Connection
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	590 * object. If there is more than one warning, subsequent warnings
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	591 * will be chained to the first one and can be retrieved by calling
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	592 * the method SQLWarning.getNextWarning on the warning that was
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	593 * retrieved previously.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	594 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	595 * This method may not be called on a closed connection; doing so
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	596 * will cause an SQLException to be thrown.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	597 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	598 * Note: Subsequent warnings will be chained to this SQLWarning.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	599 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	600 * @return the first SQLWarning object or null if there are none
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	601 * @throws SQLException if a database access error occurs or this method is
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	602 * called on a closed connection
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	603 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	604 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	605 public SQLWarning getWarnings() throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	606 if (closed)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	607 throw new SQLException("Cannot call on closed Connection", "M1M20");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	608
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	609 // if there are no warnings, this will be null, which fits with the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	610 // specification.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	611 return warnings;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	612 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	613
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	614 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	615 * Retrieves whether this Connection object has been closed. A
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	616 * connection is closed if the method close has been called on it or
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	617 * if certain fatal errors have occurred. This method is guaranteed
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	618 * to return true only when it is called after the method
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	619 * Connection.close has been called.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	620 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	621 * This method generally cannot be called to determine whether a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	622 * connection to a database is valid or invalid. A typical client
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	623 * can determine that a connection is invalid by catching any
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	624 * exceptions that might be thrown when an operation is attempted.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	625 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	626 * @return true if this Connection object is closed; false if it is
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	627 * still open
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	628 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	629 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	630 public boolean isClosed() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	631 return closed;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	632 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	633
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	634 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	635 * Retrieves whether this Connection object is in read-only mode.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	636 * MonetDB currently doesn't support updateable result sets, but
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	637 * updates are possible. Hence the Connection object is never in
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	638 * read-only mode.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	639 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	640 * @return true if this Connection object is read-only; false otherwise
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	641 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	642 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	643 public boolean isReadOnly() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	644 return false;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	645 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	646
184 e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	647 /**
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	648 * Converts the given SQL statement into the system's native SQL grammar.
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	649 * A driver may convert the JDBC SQL grammar into its system's native SQL grammar prior to sending it.
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	650 * This method returns the native form of the statement that the driver would have sent.
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	651 *
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	652 * @param sql - an SQL statement that may contain one or more '?' parameter placeholders.
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	653 * @return the native form of this statement
184 e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	654 */
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	655 @Override
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	656 public String nativeSQL(String sql) {
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	657 /* there is currently no way to get the native MonetDB rewritten SQL string back, so just return the original string */
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	658 /* in future we may replace/remove the escape sequences { <escape-type> ...} before sending it to the server */
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	659 return sql;
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	660 }
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	661
184 e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	662 /**
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	663 * Creates a CallableStatement object for calling database stored procedures.
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	664 * The CallableStatement object provides methods for setting up its IN and OUT parameters,
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	665 * and methods for executing the call to a stored procedure.
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	666 *
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	667 * Note: This method is optimized for handling stored procedure call statements.
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	668 * Some drivers may send the call statement to the database when the method prepareCall is done;
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	669 * others may wait until the CallableStatement object is executed. This has no direct effect
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	670 * on users; however, it does affect which method throws certain SQLExceptions.
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	671 *
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	672 * Result sets created using the returned CallableStatement object will by default be type TYPE_FORWARD_ONLY
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	673 * and have a concurrency level of CONCUR_READ_ONLY.
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	674 * The holdability of the created result sets can be determined by calling getHoldability().
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	675 *
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	676 * @param sql - an SQL statement that may contain one or more '?' parameter placeholders.
184 e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	677 * Typically this statement is specified using JDBC call escape syntax.
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	678 * @return a new default CallableStatement object containing the pre-compiled SQL statement
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	679 * @throws SQLException - if a database access error occurs or this method is called on a closed connection
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	680 * @throws SQLFeatureNotSupportedException - if the JDBC driver does not support this method.
184 e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	681 */
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	682 @Override
184 e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	683 public CallableStatement prepareCall(String sql) throws SQLException {
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	684 return prepareCall(sql, ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY, ResultSet.HOLD_CURSORS_OVER_COMMIT);
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	685 }
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	686
184 e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	687 /**
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	688 * Creates a CallableStatement object that will generate ResultSet objects with the given type and concurrency.
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	689 * This method is the same as the prepareCall method above, but it allows the default result set type and concurrency to be overridden.
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	690 * The holdability of the created result sets can be determined by calling getHoldability().
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	691 *
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	692 * @param sql - a String object that is the SQL statement to be sent to the database; may contain on or more '?' parameters
184 e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	693 * Typically this statement is specified using JDBC call escape syntax.
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	694 * @param resultSetType - a result set type; one of ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, or ResultSet.TYPE_SCROLL_SENSITIVE
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	695 * @param resultSetConcurrency - a concurrency type; one of ResultSet.CONCUR_READ_ONLY or ResultSet.CONCUR_UPDATABLE
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	696 * @return a new CallableStatement object containing the pre-compiled SQL statement that
184 e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	697 * will produce ResultSet objects with the given type and concurrency
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	698 * @throws SQLException - if a database access error occurs, this method is called on a closed connection or
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	699 * the given parameters are not ResultSet constants indicating type and concurrency
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	700 * @throws SQLFeatureNotSupportedException - if the JDBC driver does not support this method or
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	701 * this method is not supported for the specified result set type and result set concurrency.
184 e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	702 */
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	703 @Override
184 e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	704 public CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency) throws SQLException {
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	705 return prepareCall(sql, resultSetType, resultSetConcurrency, ResultSet.HOLD_CURSORS_OVER_COMMIT);
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	706 }
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	707
184 e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	708 /**
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	709 * Creates a CallableStatement object that will generate ResultSet objects with the given type and concurrency.
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	710 * This method is the same as the prepareCall method above, but it allows the default result set type, result set concurrency type and holdability to be overridden.
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	711 *
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	712 * @param sql - a String object that is the SQL statement to be sent to the database; may contain on or more '?' parameters
184 e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	713 * Typically this statement is specified using JDBC call escape syntax.
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	714 * @param resultSetType - a result set type; one of ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, or ResultSet.TYPE_SCROLL_SENSITIVE
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	715 * @param resultSetConcurrency - a concurrency type; one of ResultSet.CONCUR_READ_ONLY or ResultSet.CONCUR_UPDATABLE
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	716 * @param resultSetHoldability - one of the following ResultSet constants: ResultSet.HOLD_CURSORS_OVER_COMMIT or ResultSet.CLOSE_CURSORS_AT_COMMIT
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	717 * @return a new CallableStatement object, containing the pre-compiled SQL statement, that will generate ResultSet objects with the given type, concurrency, and holdability
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	718 * @throws SQLException - if a database access error occurs, this method is called on a closed connection or
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	719 * the given parameters are not ResultSet constants indicating type, concurrency, and holdability
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	720 * @throws SQLFeatureNotSupportedException - if the JDBC driver does not support this method or
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	721 * this method is not supported for the specified result set type, result set holdability and result set concurrency.
184 e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	722 */
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	723 @Override
184 e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	724 public CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	725 throws SQLException
e0f76fedafc8 Corrected implementation of Connection.prepareCall() methods. They used to return null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 178 diff changeset	726 {
271 4880267d0fe1 Added implementation of java.sql.CallableStatement interface, test program and updated the ChangeLog and release notes. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 266 diff changeset	727 try {
4880267d0fe1 Added implementation of java.sql.CallableStatement interface, test program and updated the ChangeLog and release notes. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 266 diff changeset	728 CallableStatement ret = new MonetCallableStatement(
4880267d0fe1 Added implementation of java.sql.CallableStatement interface, test program and updated the ChangeLog and release notes. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 266 diff changeset	729 this,
4880267d0fe1 Added implementation of java.sql.CallableStatement interface, test program and updated the ChangeLog and release notes. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 266 diff changeset	730 resultSetType,
4880267d0fe1 Added implementation of java.sql.CallableStatement interface, test program and updated the ChangeLog and release notes. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 266 diff changeset	731 resultSetConcurrency,
4880267d0fe1 Added implementation of java.sql.CallableStatement interface, test program and updated the ChangeLog and release notes. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 266 diff changeset	732 resultSetHoldability,
4880267d0fe1 Added implementation of java.sql.CallableStatement interface, test program and updated the ChangeLog and release notes. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 266 diff changeset	733 sql
4880267d0fe1 Added implementation of java.sql.CallableStatement interface, test program and updated the ChangeLog and release notes. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 266 diff changeset	734 );
4880267d0fe1 Added implementation of java.sql.CallableStatement interface, test program and updated the ChangeLog and release notes. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 266 diff changeset	735 // store it in the map for when we close...
4880267d0fe1 Added implementation of java.sql.CallableStatement interface, test program and updated the ChangeLog and release notes. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 266 diff changeset	736 statements.put(ret, null);
4880267d0fe1 Added implementation of java.sql.CallableStatement interface, test program and updated the ChangeLog and release notes. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 266 diff changeset	737 return ret;
4880267d0fe1 Added implementation of java.sql.CallableStatement interface, test program and updated the ChangeLog and release notes. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 266 diff changeset	738 } catch (IllegalArgumentException e) {
4880267d0fe1 Added implementation of java.sql.CallableStatement interface, test program and updated the ChangeLog and release notes. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 266 diff changeset	739 throw new SQLException(e.toString(), "M0M03");
4880267d0fe1 Added implementation of java.sql.CallableStatement interface, test program and updated the ChangeLog and release notes. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 266 diff changeset	740 }
4880267d0fe1 Added implementation of java.sql.CallableStatement interface, test program and updated the ChangeLog and release notes. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 266 diff changeset	741 // we don't have to catch SQLException because that is declared to be thrown
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	742 }
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	743
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	744 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	745 * Creates a PreparedStatement object for sending parameterized SQL
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	746 * statements to the database.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	747 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	748 * A SQL statement with or without IN parameters can be pre-compiled
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	749 * and stored in a PreparedStatement object. This object can then be
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	750 * used to efficiently execute this statement multiple times.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	751 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	752 * Note: This method is optimized for handling parametric SQL
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	753 * statements that benefit from precompilation. If the driver
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	754 * supports precompilation, the method prepareStatement will send
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	755 * the statement to the database for precompilation. Some drivers
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	756 * may not support precompilation. In this case, the statement may
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	757 * not be sent to the database until the PreparedStatement object is
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	758 * executed. This has no direct effect on users; however, it does
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	759 * affect which methods throw certain SQLException objects.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	760 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	761 * Result sets created using the returned PreparedStatement object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	762 * will by default be type TYPE_FORWARD_ONLY and have a concurrency
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	763 * level of CONCUR_READ_ONLY.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	764 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	765 * @param sql an SQL statement that may contain one or more '?' IN
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	766 * parameter placeholders
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	767 * @return a new default PreparedStatement object containing the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	768 * pre-compiled SQL statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	769 * @throws SQLException if a database access error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	770 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	771 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	772 public PreparedStatement prepareStatement(String sql) throws SQLException {
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	773 return prepareStatement(sql, ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY, ResultSet.HOLD_CURSORS_OVER_COMMIT);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	774 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	775
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	776 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	777 * Creates a PreparedStatement object that will generate ResultSet
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	778 * objects with the given type and concurrency. This method is the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	779 * same as the prepareStatement method above, but it allows the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	780 * default result set type and concurrency to be overridden.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	781 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	782 * @param sql a String object that is the SQL statement to be sent to the
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	783 * database; may contain one or more ? IN parameters
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	784 * @param resultSetType a result set type; one of
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	785 * ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	786 * or ResultSet.TYPE_SCROLL_SENSITIVE
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	787 * @param resultSetConcurrency a concurrency type; one of
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	788 * ResultSet.CONCUR_READ_ONLY or ResultSet.CONCUR_UPDATABLE
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	789 * @return a new PreparedStatement object containing the pre-compiled SQL
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	790 * statement that will produce ResultSet objects with the given
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	791 * type and concurrency
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	792 * @throws SQLException if a database access error occurs or the given
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	793 * parameters are not ResultSet constants indicating
d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	794 * type and concurrency
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	795 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	796 @Override
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	797 public PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency) throws SQLException {
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	798 return prepareStatement(sql, resultSetType, resultSetConcurrency, ResultSet.HOLD_CURSORS_OVER_COMMIT);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	799 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	800
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	801 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	802 * Creates a PreparedStatement object that will generate ResultSet
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	803 * objects with the given type, concurrency, and holdability.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	804 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	805 * This method is the same as the prepareStatement method above, but
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	806 * it allows the default result set type, concurrency, and
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	807 * holdability to be overridden.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	808 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	809 * @param sql a String object that is the SQL statement to be sent
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	810 * to the database; may contain one or more ? IN parameters
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	811 * @param resultSetType one of the following ResultSet constants:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	812 * ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	813 * or ResultSet.TYPE_SCROLL_SENSITIVE
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	814 * @param resultSetConcurrency one of the following ResultSet
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	815 * constants: ResultSet.CONCUR_READ_ONLY or
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	816 * ResultSet.CONCUR_UPDATABLE
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	817 * @param resultSetHoldability one of the following ResultSet
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	818 * constants: ResultSet.HOLD_CURSORS_OVER_COMMIT or
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	819 * ResultSet.CLOSE_CURSORS_AT_COMMIT
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	820 * @return a new PreparedStatement object, containing the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	821 * pre-compiled SQL statement, that will generate ResultSet objects
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	822 * with the given type, concurrency, and holdability
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	823 * @throws SQLException if a database access error occurs or the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	824 * given parameters are not ResultSet constants indicating type,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	825 * concurrency, and holdability
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	826 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	827 @Override
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	828 public PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	829 throws SQLException
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	830 {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	831 try {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	832 PreparedStatement ret = new MonetPreparedStatement(
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	833 this,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	834 resultSetType,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	835 resultSetConcurrency,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	836 resultSetHoldability,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	837 sql
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	838 );
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	839 // store it in the map for when we close...
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	840 statements.put(ret, null);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	841 return ret;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	842 } catch (IllegalArgumentException e) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	843 throw new SQLException(e.toString(), "M0M03");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	844 }
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	845 // we don't have to catch SQLException because that is declared to be thrown
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	846 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	847
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	848 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	849 * Creates a default PreparedStatement object that has the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	850 * capability to retrieve auto-generated keys. The given constant
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	851 * tells the driver whether it should make auto-generated keys
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	852 * available for retrieval. This parameter is ignored if the SQL
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	853 * statement is not an INSERT statement.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	854 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	855 * Note: This method is optimized for handling parametric SQL
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	856 * statements that benefit from precompilation. If the driver
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	857 * supports precompilation, the method prepareStatement will send
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	858 * the statement to the database for precompilation. Some drivers
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	859 * may not support precompilation. In this case, the statement may
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	860 * not be sent to the database until the PreparedStatement object is
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	861 * executed. This has no direct effect on users; however, it does
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	862 * affect which methods throw certain SQLExceptions.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	863 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	864 * Result sets created using the returned PreparedStatement object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	865 * will by default be type TYPE_FORWARD_ONLY and have a concurrency
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	866 * level of CONCUR_READ_ONLY.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	867 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	868 * @param sql an SQL statement that may contain one or more '?' IN
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	869 * parameter placeholders
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	870 * @param autoGeneratedKeys a flag indicating whether auto-generated
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	871 * keys should be returned; one of
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	872 * Statement.RETURN_GENERATED_KEYS or
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	873 * Statement.NO_GENERATED_KEYS
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	874 * @return a new PreparedStatement object, containing the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	875 * pre-compiled SQL statement, that will have the capability
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	876 * of returning auto-generated keys
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	877 * @throws SQLException - if a database access error occurs or the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	878 * given parameter is not a Statement constant indicating
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	879 * whether auto-generated keys should be returned
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	880 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	881 @Override
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	882 public PreparedStatement prepareStatement(String sql, int autoGeneratedKeys) throws SQLException {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	883 if (autoGeneratedKeys != Statement.RETURN_GENERATED_KEYS &&
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	884 autoGeneratedKeys != Statement.NO_GENERATED_KEYS)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	885 throw new SQLException("Invalid argument, expected RETURN_GENERATED_KEYS or NO_GENERATED_KEYS", "M1M05");
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	886
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	887 /* MonetDB has no way to disable this, so just do the normal thing ;) */
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	888 return prepareStatement(sql, ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	889 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	890
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	891 /**
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	892 * Creates a default PreparedStatement object capable of returning the auto-generated keys designated by the given array.
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	893 * This array contains the indexes of the columns in the target table that contain the auto-generated keys that should be made available.
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	894 * The driver will ignore the array if the SQL statement is not an INSERT statement, or an SQL statement able to
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	895 * return auto-generated keys (the list of such statements is vendor-specific).
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	896 *
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	897 * An SQL statement with or without IN parameters can be pre-compiled and stored in a PreparedStatement object.
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	898 * This object can then be used to efficiently execute this statement multiple times.
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	899 *
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	900 * Note: This method is optimized for handling parametric SQL statements that benefit from precompilation.
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	901 * If the driver supports precompilation, the method prepareStatement will send the statement to the database for precompilation.
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	902 * Some drivers may not support precompilation. In this case, the statement may not be sent to the database until the PreparedStatement
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	903 * object is executed. This has no direct effect on users; however, it does affect which methods throw certain SQLExceptions.
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	904 *
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	905 * Result sets created using the returned PreparedStatement object will by default be type TYPE_FORWARD_ONLY and have
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	906 * a concurrency level of CONCUR_READ_ONLY. The holdability of the created result sets can be determined by calling getHoldability().
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	907 *
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	908 * @param sql - an SQL statement that may contain one or more '?' IN parameter placeholders
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	909 * @param columnIndexes - an array of column indexes indicating the columns that should be returned from the inserted row or rows
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	910 * @return a new PreparedStatement object, containing the pre-compiled statement, that is capable of
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	911 * returning the auto-generated keys designated by the given array of column indexes
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	912 * @throws SQLException - if a database access error occurs or this method is called on a closed connection
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	913 * @throws SQLFeatureNotSupportedException - if the JDBC driver does not support this method
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	914 */
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	915 @Override
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	916 public PreparedStatement prepareStatement(String sql, int[] columnIndexes) throws SQLException {
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	917 throw newSQLFeatureNotSupportedException("prepareStatement(String sql, int[] columnIndexes)");
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	918 }
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	919
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	920 /**
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	921 * Creates a default PreparedStatement object capable of returning the auto-generated keys designated by the given array.
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	922 * This array contains the names of the columns in the target table that contain the auto-generated keys that should be returned.
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	923 * The driver will ignore the array if the SQL statement is not an INSERT statement, or an SQL statement able to
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	924 * return auto-generated keys (the list of such statements is vendor-specific).
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	925 *
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	926 * An SQL statement with or without IN parameters can be pre-compiled and stored in a PreparedStatement object.
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	927 * This object can then be used to efficiently execute this statement multiple times.
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	928 *
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	929 * Note: This method is optimized for handling parametric SQL statements that benefit from precompilation.
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	930 * If the driver supports precompilation, the method prepareStatement will send the statement to the database for precompilation.
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	931 * Some drivers may not support precompilation. In this case, the statement may not be sent to the database until the PreparedStatement
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	932 * object is executed. This has no direct effect on users; however, it does affect which methods throw certain SQLExceptions.
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	933 *
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	934 * Result sets created using the returned PreparedStatement object will by default be type TYPE_FORWARD_ONLY and have
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	935 * a concurrency level of CONCUR_READ_ONLY. The holdability of the created result sets can be determined by calling getHoldability().
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	936 *
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	937 * @param sql - an SQL statement that may contain one or more '?' IN parameter placeholders
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	938 * @param columnNames - an array of column names indicating the columns that should be returned from the inserted row or rows
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	939 * @return a new PreparedStatement object, containing the pre-compiled statement, that is capable of
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	940 * returning the auto-generated keys designated by the given array of column names
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	941 * @throws SQLException - if a database access error occurs or this method is called on a closed connection
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	942 * @throws SQLFeatureNotSupportedException - if the JDBC driver does not support this method
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	943 */
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	944 @Override
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	945 public PreparedStatement prepareStatement(String sql, String[] columnNames) throws SQLException {
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	946 throw newSQLFeatureNotSupportedException("prepareStatement(String sql, String[] columnNames)");
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	947 }
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	948
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	949 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	950 * Removes the given Savepoint object from the current transaction.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	951 * Any reference to the savepoint after it have been removed will
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	952 * cause an SQLException to be thrown.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	953 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	954 * @param savepoint the Savepoint object to be removed
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	955 * @throws SQLException if a database access error occurs or the given
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	956 * Savepoint object is not a valid savepoint in the current
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	957 * transaction
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	958 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	959 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	960 public void releaseSavepoint(Savepoint savepoint) throws SQLException {
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	961 if (!(savepoint instanceof MonetSavepoint))
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	962 throw new SQLException("This driver can only handle savepoints it created itself", "M0M06");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	963
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	964 MonetSavepoint sp = (MonetSavepoint)savepoint;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	965
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	966 // note: can't use sendIndependentCommand here because we need
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	967 // to process the auto_commit state the server gives
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	968 sendTransactionCommand("RELEASE SAVEPOINT " + sp.getName());
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	969 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	970
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	971 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	972 * Undoes all changes made in the current transaction and releases
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	973 * any database locks currently held by this Connection object.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	974 * This method should be used only when auto-commit mode has been disabled.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	975 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	976 * @throws SQLException if a database access error occurs or this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	977 * Connection object is in auto-commit mode
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	978 * @see #setAutoCommit(boolean)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	979 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	980 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	981 public void rollback() throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	982 // note: can't use sendIndependentCommand here because we need
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	983 // to process the auto_commit state the server gives
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	984 sendTransactionCommand("ROLLBACK");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	985 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	986
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	987 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	988 * Undoes all changes made after the given Savepoint object was set.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	989 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	990 * This method should be used only when auto-commit has been disabled.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	991 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	992 * @param savepoint the Savepoint object to roll back to
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	993 * @throws SQLException if a database access error occurs, the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	994 * Savepoint object is no longer valid, or this Connection
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	995 * object is currently in auto-commit mode
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	996 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	997 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	998 public void rollback(Savepoint savepoint) throws SQLException {
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	999 if (!(savepoint instanceof MonetSavepoint))
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1000 throw new SQLException("This driver can only handle savepoints it created itself", "M0M06");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1001
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1002 MonetSavepoint sp = (MonetSavepoint)savepoint;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1003
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1004 // note: can't use sendIndependentCommand here because we need
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1005 // to process the auto_commit state the server gives
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1006 sendTransactionCommand("ROLLBACK TO SAVEPOINT " + sp.getName());
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1007 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1008
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1009 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1010 * Sets this connection's auto-commit mode to the given state. If a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1011 * connection is in auto-commit mode, then all its SQL statements
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1012 * will be executed and committed as individual transactions.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1013 * Otherwise, its SQL statements are grouped into transactions that
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1014 * are terminated by a call to either the method commit or the
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1015 * method rollback. By default, new connections are in auto-commit mode.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1016 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1017 * The commit occurs when the statement completes or the next
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1018 * execute occurs, whichever comes first. In the case of statements
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1019 * returning a ResultSet object, the statement completes when the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1020 * last row of the ResultSet object has been retrieved or the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1021 * ResultSet object has been closed. In advanced cases, a single
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1022 * statement may return multiple results as well as output parameter
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1023 * values. In these cases, the commit occurs when all results and
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1024 * output parameter values have been retrieved.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1025 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1026 * NOTE: If this method is called during a transaction, the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1027 * transaction is committed.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1028 *
8 a27ee2cb14a0 Replace String methods equals("") and "".equals( with isEmpty() Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	1029 * @param autoCommit true to enable auto-commit mode; false to disable it
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1030 * @throws SQLException if a database access error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1031 * @see #getAutoCommit()
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1032 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1033 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1034 public void setAutoCommit(boolean autoCommit) throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1035 if (this.autoCommit != autoCommit) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1036 sendControlCommand("auto_commit " + (autoCommit ? "1" : "0"));
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1037 this.autoCommit = autoCommit;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1038 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1039 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1040
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1041 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1042 * Sets the given catalog name in order to select a subspace of this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1043 * Connection object's database in which to work. If the driver
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1044 * does not support catalogs, it will silently ignore this request.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1045 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1046 @Override
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	1047 public void setCatalog(String catalog) {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1048 // silently ignore this request as MonetDB does not support catalogs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1049 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1050
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1051 /**
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1052 * Changes the default holdability of ResultSet objects created using this
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1053 * Connection object to the given holdability. The default holdability of
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1054 * ResultSet objects can be be determined by invoking DatabaseMetaData.getResultSetHoldability().
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1055 *
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1056 * @param holdability - a ResultSet holdability constant; one of
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1057 * ResultSet.HOLD_CURSORS_OVER_COMMIT or
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1058 * ResultSet.CLOSE_CURSORS_AT_COMMIT
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	1059 * @throws SQLException - if a database access error occurs or this method is called on a closed connection
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	1060 * @throws SQLFeatureNotSupportedException - if the JDBC driver does not support this method or argument
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1061 * @see #getHoldability()
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1062 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1063 @Override
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1064 public void setHoldability(int holdability) throws SQLException {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1065 // we only support ResultSet.HOLD_CURSORS_OVER_COMMIT
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1066 if (holdability != ResultSet.HOLD_CURSORS_OVER_COMMIT)
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	1067 throw newSQLFeatureNotSupportedException("setHoldability(CLOSE_CURSORS_AT_COMMIT)");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1068 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1069
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1070 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1071 * Puts this connection in read-only mode as a hint to the driver to
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1072 * enable database optimizations. MonetDB doesn't support any mode
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1073 * here, hence an SQLWarning is generated if attempted to set
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1074 * to true here.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1075 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1076 * @param readOnly true enables read-only mode; false disables it
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1077 * @throws SQLException if a database access error occurs or this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1078 * method is called during a transaction.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1079 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1080 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1081 public void setReadOnly(boolean readOnly) throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1082 if (readOnly == true)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1083 addWarning("cannot setReadOnly(true): read-only Connection mode not supported", "01M08");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1084 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1085
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1086 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1087 * Creates an unnamed savepoint in the current transaction and
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1088 * returns the new Savepoint object that represents it.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1089 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1090 * @return the new Savepoint object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1091 * @throws SQLException if a database access error occurs or this Connection
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1092 * object is currently in auto-commit mode
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1093 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1094 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1095 public Savepoint setSavepoint() throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1096 // create a new Savepoint object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1097 MonetSavepoint sp = new MonetSavepoint();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1098
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1099 // note: can't use sendIndependentCommand here because we need
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1100 // to process the auto_commit state the server gives
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1101 sendTransactionCommand("SAVEPOINT " + sp.getName());
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1102 return sp;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1103 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1104
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1105 /**
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1106 * Creates a savepoint with the given name in the current transaction
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1107 * and returns the new Savepoint object that represents it.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1108 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1109 * @param name a String containing the name of the savepoint
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1110 * @return the new Savepoint object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1111 * @throws SQLException if a database access error occurs or this Connection
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1112 * object is currently in auto-commit mode
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1113 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1114 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1115 public Savepoint setSavepoint(String name) throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1116 // create a new Savepoint object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1117 MonetSavepoint sp;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1118 try {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1119 sp = new MonetSavepoint(name);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1120 } catch (IllegalArgumentException e) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1121 throw new SQLException(e.getMessage(), "M0M03");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1122 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1123
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1124 // note: can't use sendIndependentCommand here because we need
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1125 // to process the auto_commit state the server gives
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1126 sendTransactionCommand("SAVEPOINT " + sp.getName());
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1127 return sp;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1128 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1129
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1130 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1131 * Attempts to change the transaction isolation level for this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1132 * Connection object to the one given. The constants defined in the
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1133 * interface Connection are the possible transaction isolation levels.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1134 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1135 * @param level one of the following Connection constants:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1136 * Connection.TRANSACTION_READ_UNCOMMITTED,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1137 * Connection.TRANSACTION_READ_COMMITTED,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1138 * Connection.TRANSACTION_REPEATABLE_READ, or
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1139 * Connection.TRANSACTION_SERIALIZABLE.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1140 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1141 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1142 public void setTransactionIsolation(int level) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1143 if (level != TRANSACTION_SERIALIZABLE) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1144 addWarning("MonetDB only supports fully serializable " +
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1145 "transactions, continuing with transaction level " +
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1146 "raised to TRANSACTION_SERIALIZABLE", "01M09");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1147 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1148 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1149
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1150 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1151 * Installs the given TypeMap object as the type map for this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1152 * Connection object. The type map will be used for the custom
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1153 * mapping of SQL structured types and distinct types.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1154 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1155 * @param map the java.util.Map object to install as the replacement for
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1156 * this Connection object's default type map
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1157 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1158 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1159 public void setTypeMap(Map<String, Class<?>> map) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1160 typeMap = map;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1161 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1162
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1163 /**
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1164 * Returns a string identifying this Connection to the MonetDB server.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1165 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1166 * @return a String representing this Object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1167 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1168 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1169 public String toString() {
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1170 return "MonetDB Connection (" + getJDBCURL() + ") " +
243 337a1292fe18 Fixed MonetConnection string description. Pedro Ferreira <pedro.ferreira@monetdbsolutions.com> parents: 225 diff changeset	1171 (closed ? "disconnected" : "connected");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1172 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1173
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1174 //== Java 1.6 methods (JDBC 4.0)
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1175
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1176 /**
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1177 * Factory method for creating Array objects.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1178 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1179 * Note: When createArrayOf is used to create an array object that
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1180 * maps to a primitive data type, then it is implementation-defined
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1181 * whether the Array object is an array of that primitive data type
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1182 * or an array of Object.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1183 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1184 * Note: The JDBC driver is responsible for mapping the elements
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1185 * Object array to the default JDBC SQL type defined in
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1186 * java.sql.Types for the given class of Object. The default mapping
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1187 * is specified in Appendix B of the JDBC specification. If the
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1188 * resulting JDBC type is not the appropriate type for the given
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1189 * typeName then it is implementation defined whether an
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1190 * SQLException is thrown or the driver supports the resulting conversion.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1191 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1192 * @param typeName the SQL name of the type the elements of the
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1193 * array map to. The typeName is a database-specific name
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1194 * which may be the name of a built-in type, a user-defined
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1195 * type or a standard SQL type supported by this database.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1196 * This is the value returned by Array.getBaseTypeName
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1197 * @return an Array object whose elements map to the specified SQL type
89 a6608e9581c1 Moved content of ChangeLog to ChangeLog-Archive. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 77 diff changeset	1198 * @throws SQLException - if a database error occurs, the JDBC type is not appropriate for the typeName and
a6608e9581c1 Moved content of ChangeLog to ChangeLog-Archive. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 77 diff changeset	1199 * the conversion is not supported, the typeName is null or this method is called on a closed connection
a6608e9581c1 Moved content of ChangeLog to ChangeLog-Archive. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 77 diff changeset	1200 * @throws SQLFeatureNotSupportedException - if the JDBC driver does not support this data type
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1201 * @since 1.6
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1202 */
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1203 @Override
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1204 public java.sql.Array createArrayOf(String typeName, Object[] elements) throws SQLException {
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	1205 throw newSQLFeatureNotSupportedException("createArrayOf");
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1206 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1207
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1208
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1209 /**
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1210 * Constructs an object that implements the Clob interface. The
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1211 * object returned initially contains no data. The setAsciiStream,
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1212 * setCharacterStream and setString methods of the Clob interface
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1213 * may be used to add data to the Clob.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1214 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1215 * @return a MonetClob instance
89 a6608e9581c1 Moved content of ChangeLog to ChangeLog-Archive. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 77 diff changeset	1216 * @throws SQLException - if an object that implements the Clob interface can not be constructed,
a6608e9581c1 Moved content of ChangeLog to ChangeLog-Archive. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 77 diff changeset	1217 * this method is called on a closed connection or a database access error occurs.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1218 * @since 1.6
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1219 */
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1220 @Override
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1221 public java.sql.Clob createClob() throws SQLException {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1222 return new MonetClob("");
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1223 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1224
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1225 /**
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1226 * Constructs an object that implements the Blob interface. The
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1227 * object returned initially contains no data. The setBinaryStream
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1228 * and setBytes methods of the Blob interface may be used to add
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1229 * data to the Blob.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1230 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1231 * @return a MonetBlob instance
89 a6608e9581c1 Moved content of ChangeLog to ChangeLog-Archive. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 77 diff changeset	1232 * @throws SQLException - if an object that implements the Blob interface can not be constructed,
a6608e9581c1 Moved content of ChangeLog to ChangeLog-Archive. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 77 diff changeset	1233 * this method is called on a closed connection or a database access error occurs.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1234 * @since 1.6
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1235 */
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1236 @Override
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1237 public java.sql.Blob createBlob() throws SQLException {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1238 byte[] buf = new byte[1];
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1239 return new MonetBlob(buf);
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1240 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1241
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1242 /**
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1243 * Constructs an object that implements the NClob interface. The
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1244 * object returned initially contains no data. The setAsciiStream,
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1245 * setCharacterStream and setString methods of the NClob interface
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1246 * may be used to add data to the NClob.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1247 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1248 * @return an NClob instance
89 a6608e9581c1 Moved content of ChangeLog to ChangeLog-Archive. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 77 diff changeset	1249 * @throws SQLException - if an object that implements the NClob interface can not be constructed,
a6608e9581c1 Moved content of ChangeLog to ChangeLog-Archive. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 77 diff changeset	1250 * this method is called on a closed connection or a database access error occurs.
a6608e9581c1 Moved content of ChangeLog to ChangeLog-Archive. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 77 diff changeset	1251 * @throws SQLFeatureNotSupportedException - if the JDBC driver does not support this data type
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1252 * @since 1.6
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1253 */
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1254 @Override
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1255 public java.sql.NClob createNClob() throws SQLException {
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	1256 throw newSQLFeatureNotSupportedException("createNClob");
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1257 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1258
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1259 /**
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1260 * Factory method for creating Struct objects.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1261 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1262 * @param typeName the SQL type name of the SQL structured type that
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1263 * this Struct object maps to. The typeName is the name of a
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1264 * user-defined type that has been defined for this database.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1265 * It is the value returned by Struct.getSQLTypeName.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1266 * @param attributes the attributes that populate the returned object
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1267 * @return a Struct object that maps to the given SQL type and is
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1268 * populated with the given attributes
89 a6608e9581c1 Moved content of ChangeLog to ChangeLog-Archive. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 77 diff changeset	1269 * @throws SQLException - if an object that implements the Struct interface can not be constructed,
a6608e9581c1 Moved content of ChangeLog to ChangeLog-Archive. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 77 diff changeset	1270 * this method is called on a closed connection or a database access error occurs.
a6608e9581c1 Moved content of ChangeLog to ChangeLog-Archive. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 77 diff changeset	1271 * @throws SQLFeatureNotSupportedException - if the JDBC driver does not support this data type
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1272 * @since 1.6
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1273 */
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1274 @Override
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1275 public java.sql.Struct createStruct(String typeName, Object[] attributes) throws SQLException {
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	1276 throw newSQLFeatureNotSupportedException("createStruct");
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1277 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1278
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1279 /**
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1280 * Constructs an object that implements the SQLXML interface. The
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1281 * object returned initially contains no data. The
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1282 * createXmlStreamWriter object and setString method of the SQLXML
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1283 * interface may be used to add data to the SQLXML object.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1284 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1285 * @return An object that implements the SQLXML interface
89 a6608e9581c1 Moved content of ChangeLog to ChangeLog-Archive. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 77 diff changeset	1286 * @throws SQLException - if an object that implements the SQLXML interface can not be constructed,
a6608e9581c1 Moved content of ChangeLog to ChangeLog-Archive. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 77 diff changeset	1287 * this method is called on a closed connection or a database access error occurs.
a6608e9581c1 Moved content of ChangeLog to ChangeLog-Archive. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 77 diff changeset	1288 * @throws SQLFeatureNotSupportedException - if the JDBC driver does not support this data type
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1289 * @since 1.6
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1290 */
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1291 @Override
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1292 public java.sql.SQLXML createSQLXML() throws SQLException {
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	1293 throw newSQLFeatureNotSupportedException("createSQLXML");
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1294 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1295
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1296 /**
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1297 * Returns true if the connection has not been closed and is still
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1298 * valid. The driver shall submit a query on the connection or use
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1299 * some other mechanism that positively verifies the connection is
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1300 * still valid when this method is called.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1301 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1302 * The query submitted by the driver to validate the connection
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1303 * shall be executed in the context of the current transaction.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1304 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1305 * @param timeout The time in seconds to wait for the database
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1306 * operation used to validate the connection to complete. If
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1307 * the timeout period expires before the operation completes,
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1308 * this method returns false. A value of 0 indicates a
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1309 * timeout is not applied to the database operation.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1310 * @return true if the connection is valid, false otherwise
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1311 * @throws SQLException if the value supplied for timeout is less than 0
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1312 * @since 1.6
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1313 */
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1314 @Override
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1315 public boolean isValid(int timeout) throws SQLException {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1316 if (timeout < 0)
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1317 throw new SQLException("timeout is less than 0", "M1M05");
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1318 if (closed)
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1319 return false;
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1320
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1321 // ping db using query: select 1;
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1322 Statement stmt = null;
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1323 ResultSet rs = null;
167 89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1324 boolean isValid = false;
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1325 try {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1326 stmt = createStatement();
167 89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1327 if (stmt != null) {
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1328 int original_timeout = stmt.getQueryTimeout();
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1329 if (timeout > 0 && original_timeout != timeout) {
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1330 // we need to change the requested timeout for this test query
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1331 stmt.setQueryTimeout(timeout);
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1332 }
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1333 rs = stmt.executeQuery("SELECT 1");
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1334 if (rs != null && rs.next()) {
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1335 isValid = true;
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1336 }
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1337 if (timeout > 0 && original_timeout != timeout) {
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1338 // restore the original server timeout value
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1339 stmt.setQueryTimeout(original_timeout);
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1340 }
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1341 }
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1342 } catch (SQLException se) {
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1343 String msg = se.getMessage();
175 8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	1344 // System.out.println(se.getSQLState() + " Con.isValid(): " + msg);
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	1345 if (msg != null && msg.equalsIgnoreCase("Current transaction is aborted (please ROLLBACK)")) {
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	1346 // Must use equalsIgnoreCase() here because up to Jul2017 release 'Current' was 'current' so with lowercase c.
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	1347 // It changed to 'Current' after Jul2017 release. We need to support all server versions.
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	1348 // SQLState = 25005
167 89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1349 isValid = true;
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1350 }
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1351 /* ignore stmt errors/exceptions, we are only testing if the connection is still alive and usable */
89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1352 } finally {
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1353 if (rs != null) {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1354 try {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1355 rs.close();
167 89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1356 } catch (Exception e2) { /* ignore error */ }
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1357 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1358 if (stmt != null) {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1359 try {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1360 stmt.close();
167 89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1361 } catch (Exception e2) { /* ignore error */ }
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1362 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1363 }
167 89e954e7acbb Correct implementation of method Connection.isValid(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	1364 return isValid;
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1365 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1366
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1367 /**
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1368 * Returns the value of the client info property specified by name.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1369 * This method may return null if the specified client info property
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1370 * has not been set and does not have a default value.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1371 * This method will also return null if the specified client info
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1372 * property name is not supported by the driver.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1373 * Applications may use the DatabaseMetaData.getClientInfoProperties method
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1374 * to determine the client info properties supported by the driver.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1375 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1376 * @param name - The name of the client info property to retrieve
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1377 * @return The value of the client info property specified or null
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1378 * @throws SQLException - if the database server returns an error
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1379 * when fetching the client info value from the database
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1380 * or this method is called on a closed connection
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1381 * @since 1.6
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1382 */
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1383 @Override
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1384 public String getClientInfo(String name) throws SQLException {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1385 if (name == null \|\| name.isEmpty())
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1386 return null;
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1387 return conn_props.getProperty(name);
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1388 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1389
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1390 /**
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1391 * Returns a list containing the name and current value of each client info
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1392 * property supported by the driver. The value of a client info property may
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1393 * be null if the property has not been set and does not have a default value.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1394 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1395 * @return A Properties object that contains the name and current value
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1396 * of each of the client info properties supported by the driver.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1397 * @throws SQLException - if the database server returns an error
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1398 * when fetching the client info value from the database
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1399 * or this method is called on a closed connection
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1400 * @since 1.6
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1401 */
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1402 @Override
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1403 public Properties getClientInfo() throws SQLException {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1404 // return a clone of the connection properties object
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1405 return new Properties(conn_props);
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1406 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1407
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1408 /**
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1409 * Sets the value of the client info property specified by name to the value specified by value.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1410 * Applications may use the DatabaseMetaData.getClientInfoProperties method to determine
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1411 * the client info properties supported by the driver and the maximum length that may be specified
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1412 * for each property.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1413 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1414 * The driver stores the value specified in a suitable location in the database. For example
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1415 * in a special register, session parameter, or system table column. For efficiency the driver
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1416 * may defer setting the value in the database until the next time a statement is executed
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1417 * or prepared. Other than storing the client information in the appropriate place in the
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1418 * database, these methods shall not alter the behavior of the connection in anyway.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1419 * The values supplied to these methods are used for accounting, diagnostics and debugging purposes only.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1420 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1421 * The driver shall generate a warning if the client info name specified is not recognized by the driver.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1422 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1423 * If the value specified to this method is greater than the maximum length for the property
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1424 * the driver may either truncate the value and generate a warning or generate a SQLClientInfoException.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1425 * If the driver generates a SQLClientInfoException, the value specified was not set on the connection.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1426 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1427 * The following are standard client info properties. Drivers are not required to support these
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1428 * properties however if the driver supports a client info property that can be described by one
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1429 * of the standard properties, the standard property name should be used.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1430 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1431 * ApplicationName - The name of the application currently utilizing the connection
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1432 * ClientUser - The name of the user that the application using the connection is performing work for.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1433 * This may not be the same as the user name that was used in establishing the connection.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1434 * ClientHostname - The hostname of the computer the application using the connection is running on.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1435 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1436 * @param name - The name of the client info property to set
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1437 * @param value - The value to set the client info property to. If the
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1438 * value is null, the current value of the specified property is cleared.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1439 * @throws SQLClientInfoException - if the database server returns an error
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1440 * while setting the clientInfo values on the database server
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1441 * or this method is called on a closed connection
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1442 * @since 1.6
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1443 */
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1444 @Override
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 186 diff changeset	1445 public void setClientInfo(String name, String value) throws SQLClientInfoException {
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1446 if (name == null \|\| name.isEmpty()) {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1447 addWarning("setClientInfo: missing property name", "01M07");
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1448 return;
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1449 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1450 // If the value is null, the current value of the specified property is cleared.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1451 if (value == null) {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1452 if (conn_props.containsKey(name))
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1453 conn_props.remove(name);
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1454 return;
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1455 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1456 // only set value for supported property names
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1457 if (name.equals("host") \|\|
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1458 name.equals("port") \|\|
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1459 name.equals("user") \|\|
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1460 name.equals("password") \|\|
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1461 name.equals("database") \|\|
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1462 name.equals("language") \|\|
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1463 name.equals("so_timeout") \|\|
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1464 name.equals("debug") \|\|
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1465 name.equals("hash") \|\|
175 8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	1466 name.equals("treat_blob_as_binary") \|\|
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	1467 name.equals("treat_clob_as_varchar"))
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	1468 {
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1469 conn_props.setProperty(name, value);
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1470 } else {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1471 addWarning("setClientInfo: " + name + "is not a recognised property", "01M07");
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1472 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1473 return;
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1474 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1475
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1476 /**
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1477 * Sets the value of the connection's client info properties.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1478 * The Properties object contains the names and values of the client info
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1479 * properties to be set. The set of client info properties contained in the
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1480 * properties list replaces the current set of client info properties on the connection.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1481 * If a property that is currently set on the connection is not present in the
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1482 * properties list, that property is cleared. Specifying an empty properties list
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1483 * will clear all of the properties on the connection.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1484 * See setClientInfo (String, String) for more information.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1485 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1486 * If an error occurs in setting any of the client info properties, a
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1487 * SQLClientInfoException is thrown. The SQLClientInfoException contains information
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1488 * indicating which client info properties were not set. The state of the client
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1489 * information is unknown because some databases do not allow multiple client info
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1490 * properties to be set atomically. For those databases, one or more properties may
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1491 * have been set before the error occurred.
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1492 *
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1493 * @param props - The list of client info properties to set
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1494 * @throws SQLClientInfoException - if the database server returns an error
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1495 * while setting the clientInfo values on the database server
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1496 * or this method is called on a closed connection
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1497 * @since 1.6
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1498 */
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1499 @Override
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 186 diff changeset	1500 public void setClientInfo(Properties props) throws SQLClientInfoException {
47 562dbfb2fee8 Prevent null pointer exception by checking props argument Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 45 diff changeset	1501 if (props != null) {
562dbfb2fee8 Prevent null pointer exception by checking props argument Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 45 diff changeset	1502 for (Entry<Object, Object> entry : props.entrySet()) {
562dbfb2fee8 Prevent null pointer exception by checking props argument Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 45 diff changeset	1503 setClientInfo(entry.getKey().toString(),
562dbfb2fee8 Prevent null pointer exception by checking props argument Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 45 diff changeset	1504 entry.getValue().toString());
562dbfb2fee8 Prevent null pointer exception by checking props argument Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 45 diff changeset	1505 }
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1506 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1507 }
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1508
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1509
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1510 //== Java 1.7 methods (JDBC 4.1)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1511
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1512 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1513 * Sets the given schema name to access.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1514 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1515 * @param schema the name of a schema in which to work
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1516 * @throws SQLException if a database access error occurs or this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1517 * method is called on a closed connection
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1518 * @since 1.7
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1519 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1520 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1521 public void setSchema(String schema) throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1522 if (closed)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1523 throw new SQLException("Cannot call on closed Connection", "M1M20");
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1524 if (schema == null)
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1525 throw new SQLException("Missing schema name", "M1M05");
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1526
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1527 Statement st = createStatement();
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1528 try {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1529 st.execute("SET SCHEMA \"" + schema + "\"");
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1530 } finally {
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1531 st.close();
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1532 }
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1533 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1534
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1535 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1536 * Retrieves this Connection object's current schema name.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1537 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1538 * @return the current schema name or null if there is none
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1539 * @throws SQLException if a database access error occurs or this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1540 * method is called on a closed connection
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1541 * @since 1.7
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1542 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1543 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1544 public String getSchema() throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1545 if (closed)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1546 throw new SQLException("Cannot call on closed Connection", "M1M20");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1547
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1548 String cur_schema;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1549 Statement st = createStatement();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1550 ResultSet rs = null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1551 try {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1552 rs = st.executeQuery("SELECT CURRENT_SCHEMA");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1553 if (!rs.next())
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1554 throw new SQLException("Row expected", "02000");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1555 cur_schema = rs.getString(1);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1556 } finally {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1557 if (rs != null)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1558 rs.close();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1559 st.close();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1560 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1561 return cur_schema;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1562 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1563
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1564 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1565 * Terminates an open connection. Calling abort results in:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1566 * * The connection marked as closed
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1567 * * Closes any physical connection to the database
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1568 * * Releases resources used by the connection
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1569 * * Insures that any thread that is currently accessing the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1570 * connection will either progress to completion or throw an
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1571 * SQLException.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1572 * Calling abort marks the connection closed and releases any
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1573 * resources. Calling abort on a closed connection is a no-op.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1574 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1575 * @param executor The Executor implementation which will be used by
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1576 * abort
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1577 * @throws SQLException if a database access error occurs or the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1578 * executor is null
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1579 * @throws SecurityException if a security manager exists and
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1580 * its checkPermission method denies calling abort
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1581 * @since 1.7
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1582 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1583 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1584 public void abort(Executor executor) throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1585 if (closed)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1586 return;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1587 if (executor == null)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1588 throw new SQLException("executor is null", "M1M05");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1589 // this is really the simplest thing to do, it destroys
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1590 // everything (in particular the server connection)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1591 close();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1592 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1593
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1594 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1595 * Sets the maximum period a Connection or objects created from the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1596 * Connection will wait for the database to reply to any one
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1597 * request. If any request remains unanswered, the waiting method
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1598 * will return with a SQLException, and the Connection or objects
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1599 * created from the Connection will be marked as closed. Any
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1600 * subsequent use of the objects, with the exception of the close,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1601 * isClosed or Connection.isValid methods, will result in a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1602 * SQLException.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1603 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1604 * @param executor The Executor implementation which will be used by
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1605 * setNetworkTimeout
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1606 * @param millis The time in milliseconds to wait for the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1607 * database operation to complete
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1608 * @throws SQLException if a database access error occurs, this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1609 * method is called on a closed connection, the executor is
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1610 * null, or the value specified for seconds is less than 0.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1611 * @since 1.7
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1612 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1613 @Override
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1614 public void setNetworkTimeout(Executor executor, int millis) throws SQLException {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1615 if (closed)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1616 throw new SQLException("Cannot call on closed Connection", "M1M20");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1617 if (executor == null)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1618 throw new SQLException("executor is null", "M1M05");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1619 if (millis < 0)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1620 throw new SQLException("milliseconds is less than zero", "M1M05");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1621
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1622 try {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1623 server.setSoTimeout(millis);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1624 } catch (SocketException e) {
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	1625 throw new SQLNonTransientConnectionException(e.getMessage(), "08000");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1626 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1627 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1628
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1629 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1630 * Retrieves the number of milliseconds the driver will wait for a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1631 * database request to complete. If the limit is exceeded, a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1632 * SQLException is thrown.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1633 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1634 * @return the current timeout limit in milliseconds; zero means
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1635 * there is no limit
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1636 * @throws SQLException if a database access error occurs or
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1637 * this method is called on a closed Connection
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1638 * @since 1.7
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1639 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1640 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1641 public int getNetworkTimeout() throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1642 if (closed)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1643 throw new SQLException("Cannot call on closed Connection", "M1M20");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1644
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1645 try {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1646 return server.getSoTimeout();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1647 } catch (SocketException e) {
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	1648 throw new SQLNonTransientConnectionException(e.getMessage(), "08000");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1649 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1650 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1651
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1652
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1653 //== end methods of interface java.sql.Connection
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1654
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1655
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1656 /**
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 186 diff changeset	1657 * @return the MonetDB JDBC Connection URL (without user name and password).
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1658 * Defined as public because it is called from: MonetDatabaseMetaData.java getURL()
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1659 */
199 e87d89d371f1 Make some public non-JDBC methods accessable only to classes of the same package. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 194 diff changeset	1660 String getJDBCURL() {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1661 String language = "";
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1662 if (lang == LANG_MAL)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1663 language = "?language=mal";
199 e87d89d371f1 Make some public non-JDBC methods accessable only to classes of the same package. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 194 diff changeset	1664 return MonetDriver.MONETURL + hostname + ":" + port + "/" + database + language;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1665 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1666
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1667 /**
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 186 diff changeset	1668 * @return whether the JDBC BLOB type should be mapped to VARBINARY type.
175 8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	1669 * This allows generic JDBC programs to fetch Blob data via getBytes()
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	1670 * instead of getBlob() and Blob.getBinaryStream() to reduce overhead.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1671 */
199 e87d89d371f1 Make some public non-JDBC methods accessable only to classes of the same package. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 194 diff changeset	1672 boolean mapBlobAsVarBinary() {
175 8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	1673 return treatBlobAsVarBinary;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1674 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1675
175 8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	1676 /**
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 186 diff changeset	1677 * @return whether the JDBC CLOB type should be mapped to VARCHAR type.
175 8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	1678 * This allows generic JDBC programs to fetch Clob data via getString()
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	1679 * instead of getClob() and Clob.getCharacterStream() to reduce overhead.
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	1680 */
199 e87d89d371f1 Make some public non-JDBC methods accessable only to classes of the same package. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 194 diff changeset	1681 boolean mapClobAsVarChar() {
175 8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	1682 return treatClobAsVarChar;
8700d9ef2ace Added possibility via a connection property to let the JDBC driver Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 167 diff changeset	1683 }
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1684
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1685 /**
215 71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1686 * Internal utility method to query the server to find out if it has
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1687 * the system table sys.comments (which is new as of Mar2018 release).
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1688 * The result is cached and reused, so that we only test the query once per connection.
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1689 * This method is used by methods from MonetDatabaseMetaData.
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1690 */
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1691 boolean commentsTableExists() {
219 4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1692 if (!queriedCommentsTable) {
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1693 hasCommentsTable = existsSysTable("comments");
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1694 queriedCommentsTable = true; // set flag, so the querying is done only at first invocation.
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1695 }
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1696 return hasCommentsTable;
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1697 }
215 71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1698
219 4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1699 /**
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1700 * Internal utility method to query the server to find out if it has
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1701 * the system table sys.privilege_codes (which is new as of Jul2017 release).
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1702 * The result is cached and reused, so that we only test the query once per connection.
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1703 * This method is used by methods from MonetDatabaseMetaData.
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1704 */
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1705 boolean privilege_codesTableExists() {
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1706 if (!queriedPrivilege_codesTable) {
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1707 hasPrivilege_codesTable = existsSysTable("privilege_codes");
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1708 queriedPrivilege_codesTable = true; // set flag, so the querying is done only at first invocation.
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1709 }
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1710 return hasPrivilege_codesTable;
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1711 }
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1712
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1713 /**
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1714 * Internal utility method to query the server to find out if it has the system table sys.<tablename>.
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1715 */
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1716 private boolean existsSysTable(String tablename) {
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1717 boolean exists = false;
215 71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1718 Statement stmt = null;
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1719 ResultSet rs = null;
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1720 try {
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1721 stmt = createStatement();
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1722 if (stmt != null) {
219 4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1723 rs = stmt.executeQuery("SELECT id FROM sys._tables WHERE name = '"
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1724 + tablename
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1725 + "' AND schema_id IN (SELECT id FROM sys.schemas WHERE name = 'sys')");
215 71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1726 if (rs != null) {
219 4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1727 exists = rs.next(); // if a row is available it exists, else not
215 71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1728 }
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1729 }
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1730 } catch (SQLException se) {
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1731 /* ignore */
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1732 } finally {
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1733 if (rs != null) {
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1734 try {
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1735 rs.close();
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1736 } catch (SQLException e) { /* ignore */ }
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1737 }
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1738 if (stmt != null) {
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1739 try {
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1740 stmt.close();
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1741 } catch (SQLException e) { /* ignore */ }
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1742 }
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1743 }
219 4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1744 // for debug: System.out.println("testTableExists(" + tablename + ") returns: " + exists);
4572f0694fde Improved DatabaseMetaData methods getTablePrivileges() and getColumnPrivileges() by returning also Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 215 diff changeset	1745 return exists;
215 71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1746 }
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1747
71b039bc2d99 Added support for querying the sys.comments table for some meta data methods Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 214 diff changeset	1748 /**
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1749 * Sends the given string to MonetDB as special transaction command.
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1750 * All possible returned information is discarded.
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1751 * Encountered errors are reported.
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1752 *
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1753 * @param command the exact string to send to MonetDB
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1754 * @throws SQLException if an IO exception or a database error occurs
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1755 */
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1756 private void sendTransactionCommand(String command) throws SQLException {
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1757 // create a container for the result
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1758 ResponseList l = new ResponseList(0, 0, ResultSet.FETCH_FORWARD, ResultSet.CONCUR_READ_ONLY);
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1759 // send the appropriate query string to the database
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1760 try {
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1761 l.processQuery(command);
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1762 } finally {
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1763 l.close();
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1764 }
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1765 }
83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	1766
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1767 /**
278 1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1768 * Sends the given string to MonetDB as regular SQL statement/query using queryTempl
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1769 * Making sure there is a prompt after the command is sent. All possible
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1770 * returned information is discarded. Encountered errors are reported.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1771 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1772 * @param command the exact string to send to MonetDB
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1773 * @throws SQLException if an IO exception or a database error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1774 */
278 1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1775 private void sendIndependentCommand(String command) throws SQLException {
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1776 sendCommand(command, true);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1777 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1778
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1779 /**
278 1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1780 * Sends the given string to MonetDB as control statement using commandTempl
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1781 * Making sure there is a prompt after the command is sent. All possible
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1782 * returned information is discarded. Encountered errors are reported.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1783 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1784 * @param command the exact string to send to MonetDB
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1785 * @throws SQLException if an IO exception or a database error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1786 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1787 void sendControlCommand(String command) throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1788 // send X command
278 1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1789 sendCommand(command, false);
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1790 }
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1791
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1792 /**
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1793 * Sends the given string to MonetDB as command/query using commandTempl or queryTempl
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1794 * Making sure there is a prompt after the command is sent. All possible
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1795 * returned information is discarded. Encountered errors are reported.
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1796 *
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1797 * @param command the exact string to send to MonetDB
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1798 * @param usequeryTempl send the command using a queryTempl? else it is send using commandTempl
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1799 * @throws SQLException if an IO exception or a database error occurs
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1800 */
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1801 private void sendCommand(String command, boolean usequeryTempl) throws SQLException {
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1802 String cmd = usequeryTempl ?
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1803 (queryTempl[0] == null ? "" : queryTempl[0]) + command + (queryTempl[1] == null ? "" : queryTempl[1])
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1804 :
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1805 (commandTempl[0] == null ? "" : commandTempl[0]) + command + (commandTempl[1] == null ? "" : commandTempl[1]);
1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1806
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1807 synchronized (server) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1808 try {
278 1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	1809 out.writeLine(cmd);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1810 String error = in.waitForPrompt();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1811 if (error != null)
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	1812 throw new SQLException(error.substring(6), error.substring(0, 5));
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1813 } catch (SocketTimeoutException e) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1814 close(); // JDBC 4.1 semantics, abort()
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	1815 throw new SQLNonTransientConnectionException("connection timed out", "08M33");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1816 } catch (IOException e) {
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	1817 throw new SQLNonTransientConnectionException(e.getMessage(), "08000");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1818 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1819 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1820 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1821
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1822 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1823 * Adds a warning to the pile of warnings this Connection object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1824 * has. If there were no warnings (or clearWarnings was called)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1825 * this warning will be the first, otherwise this warning will get
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1826 * appended to the current warning.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1827 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1828 * @param reason the warning message
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1829 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1830 void addWarning(String reason, String sqlstate) {
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	1831 SQLWarning warng = new SQLWarning(reason, sqlstate);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1832 if (warnings == null) {
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	1833 warnings = warng;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1834 } else {
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	1835 warnings.setNextWarning(warng);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1836 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1837 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1838
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1839 /** the default number of rows that are (attempted to) read at once */
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	1840 private static final int DEF_FETCHSIZE = 250;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1841 /** The sequence counter */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1842 private static int seqCounter = 0;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1843
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1844 /** An optional thread that is used for sending large queries */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1845 private SendThread sendThread = null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1846
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1847 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1848 * A Response is a message sent by the server to indicate some
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1849 * action has taken place, and possible results of that action.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1850 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1851 // {{{ interface Response
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1852 interface Response {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1853 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1854 * Adds a line to the underlying Response implementation.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1855 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1856 * @param line the header line as String
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1857 * @param linetype the line type according to the MAPI protocol
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1858 * @return a non-null String if the line is invalid,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1859 * or additional lines are not allowed.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1860 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1861 public abstract String addLine(String line, int linetype);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1862
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1863 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1864 * Returns whether this Reponse expects more lines to be added
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1865 * to it.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1866 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1867 * @return true if a next line should be added, false otherwise
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1868 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1869 public abstract boolean wantsMore();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1870
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1871 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1872 * Indicates that no more header lines will be added to this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1873 * Response implementation.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	1874 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1875 * @throws SQLException if the contents of the Response is not
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1876 * consistent or sufficient.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1877 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1878 public abstract void complete() throws SQLException;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1879
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1880 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1881 * Instructs the Response implementation to close and do the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1882 * necessary clean up procedures.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1883 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1884 public abstract void close();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1885 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1886 // }}}
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1887
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1888 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1889 * The ResultSetResponse represents a tabular result sent by the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1890 * server. This is typically an SQL table. The MAPI headers of the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1891 * Response look like:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1892 * <pre>
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1893 * &1 1 28 2 10
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1894 * # name, value # name
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1895 * # varchar, varchar # type
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1896 * </pre>
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1897 * there the first line consists out of<br />
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1898 * <tt>&"qt" "id" "tc" "cc" "rc"</tt>.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1899 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1900 // {{{ ResultSetResponse class implementation
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1901 class ResultSetResponse implements Response {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1902 /** The number of columns in this result */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1903 public final int columncount;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1904 /** The total number of rows this result set has */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1905 public final int tuplecount;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1906 /** The numbers of rows to retrieve per DataBlockResponse */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1907 private int cacheSize;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1908 /** The table ID of this result */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1909 public final int id;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1910 /** The names of the columns in this result */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1911 private String[] name;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1912 /** The types of the columns in this result */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1913 private String[] type;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1914 /** The max string length for each column in this result */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1915 private int[] columnLengths;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1916 /** The table for each column in this result */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1917 private String[] tableNames;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1918 /** The query sequence number */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1919 private final int seqnr;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1920 /** A List of result blocks (chunks of size fetchSize/cacheSize) */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1921 private DataBlockResponse[] resultBlocks;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1922
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1923 /** A bitmap telling whether the headers are set or not */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1924 private boolean[] isSet;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1925 /** Whether this Response is closed */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1926 private boolean closed;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1927
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1928 /** The Connection that we should use when requesting a new block */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1929 private MonetConnection.ResponseList parent;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1930 /** Whether the fetchSize was explitly set by the user */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1931 private boolean cacheSizeSetExplicitly = false;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1932 /** Whether we should send an Xclose command to the server
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1933 * if we close this Response */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1934 private boolean destroyOnClose;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1935 /** the offset to be used on Xexport queries */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1936 private int blockOffset = 0;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1937
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1938 /** A parser for header lines */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1939 HeaderLineParser hlp;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1940
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	1941 private static final int NAMES = 0;
4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	1942 private static final int TYPES = 1;
4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	1943 private static final int TABLES = 2;
4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	1944 private static final int LENS = 3;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1945
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1946
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1947 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1948 * Sole constructor, which requires a MonetConnection parent to
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1949 * be given.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1950 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1951 * @param id the ID of the result set
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1952 * @param tuplecount the total number of tuples in the result set
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1953 * @param columncount the number of columns in the result set
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1954 * @param rowcount the number of rows in the current block
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1955 * @param parent the parent that created this Response and will
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	1956 * supply new result blocks when necessary
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1957 * @param seq the query sequence number
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1958 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1959 ResultSetResponse(
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1960 int id,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1961 int tuplecount,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1962 int columncount,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1963 int rowcount,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1964 MonetConnection.ResponseList parent,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1965 int seq)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1966 throws SQLException
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1967 {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1968 isSet = new boolean[7];
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1969 this.parent = parent;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1970 if (parent.cachesize == 0) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1971 /* Below we have to calculate how many "chunks" we need
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1972 * to allocate to store the entire result. However, if
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1973 * the user didn't set a cache size, as in this case, we
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1974 * need to stick to our defaults. */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1975 cacheSize = MonetConnection.DEF_FETCHSIZE;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1976 cacheSizeSetExplicitly = false;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1977 } else {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1978 cacheSize = parent.cachesize;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1979 cacheSizeSetExplicitly = true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1980 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1981 /* So far, so good. Now the problem with EXPLAIN, DOT, etc
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1982 * queries is, that they don't support any block fetching,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1983 * so we need to always fetch everything at once. For that
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1984 * reason, the cache size is here set to the rowcount if
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1985 * it's larger, such that we do a full fetch at once.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1986 * (Because we always set a reply_size, we can only get a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1987 * larger rowcount from the server if it doesn't paginate,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1988 * because it's a pseudo SQL result.) */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1989 if (rowcount > cacheSize)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1990 cacheSize = rowcount;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1991 seqnr = seq;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1992 closed = false;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1993 destroyOnClose = id > 0 && tuplecount > rowcount;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1994
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1995 this.id = id;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1996 this.tuplecount = tuplecount;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1997 this.columncount = columncount;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1998 this.resultBlocks =
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1999 new DataBlockResponse[(tuplecount / cacheSize) + 1];
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2000
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2001 hlp = new HeaderLineParser(columncount);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2002
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2003 resultBlocks[0] = new DataBlockResponse(
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2004 rowcount,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2005 parent.rstype == ResultSet.TYPE_FORWARD_ONLY
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2006 );
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2007 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2008
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2009 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2010 * Parses the given string and changes the value of the matching
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2011 * header appropriately, or passes it on to the underlying
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2012 * DataResponse.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2013 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2014 * @param tmpLine the string that contains the header
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2015 * @return a non-null String if the header cannot be parsed or
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2016 * is unknown
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2017 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2018 // {{{ addLine
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2019 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2020 public String addLine(String tmpLine, int linetype) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2021 if (isSet[LENS] && isSet[TYPES] && isSet[TABLES] && isSet[NAMES]) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2022 return resultBlocks[0].addLine(tmpLine, linetype);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2023 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2024
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2025 if (linetype != BufferedMCLReader.HEADER)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2026 return "header expected, got: " + tmpLine;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2027
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2028 // depending on the name of the header, we continue
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2029 try {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2030 switch (hlp.parse(tmpLine)) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2031 case HeaderLineParser.NAME:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2032 name = hlp.values.clone();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2033 isSet[NAMES] = true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2034 break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2035 case HeaderLineParser.LENGTH:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2036 columnLengths = hlp.intValues.clone();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2037 isSet[LENS] = true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2038 break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2039 case HeaderLineParser.TYPE:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2040 type = hlp.values.clone();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2041 isSet[TYPES] = true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2042 break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2043 case HeaderLineParser.TABLE:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2044 tableNames = hlp.values.clone();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2045 isSet[TABLES] = true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2046 break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2047 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2048 } catch (MCLParseException e) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2049 return e.getMessage();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2050 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2051
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2052 // all is well
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2053 return null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2054 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2055 // }}}
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2056
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2057 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2058 * Returns whether this ResultSetResponse needs more lines.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2059 * This method returns true if not all headers are set, or the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2060 * first DataBlockResponse reports to want more.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2061 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2062 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2063 public boolean wantsMore() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2064 if (isSet[LENS] && isSet[TYPES] && isSet[TABLES] && isSet[NAMES]) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2065 return resultBlocks[0].wantsMore();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2066 } else {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2067 return true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2068 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2069 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2070
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2071 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2072 * Returns an array of Strings containing the values between
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2073 * ',\t' separators.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2074 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2075 * @param chrLine a character array holding the input data
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2076 * @param start where the relevant data starts
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2077 * @param stop where the relevant data stops
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2078 * @return an array of Strings
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2079 */
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	2080 private final String[] getValues(char[] chrLine, int start, int stop) {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2081 int elem = 0;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2082 String[] values = new String[columncount];
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	2083
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2084 for (int i = start; i < stop; i++) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2085 if (chrLine[i] == '\t' && chrLine[i - 1] == ',') {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2086 values[elem++] =
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2087 new String(chrLine, start, i - 1 - start);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2088 start = i + 1;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2089 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2090 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2091 // at the left over part
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2092 values[elem++] = new String(chrLine, start, stop - start);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2093
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2094 return values;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2095 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2096
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2097 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2098 * Adds the given DataBlockResponse to this ResultSetResponse at
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2099 * the given block position.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2100 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2101 * @param offset the offset number of rows for this block
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2102 * @param rr the DataBlockResponse to add
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2103 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2104 void addDataBlockResponse(int offset, DataBlockResponse rr) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2105 int block = (offset - blockOffset) / cacheSize;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2106 resultBlocks[block] = rr;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2107 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2108
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2109 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2110 * Marks this Response as being completed. A complete Response
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2111 * needs to be consistent with regard to its internal data.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2112 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2113 * @throws SQLException if the data currently in this Response is not
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	2114 * sufficient to be consistant
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2115 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2116 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2117 public void complete() throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2118 String error = "";
136 4320e6891536 Replace AssertionError() with SQLException(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 90 diff changeset	2119 if (!isSet[NAMES]) error = "name header missing\n";
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	2120 if (!isSet[TYPES]) error += "type header missing\n";
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2121 if (!isSet[TABLES]) error += "table name header missing\n";
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	2122 if (!isSet[LENS]) error += "column width header missing\n";
136 4320e6891536 Replace AssertionError() with SQLException(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 90 diff changeset	2123 if (!error.isEmpty())
4320e6891536 Replace AssertionError() with SQLException(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 90 diff changeset	2124 throw new SQLException(error, "M0M10");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2125 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2126
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2127 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2128 * Returns the names of the columns
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2129 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2130 * @return the names of the columns
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2131 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2132 String[] getNames() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2133 return name;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2134 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2135
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2136 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2137 * Returns the types of the columns
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2138 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2139 * @return the types of the columns
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2140 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2141 String[] getTypes() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2142 return type;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2143 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2144
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2145 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2146 * Returns the tables of the columns
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2147 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2148 * @return the tables of the columns
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2149 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2150 String[] getTableNames() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2151 return tableNames;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2152 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2153
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2154 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2155 * Returns the lengths of the columns
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2156 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2157 * @return the lengths of the columns
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2158 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2159 int[] getColumnLengths() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2160 return columnLengths;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2161 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2162
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2163 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2164 * Returns the cache size used within this Response
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2165 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2166 * @return the cache size
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2167 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2168 int getCacheSize() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2169 return cacheSize;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2170 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2171
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2172 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2173 * Returns the current block offset
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2174 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2175 * @return the current block offset
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2176 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2177 int getBlockOffset() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2178 return blockOffset;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2179 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2180
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2181 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2182 * Returns the ResultSet type, FORWARD_ONLY or not.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2183 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2184 * @return the ResultSet type
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2185 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2186 int getRSType() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2187 return parent.rstype;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2188 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2189
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2190 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2191 * Returns the concurrency of the ResultSet.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2192 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2193 * @return the ResultSet concurrency
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2194 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2195 int getRSConcur() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2196 return parent.rsconcur;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2197 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2198
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2199 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2200 * Returns a line from the cache. If the line is already present in the
136 4320e6891536 Replace AssertionError() with SQLException(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 90 diff changeset	2201 * cache, it is returned, if not appropriate actions are taken to make
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2202 * sure the right block is being fetched and as soon as the requested
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2203 * line is fetched it is returned.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2204 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2205 * @param row the row in the result set to return
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2206 * @return the exact row read as requested or null if the requested row
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2207 * is out of the scope of the result set
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2208 * @throws SQLException if an database error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2209 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2210 String getLine(int row) throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2211 if (row >= tuplecount \|\| row < 0)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2212 return null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2213
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2214 int block = (row - blockOffset) / cacheSize;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2215 int blockLine = (row - blockOffset) % cacheSize;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2216
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2217 // do we have the right block loaded? (optimistic try)
214 b8c007e86694 Improve readability Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	2218 DataBlockResponse rawr = resultBlocks[block];
b8c007e86694 Improve readability Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	2219 if (rawr == null) {
b8c007e86694 Improve readability Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	2220 // load block
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2221 /// TODO: ponder about a maximum number of blocks to keep
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2222 /// in memory when dealing with random access to
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2223 /// reduce memory blow-up
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2224
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2225 // if we're running forward only, we can discard the old
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2226 // block loaded
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2227 if (parent.rstype == ResultSet.TYPE_FORWARD_ONLY) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2228 for (int i = 0; i < block; i++)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2229 resultBlocks[i] = null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2230
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2231 if (MonetConnection.seqCounter - 1 == seqnr &&
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2232 !cacheSizeSetExplicitly &&
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2233 tuplecount - row > cacheSize &&
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2234 cacheSize < MonetConnection.DEF_FETCHSIZE * 10)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2235 {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2236 // there has no query been issued after this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2237 // one, so we can consider this an uninterrupted
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2238 // continuation request. Let's once increase
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2239 // the cacheSize as it was not explicitly set,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2240 // since the chances are high that we won't
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2241 // bother anyone else by doing so, and just
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2242 // gaining some performance.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2243
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2244 // store the previous position in the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2245 // blockOffset variable
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2246 blockOffset += cacheSize;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2247
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2248 // increase the cache size (a lot)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2249 cacheSize *= 10;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2250
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2251 // by changing the cacheSize, we also
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2252 // change the block measures. Luckily
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2253 // we don't care about previous blocks
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2254 // because we have a forward running
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2255 // pointer only. However, we do have
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2256 // to recalculate the block number, to
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2257 // ensure the next call to find this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2258 // new block.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2259 block = (row - blockOffset) / cacheSize;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2260 blockLine = (row - blockOffset) % cacheSize;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2261 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2262 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2263
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2264 // ok, need to fetch cache block first
136 4320e6891536 Replace AssertionError() with SQLException(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 90 diff changeset	2265 parent.executeQuery(commandTempl,
4320e6891536 Replace AssertionError() with SQLException(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 90 diff changeset	2266 "export " + id + " " + ((block * cacheSize) + blockOffset) + " " + cacheSize);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2267 rawr = resultBlocks[block];
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	2268 if (rawr == null)
136 4320e6891536 Replace AssertionError() with SQLException(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 90 diff changeset	2269 throw new SQLException("resultBlocks[" + block + "] should have been fetched by now", "M0M10");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2270 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2271
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2272 return rawr.getRow(blockLine);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2273 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2274
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2275 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2276 * Closes this Response by sending an Xclose to the server indicating
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2277 * that the result can be closed at the server side as well.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2278 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2279 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2280 public void close() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2281 if (closed) return;
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	2282
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2283 // send command to server indicating we're done with this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2284 // result only if we had an ID in the header and this result
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2285 // was larger than the reply size
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2286 try {
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	2287 if (destroyOnClose)
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	2288 sendControlCommand("close " + id);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2289 } catch (SQLException e) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2290 // probably a connection error...
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2291 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2292
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2293 // close the data block associated with us
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2294 for (int i = 1; i < resultBlocks.length; i++) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2295 DataBlockResponse r = resultBlocks[i];
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	2296 if (r != null)
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	2297 r.close();
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2298 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2299
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2300 closed = true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2301 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2302
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2303 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2304 * Returns whether this Response is closed
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2305 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2306 * @return whether this Response is closed
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2307 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2308 boolean isClosed() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2309 return closed;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2310 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2311 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2312 // }}}
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	2313
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2314 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2315 * The DataBlockResponse is tabular data belonging to a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2316 * ResultSetResponse. Tabular data from the server typically looks
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2317 * like:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2318 * <pre>
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2319 * [ "value", 56 ]
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2320 * </pre>
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2321 * where each column is separated by ",\t" and each tuple surrounded
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2322 * by brackets ("[" and "]"). A DataBlockResponse object holds the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2323 * raw data as read from the server, in a parsed manner, ready for
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2324 * easy retrieval.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	2325 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2326 * This object is not intended to be queried by multiple threads
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2327 * synchronously. It is designed to work for one thread retrieving
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2328 * rows from it. When multiple threads will retrieve rows from this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2329 * object, it is possible for threads to get the same data.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2330 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2331 // {{{ DataBlockResponse class implementation
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2332 static class DataBlockResponse implements Response {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2333 /** The String array to keep the data in */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2334 private final String[] data;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2335
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2336 /** The counter which keeps the current position in the data array */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2337 private int pos;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2338 /** Whether we can discard lines as soon as we have read them */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2339 private boolean forwardOnly;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2340
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2341 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2342 * Constructs a DataBlockResponse object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2343 * @param size the size of the data array to create
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2344 * @param forward whether this is a forward only result
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2345 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2346 DataBlockResponse(int size, boolean forward) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2347 pos = -1;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2348 data = new String[size];
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2349 forwardOnly = forward;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2350 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2351
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2352 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2353 * addLine adds a String of data to this object's data array.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2354 * Note that an IndexOutOfBoundsException can be thrown when an
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2355 * attempt is made to add more than the original construction size
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2356 * specified.
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	2357 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2358 * @param line the header line as String
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2359 * @param linetype the line type according to the MAPI protocol
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2360 * @return a non-null String if the line is invalid,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2361 * or additional lines are not allowed.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2362 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2363 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2364 public String addLine(String line, int linetype) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2365 if (linetype != BufferedMCLReader.RESULT)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2366 return "protocol violation: unexpected line in data block: " + line;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2367 // add to the backing array
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2368 data[++pos] = line;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2369
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2370 // all is well
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2371 return null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2372 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2373
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2374 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2375 * Returns whether this Reponse expects more lines to be added
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2376 * to it.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2377 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2378 * @return true if a next line should be added, false otherwise
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2379 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2380 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2381 public boolean wantsMore() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2382 // remember: pos is the value already stored
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2383 return pos + 1 < data.length;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2384 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2385
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2386 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2387 * Indicates that no more header lines will be added to this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2388 * Response implementation. In most cases this is a redundant
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2389 * operation because the data array is full. However... it can
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2390 * happen that this is NOT the case!
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2391 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2392 * @throws SQLException if not all rows are filled
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2393 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2394 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2395 public void complete() throws SQLException {
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	2396 if ((pos + 1) != data.length)
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	2397 throw new SQLException("Inconsistent state detected! Current block capacity: "
c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	2398 + data.length + ", block usage: " + (pos + 1) + ". Did MonetDB send what it promised to?", "M0M10");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2399 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2400
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2401 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2402 * Instructs the Response implementation to close and do the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2403 * necessary clean up procedures.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2404 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2405 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2406 public void close() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2407 // feed all rows to the garbage collector
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2408 for (int i = 0; i < data.length; i++) data[i] = null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2409 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2410
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2411 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2412 * Retrieves the required row. Warning: if the requested rows
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2413 * is out of bounds, an IndexOutOfBoundsException will be
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2414 * thrown.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2415 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2416 * @param line the row to retrieve
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2417 * @return the requested row as String
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2418 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2419 String getRow(int line) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2420 if (forwardOnly) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2421 String ret = data[line];
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2422 data[line] = null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2423 return ret;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2424 } else {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2425 return data[line];
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2426 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2427 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2428 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2429 // }}}
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2430
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2431 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2432 * The UpdateResponse represents an update statement response. It
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2433 * is issued on an UPDATE, INSERT or DELETE SQL statement. This
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2434 * response keeps a count field that represents the affected rows
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2435 * and a field that contains the last inserted auto-generated ID, or
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2436 * -1 if not applicable.<br />
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2437 * <tt>&2 0 -1</tt>
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2438 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2439 // {{{ UpdateResponse class implementation
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2440 static class UpdateResponse implements Response {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2441 public final int count;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2442 public final String lastid;
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	2443
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2444 public UpdateResponse(int cnt, String id) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2445 // fill the blank finals
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2446 this.count = cnt;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2447 this.lastid = id;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2448 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2449
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2450 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2451 public String addLine(String line, int linetype) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2452 return "Header lines are not supported for an UpdateResponse";
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2453 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2454
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2455 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2456 public boolean wantsMore() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2457 return false;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2458 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2459
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2460 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2461 public void complete() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2462 // empty, because there is nothing to check
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2463 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2464
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2465 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2466 public void close() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2467 // nothing to do here...
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2468 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2469 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2470 // }}}
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2471
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2472 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2473 * The SchemaResponse represents an schema modification response.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2474 * It is issued on statements like CREATE, DROP or ALTER TABLE.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2475 * This response keeps a field that represents the success state, as
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2476 * defined by JDBC, which is currently in MonetDB's case alwats
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2477 * SUCCESS_NO_INFO. Note that this state is not sent by the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2478 * server.<br />
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2479 * <tt>&3</tt>
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2480 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2481 // {{{ SchemaResponse class implementation
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2482 class SchemaResponse implements Response {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2483 public final int state = Statement.SUCCESS_NO_INFO;
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	2484
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2485 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2486 public String addLine(String line, int linetype) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2487 return "Header lines are not supported for a SchemaResponse";
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2488 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2489
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2490 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2491 public boolean wantsMore() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2492 return false;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2493 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2494
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2495 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2496 public void complete() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2497 // empty, because there is nothing to check
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2498 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2499
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2500 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2501 public void close() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2502 // nothing to do here...
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2503 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2504 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2505 // }}}
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2506
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2507 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2508 * The AutoCommitResponse represents a transaction message. It
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2509 * stores (a change in) the server side auto commit mode.<br />
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2510 * <tt>&4 (t\|f)</tt>
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2511 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2512 // {{{ AutoCommitResponse class implementation
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2513 class AutoCommitResponse extends SchemaResponse {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2514 public final boolean autocommit;
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	2515
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2516 public AutoCommitResponse(boolean ac) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2517 // fill the blank final
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2518 this.autocommit = ac;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2519 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2520 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2521 // }}}
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2522
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2523 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2524 * A list of Response objects. Responses are added to this list.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2525 * Methods of this class are not synchronized. This is left as
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2526 * responsibility to the caller to prevent concurrent access.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2527 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2528 // {{{ ResponseList class implementation
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2529 class ResponseList {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2530 /** The cache size (number of rows in a DataBlockResponse object) */
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	2531 private final int cachesize;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2532 /** The maximum number of results for this query */
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	2533 private final int maxrows;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2534 /** The ResultSet type to produce */
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	2535 private final int rstype;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2536 /** The ResultSet concurrency to produce */
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	2537 private final int rsconcur;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2538 /** The sequence number of this ResponseList */
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	2539 private final int seqnr;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2540 /** A list of the Responses associated with the query,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2541 * in the right order */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2542 private List<Response> responses;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2543 /** A map of ResultSetResponses, used for additional
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2544 * DataBlockResponse mapping */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2545 private Map<Integer, ResultSetResponse> rsresponses;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2546
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2547 /** The current header returned by getNextResponse() */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2548 private int curResponse;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2549
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2550 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2551 * Main constructor. The query argument can either be a String
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2552 * or List. An SQLException is thrown if another object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2553 * instance is supplied.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2554 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2555 * @param cachesize overall cachesize to use
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2556 * @param maxrows maximum number of rows to allow in the set
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2557 * @param rstype the type of result sets to produce
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2558 * @param rsconcur the concurrency of result sets to produce
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2559 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2560 ResponseList(
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2561 int cachesize,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2562 int maxrows,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2563 int rstype,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2564 int rsconcur
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2565 ) throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2566 this.cachesize = cachesize;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2567 this.maxrows = maxrows;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2568 this.rstype = rstype;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2569 this.rsconcur = rsconcur;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2570 responses = new ArrayList<Response>();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2571 curResponse = -1;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2572 seqnr = MonetConnection.seqCounter++;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2573 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2574
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2575 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2576 * Retrieves the next available response, or null if there are
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2577 * no more responses.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2578 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2579 * @return the next Response available or null
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2580 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2581 Response getNextResponse() throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2582 if (rstype == ResultSet.TYPE_FORWARD_ONLY) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2583 // free resources if we're running forward only
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2584 if (curResponse >= 0 && curResponse < responses.size()) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2585 Response tmp = responses.get(curResponse);
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	2586 if (tmp != null)
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	2587 tmp.close();
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2588 responses.set(curResponse, null);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2589 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2590 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2591 curResponse++;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2592 if (curResponse >= responses.size()) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2593 // ResponseList is obviously completed so, there are no
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2594 // more responses
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2595 return null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2596 } else {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2597 // return this response
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2598 return responses.get(curResponse);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2599 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2600 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2601
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2602 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2603 * Closes the Reponse at index i, if not null.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2604 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2605 * @param i the index position of the header to close
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2606 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2607 void closeResponse(int i) {
262 2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	2608 if (i < 0 \|\| i >= responses.size())
2d62ca1f758b Moved utility method newSQLFeatureNotSupportedException(String name) from MonetPreparedStatement.java and MonetResultSet.java Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	2609 return;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2610 Response tmp = responses.set(i, null);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2611 if (tmp != null)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2612 tmp.close();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2613 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2614
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2615 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2616 * Closes the current response.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2617 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2618 void closeCurrentResponse() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2619 closeResponse(curResponse);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2620 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2621
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2622 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2623 * Closes the current and previous responses.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2624 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2625 void closeCurOldResponses() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2626 for (int i = curResponse; i >= 0; i--) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2627 closeResponse(i);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2628 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2629 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2630
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2631 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2632 * Closes this ResponseList by closing all the Responses in this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2633 * ResponseList.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2634 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2635 void close() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2636 for (int i = 0; i < responses.size(); i++) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2637 closeResponse(i);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2638 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2639 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2640
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2641 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2642 * Returns whether this ResponseList has still unclosed
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2643 * Responses.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2644 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2645 boolean hasUnclosedResponses() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2646 for (Response r : responses) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2647 if (r != null)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2648 return true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2649 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2650 return false;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2651 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2652
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2653 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2654 * Executes the query contained in this ResponseList, and
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2655 * stores the Responses resulting from this query in this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2656 * ResponseList.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2657 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2658 * @throws SQLException if a database error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2659 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2660 void processQuery(String query) throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2661 executeQuery(queryTempl, query);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2662 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2663
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2664 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2665 * Internal executor of queries.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2666 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2667 * @param templ the template to fill in
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2668 * @param the query to execute
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2669 * @throws SQLException if a database error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2670 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2671 @SuppressWarnings("fallthrough")
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2672 void executeQuery(String[] templ, String query)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2673 throws SQLException
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2674 {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2675 boolean sendThreadInUse = false;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2676 String error = null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2677
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2678 try {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2679 synchronized (server) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2680 // make sure we're ready to send query; read data till we
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2681 // have the prompt it is possible (and most likely) that we
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2682 // already have the prompt and do not have to skip any
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2683 // lines. Ignore errors from previous result sets.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2684 in.waitForPrompt();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2685
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2686 // {{{ set reply size
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2687 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2688 * Change the reply size of the server. If the given
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2689 * value is the same as the current value known to use,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2690 * then ignore this call. If it is set to 0 we get a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2691 * prompt after the server sent it's header.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2692 */
178 dd12348c41cf Improvement: only extend typeMap when the property was set to true. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 175 diff changeset	2693 int size = (cachesize == 0 ? DEF_FETCHSIZE : cachesize);
dd12348c41cf Improvement: only extend typeMap when the property was set to true. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 175 diff changeset	2694 if (maxrows > 0 && maxrows < size)
dd12348c41cf Improvement: only extend typeMap when the property was set to true. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 175 diff changeset	2695 size = maxrows;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2696 // don't do work if it's not needed
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2697 if (lang == LANG_SQL && size != curReplySize && templ != commandTempl) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2698 sendControlCommand("reply_size " + size);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2699
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2700 // store the reply size after a successful change
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2701 curReplySize = size;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2702 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2703 // }}} set reply size
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2704
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2705 // If the query is larger than the TCP buffer size, use a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2706 // special send thread to avoid deadlock with the server due
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2707 // to blocking behaviour when the buffer is full. Because
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2708 // the server will be writing back results to us, it will
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2709 // eventually block as well when its TCP buffer gets full,
278 1d6062d94377 Reduce duplicate code. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 271 diff changeset	2710 // as we are blocking and not consuming from it. The result
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2711 // is a state where both client and server want to write,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2712 // but block.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2713 if (query.length() > MapiSocket.BLOCK) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2714 // get a reference to the send thread
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2715 if (sendThread == null)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2716 sendThread = new SendThread(out);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2717 // tell it to do some work!
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2718 sendThread.runQuery(templ, query);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2719 sendThreadInUse = true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2720 } else {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2721 // this is a simple call, which is a lot cheaper and will
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2722 // always succeed for small queries.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2723 out.writeLine(
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2724 (templ[0] == null ? "" : templ[0]) +
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2725 query +
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2726 (templ[1] == null ? "" : templ[1]));
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2727 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2728
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2729 // go for new results
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2730 String tmpLine = in.readLine();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2731 int linetype = in.getLineType();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2732 Response res = null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2733 while (linetype != BufferedMCLReader.PROMPT) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2734 // each response should start with a start of header
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2735 // (or error)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2736 switch (linetype) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2737 case BufferedMCLReader.SOHEADER:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2738 // make the response object, and fill it
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2739 try {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2740 switch (sohp.parse(tmpLine)) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2741 case StartOfHeaderParser.Q_PARSE:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2742 throw new MCLParseException("Q_PARSE header not allowed here", 1);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2743 case StartOfHeaderParser.Q_TABLE:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2744 case StartOfHeaderParser.Q_PREPARE: {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2745 int id = sohp.getNextAsInt();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2746 int tuplecount = sohp.getNextAsInt();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2747 int columncount = sohp.getNextAsInt();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2748 int rowcount = sohp.getNextAsInt();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2749 // enforce the maxrows setting
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2750 if (maxrows != 0 && tuplecount > maxrows)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2751 tuplecount = maxrows;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2752 res = new ResultSetResponse(
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2753 id,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2754 tuplecount,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2755 columncount,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2756 rowcount,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2757 this,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2758 seqnr
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2759 );
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2760 // only add this resultset to
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2761 // the hashmap if it can possibly
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2762 // have an additional datablock
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2763 if (rowcount < tuplecount) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2764 if (rsresponses == null)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2765 rsresponses = new HashMap<Integer, ResultSetResponse>();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2766 rsresponses.put(
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2767 Integer.valueOf(id),
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2768 (ResultSetResponse) res
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2769 );
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2770 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2771 } break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2772 case StartOfHeaderParser.Q_UPDATE:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2773 res = new UpdateResponse(
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2774 sohp.getNextAsInt(), // count
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2775 sohp.getNextAsString() // key-id
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2776 );
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2777 break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2778 case StartOfHeaderParser.Q_SCHEMA:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2779 res = new SchemaResponse();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2780 break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2781 case StartOfHeaderParser.Q_TRANS:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2782 boolean ac = sohp.getNextAsString().equals("t") ? true : false;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2783 if (autoCommit && ac) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2784 addWarning("Server enabled auto commit " +
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2785 "mode while local state " +
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2786 "already was auto commit.", "01M11"
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2787 );
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2788 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2789 autoCommit = ac;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2790 res = new AutoCommitResponse(ac);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2791 break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2792 case StartOfHeaderParser.Q_BLOCK: {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2793 // a new block of results for a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2794 // response...
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	2795 int id = sohp.getNextAsInt();
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2796 sohp.getNextAsInt(); // columncount
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2797 int rowcount = sohp.getNextAsInt();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2798 int offset = sohp.getNextAsInt();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2799 ResultSetResponse t =
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2800 rsresponses.get(Integer.valueOf(id));
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2801 if (t == null) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2802 error = "M0M12!no ResultSetResponse with id " + id + " found";
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2803 break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2804 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2805
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2806 DataBlockResponse r =
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2807 new DataBlockResponse(
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2808 rowcount, // rowcount
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2809 t.getRSType() == ResultSet.TYPE_FORWARD_ONLY
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2810 );
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2811
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2812 t.addDataBlockResponse(offset, r);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2813 res = r;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2814 } break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2815 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2816 } catch (MCLParseException e) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2817 error = "M0M10!error while parsing start of header:\n" +
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2818 e.getMessage() +
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2819 " found: '" + tmpLine.charAt(e.getErrorOffset()) + "'" +
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2820 " in: \"" + tmpLine + "\"" +
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2821 " at pos: " + e.getErrorOffset();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2822 // flush all the rest
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2823 in.waitForPrompt();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2824 linetype = in.getLineType();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2825 break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2826 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2827
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2828 // immediately handle errors after parsing
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2829 // the header (res may be null)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2830 if (error != null) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2831 in.waitForPrompt();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2832 linetype = in.getLineType();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2833 break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2834 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2835
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2836 // here we have a res object, which
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2837 // we can start filling
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2838 while (res.wantsMore()) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2839 error = res.addLine(
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2840 in.readLine(),
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2841 in.getLineType()
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2842 );
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2843 if (error != null) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2844 // right, some protocol violation,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2845 // skip the rest of the result
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2846 error = "M0M10!" + error;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2847 in.waitForPrompt();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2848 linetype = in.getLineType();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2849 break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2850 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2851 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2852 if (error != null)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2853 break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2854 // it is of no use to store
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2855 // DataBlockReponses, you never want to
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2856 // retrieve them directly anyway
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2857 if (!(res instanceof DataBlockResponse))
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2858 responses.add(res);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2859
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2860 // read the next line (can be prompt, new
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2861 // result, error, etc.) before we start the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2862 // loop over
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2863 tmpLine = in.readLine();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2864 linetype = in.getLineType();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2865 break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2866 case BufferedMCLReader.INFO:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2867 addWarning(tmpLine.substring(1), "01000");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2868
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2869 // read the next line (can be prompt, new
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2870 // result, error, etc.) before we start the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2871 // loop over
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2872 tmpLine = in.readLine();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2873 linetype = in.getLineType();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2874 break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2875 default: // Yeah... in Java this is correct!
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2876 // we have something we don't
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2877 // expect/understand, let's make it an error
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2878 // message
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2879 tmpLine = "!M0M10!protocol violation, unexpected line: " + tmpLine;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2880 // don't break; fall through...
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2881 case BufferedMCLReader.ERROR:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2882 // read everything till the prompt (should be
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2883 // error) we don't know if we ignore some
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2884 // garbage here... but the log should reveal
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2885 // that
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2886 error = in.waitForPrompt();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2887 linetype = in.getLineType();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2888 if (error != null) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2889 error = tmpLine.substring(1) + "\n" + error;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2890 } else {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2891 error = tmpLine.substring(1);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2892 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2893 break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2894 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2895 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2896 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2897
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2898 // if we used the sendThread, make sure it has finished
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2899 if (sendThreadInUse) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2900 String tmp = sendThread.getErrors();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2901 if (tmp != null) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2902 if (error == null) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2903 error = "08000!" + tmp;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2904 } else {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2905 error += "\n08000!" + tmp;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2906 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2907 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2908 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2909 if (error != null) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2910 SQLException ret = null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2911 String[] errors = error.split("\n");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2912 for (int i = 0; i < errors.length; i++) {
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	2913 SQLException newErr;
d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	2914 if (errors[i].length() >= 6) {
d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	2915 newErr = new SQLException(errors[i].substring(6), errors[i].substring(0, 5));
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2916 } else {
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	2917 newErr = new SQLNonTransientConnectionException(errors[i], "08000");
d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	2918 }
d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	2919 if (ret == null) {
d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	2920 ret = newErr;
d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	2921 } else {
d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	2922 ret.setNextException(newErr);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2923 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2924 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2925 throw ret;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2926 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2927 } catch (SocketTimeoutException e) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2928 close(); // JDBC 4.1 semantics, abort()
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	2929 throw new SQLNonTransientConnectionException("connection timed out", "08M33");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2930 } catch (IOException e) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2931 closed = true;
144 d6abd1ffffbb Use SQLNonTransientConnectionException instead of SQLException where applicable (SQLState starts with 08) Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 136 diff changeset	2932 throw new SQLNonTransientConnectionException(e.getMessage() + " (mserver5 still alive?)", "08006");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2933 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2934 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2935 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2936 // }}}
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2937
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2938 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2939 * A thread to send a query to the server. When sending large
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2940 * amounts of data to a server, the output buffer of the underlying
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2941 * communication socket may overflow. In such case the sending
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2942 * process blocks. In order to prevent deadlock, it might be
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2943 * desirable that the driver as a whole does not block. This thread
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2944 * facilitates the prevention of such 'full block', because this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2945 * separate thread only will block.<br />
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2946 * This thread is designed for reuse, as thread creation costs are
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2947 * high.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2948 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2949 // {{{ SendThread class implementation
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2950 static class SendThread extends Thread {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2951 /** The state WAIT represents this thread to be waiting for
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2952 * something to do */
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	2953 private static final int WAIT = 0;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2954 /** The state QUERY represents this thread to be executing a query */
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	2955 private static final int QUERY = 1;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2956 /** The state SHUTDOWN is the final state that ends this thread */
186 4767b005a531 Making variables private where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 184 diff changeset	2957 private static final int SHUTDOWN = -1;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2958
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2959 private String[] templ;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2960 private String query;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2961 private BufferedMCLWriter out;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2962 private String error;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2963 private int state = WAIT;
77 83aee4f60649 Added private method sendTransactionCommand(String); to reduce duplicate code in 6 methods. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 47 diff changeset	2964
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2965 final Lock sendLock = new ReentrantLock();
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	2966 final Condition queryAvailable = sendLock.newCondition();
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2967 final Condition waiting = sendLock.newCondition();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2968
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2969 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2970 * Constructor which immediately starts this thread and sets it
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2971 * into daemon mode.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2972 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2973 * @param monet the socket to write to
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2974 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2975 public SendThread(BufferedMCLWriter out) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2976 super("SendThread");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2977 setDaemon(true);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2978 this.out = out;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2979 start();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2980 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2981
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2982 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2983 public void run() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2984 sendLock.lock();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2985 try {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2986 while (true) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2987 while (state == WAIT) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2988 try {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2989 queryAvailable.await();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2990 } catch (InterruptedException e) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2991 // woken up, eh?
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2992 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2993 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2994 if (state == SHUTDOWN)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2995 break;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2996
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2997 // state is QUERY here
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2998 try {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	2999 out.writeLine(
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3000 (templ[0] == null ? "" : templ[0]) +
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3001 query +
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3002 (templ[1] == null ? "" : templ[1]));
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3003 } catch (IOException e) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3004 error = e.getMessage();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3005 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3006
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3007 // update our state, and notify, maybe someone is waiting
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3008 // for us in throwErrors
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3009 state = WAIT;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3010 waiting.signal();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3011 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3012 } finally {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3013 sendLock.unlock();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3014 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3015 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3016
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3017 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3018 * Starts sending the given query over the given socket. Beware
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3019 * that the thread should be finished (can be assured by calling
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3020 * throwErrors()) before this method is called!
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3021 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3022 * @param templ the query template
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3023 * @param query the query itself
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3024 * @throws SQLException if this SendThread is already in use
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3025 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3026 public void runQuery(String[] templ, String query) throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3027 sendLock.lock();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3028 try {
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	3029 if (state != WAIT)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3030 throw new SQLException("SendThread already in use or shutting down!", "M0M03");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3031
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3032 this.templ = templ;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3033 this.query = query;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3034
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3035 // let the thread know there is some work to do
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3036 state = QUERY;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3037 queryAvailable.signal();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3038 } finally {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3039 sendLock.unlock();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3040 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3041 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3042
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3043 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3044 * Returns errors encountered during the sending process.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3045 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3046 * @return the errors or null if none
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3047 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3048 public String getErrors() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3049 sendLock.lock();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3050 try {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3051 // make sure the thread is in WAIT state, not QUERY
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3052 while (state == QUERY) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3053 try {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3054 waiting.await();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3055 } catch (InterruptedException e) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3056 // just try again
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3057 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3058 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3059 if (state == SHUTDOWN)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3060 error = "SendThread is shutting down";
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3061 } finally {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3062 sendLock.unlock();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3063 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3064 return error;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3065 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3066
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3067 /**
45 c2bf983dc79b Implemented Connection methods: getClientInfo(name) and getClientInfo(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 25 diff changeset	3068 * Requests this SendThread to stop.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3069 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3070 public void shutdown() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3071 sendLock.lock();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3072 state = SHUTDOWN;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3073 sendLock.unlock();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3074 this.interrupt(); // break any wait conditions
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3075 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3076 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3077 // }}}
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	3078 }

Mercurial > hg > monetdb-java

annotate src/main/java/nl/cwi/monetdb/jdbc/MonetConnection.java @ 278:1d6062d94377