monetdb-java: src/main/java/org/monetdb/jdbc/MonetStatement.java annotate

annotate src/main/java/org/monetdb/jdbc/MonetStatement.java @ 391:f523727db392

Moved Java classes from packages starting with nl.cwi.monetdb.* to package org.monetdb.* This naming complies to the Java Package Naming convention as MonetDB's main website is www.monetdb.org.

author	Martin van Dinther <martin.van.dinther@monetdbsolutions.com>
date	Thu, 12 Nov 2020 22:02:01 +0100 (2020-11-12)
parents	src/main/java/nl/cwi/monetdb/jdbc/MonetStatement.java@02f353f62abe
children	00c6bb1d84ed

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 *
350 54137aeb1f92 Update Copyright year. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 316 diff changeset	6 * Copyright 1997 - July 2008 CWI, August 2008 - 2020 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
391 f523727db392 Moved Java classes from packages starting with nl.cwi.monetdb.* to package org.monetdb.* Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 378 diff changeset	9 package org.monetdb.jdbc;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	10
391 f523727db392 Moved Java classes from packages starting with nl.cwi.monetdb.* to package org.monetdb.* Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 378 diff changeset	11 import org.monetdb.mcl.net.MapiSocket;
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	12 import java.sql.BatchUpdateException;
749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	13 import java.sql.Connection;
749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	14 import java.sql.Statement;
749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	15 import java.sql.ResultSet;
749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	16 import java.sql.SQLException;
179 f0a704e33fe4 Improvement: throw SQLFeatureNotSupportedException instead of SQLException Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	17 import java.sql.SQLFeatureNotSupportedException;
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	18 import java.sql.SQLWarning;
749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	19 import java.util.ArrayList;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	20 import java.util.concurrent.locks.ReentrantLock;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	21
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	22 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	23 * A Statement suitable for the MonetDB database.
29 c26213e86442 Use newSQLFeatureNotSupportedException() for setArray() Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 14 diff changeset	24 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	25 * The object used for executing a static SQL statement and returning
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 183 diff changeset	26 * the results it produces.
29 c26213e86442 Use newSQLFeatureNotSupportedException() for setArray() Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 14 diff changeset	27 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	28 * By default, only one {@link ResultSet} object per Statement object can be
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	29 * open at the same time. Therefore, if the reading of one ResultSet
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	30 * object is interleaved with the reading of another, each must have
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	31 * been generated by different {@link Statement} objects. All execution methods
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	32 * in the Statement interface implicitly close a Statement's current
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	33 * ResultSet object if an open one exists.
29 c26213e86442 Use newSQLFeatureNotSupportedException() for setArray() Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 14 diff changeset	34 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	35 * The current state of this Statement is that it only implements the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	36 * executeQuery() which returns a ResultSet where from results can be
259 1485870ae208 Improve comment text and resolve 4 javadoc errors: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 250 diff changeset	37 * read and executeUpdate() which returns the affected rows for DML.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	38 * Commit and rollback are implemented, as is the autoCommit mechanism
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 183 diff changeset	39 * which relies on server side auto commit.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	40 * Multi-result queries are supported using the getMoreResults() method.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	41 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	42 * @author Fabian Groffen
29 c26213e86442 Use newSQLFeatureNotSupportedException() for setArray() Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 14 diff changeset	43 * @author Martin van Dinther
376 ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	44 * @version 0.9
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	45 */
164 7c9e386fe49a As of Java 1.7 implementations of JDBC interfaces Connection, Statement, PreparedStatement, Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 90 diff changeset	46 public class MonetStatement
7c9e386fe49a As of Java 1.7 implementations of JDBC interfaces Connection, Statement, PreparedStatement, Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 90 diff changeset	47 extends MonetWrapper
7c9e386fe49a As of Java 1.7 implementations of JDBC interfaces Connection, Statement, PreparedStatement, Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 90 diff changeset	48 implements Statement, AutoCloseable
7c9e386fe49a As of Java 1.7 implementations of JDBC interfaces Connection, Statement, PreparedStatement, Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 90 diff changeset	49 {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	50 /** The parental Connection object */
286 d430f8adbf1b Add keyword "final" to those variables which do not change after first assigment. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	51 protected final MonetConnection connection;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	52 /** The last ResponseList object this Statement produced */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	53 private MonetConnection.ResponseList lastResponseList;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	54 /** The last Response that this object uses */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	55 MonetConnection.Response header;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	56 /** The warnings this Statement object generated */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	57 private SQLWarning warnings;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	58 /** Whether this Statement object is closed or not */
292 b127164342c4 Introduce default general behavior settings DEF_... for MonetResultSets and use them Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 291 diff changeset	59 protected boolean closed = false;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	60 /** Whether the application wants this Statement object to be pooled */
292 b127164342c4 Introduce default general behavior settings DEF_... for MonetResultSets and use them Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 291 diff changeset	61 protected boolean poolable = false;
249 46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	62 /** Whether this Statement should be closed if the last ResultSet closes */
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	63 private boolean closeOnCompletion = false;
249 46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	64 /** The timeout (in sec) for the query to return, 0 means no timeout */
46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	65 private int queryTimeout = 0;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	66 /** The size of the blocks of results to ask for at the server */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	67 private int fetchSize = 0;
376 ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	68 /** The maximum number of rows to return in a ResultSet, 0 indicates unlimited */
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	69 private long maxRows = 0;
292 b127164342c4 Introduce default general behavior settings DEF_... for MonetResultSets and use them Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 291 diff changeset	70 /** The type of ResultSet to produce; i.e. forward only, random access */
b127164342c4 Introduce default general behavior settings DEF_... for MonetResultSets and use them Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 291 diff changeset	71 private int resultSetType = MonetResultSet.DEF_RESULTSETTYPE;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	72 /** The suggested direction of fetching data (implemented but not used) */
292 b127164342c4 Introduce default general behavior settings DEF_... for MonetResultSets and use them Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 291 diff changeset	73 private int fetchDirection = MonetResultSet.DEF_FETCHDIRECTION;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	74 /** The concurrency of the ResultSet to produce */
292 b127164342c4 Introduce default general behavior settings DEF_... for MonetResultSets and use them Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 291 diff changeset	75 private int resultSetConcurrency = MonetResultSet.DEF_CONCURRENCY;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	76
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	77 /** A List to hold all queries of a batch */
290 d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	78 private ArrayList<String> batch = null;
d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	79 private ReentrantLock batchLock = null;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	80
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	81
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	82 /**
292 b127164342c4 Introduce default general behavior settings DEF_... for MonetResultSets and use them Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 291 diff changeset	83 * MonetStatement constructor which checks the arguments for validity.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	84 * This constructor is only accessible to classes from the jdbc package.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	85 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	86 * @param connection the connection that created this Statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	87 * @param resultSetType type of ResultSet to produce
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	88 * @param resultSetConcurrency concurrency of ResultSet to produce
292 b127164342c4 Introduce default general behavior settings DEF_... for MonetResultSets and use them Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 291 diff changeset	89 * @param resultSetHoldability holdability of ResultSet after commit
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	90 * @throws SQLException if an error occurs during login
292 b127164342c4 Introduce default general behavior settings DEF_... for MonetResultSets and use them Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 291 diff changeset	91 * @throws IllegalArgumentException is one of the arguments null or empty
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	92 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	93 MonetStatement(
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	94 final MonetConnection connection,
003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	95 final int resultSetType,
003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	96 final int resultSetConcurrency,
003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	97 final int resultSetHoldability)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	98 throws SQLException, IllegalArgumentException
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	99 {
164 7c9e386fe49a As of Java 1.7 implementations of JDBC interfaces Connection, Statement, PreparedStatement, Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 90 diff changeset	100 if (connection == null)
7c9e386fe49a As of Java 1.7 implementations of JDBC interfaces Connection, Statement, PreparedStatement, Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 90 diff changeset	101 throw new IllegalArgumentException("No Connection given!");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	102
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	103 this.connection = connection;
292 b127164342c4 Introduce default general behavior settings DEF_... for MonetResultSets and use them Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 291 diff changeset	104 this.queryTimeout = connection.lastSetQueryTimeout;
b127164342c4 Introduce default general behavior settings DEF_... for MonetResultSets and use them Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 291 diff changeset	105
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	106 this.resultSetType = resultSetType;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	107 this.resultSetConcurrency = resultSetConcurrency;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	108
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	109 // check our limits, and generate warnings as appropriate
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	110 if (this.resultSetConcurrency != ResultSet.CONCUR_READ_ONLY) {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	111 addWarning("No concurrency mode other then read only is supported, continuing with concurrency level READ_ONLY", "01M13");
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	112 this.resultSetConcurrency = ResultSet.CONCUR_READ_ONLY;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	113 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	114
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	115 // check type for supported mode
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	116 if (this.resultSetType == ResultSet.TYPE_SCROLL_SENSITIVE) {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	117 addWarning("Change sensitive scrolling ResultSet objects are not supported, continuing with a change non-sensitive scrollable cursor.", "01M14");
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	118 this.resultSetType = ResultSet.TYPE_SCROLL_INSENSITIVE;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	119 }
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 // check type for supported holdability
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	122 if (resultSetHoldability != ResultSet.HOLD_CURSORS_OVER_COMMIT) {
292 b127164342c4 Introduce default general behavior settings DEF_... for MonetResultSets and use them Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 291 diff changeset	123 addWarning("Close cursors at commit not supported, continuing with holdability to hold cursors open over commit.", "01M15");
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	124 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	125 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	126
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	127 //== methods of interface Statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	128
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	129 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	130 * Adds the given SQL command to the current list of commmands for this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	131 * Statement object. The commands in this list can be executed as a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	132 * batch by calling the method executeBatch.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	133 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	134 * @param sql typically this is a static SQL INSERT or UPDATE statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	135 * @throws SQLException so the PreparedStatement can throw this exception
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 @Override
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	138 public void addBatch(final String sql) throws SQLException {
290 d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	139 if (batch == null) {
d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	140 // create the ArrayList at first time use
d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	141 batch = new ArrayList<String>();
d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	142 }
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	143 batch.add(sql);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	144 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	145
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	146 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	147 * Empties this Statement object's current list of SQL commands.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	148 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	149 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	150 public void clearBatch() {
290 d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	151 if (batch != null)
d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	152 batch.clear();
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	153 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	154
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	155 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	156 * Submits a batch of commands to the database for execution and if
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	157 * all commands execute successfully, returns an array of update
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	158 * counts. The int elements of the array that is returned are
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	159 * ordered to correspond to the commands in the batch, which are
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	160 * ordered according to the order in which they were added to the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	161 * batch. The elements in the array returned by the method
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	162 * executeBatch may be one of the following:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	163 * <ol>
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	164 * <li>A number greater than or equal to zero -- indicates that the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	165 * command was processed successfully and is an update count giving
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	166 * the number of rows in the database that were affected by the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	167 * command's execution</li>
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	168 * <li>A value of SUCCESS_NO_INFO -- indicates that the command was
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	169 * processed successfully but that the number of rows affected is
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	170 * unknown</li>
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	171 * </ol>
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	172 * If one of the commands in a batch update fails to execute
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	173 * properly, this method throws a BatchUpdateException, and a JDBC
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	174 * driver may or may not continue to process the remaining commands
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	175 * in the batch. However, the driver's behavior must be consistent
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	176 * with a particular DBMS, either always continuing to process
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	177 * commands or never continuing to process commands.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	178 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	179 * MonetDB does continues after an error has occurred in the batch.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	180 * If one of the commands attempts to return a result set, an
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	181 * SQLException is added to the SQLException list and thrown
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	182 * afterwards execution. Failing queries result in SQLExceptions
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 183 diff changeset	183 * too and may cause subparts of the batch to fail as well.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	184 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	185 * @return an array of update counts containing one element for each
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	186 * command in the batch. The elements of the array are ordered
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	187 * according to the order in which commands were added to the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	188 * batch.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	189 * @throws SQLException if a database access error occurs. Throws
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	190 * BatchUpdateException (a subclass of SQLException) if one of the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	191 * commands sent to the database fails to execute properly
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	192 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	193 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	194 public int[] executeBatch() throws SQLException {
290 d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	195 if (batch == null \|\| batch.isEmpty()) {
d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	196 return new int[0];
d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	197 }
d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	198
d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	199 // this method is synchronized/locked to make sure no one gets in between the
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	200 // operations we execute below
290 d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	201 if (batchLock == null) {
d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	202 // create a ReentrantLock at first time use
d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	203 batchLock = new ReentrantLock();
d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	204 }
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	205 batchLock.lock();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	206 try {
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	207 final int[] counts = new int[batch.size()];
003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	208 final String sep = connection.queryTempl[2];
003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	209 final int sepLen = sep.length();
003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	210 final BatchUpdateException e = new BatchUpdateException("Error(s) occurred while executing the batch, see next SQLExceptions for details", "22000", counts);
003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	211 final StringBuilder tmpBatch = new StringBuilder(MapiSocket.BLOCK);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	212 int offset = 0;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	213 boolean first = true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	214 boolean error = false;
290 d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	215
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	216 for (int i = 0; i < batch.size(); i++) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	217 String tmp = batch.get(i);
290 d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	218 if (sepLen + tmp.length() > MapiSocket.BLOCK) {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	219 // The thing is too big. Way too big. Since it won't
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	220 // be optimal anyway, just add it to whatever we have
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	221 // and continue.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	222 if (!first)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	223 tmpBatch.append(sep);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	224 tmpBatch.append(tmp);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	225 // send and receive
290 d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	226 error \|= internalBatch(tmpBatch, counts, offset, i + 1, e);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	227 offset = i;
316 d479475888e3 Replace StringBuilder methods sb.delete(0, sb.length()) with faster sb.setLength(0). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 295 diff changeset	228 tmpBatch.setLength(0); // clear the buffer
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	229 first = true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	230 continue;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	231 }
290 d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	232 if (tmpBatch.length() + sepLen + tmp.length() >= MapiSocket.BLOCK) {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	233 // send and receive
290 d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	234 error \|= internalBatch(tmpBatch, counts, offset, i + 1, e);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	235 offset = i;
316 d479475888e3 Replace StringBuilder methods sb.delete(0, sb.length()) with faster sb.setLength(0). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 295 diff changeset	236 tmpBatch.setLength(0); // clear the buffer
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	237 first = true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	238 }
290 d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	239 if (first)
d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	240 first = false;
d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	241 else
d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	242 tmpBatch.append(sep);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	243 tmpBatch.append(tmp);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	244 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	245 // send and receive
290 d477b3103a8b Optimised MonetStatement memory resource usage by only creating an ArrayList and ReentrantLock object when the batch methods addBatch() or executeBatch() are called. In most Statement usages those methods are not called. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 286 diff changeset	246 error \|= internalBatch(tmpBatch, counts, offset, counts.length, e);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	247
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	248 // throw BatchUpdateException if it contains something
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	249 if (error)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	250 throw e;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	251 // otherwise just return the counts
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	252 return counts;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	253 } finally {
361 253363a2ae28 Fix for bug 6953. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 350 diff changeset	254 batch.clear();
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	255 batchLock.unlock();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	256 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	257 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	258
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	259 private boolean internalBatch(
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	260 final StringBuilder batch,
003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	261 final int[] counts,
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	262 int offset,
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	263 final int max,
003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	264 final BatchUpdateException e)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	265 throws BatchUpdateException
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 try {
316 d479475888e3 Replace StringBuilder methods sb.delete(0, sb.length()) with faster sb.setLength(0). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 295 diff changeset	268 boolean hasResultSet = internalExecute(batch.toString());
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	269 int count = -1;
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	270
316 d479475888e3 Replace StringBuilder methods sb.delete(0, sb.length()) with faster sb.setLength(0). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 295 diff changeset	271 if (!hasResultSet)
250 3038e60bdca1 If methods never throw an SQLException, remove the "throws SQLException" part. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 249 diff changeset	272 count = getUpdateCount();
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	273
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	274 do {
164 7c9e386fe49a As of Java 1.7 implementations of JDBC interfaces Connection, Statement, PreparedStatement, Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 90 diff changeset	275 if (offset >= max)
7c9e386fe49a As of Java 1.7 implementations of JDBC interfaces Connection, Statement, PreparedStatement, Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 90 diff changeset	276 throw new SQLException("Overflow: don't use multi statements when batching (" + max + ")", "M1M16");
316 d479475888e3 Replace StringBuilder methods sb.delete(0, sb.length()) with faster sb.setLength(0). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 295 diff changeset	277 if (hasResultSet) {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	278 e.setNextException(
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	279 new SQLException("Batch query produced a ResultSet! " +
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	280 "Ignoring and setting update count to " +
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	281 "value " + EXECUTE_FAILED, "M1M17"));
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	282 counts[offset] = EXECUTE_FAILED;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	283 } else if (count >= 0) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	284 counts[offset] = count;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	285 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	286 offset++;
316 d479475888e3 Replace StringBuilder methods sb.delete(0, sb.length()) with faster sb.setLength(0). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 295 diff changeset	287 } while ((hasResultSet = getMoreResults()) \|\| (count = getUpdateCount()) != -1);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	288 } catch (SQLException ex) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	289 e.setNextException(ex);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	290 for (; offset < max; offset++) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	291 counts[offset] = EXECUTE_FAILED;
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 return true;
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 return false;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	296 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	297
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	298 /**
181 237816fef586 Correct the documentation of the cancel() method. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 179 diff changeset	299 * Cancels this Statement object if both the DBMS and driver support aborting an SQL statement.
237816fef586 Correct the documentation of the cancel() method. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 179 diff changeset	300 * This method can be used by one thread to cancel a statement that is being executed by another thread.
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	301 *
181 237816fef586 Correct the documentation of the cancel() method. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 179 diff changeset	302 * @throws SQLException - if a database access error occurs or this method is called on a closed Statement
179 f0a704e33fe4 Improvement: throw SQLFeatureNotSupportedException instead of SQLException Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	303 * @throws SQLFeatureNotSupportedException - if the JDBC driver does not support this method
0 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 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	306 public void cancel() throws SQLException {
179 f0a704e33fe4 Improvement: throw SQLFeatureNotSupportedException instead of SQLException Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 164 diff changeset	307 throw new SQLFeatureNotSupportedException("Query cancelling is currently not supported by the driver.", "0A000");
291 611c0954b0e6 Add a reference to the request logged in bugzilla to implement Statement.cancel() method Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 290 diff changeset	308 // a request to implement this is already logged, see: https://www.monetdb.org/bugzilla/show_bug.cgi?id=6222
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	309 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	310
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	311 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	312 * Clears all warnings reported for this Statement object. After a call to
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	313 * this method, the method getWarnings returns null until a new warning is
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	314 * reported for this Statement object.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	315 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	316 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	317 public void clearWarnings() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	318 warnings = null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	319 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	320
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	321 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	322 * Releases this Statement object's database and JDBC resources immediately
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	323 * instead of waiting for this to happen when it is automatically closed. It
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	324 * is generally good practice to release resources as soon as you are
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	325 * finished with them to avoid tying up database resources.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	326 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	327 * Calling the method close on a Statement object that is already closed has
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	328 * no effect.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	329 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	330 * A Statement object is automatically closed when it is garbage collected.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	331 * When a Statement object is closed, its current ResultSet object, if one
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	332 * exists, is also closed.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	333 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	334 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	335 public void close() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	336 // close previous ResultSet, if not closed already
183 57f09396b22c Small improvements Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 181 diff changeset	337 if (lastResponseList != null) {
29 c26213e86442 Use newSQLFeatureNotSupportedException() for setArray() Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 14 diff changeset	338 lastResponseList.close();
183 57f09396b22c Small improvements Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 181 diff changeset	339 lastResponseList = null;
57f09396b22c Small improvements Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 181 diff changeset	340 }
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	341 closed = true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	342 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	343
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	344 // Chapter 13.1.2.3 of Sun's JDBC 3.0 Specification
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	345 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	346 * Executes the given SQL statement, which may return multiple results. In
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	347 * some (uncommon) situations, a single SQL statement may return multiple
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	348 * result sets and/or update counts. Normally you can ignore this unless
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	349 * you are (1) executing a stored procedure that you know may return
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	350 * multiple results or (2) you are dynamically executing an unknown SQL
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	351 * string.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	352 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	353 * The execute method executes an SQL statement and indicates the form of
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	354 * the first result. You must then use the methods getResultSet or
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	355 * getUpdateCount to retrieve the result, and getMoreResults to move to any
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	356 * subsequent result(s).
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	357 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	358 * @param sql any SQL statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	359 * @return true if the first result is a ResultSet object; false if it is an
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	360 * update count or there are no results
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	361 * @throws SQLException if a database access error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	362 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	363 @Override
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	364 public boolean execute(final String sql) throws SQLException {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	365 return internalExecute(sql);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	366 }
29 c26213e86442 Use newSQLFeatureNotSupportedException() for setArray() Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 14 diff changeset	367
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	368 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	369 * Executes the given SQL statement, which may return multiple
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	370 * results, and signals the driver that any auto-generated keys
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	371 * should be made available for retrieval. The driver will ignore
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	372 * this signal if the SQL statement is not an INSERT statement.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	373 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	374 * In some (uncommon) situations, a single SQL statement may return
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	375 * multiple result sets and/or update counts. Normally you can
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	376 * ignore this unless you are (1) executing a stored procedure that
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	377 * you know may return multiple results or (2) you are dynamically
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	378 * executing an unknown SQL string.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	379 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	380 * The execute method executes an SQL statement and indicates the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	381 * form of the first result. You must then use the methods
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	382 * getResultSet or getUpdateCount to retrieve the result, and
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	383 * getMoreResults to move to any subsequent result(s).
0 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 * @param sql any SQL statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	386 * @param autoGeneratedKeys a constant indicating whether
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	387 * auto-generated keys should be made available for retrieval
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	388 * using the method getGeneratedKeys; one of the following
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	389 * constants: Statement.RETURN_GENERATED_KEYS or
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	390 * Statement.NO_GENERATED_KEYS
259 1485870ae208 Improve comment text and resolve 4 javadoc errors: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 250 diff changeset	391 * @return true if the first result is a ResultSet object; false if
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	392 * it is an update count or there are no results
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	393 * @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	394 * second parameter supplied to this method is not
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	395 * Statement.RETURN_GENERATED_KEYS or
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	396 * Statement.NO_GENERATED_KEYS.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	397 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	398 @Override
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	399 public boolean execute(final String sql, final int autoGeneratedKeys)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	400 throws SQLException
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 if (autoGeneratedKeys != Statement.RETURN_GENERATED_KEYS &&
29 c26213e86442 Use newSQLFeatureNotSupportedException() for setArray() Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 14 diff changeset	403 autoGeneratedKeys != Statement.NO_GENERATED_KEYS)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	404 throw new SQLException("Invalid argument, expected RETURN_GENERATED_KEYS or NO_GENERATED_KEYS", "M1M05");
29 c26213e86442 Use newSQLFeatureNotSupportedException() for setArray() Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 14 diff changeset	405
c26213e86442 Use newSQLFeatureNotSupportedException() for setArray() Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 14 diff changeset	406 /* MonetDB has no way to disable this, so just do the normal thing ;) */
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	407 return internalExecute(sql);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	408 }
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 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	411 * Executes the given SQL statement, which may return multiple
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	412 * results, and signals the driver that the auto-generated keys
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	413 * indicated in the given array should be made available for
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	414 * retrieval. This array contains the indexes of the columns in the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	415 * target table that contain the auto-generated keys that should be
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	416 * made available. The driver will ignore the array if the given SQL
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	417 * statement is not an INSERT statement.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	418 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	419 * Under some (uncommon) situations, a single SQL statement may
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	420 * return multiple result sets and/or update counts. Normally you
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	421 * can ignore this unless you are (1) executing a stored procedure
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	422 * that you know may return multiple results or (2) you are
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	423 * dynamically executing an unknown SQL string.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	424 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	425 * The execute method executes an SQL statement and indicates the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	426 * form of the first result. You must then use the methods
259 1485870ae208 Improve comment text and resolve 4 javadoc errors: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 250 diff changeset	427 * getResultSet or getUpdateCount to retrieve the result, and
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	428 * getMoreResults to move to any subsequent result(s).
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	429 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	430 * MonetDB only supports returing the generated key for one column,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	431 * which will be the first column that has a serial. Hence, this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	432 * method cannot work as required and the driver will fall back to
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	433 * executing with request to the database to return the generated
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	434 * key, if any.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	435 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	436 * @param sql any SQL statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	437 * @param columnIndexes an array of the indexes of the columns in
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	438 * the inserted row that should be made available for
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	439 * retrieval by a call to the method getGeneratedKeys
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	440 * @return true if the first result is a ResultSet object; false if
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	441 * it is an update count or there are no results
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	442 * @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	443 * elements in the int array passed to this method are not
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	444 * valid column indexes
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
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	447 public boolean execute(final String sql, final int[] columnIndexes)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	448 throws SQLException
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 addWarning("execute: generated keys for fixed set of columns not supported", "01M18");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	451 return execute(sql, Statement.RETURN_GENERATED_KEYS);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	452 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	453
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	454 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	455 * Executes the given SQL statement, which may return multiple
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	456 * results, and signals the driver that the auto-generated keys
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	457 * indicated in the given array should be made available for
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	458 * retrieval. This array contains the names of the columns in the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	459 * target table that contain the auto-generated keys that should be
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	460 * made available. The driver will ignore the array if the given SQL
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	461 * statement is not an INSERT statement.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	462 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	463 * In some (uncommon) situations, a single SQL statement may return
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	464 * multiple result sets and/or update counts. Normally you can
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	465 * ignore this unless you are (1) executing a stored procedure that
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	466 * you know may return multiple results or (2) you are dynamically
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	467 * executing an unknown SQL string.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	468 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	469 * The execute method executes an SQL statement and indicates the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	470 * form of the first result. You must then use the methods
259 1485870ae208 Improve comment text and resolve 4 javadoc errors: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 250 diff changeset	471 * getResultSet or getUpdateCount to retrieve the result, and
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	472 * getMoreResults to move to any subsequent result(s).
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	473 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	474 * MonetDB only supports returing the generated key for one column,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	475 * which will be the first column that has a serial. Hence, this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	476 * method cannot work as required and the driver will fall back to
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	477 * executing with request to the database to return the generated
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	478 * key, if any.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	479 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	480 * @param sql any SQL statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	481 * @param columnNames an array of the names of the columns in the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	482 * inserted row that should be made available for retrieval
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	483 * by a call to the method getGeneratedKeys
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	484 * @return true if the next result is a ResultSet object; false if
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	485 * it is an update count or there are no more results
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	486 * @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	487 * elements of the String array passed to this method are
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	488 * not valid column names
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	489 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	490 @Override
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	491 public boolean execute(final String sql, final String[] columnNames)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	492 throws SQLException
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 addWarning("execute: generated keys for fixed set of columns not supported", "01M18");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	495 return execute(sql, Statement.RETURN_GENERATED_KEYS);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	496 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	497
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	498 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	499 * Performs the steps to execute a given SQL statement. This method
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	500 * exists to allow the functionality of this function to be called
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	501 * from within this class only. The PreparedStatement for example
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	502 * overrides the execute() method to throw an SQLException, but it
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	503 * needs its functionality when the executeBatch method (which is
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	504 * inherited) is called.
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 * @param sql any SQL statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	507 * @return true if the first result is a ResultSet object; false if
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	508 * it is an update count or there are no results
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	509 * @throws SQLException if a database access error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	510 */
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	511 private boolean internalExecute(final String sql) throws SQLException {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	512 // close previous query, if not closed already
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	513 if (lastResponseList != null) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	514 lastResponseList.close();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	515 lastResponseList = null;
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
249 46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	518 if (queryTimeout != connection.lastSetQueryTimeout) {
46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	519 // set requested/changed queryTimeout on the server side first
46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	520 Statement st = null;
46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	521 try {
46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	522 st = connection.createStatement();
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	523 final String callstmt = "CALL \"sys\".\"settimeout\"(" + queryTimeout + ")";
249 46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	524 // for debug: System.out.println("Before: " + callstmt);
46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	525 st.execute(callstmt);
46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	526 // for debug: System.out.println("After : " + callstmt);
46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	527 connection.lastSetQueryTimeout = queryTimeout;
46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	528 }
46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	529 /* do not catch SQLException here, as we want to know it when it fails */
46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	530 finally {
46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	531 if (st != null) {
286 d430f8adbf1b Add keyword "final" to those variables which do not change after first assigment. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	532 try {
d430f8adbf1b Add keyword "final" to those variables which do not change after first assigment. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	533 st.close();
d430f8adbf1b Add keyword "final" to those variables which do not change after first assigment. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 261 diff changeset	534 } catch (SQLException e) { /* ignore */ }
249 46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	535 }
46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	536 }
46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	537 }
46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	538
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	539 // create a container for the result
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	540 lastResponseList = connection.new ResponseList(
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	541 fetchSize,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	542 maxRows,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	543 resultSetType,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	544 resultSetConcurrency
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 // fill the header list by processing the query
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	547 lastResponseList.processQuery(sql);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	548
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	549 return getMoreResults();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	550 }
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 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	553 * Executes the given SQL statement, which returns a single ResultSet
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	554 * object.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	555 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	556 * @param sql an SQL statement to be sent to the database, typically a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	557 * static SQL SELECT statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	558 * @return a ResultSet object that contains the data produced by the given
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	559 * query; never null
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	560 * @throws SQLException if a database access error occurs or the given SQL
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	561 * statement produces anything other than a single ResultSet object
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 @Override
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	564 public ResultSet executeQuery(final String sql) throws SQLException {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	565 if (execute(sql) != true)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	566 throw new SQLException("Query did not produce a result set", "M1M19");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	567
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	568 return getResultSet();
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
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	571 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	572 * Executes the given SQL statement, which may be an INSERT, UPDATE, or
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	573 * DELETE statement or an SQL statement that returns nothing, such as an
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	574 * SQL DDL statement.
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 * @param sql an SQL INSERT, UPDATE or DELETE statement or an SQL statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	577 * that returns nothing
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	578 * @return either the row count for INSERT, UPDATE or DELETE statements, or
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 183 diff changeset	579 * 0 for SQL statements that return nothing
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	580 * @throws SQLException if a database access error occurs or the given SQL
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	581 * statement produces a ResultSet 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
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	584 public int executeUpdate(final String sql) throws SQLException {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	585 if (execute(sql) != false)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	586 throw new SQLException("Query produced a result set", "M1M17");
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 return getUpdateCount();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	589 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	590
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	591 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	592 * Executes the given SQL statement and signals the driver with the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	593 * given flag about whether the auto-generated keys produced by this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	594 * Statement object should be made available for retrieval.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	595 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	596 * @param sql must be an SQL INSERT, UPDATE or DELETE statement or
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	597 * an SQL statement that returns nothing
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	598 * @param autoGeneratedKeys - a flag indicating whether
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	599 * auto-generated keys should be made available for
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	600 * retrieval; one of the following constants:
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	601 * Statement.RETURN_GENERATED_KEYS
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	602 * Statement.NO_GENERATED_KEYS
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	603 * @return either the row count for INSERT, UPDATE or DELETE
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	604 * statements, or 0 for SQL statements that return nothing
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	605 * @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	606 * given SQL statement returns a ResultSet object, or the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	607 * given constant is not one of those allowed
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 @Override
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	610 public int executeUpdate(final String sql, final int autoGeneratedKeys)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	611 throws SQLException
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 if (autoGeneratedKeys != Statement.RETURN_GENERATED_KEYS &&
29 c26213e86442 Use newSQLFeatureNotSupportedException() for setArray() Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 14 diff changeset	614 autoGeneratedKeys != Statement.NO_GENERATED_KEYS)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	615 throw new SQLException("Invalid argument, expected RETURN_GENERATED_KEYS or NO_GENERATED_KEYS", "M1M05");
29 c26213e86442 Use newSQLFeatureNotSupportedException() for setArray() Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 14 diff changeset	616
c26213e86442 Use newSQLFeatureNotSupportedException() for setArray() Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 14 diff changeset	617 /* MonetDB has no way to disable this, so just do the normal thing ;) */
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	618 if (execute(sql) != false)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	619 throw new SQLException("Query produced a result set", "M1M17");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	620
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	621 return getUpdateCount();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	622 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	623
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	624 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	625 * Executes the given SQL statement and signals the driver that the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	626 * auto-generated keys indicated in the given array should be made
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	627 * available for retrieval. The driver will ignore the array if the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	628 * SQL statement is not an INSERT statement.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	629 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	630 * MonetDB only supports returing the generated key for one column,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	631 * which will be the first column that has a serial. Hence, this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	632 * method cannot work as required and the driver will fall back to
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	633 * executing with request to the database to return the generated
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	634 * key, if any.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	635 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	636 * @param sql an SQL INSERT, UPDATE or DELETE statement or an SQL
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	637 * statement that returns nothing, such as an SQL DDL statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	638 * @param columnIndexes an array of column indexes indicating the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	639 * columns that should be returned from the inserted row
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	640 * @return either the row count for INSERT, UPDATE, or DELETE
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	641 * statements, or 0 for SQL statements that return nothing
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	642 * @throws SQLException if a database access error occurs, the SQL
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	643 * statement returns a ResultSet object, or the second
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	644 * argument supplied to this method is not an int array
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	645 * whose elements are valid column indexes
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	646 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	647 @Override
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	648 public int executeUpdate(final String sql, final int[] columnIndexes)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	649 throws SQLException
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	650 {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	651 addWarning("executeUpdate: generated keys for fixed set of columns not supported", "01M18");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	652 return executeUpdate(sql, Statement.RETURN_GENERATED_KEYS);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	653 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	654
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	655 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	656 * Executes the given SQL statement and signals the driver that the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	657 * auto-generated keys indicated in the given array should be made
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	658 * available for retrieval. The driver will ignore the array if the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	659 * SQL statement is not an INSERT statement.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	660 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	661 * MonetDB only supports returing the generated key for one column,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	662 * which will be the first column that has a serial. Hence, this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	663 * method cannot work as required and the driver will fall back to
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	664 * executing with request to the database to return the generated
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	665 * key, if any.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	666 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	667 * @param sql an SQL INSERT, UPDATE or DELETE statement or an SQL
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	668 * statement that returns nothing, such as an SQL DDL statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	669 * @param columnNames an array of the names of the columns that
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	670 * should be returned from the inserted row
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	671 * @return either the row count for INSERT, UPDATE, or DELETE
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	672 * statements, or 0 for SQL statements that return nothing
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	673 * @throws SQLException if a database access error occurs, the SQL
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	674 * statement returns a ResultSet object, or the second
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	675 * argument supplied to this method is not a String array
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	676 * whose elements are valid column names
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	677 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	678 @Override
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	679 public int executeUpdate(final String sql, final String[] columnNames)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	680 throws SQLException
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	681 {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	682 addWarning("executeUpdate: generated keys for fixed set of columns not supported", "01M18");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	683 return executeUpdate(sql, Statement.RETURN_GENERATED_KEYS);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	684 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	685
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	686 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	687 * Retrieves the Connection object that produced this Statement object.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	688 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	689 * @return the connection that produced this statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	690 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	691 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	692 public Connection getConnection() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	693 return connection;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	694 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	695
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	696 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	697 * Retrieves the direction for fetching rows from database tables that is
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	698 * the default for result sets generated from this Statement object. If
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	699 * this Statement object has not set a fetch direction by calling the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	700 * method setFetchDirection, the return value is ResultSet.FETCH_FORWARD.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	701 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	702 * @return the default fetch direction for result sets generated from this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	703 * Statement object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	704 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	705 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	706 public int getFetchDirection() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	707 return fetchDirection;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	708 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	709
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	710 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	711 * Retrieves the number of result set rows that is the default fetch size
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	712 * for ResultSet objects generated from this Statement object. If this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	713 * Statement object has not set a fetch size by calling the method
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	714 * setFetchSize, or the method setFetchSize was called as such to let
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	715 * the driver ignore the hint, 0 is returned.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	716 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	717 * @return the default fetch size for result sets generated from this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	718 * Statement object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	719 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	720 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	721 public int getFetchSize() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	722 return fetchSize;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	723 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	724
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	725 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	726 * Retrieves any auto-generated keys created as a result of
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	727 * executing this Statement object. If this Statement object did not
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	728 * generate any keys, an empty ResultSet object is returned.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	729 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	730 * @return a ResultSet object containing the auto-generated key(s)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	731 * generated by the execution of this Statement object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	732 * @throws SQLException - if a database access error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	733 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	734 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	735 public ResultSet getGeneratedKeys() throws SQLException {
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	736 final String[] columns, types;
003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	737 final String[][] results;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	738
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	739 columns = new String[1];
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	740 types = new String[1];
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	741
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	742 columns[0] = "GENERATED_KEY";
29 c26213e86442 Use newSQLFeatureNotSupportedException() for setArray() Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 14 diff changeset	743 /* the generated key should be an integer, because (wait for it) other
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	744 * frameworks such as spring expect this. */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	745 types[0] = "BIGINT";
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	746
260 d3d466182d65 Prevent NullPointerExceptions to be thrown when header == null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 259 diff changeset	747 if (header != null && header instanceof MonetConnection.UpdateResponse) {
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	748 final String lastid = ((MonetConnection.UpdateResponse)header).lastid;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	749 if (lastid.equals("-1")) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	750 results = new String[0][1];
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	751 } else {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	752 results = new String[1][1];
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	753 results[0][0] = lastid;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	754 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	755 } else {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	756 results = new String[0][1];
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	757 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	758
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	759 try {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	760 return new MonetVirtualResultSet(this, columns, types, results);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	761 } catch (IllegalArgumentException e) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	762 throw new SQLException("Internal driver error: " + e.getMessage(), "M0M03");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	763 }
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
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	766 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	767 * Retrieves the maximum number of bytes that can be returned for
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	768 * character and binary column values in a ResultSet object produced
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	769 * by this Statement object. This limit applies only to BINARY,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	770 * VARBINARY, LONGVARBINARY, CHAR, VARCHAR, and LONGVARCHAR
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	771 * columns. If the limit is exceeded, the excess data is silently
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	772 * discarded.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	773 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	774 * The MonetDB JDBC driver currently doesn't support limiting
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	775 * fieldsizes, and hence always return 0 (unlimited).
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 * @return the current column size limit for columns storing
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	778 * character and binary values; zero means there is no limit
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 183 diff changeset	779 * @see #setMaxFieldSize(int max)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	780 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	781 @Override
250 3038e60bdca1 If methods never throw an SQLException, remove the "throws SQLException" part. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 249 diff changeset	782 public int getMaxFieldSize() {
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 183 diff changeset	783 return 210241024*1024 - 2; // MonetDB supports null terminated strings of max 2GB, see function: int UTF8_strlen()
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	784 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	785
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	786 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	787 * Retrieves the maximum number of rows that a ResultSet object produced by
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	788 * this Statement object can contain. If this limit is exceeded, the excess
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	789 * rows are silently dropped.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	790 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	791 * @return the current maximum number of rows for a ResultSet object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	792 * produced by this Statement object; zero means there is no limit
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 183 diff changeset	793 * @see #setMaxRows(int max)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	794 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	795 @Override
250 3038e60bdca1 If methods never throw an SQLException, remove the "throws SQLException" part. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 249 diff changeset	796 public int getMaxRows() {
376 ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	797 if (maxRows >= Integer.MAX_VALUE)
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	798 return Integer.MAX_VALUE;
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	799 return (int)maxRows;
0 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 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	803 * Moves to this Statement object's next result, returns true if it is a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	804 * ResultSet object, and implicitly closes any current ResultSet object(s)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	805 * obtained with the method getResultSet.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	806 *
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 183 diff changeset	807 * There are no more results when the following is true:
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	808 * (!getMoreResults() && (getUpdateCount() == -1)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	809 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	810 * @return true if the next result is a ResultSet object; false if it is
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	811 * an update count or there are no more results
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	812 * @throws SQLException if a database access error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	813 * @see #getMoreResults(int current)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	814 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	815 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	816 public boolean getMoreResults() throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	817 return getMoreResults(CLOSE_ALL_RESULTS);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	818 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	819
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	820 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	821 * Moves to this Statement object's next result, deals with any current
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	822 * ResultSet object(s) according to the instructions specified by the given
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	823 * flag, and returns true if the next result is a ResultSet object.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	824 *
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 183 diff changeset	825 * There are no more results when the following is true:
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	826 * (!getMoreResults() && (getUpdateCount() == -1)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	827 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	828 * @param current one of the following Statement constants indicating what
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	829 * should happen to current ResultSet objects obtained using
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	830 * the method getResultSet: CLOSE_CURRENT_RESULT,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	831 * KEEP_CURRENT_RESULT, or CLOSE_ALL_RESULTS
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	832 * @return true if the next result is a ResultSet object; false if it is
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	833 * an update count or there are no more results
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	834 * @throws SQLException if a database access error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	835 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	836 @Override
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	837 public boolean getMoreResults(final int current) throws SQLException {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	838 // protect against people calling this on an unitialised state
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	839 if (lastResponseList == null) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	840 header = null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	841 return false;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	842 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	843
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	844 if (current == CLOSE_CURRENT_RESULT) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	845 lastResponseList.closeCurrentResponse();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	846 } else if (current == CLOSE_ALL_RESULTS) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	847 lastResponseList.closeCurOldResponses();
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 // we default to keep current result, which requires no action
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	850 header = lastResponseList.getNextResponse();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	851
260 d3d466182d65 Prevent NullPointerExceptions to be thrown when header == null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 259 diff changeset	852 return (header != null && header instanceof MonetConnection.ResultSetResponse);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	853 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	854
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	855 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	856 * Retrieves the number of seconds the driver will wait for a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	857 * Statement object to execute. If the limit is exceeded, a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	858 * SQLException is thrown.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	859 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	860 * @return the current query timeout limit in seconds; zero means
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	861 * there is no limit
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	862 * @see #setQueryTimeout(int)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	863 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	864 @Override
249 46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	865 public int getQueryTimeout() {
46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	866 return queryTimeout;
0 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
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	869 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	870 * Retrieves the current result as a ResultSet object. This method
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	871 * should be called only once per result.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	872 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	873 * @return the current result as a ResultSet object or null if the result
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	874 * is an update count or there are no more results
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	875 * @throws SQLException if a database access error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	876 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	877 @Override
29 c26213e86442 Use newSQLFeatureNotSupportedException() for setArray() Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 14 diff changeset	878 public ResultSet getResultSet() throws SQLException {
260 d3d466182d65 Prevent NullPointerExceptions to be thrown when header == null. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 259 diff changeset	879 return (header != null && header instanceof MonetConnection.ResultSetResponse)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	880 ? new MonetResultSet(this,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	881 (MonetConnection.ResultSetResponse)header)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	882 : null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	883 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	884
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	885 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	886 * Retrieves the result set concurrency for ResultSet objects generated
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	887 * by this Statement object.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	888 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	889 * @return either ResultSet.CONCUR_READ_ONLY or ResultSet.CONCUR_UPDATABLE
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	890 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	891 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	892 public int getResultSetConcurrency() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	893 return resultSetConcurrency;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	894 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	895
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	896 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	897 * Retrieves the result set holdability for ResultSet objects
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	898 * generated by this Statement object.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	899 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	900 * @return either ResultSet.HOLD_CURSORS_OVER_COMMIT or
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	901 * ResultSet.CLOSE_CURSORS_AT_COMMIT
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	902 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	903 @Override
250 3038e60bdca1 If methods never throw an SQLException, remove the "throws SQLException" part. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 249 diff changeset	904 public int getResultSetHoldability() {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	905 return ResultSet.HOLD_CURSORS_OVER_COMMIT;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	906 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	907
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	908 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	909 * Retrieves the result set type for ResultSet objects generated by this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	910 * Statement object.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	911 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	912 * @return one of ResultSet.TYPE_FORWARD_ONLY,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	913 * ResultSet.TYPE_SCROLL_INSENSITIVE, or
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	914 * ResultSet.TYPE_SCROLL_SENSITIVE
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	915 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	916 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	917 public int getResultSetType() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	918 return resultSetType;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	919 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	920
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	921 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	922 * Retrieves the current result as an update count; if the result is a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	923 * ResultSet object or there are no more results, -1 is returned. This
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	924 * method should be called only once per result.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	925 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	926 * @return the current result as an update count; -1 if the current result
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	927 * is a ResultSet object or there are no more results
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	928 * @throws SQLException if a database access error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	929 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	930 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	931 public int getUpdateCount() throws SQLException {
378 02f353f62abe Adjust UpdateResponse to allow for large updates (long instead of int). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 377 diff changeset	932 long ret = getLargeUpdateCount();
02f353f62abe Adjust UpdateResponse to allow for large updates (long instead of int). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 377 diff changeset	933 if (ret >= Integer.MAX_VALUE)
02f353f62abe Adjust UpdateResponse to allow for large updates (long instead of int). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 377 diff changeset	934 return Integer.MAX_VALUE;
02f353f62abe Adjust UpdateResponse to allow for large updates (long instead of int). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 377 diff changeset	935 return (int)ret;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	936 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	937
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	938 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	939 * Retrieves the first warning reported by calls on this Statement object.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	940 * If there is more than one warning, subsequent warnings will be chained to
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	941 * the first one and can be retrieved by calling the method
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	942 * SQLWarning.getNextWarning on the warning that was retrieved previously.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	943 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	944 * This method may not be called on a closed statement; doing so will cause
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	945 * an SQLException to be thrown.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	946 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	947 * 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	948 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	949 * @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	950 * @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	951 * called on a closed connection
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	952 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	953 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	954 public SQLWarning getWarnings() throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	955 if (closed)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	956 throw new SQLException("Cannot call on closed Statement", "M1M20");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	957
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	958 // 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	959 // specification.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	960 return warnings;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	961 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	962
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 * Sets the SQL cursor name to the given String, which will be used
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	965 * by subsequent Statement object execute methods. This name can
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	966 * then be used in SQL positioned update or delete statements to
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	967 * identify the current row in the ResultSet object generated by
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	968 * this statement. If the database does not support positioned
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	969 * update/delete, this method is a noop. To insure that a cursor has
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	970 * the proper isolation level to support updates, the cursor's
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	971 * SELECT statement should have the form SELECT FOR UPDATE. If FOR
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	972 * UPDATE is not present, positioned updates may fail.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	973 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	974 * <b>Note:</b> By definition, the execution of positioned updates
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	975 * and deletes must be done by a different Statement object than the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	976 * one that generated the ResultSet object being used for
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	977 * positioning. Also, cursor names must be unique within a
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	978 * connection.
749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	979 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	980 * Since MonetDB does not support positioned update/delete, this
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	981 * method is a noop.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	982 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	983 * @param name the new cursor name, which must be unique within a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	984 * connection
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	985 * @throws SQLException if a database access error occurs
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 @Override
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	988 public void setCursorName(final String name) throws SQLException {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	989 addWarning("setCursorName: positioned updates/deletes not supported", "01M21");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	990 }
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 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	993 * Sets escape processing on or off. If escape scanning is on (the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	994 * default), the driver will do escape substitution before sending
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	995 * the SQL statement to the database. Note: Since prepared
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	996 * statements have usually been parsed prior to making this call,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	997 * disabling escape processing for PreparedStatements objects will
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	998 * have no effect.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	999 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1000 * The MonetDB JDBC driver implements no escape processing at all in
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1001 * its current implementation because it is too expensive, and in
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1002 * general should not be necessary given SQL standards compliance.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1003 * In this sense, this driver will ignore any call to this function.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1004 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1005 * @param enable true to enable escape processing; false to disable
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1006 * it
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1007 * @throws SQLException if a database access error occurs
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 @Override
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	1010 public void setEscapeProcessing(final boolean enable) throws SQLException {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1011 if (enable)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1012 addWarning("setEscapeProcessing: JDBC escape syntax is not supported by this driver", "01M22");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1013 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1014
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1015 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1016 * Gives the driver a hint as to the direction in which rows will be
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1017 * processed in ResultSet objects created using this Statement object.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1018 * The default value is ResultSet.FETCH_FORWARD.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	1019 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1020 * Note that this method sets the default fetch direction for result sets
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1021 * generated by this Statement object. Each result set has its own methods
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1022 * for getting and setting its own fetch direction.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1023 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1024 * @param direction the initial direction for processing rows
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1025 * @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	1026 * direction is not one of ResultSet.FETCH_FORWARD,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1027 * ResultSet.FETCH_REVERSE, or ResultSet.FETCH_UNKNOWN
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1028 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1029 @Override
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	1030 public void setFetchDirection(final int direction) throws SQLException {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1031 if (direction == ResultSet.FETCH_FORWARD \|\|
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1032 direction == ResultSet.FETCH_REVERSE \|\|
29 c26213e86442 Use newSQLFeatureNotSupportedException() for setArray() Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 14 diff changeset	1033 direction == ResultSet.FETCH_UNKNOWN)
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1034 {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1035 fetchDirection = direction;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1036 } else {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1037 throw new SQLException("Illegal direction: " + direction, "M1M05");
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 * Gives the JDBC driver a hint as to the number of rows that should be
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1043 * fetched from the database when more rows are needed. The number of rows
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1044 * specified affects only result sets created using this statement. If the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1045 * value specified is zero, then the hint is ignored.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1046 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1047 * @param rows the number of rows to fetch
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1048 * @throws SQLException if the condition 0 <= rows <= this.getMaxRows()
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1049 * is not satisfied.
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 @Override
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	1052 public void setFetchSize(final int rows) throws SQLException {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1053 if (rows >= 0 && !(getMaxRows() != 0 && rows > getMaxRows())) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1054 fetchSize = rows;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1055 } else {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1056 throw new SQLException("Illegal fetch size value: " + rows, "M1M05");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1057 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1058 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1059
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1060 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1061 * Sets the limit for the maximum number of bytes in a ResultSet
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1062 * column storing character or binary values to the given number of
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1063 * bytes. This limit applies only to BINARY, VARBINARY,
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1064 * LONGVARBINARY, CHAR, VARCHAR, and LONGVARCHAR fields. If the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1065 * limit is exceeded, the excess data is silently discarded. For
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1066 * maximum portability, use values greater than 256.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	1067 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1068 * MonetDB does not support any fieldsize limiting, and hence the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1069 * driver does not emulate it either, since it doesn't really lead
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1070 * to memory reduction.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1071 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1072 * @param max the new column size limit in bytes; zero means there
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1073 * is no limit
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1074 * @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	1075 * condition max >= 0 is not satisfied
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 183 diff changeset	1076 * @see #getMaxFieldSize()
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1077 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1078 @Override
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	1079 public void setMaxFieldSize(final int max) throws SQLException {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1080 if (max < 0)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1081 throw new SQLException("Illegal max value: " + max, "M1M05");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1082 if (max > 0)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1083 addWarning("setMaxFieldSize: field size limitation not supported", "01M23");
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 * Sets the limit for the maximum number of rows that any ResultSet object
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1088 * can contain to the given number. If the limit is exceeded, the excess
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1089 * rows are silently dropped.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1090 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1091 * @param max the new max rows limit; zero means there is no limit
194 1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 183 diff changeset	1092 * @throws SQLException if the condition max >= 0 is not satisfied
1296dbcc4958 Resolved javadoc many errors and warnings, such as: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 183 diff changeset	1093 * @see #getMaxRows()
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1094 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1095 @Override
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	1096 public void setMaxRows(final int max) throws SQLException {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1097 if (max < 0)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1098 throw new SQLException("Illegal max value: " + max, "M1M05");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1099 maxRows = max;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1100 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1101
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1102 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1103 * Sets the number of seconds the driver will wait for a Statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1104 * object to execute to the given number of seconds. If the limit is
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1105 * exceeded, an SQLException is thrown.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	1106 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1107 * @param seconds the new query timeout limit in seconds; zero means
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1108 * there is no limit
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1109 * @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	1110 * condition seconds >= 0 is not satisfied
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1111 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1112 @Override
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	1113 public void setQueryTimeout(final int seconds) throws SQLException {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1114 if (seconds < 0)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1115 throw new SQLException("Illegal timeout value: " + seconds, "M1M05");
249 46385d8ff8c9 Improve the implementation of Statement methods getQueryTimeout() and setQueryTimeout(). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 200 diff changeset	1116 queryTimeout = seconds;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1117 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1118
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1119 //== 1.6 methods (JDBC 4.0)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1120
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1121 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1122 * Retrieves whether this Statement object has been closed. A
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1123 * Statement 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	1124 * if it is automatically closed.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1125 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1126 * @return true if this Statement object is closed; false if it is
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1127 * still open
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 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1130 public boolean isClosed() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1131 return closed;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1132 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1133
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 * Requests that a Statement be pooled or not pooled. The value
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1136 * specified is a hint to the statement pool implementation
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1137 * indicating whether the applicaiton wants the statement to be
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1138 * pooled. It is up to the statement pool manager as to whether the
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	1139 * hint is used.
749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	1140 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1141 * The poolable value of a statement is applicable to both internal
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1142 * statement caches implemented by the driver and external statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1143 * caches implemented by application servers and other applications.
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	1144 *
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1145 * By default, a Statement is not poolable when created, and a
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1146 * PreparedStatement and CallableStatement are poolable when
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1147 * created.
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 * @param poolable requests that the statement be pooled if true
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1150 * and that the statement not be pooled if false
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1151 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1152 @Override
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	1153 public void setPoolable(final boolean poolable) {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1154 this.poolable = poolable;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1155 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1156
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 * Returns a value indicating whether the Statement is poolable or
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1159 * not.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1160 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1161 * @return true if the Statement is poolable; false otherwise
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 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1164 public boolean isPoolable() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1165 return poolable;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1166 }
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 //== 1.7 methods (JDBC 4.1)
29 c26213e86442 Use newSQLFeatureNotSupportedException() for setArray() Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 14 diff changeset	1169
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1170 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1171 * Specifies that this Statement will be closed when all its
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1172 * dependent result sets are closed. If execution of the Statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1173 * does not produce any result sets, this method has no effect.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1174 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1175 * @throws SQLException if this method is called on a closed Statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1176 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1177 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1178 public void closeOnCompletion() throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1179 if (closed)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1180 throw new SQLException("Cannot call on closed Statement", "M1M20");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1181 closeOnCompletion = true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1182 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1183
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1184 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1185 * Returns a value indicating whether this Statement will be closed
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1186 * when all its dependent result sets are closed.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1187 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1188 * @return true if the Statement will be closed when all of its
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1189 * dependent result sets are closed; false otherwise
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1190 * @throws SQLException if this method is called on a closed Statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1191 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1192 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1193 public boolean isCloseOnCompletion() throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1194 if (closed)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1195 throw new SQLException("Cannot call on closed Statement", "M1M20");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1196 return closeOnCompletion;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1197 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1198
376 ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1199 //== Java 1.8 methods (JDBC 4.2)
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1200
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1201 /**
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1202 * Retrieves the current result as an update count;
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1203 * if the result is a ResultSet object or there are no more results, -1 is returned.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1204 * This method should be called only once per result.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1205 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1206 * This method should be used when the returned row count may exceed Integer.MAX_VALUE.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1207 * The default implementation will throw UnsupportedOperationException
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1208 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1209 * @return the current result as an update count; -1 if the current
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1210 * result is a ResultSet object or there are no more results
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1211 * @throws SQLException if a database access error occurs or this
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1212 * method is called on a closed Statement
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1213 */
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1214 public long getLargeUpdateCount() throws SQLException {
378 02f353f62abe Adjust UpdateResponse to allow for large updates (long instead of int). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 377 diff changeset	1215 long ret = -1;
02f353f62abe Adjust UpdateResponse to allow for large updates (long instead of int). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 377 diff changeset	1216 if (header != null) {
02f353f62abe Adjust UpdateResponse to allow for large updates (long instead of int). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 377 diff changeset	1217 if (header instanceof MonetConnection.UpdateResponse) {
02f353f62abe Adjust UpdateResponse to allow for large updates (long instead of int). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 377 diff changeset	1218 ret = ((MonetConnection.UpdateResponse)header).count;
02f353f62abe Adjust UpdateResponse to allow for large updates (long instead of int). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 377 diff changeset	1219 } else if (header instanceof MonetConnection.SchemaResponse) {
02f353f62abe Adjust UpdateResponse to allow for large updates (long instead of int). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 377 diff changeset	1220 ret = ((MonetConnection.SchemaResponse)header).state;
02f353f62abe Adjust UpdateResponse to allow for large updates (long instead of int). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 377 diff changeset	1221 }
02f353f62abe Adjust UpdateResponse to allow for large updates (long instead of int). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 377 diff changeset	1222 }
02f353f62abe Adjust UpdateResponse to allow for large updates (long instead of int). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 377 diff changeset	1223
02f353f62abe Adjust UpdateResponse to allow for large updates (long instead of int). Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 377 diff changeset	1224 return ret;
376 ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1225 }
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1226
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1227 /**
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1228 * Sets the limit for the maximum number of rows that any ResultSet object
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1229 * generated by this Statement object can contain to the given number.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1230 * If the limit is exceeded, the excess rows are silently dropped.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1231 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1232 * This method should be used when the row limit may exceed Integer.MAX_VALUE.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1233 * The default implementation will throw UnsupportedOperationException
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1234 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1235 * @param max the new max rows limit; zero means there is no limit
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1236 * @throws SQLException if a database access error occurs,
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1237 * this method is called on a closed Statement or
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1238 * the condition max >= 0 is not satisfied
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1239 * @see #getLargeMaxRows()
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1240 */
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1241 @Override
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1242 public void setLargeMaxRows(final long max) throws SQLException {
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1243 if (max < 0)
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1244 throw new SQLException("Illegal max value: " + max, "M1M05");
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1245 maxRows = max;
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1246 }
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1247
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1248 /**
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1249 * Retrieves the maximum number of rows that a ResultSet object produced by
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1250 * this Statement object can contain. If this limit is exceeded, the excess
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1251 * rows are silently dropped.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1252 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1253 * This method should be used when the returned row limit may exceed Integer.MAX_VALUE.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1254 * The default implementation will return 0
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1255 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1256 * @return the current maximum number of rows for a ResultSet object
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1257 * produced by this Statement object; zero means there is no limit
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1258 * @see #setLargeMaxRows(long max)
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1259 */
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1260 @Override
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1261 public long getLargeMaxRows() {
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1262 return maxRows;
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1263 }
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1264
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1265 /**
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1266 * Submits a batch of commands to the database for execution and if
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1267 * all commands execute successfully, returns an array of update counts.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1268 * The long elements of the array that is returned are ordered to
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1269 * correspond to the commands in the batch, which are ordered according
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1270 * to the order in which they were added to the batch.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1271 * The elements in the array returned by the method executeLargeBatch
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1272 * may be one of the following:
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1273 * <ol>
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1274 * <li>A number greater than or equal to zero -- indicates that the command
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1275 * was processed successfully and is an update count giving the number of
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1276 * rows in the database that were affected by the command's execution</li>
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1277 * <li>A value of SUCCESS_NO_INFO -- indicates that the command was
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1278 * processed successfully but that the number of rows affected is unknown</li>
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1279 * If one of the commands in a batch update fails to execute properly,
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1280 * this method throws a BatchUpdateException, and a JDBC driver may or
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1281 * may not continue to process the remaining commands in the batch.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1282 * However, the driver's behavior must be consistent with a particular DBMS,
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1283 * either always continuing to process commands or never continuing to process
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1284 * commands. If the driver continues processing after a failure, the array
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1285 * returned by the method BatchUpdateException.getLargeUpdateCounts will
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1286 * contain as many elements as there are commands in the batch, and at
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1287 * least one of the elements will be the following:
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1288 * <li>A value of EXECUTE_FAILED -- indicates that the command failed to
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1289 * execute successfully and occurs only if a driver continues to process
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1290 * commands after a command fails</li>
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1291 * </ol>
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1292 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1293 * This method should be used when the returned row count may exceed Integer.MAX_VALUE.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1294 * The default implementation will throw UnsupportedOperationException
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1295 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1296 * MonetDB does continues after an error has occurred in the batch.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1297 * If one of the commands attempts to return a result set, an
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1298 * SQLException is added to the SQLException list and thrown
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1299 * afterwards execution. Failing queries result in SQLExceptions
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1300 * too and may cause subparts of the batch to fail as well.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1301 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1302 * @return an array of update counts containing one element for each
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1303 * command in the batch. The elements of the array are ordered
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1304 * according to the order in which commands were added to the batch.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1305 * @throws SQLException if a database access error occurs, this method is called
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1306 * on a closed Statement or the driver does not support batch statements.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1307 * Throws BatchUpdateException (a subclass of SQLException) if one of the
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1308 * commands sent to the database fails to execute properly or attempts to return a result set.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1309 */
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1310 @Override
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1311 public long[] executeLargeBatch() throws SQLException {
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1312 if (batch == null \|\| batch.isEmpty()) {
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1313 return new long[0];
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1314 }
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1315
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1316 final int[] ret = executeBatch();
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1317 // copy contents of int[] into new long[]
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1318 final long[] counts = new long[ret.length];
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1319 for (int i = 0; i < ret.length; i++) {
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1320 counts[i] = ret[i];
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1321 }
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1322 return counts;
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1323 }
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1324
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1325 /**
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1326 * Executes the given SQL statement, which may be an INSERT, UPDATE, or
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1327 * DELETE statement or an SQL statement that returns nothing, such as an
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1328 * SQL DDL statement.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1329 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1330 * This method should be used when the returned row count may exceed Integer.MAX_VALUE.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1331 * Note: This method cannot be called on a PreparedStatement or CallableStatement.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1332 * The default implementation will throw SQLFeatureNotSupportedException
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1333 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1334 * @param sql an SQL Data Manipulation Language (DML) statement, such as
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1335 * INSERT, UPDATE or DELETE; or an SQL statement that returns nothing,
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1336 * such as a DDL statement.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1337 * @return either (1) the row count for SQL Data Manipulation Language (DML) statements
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1338 * or (2) 0 for SQL statements that return nothing
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1339 * @throws SQLException if a database access error occurs, this method is
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1340 * called on a closed Statement, the given SQL statement produces a
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1341 * ResultSet object, the method is called on a PreparedStatement or CallableStatement
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1342 */
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1343 @Override
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1344 public long executeLargeUpdate(final String sql) throws SQLException {
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1345 if (execute(sql) != false)
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1346 throw new SQLException("Query produced a result set", "M1M17");
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1347
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1348 return getLargeUpdateCount();
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1349 }
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1350
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1351 /**
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1352 * Executes the given SQL statement and signals the driver with the
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1353 * given flag about whether the auto-generated keys produced by this
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1354 * Statement object should be made available for retrieval.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1355 * The driver will ignore the flag if the SQL statement is not an INSERT
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1356 * statement, or an SQL statement able to return auto-generated keys
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1357 * (the list of such statements is vendor-specific).
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1358 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1359 * This method should be used when the returned row count may exceed Integer.MAX_VALUE.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1360 * Note: This method cannot be called on a PreparedStatement or CallableStatement.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1361 * The default implementation will throw SQLFeatureNotSupportedException
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1362 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1363 * @param sql an SQL Data Manipulation Language (DML) statement, such as
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1364 * INSERT, UPDATE or DELETE; or an SQL statement that returns nothing,
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1365 * such as a DDL statement.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1366 * @param autoGeneratedKeys - a flag indicating whether
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1367 * auto-generated keys should be made available for
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1368 * retrieval; one of the following constants:
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1369 * Statement.RETURN_GENERATED_KEYS
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1370 * Statement.NO_GENERATED_KEYS
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1371 * @return either (1) the row count for SQL Data Manipulation Language (DML) statements
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1372 * or (2) 0 for SQL statements that return nothing
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1373 * @throws SQLException if a database access error occurs, this method is
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1374 * called on a closed Statement, the given SQL statement produces a
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1375 * ResultSet object, the given constant is not one of those allowed,
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1376 * the method is called on a PreparedStatement or CallableStatement
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1377 */
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1378 @Override
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1379 public long executeLargeUpdate(final String sql, final int autoGeneratedKeys)
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1380 throws SQLException
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1381 {
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1382 if (autoGeneratedKeys != Statement.RETURN_GENERATED_KEYS &&
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1383 autoGeneratedKeys != Statement.NO_GENERATED_KEYS)
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1384 throw new SQLException("Invalid argument, expected RETURN_GENERATED_KEYS or NO_GENERATED_KEYS", "M1M05");
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1385
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1386 /* MonetDB has no way to disable this, so just do the normal thing ;) */
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1387 if (execute(sql) != false)
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1388 throw new SQLException("Query produced a result set", "M1M17");
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1389
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1390 return getLargeUpdateCount();
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1391 }
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1392
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1393 /**
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1394 * Executes the given SQL statement and signals the driver that the
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1395 * auto-generated keys indicated in the given array should be made
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1396 * available for retrieval. The driver will ignore the array if the
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1397 * SQL statement is not an INSERT statement.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1398 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1399 * This method should be used when the returned row count may exceed Integer.MAX_VALUE.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1400 * Note: This method cannot be called on a PreparedStatement or CallableStatement.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1401 * The default implementation will throw SQLFeatureNotSupportedException
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1402 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1403 * MonetDB only supports returing the generated key for one column,
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1404 * which will be the first column that has a serial. Hence, this
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1405 * method cannot work as required and the driver will fall back to
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1406 * executing with request to the database to return the generated
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1407 * key, if any.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1408 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1409 * @param sql an SQL Data Manipulation Language (DML) statement, such as
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1410 * INSERT, UPDATE or DELETE; or an SQL statement that returns nothing,
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1411 * such as a DDL statement.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1412 * @param columnIndexes an array of column indexes indicating the
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1413 * columns that should be returned from the inserted row
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1414 * @return either (1) the row count for SQL Data Manipulation Language (DML) statements
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1415 * or (2) 0 for SQL statements that return nothing
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1416 * @throws SQLException if a database access error occurs, this method is
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1417 * called on a closed Statement, the given SQL statement produces a
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1418 * ResultSet object, the second argument supplied to this method is
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1419 * not an int array whose elements are valid column indexes,
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1420 * the method is called on a PreparedStatement or CallableStatement
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1421 */
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1422 @Override
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1423 public long executeLargeUpdate(final String sql, final int[] columnIndexes)
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1424 throws SQLException
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1425 {
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1426 addWarning("executeLargeUpdate: generated keys for fixed set of columns not supported", "01M18");
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1427 return executeLargeUpdate(sql, Statement.RETURN_GENERATED_KEYS);
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1428 }
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1429
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1430 /**
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1431 * Executes the given SQL statement and signals the driver that the
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1432 * auto-generated keys indicated in the given array should be made
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1433 * available for retrieval. The driver will ignore the array if the
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1434 * SQL statement is not an INSERT statement.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1435 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1436 * This method should be used when the returned row count may exceed Integer.MAX_VALUE.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1437 * Note: This method cannot be called on a PreparedStatement or CallableStatement.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1438 * The default implementation will throw SQLFeatureNotSupportedException
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1439 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1440 * MonetDB only supports returing the generated key for one column,
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1441 * which will be the first column that has a serial. Hence, this
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1442 * method cannot work as required and the driver will fall back to
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1443 * executing with request to the database to return the generated
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1444 * key, if any.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1445 *
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1446 * @param sql an SQL Data Manipulation Language (DML) statement, such as
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1447 * INSERT, UPDATE or DELETE; or an SQL statement that returns nothing,
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1448 * such as a DDL statement.
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1449 * @param columnNames an array of the names of the columns that
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1450 * should be returned from the inserted row
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1451 * @return either (1) the row count for SQL Data Manipulation Language (DML) statements
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1452 * or (2) 0 for SQL statements that return nothing
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1453 * @throws SQLException if a database access error occurs, this method is
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1454 * called on a closed Statement, the given SQL statement produces a
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1455 * ResultSet object, the second argument supplied to this method is
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1456 * not a String array whose elements are valid column names,
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1457 * the method is called on a PreparedStatement or CallableStatement
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1458 */
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1459 @Override
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1460 public long executeLargeUpdate(final String sql, final String[] columnNames)
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1461 throws SQLException
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1462 {
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1463 addWarning("executeLargeUpdate: generated keys for fixed set of columns not supported", "01M18");
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1464 return executeLargeUpdate(sql, Statement.RETURN_GENERATED_KEYS);
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1465 }
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1466
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1467 //== end methods of interface Statement
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1468
376 ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1469
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1470 //== internal helper methods which do not belong to the JDBC interface
ffdc7b0e102d Updated JDBC driver to comply with JDBC 4.2 interface now we compile for Java 8. This includes: Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 361 diff changeset	1471
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1472 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1473 * Adds a warning to the pile of warnings this Statement object has. If
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1474 * there were no warnings (or clearWarnings was called) this warning will
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1475 * be the first, otherwise this warning will get appended to the current
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1476 * warning.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1477 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1478 * @param reason the warning message
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1479 */
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	1480 private void addWarning(final String reason, final String sqlstate) {
183 57f09396b22c Small improvements Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 181 diff changeset	1481 SQLWarning warng = new SQLWarning(reason, sqlstate);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1482 if (warnings == null) {
183 57f09396b22c Small improvements Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 181 diff changeset	1483 warnings = warng;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1484 } else {
183 57f09396b22c Small improvements Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 181 diff changeset	1485 warnings.setNextWarning(warng);
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1486 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1487 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1488
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1489 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1490 * Closes this Statement if there are no more open ResultSets
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1491 * (Responses). Called by MonetResultSet.close().
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1492 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1493 void closeIfCompletion() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1494 if (!closeOnCompletion \|\| lastResponseList == null)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1495 return;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1496 if (!lastResponseList.hasUnclosedResponses())
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1497 close();
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1498 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1499 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1500
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1501 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1502 * This internal subclass is not intended for normal use. Therefore it is restricted to
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1503 * classes from the very same package only.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1504 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1505 * Known issues with this class: some methods of the ResultSetMetaData object (obtained via getMetaData())
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1506 * require that its statement argument (accessed via getStatement()) has a valid Statement object set.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1507 * Instances of this subclass do not have a valid Statement (see special constructor), so
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1508 * those metadata methods do not return the correct values.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1509 * Special checks are programmed to prevent NullPointerExceptions, see above.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1510 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1511 * As of Jun2016 this class is only used by MonetStatement.getGeneratedKeys()
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1512 * Note: to resolve a javac -Xlint warning, this class definition is moved to this file.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1513 *
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1514 * TODO: try to eliminate the need for this class completely.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1515 */
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	1516 final class MonetVirtualResultSet extends MonetResultSet {
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1517 private String results[][];
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1518 private boolean closed;
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 MonetVirtualResultSet(
295 003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	1521 final Statement statement,
003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	1522 final String[] columns,
003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	1523 final String[] types,
003ae6d881db Add "final" keyword to method arguments and local variables where possible. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 292 diff changeset	1524 final String[][] results
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1525 ) throws IllegalArgumentException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1526 super(statement, columns, types, results.length);
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1527 this.results = results;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1528 closed = false;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1529 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1530
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1531 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1532 * This method is overridden in order to let it use the results array
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1533 * instead of the cache in the Statement object that created it.
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 * @param row the number of the row to which the cursor should move. A
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1536 * positive number indicates the row number counting from the
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1537 * beginning of the result set; a negative number indicates the row
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1538 * number counting from the end of the result set
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1539 * @return true if the cursor is on the result set; false otherwise
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1540 * @throws SQLException if a database error occurs
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1541 */
13 749e3cf8b2aa Expanded the classes needed for import. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 0 diff changeset	1542 @Override
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1543 public boolean absolute(int row) throws SQLException {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1544 if (closed)
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1545 throw new SQLException("ResultSet is closed!", "M1M20");
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1546
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1547 // first calculate what the JDBC row is
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1548 if (row < 0) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1549 // calculate the negatives...
377 8a813f5cef1b Extend StartOfHeaderParser with method getNextAsLong() and change type of tuplecount to long. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 376 diff changeset	1550 row = (int) tupleCount + row + 1;
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1551 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1552 // now place the row not farther than just before or after the result
250 3038e60bdca1 If methods never throw an SQLException, remove the "throws SQLException" part. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 249 diff changeset	1553 if (row < 0)
3038e60bdca1 If methods never throw an SQLException, remove the "throws SQLException" part. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 249 diff changeset	1554 row = 0; // before first
3038e60bdca1 If methods never throw an SQLException, remove the "throws SQLException" part. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 249 diff changeset	1555 else if (row > tupleCount + 1)
377 8a813f5cef1b Extend StartOfHeaderParser with method getNextAsLong() and change type of tuplecount to long. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 376 diff changeset	1556 row = (int) tupleCount + 1; // after last
0 a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1557
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1558 // store it
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1559 curRow = row;
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 // see if we have the row
250 3038e60bdca1 If methods never throw an SQLException, remove the "throws SQLException" part. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 249 diff changeset	1562 if (row < 1 \|\| row > tupleCount)
3038e60bdca1 If methods never throw an SQLException, remove the "throws SQLException" part. Martin van Dinther <martin.van.dinther@monetdbsolutions.com> parents: 249 diff changeset	1563 return false;
0 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 for (int i = 0; i < results[row - 1].length; i++) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1566 tlp.values[i] = results[row - 1][i];
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1567 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1568
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1569 return true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1570 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1571
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1572 /**
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1573 * Mainly here to prevent errors when the close method is called. There
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1574 * is no real need for this object to close it. We simply remove our
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1575 * resultset data.
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1576 */
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1577 @Override
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1578 public void close() {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1579 if (!closed) {
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1580 closed = true;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1581 results = null;
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1582 // types and columns are MonetResultSets private parts
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1583 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1584 }
a5a898f6886c Copy of MonetDB java directory changeset e6e32756ad31. Sjoerd Mullender <sjoerd@acm.org> parents: diff changeset	1585 }

Mercurial > hg > monetdb-java

annotate src/main/java/org/monetdb/jdbc/MonetStatement.java @ 391:f523727db392