-
Notifications
You must be signed in to change notification settings - Fork 219
/
MySQLConnection.java
1382 lines (1286 loc) · 67.4 KB
/
MySQLConnection.java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
/*
MariaDB Client for Java
Copyright (c) 2012 Monty Program Ab.
This library is free software; you can redistribute it and/or modify it under
the terms of the GNU Lesser General Public License as published by the Free
Software Foundation; either version 2.1 of the License, or (at your option)
any later version.
This library is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
for more details.
You should have received a copy of the GNU Lesser General Public License along
with this library; if not, write to Monty Program Ab info@montyprogram.com.
This particular MariaDB Client for Java file is work
derived from a Drizzle-JDBC. Drizzle-JDBC file which is covered by subject to
the following copyright and notice provisions:
Copyright (c) 2009-2011, Marcus Eriksson
Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list
of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this
list of conditions and the following disclaimer in the documentation and/or
other materials provided with the distribution.
Neither the name of the driver nor the names of its contributors may not be
used to endorse or promote products derived from this software without specific
prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
OF SUCH DAMAGE.
*/
package org.mariadb.jdbc;
import org.mariadb.jdbc.internal.SQLExceptionMapper;
import org.mariadb.jdbc.internal.common.QueryException;
import org.mariadb.jdbc.internal.common.Utils;
import org.mariadb.jdbc.internal.mysql.MySQLProtocol;
import org.mariadb.jdbc.internal.mysql.Protocol;
import java.net.SocketException;
import java.sql.*;
import java.util.*;
import java.util.concurrent.Executor;
public final class MySQLConnection implements Connection {
/**
* the protocol to communicate with.
*/
private final Protocol protocol;
/**
* save point count - to generate good names for the savepoints.
*/
private int savepointCount = 0;
/**
* the properties for the client.
*/
private final Properties clientInfoProperties;
public MySQLPooledConnection pooledConnection;
private boolean warningsCleared;
boolean noBackslashEscapes;
boolean nullCatalogMeansCurrent = true;
int autoIncrementIncrement;
Calendar cal;
/**
* Creates a new connection with a given protocol and query factory.
*
* @param protocol the protocol to use.
*/
private MySQLConnection(Protocol protocol) {
this.protocol = protocol;
clientInfoProperties = protocol.getInfo();
}
Protocol getProtocol() {
return protocol;
}
static TimeZone getTimeZone(String id) throws SQLException {
TimeZone tz = java.util.TimeZone.getTimeZone(id);
// Validate the timezone ID. JDK maps invalid timezones to GMT
if (tz.getID().equals("GMT") && !id.equals("GMT")) {
throw new SQLException("invalid timezone id '" + id + "'");
}
return tz;
}
public static MySQLConnection newConnection(Protocol protocol) throws SQLException {
MySQLConnection connection = new MySQLConnection(protocol);
Properties info = protocol.getInfo();
boolean fastConnect = info.get("fastConnect") != null ;
String sessionVariables = info.getProperty("sessionVariables");
String timeZoneId = info.getProperty("serverTimezone");
if (timeZoneId != null) {
TimeZone tz = getTimeZone(timeZoneId);
connection.cal = Calendar.getInstance(tz);
}
connection.noBackslashEscapes = protocol.noBackslashEscapes();
String nullCatalogMeansCurrentString = info.getProperty("nullCatalogMeansCurrent");
if (nullCatalogMeansCurrentString != null && nullCatalogMeansCurrentString.equals("false")) {
connection.nullCatalogMeansCurrent = false;
}
Statement st = null;
try {
st = connection.createStatement();
if (sessionVariables != null) {
st.executeUpdate("set session " + sessionVariables);
}
ResultSet rs = st.executeQuery("show variables like 'max_allowed_packet'");
rs.next();
protocol.setMaxAllowedPacket(Integer.parseInt(rs.getString(2)));
} finally {
if (st != null)
st.close();
}
return connection;
}
int getAutoIncrementIncrement() {
if(autoIncrementIncrement == 0) {
try {
ResultSet rs = createStatement().executeQuery("select @@auto_increment_increment");
rs.next();
autoIncrementIncrement = rs.getInt(1);
} catch (SQLException e) {
autoIncrementIncrement = 1;
}
}
return autoIncrementIncrement;
}
/**
* creates a new statement.
*
* @return a statement
* @throws SQLException if we cannot create the statement.
*/
public Statement createStatement() throws SQLException {
if (getProtocol().isClosed()) {
throw new SQLException("Cannot create a statement: closed connection");
}
return new MySQLStatement(this);
}
/**
* creates a new prepared statement. Only client side prepared statement emulation right now.
*
* @param sql the query.
* @return a prepared statement.
* @throws SQLException if there is a problem preparing the statement.
*/
public PreparedStatement prepareStatement(final String sql) throws SQLException {
return new MySQLPreparedStatement(this, sql);
}
public CallableStatement prepareCall(final String sql) throws SQLException {
return new MySQLCallableStatement(this, sql);
}
public String nativeSQL(final String sql) throws SQLException {
return Utils.nativeSQL(sql,noBackslashEscapes);
}
/**
* Sets whether this connection is auto commited.
*
* @param autoCommit if it should be auto commited.
* @throws SQLException if something goes wrong talking to the server.
*/
public void setAutoCommit(boolean autoCommit) throws SQLException {
if (autoCommit == getAutoCommit())
return;
Statement stmt = createStatement();
try {
stmt.executeUpdate("set autocommit="+((autoCommit)?"1":"0"));
} finally {
stmt.close();
}
}
/**
* returns true if statements on this connection are auto commited.
*
* @return true if auto commit is on.
* @throws SQLException if there is an error
*/
public boolean getAutoCommit() throws SQLException {
return protocol.getAutocommit();
}
/**
* sends commit to the server.
*
* @throws SQLException if there is an error commiting.
*/
public void commit() throws SQLException {
Statement st = createStatement();
try {
st.execute("COMMIT");
} finally {
st.close();
}
}
/**
* rolls back a transaction.
*
* @throws SQLException if there is an error rolling back.
*/
public void rollback() throws SQLException {
Statement st = createStatement();
try {
st.execute("ROLLBACK");
} finally {
st.close();
}
}
/**
* close the connection.
*
* @throws SQLException if there is a problem talking to the server.
*/
public void close() throws SQLException {
if (pooledConnection != null) {
if (protocol != null && protocol.inTransaction()) {
/* Rollback transaction prior to returning physical connection to the pool */
rollback();
}
pooledConnection.fireConnectionClosed();
return;
}
protocol.close();
}
/**
* checks if the connection is closed.
*
* @return true if the connection is closed
* @throws SQLException if the connection cannot be closed.
*/
public boolean isClosed() throws SQLException {
return protocol.isClosed();
}
/**
* returns the meta data about the database.
*
* @return meta data about the db.
* @throws SQLException if there is a problem creating the meta data.
*/
public DatabaseMetaData getMetaData() throws SQLException {
return new MySQLDatabaseMetaData(this,protocol.getUsername(),
"jdbc:mysql://" + protocol.getHost() + ":" + protocol.getPort() + "/" + protocol.getDatabase());
}
/**
* Sets whether this connection is read only.
*
* @param readOnly true if it should be read only.
* @throws SQLException if there is a problem
*/
public void setReadOnly(final boolean readOnly) throws SQLException {
protocol.setReadonly(readOnly);
}
/**
* Retrieves whether this <code>Connection</code> object is in read-only mode.
*
* @return <code>true</code> if this <code>Connection</code> object is read-only; <code>false</code> otherwise
* @throws java.sql.SQLException SQLException if a database access error occurs or this method is called on a closed
* connection
*/
public boolean isReadOnly() throws SQLException {
return !protocol.checkIfMaster();
}
public static String quoteIdentifier(String s) {
return "`" + s.replaceAll("`","``") + "`";
}
public static String unquoteIdentifier(String s) {
if (s != null && s.startsWith("`") && s.endsWith("`") && s.length()>= 2) {
return s.substring(1, s.length()-1).replace("``", "`");
}
return s;
}
/**
* Sets the given catalog name in order to select a subspace of this <code>Connection</code> object's database in
* which to work.
*
* If the driver does not support catalogs, it will silently ignore this request.
*
* MySQL treats catalogs and databases as equivalent
*
* @param catalog the name of a catalog (subspace in this <code>Connection</code> object's database) in which to
* work
* @throws java.sql.SQLException if a database access error occurs or this method is called on a closed connection
* @see #getCatalog
*/
public void setCatalog(final String catalog) throws SQLException {
if (catalog == null){
throw new SQLException("The catalog name may not be null", "XAE05");
}
Statement st = createStatement();
try {
/* Quote modifiers correctly, with backtick char */
st.execute("USE "+ quoteIdentifier(catalog) );
st.close();
} finally {
st.close();
}
}
/**
* Retrieves this <code>Connection</code> object's current catalog name.
*
* catalogs are not supported in drizzle
*
* TODO: Explain the wrapper interface to be able to change database
*
* @return the current catalog name or <code>null</code> if there is none
* @throws java.sql.SQLException if a database access error occurs or this method is called on a closed connection
* @see #setCatalog
*/
public String getCatalog() throws SQLException {
String catalog = null;
Statement st = null;
try {
st = createStatement();
ResultSet rs = st.executeQuery("select database()");
rs.next();
catalog = rs.getString(1);
} finally {
if (st != null)
st.close();
}
return catalog;
}
/**
* Attempts to change the transaction isolation level for this <code>Connection</code> object to the one given. The
* constants defined in the interface <code>Connection</code> are the possible transaction isolation levels.
*
* <B>Note:</B> If this method is called during a transaction, the result is implementation-defined.
*
* @param level one of the following <code>Connection</code> constants: <code>Connection.TRANSACTION_READ_UNCOMMITTED</code>,
* <code>Connection.TRANSACTION_READ_COMMITTED</code>, <code>Connection.TRANSACTION_REPEATABLE_READ</code>,
* or <code>Connection.TRANSACTION_SERIALIZABLE</code>. (Note that <code>Connection.TRANSACTION_NONE</code>
* cannot be used because it specifies that transactions are not supported.)
* @throws java.sql.SQLException if a database access error occurs, this method is called on a closed connection or
* the given parameter is not one of the <code>Connection</code> constants
* @see java.sql.DatabaseMetaData#supportsTransactionIsolationLevel
* @see #getTransactionIsolation
*/
public void setTransactionIsolation(final int level) throws SQLException {
String query = "SET SESSION TRANSACTION ISOLATION LEVEL";
switch (level) {
case Connection.TRANSACTION_READ_UNCOMMITTED:
query += " READ UNCOMMITTED";
break;
case Connection.TRANSACTION_READ_COMMITTED:
query += " READ COMMITTED";
break;
case Connection.TRANSACTION_REPEATABLE_READ:
query += " REPEATABLE READ";
break;
case Connection.TRANSACTION_SERIALIZABLE:
query += " SERIALIZABLE";
break;
default:
throw SQLExceptionMapper.getSQLException("Unsupported transaction isolation level");
}
Statement st = createStatement();
try {
st.execute(query);
} finally {
st.close();
}
}
/**
* Retrieves this <code>Connection</code> object's current transaction isolation level.
*
* @return the current transaction isolation level, which will be one of the following constants:
* <code>Connection.TRANSACTION_READ_UNCOMMITTED</code>, <code>Connection.TRANSACTION_READ_COMMITTED</code>,
* <code>Connection.TRANSACTION_REPEATABLE_READ</code>, <code>Connection.TRANSACTION_SERIALIZABLE</code>, or
* <code>Connection.TRANSACTION_NONE</code>.
* @throws java.sql.SQLException if a database access error occurs or this method is called on a closed connection
* @see #setTransactionIsolation
*/
public int getTransactionIsolation() throws SQLException {
final Statement stmt = createStatement();
try {
final ResultSet rs = stmt.executeQuery("SELECT @@tx_isolation");
rs.next();
final String response = rs.getString(1);
if (response.equals("REPEATABLE-READ")) {
return Connection.TRANSACTION_REPEATABLE_READ;
}
if (response.equals("READ-UNCOMMITTED")) {
return Connection.TRANSACTION_READ_UNCOMMITTED;
}
if (response.equals("READ-COMMITTED")) {
return Connection.TRANSACTION_READ_COMMITTED;
}
if (response.equals("SERIALIZABLE")) {
return Connection.TRANSACTION_SERIALIZABLE;
}
} finally {
stmt.close();
}
throw SQLExceptionMapper.getSQLException("Could not get transaction isolation level");
}
/**
* Not yet implemented: Protocol needs to store any warnings related to connections
*
*
* Retrieves the first warning reported by calls on this <code>Connection</code> object. If there is more than one
* warning, subsequent warnings will be chained to the first one and can be retrieved by calling the method
* <code>SQLWarning.getNextWarning</code> on the warning that was retrieved previously.
*
* This method may not be called on a closed connection; doing so will cause an <code>SQLException</code> to be
* thrown.
*
* <P><B>Note:</B> Subsequent warnings will be chained to this SQLWarning.
*
* @return the first <code>SQLWarning</code> object or <code>null</code> if there are none
* @throws java.sql.SQLException if a database access error occurs or this method is called on a closed connection
* @see java.sql.SQLWarning
*/
public SQLWarning getWarnings() throws SQLException {
if (warningsCleared || isClosed() || !protocol.hasWarnings()) {
return null;
}
Statement st = null;
ResultSet rs = null;
SQLWarning last = null;
SQLWarning first = null;
try {
st = this.createStatement();
rs = st.executeQuery("show warnings");
// returned result set has 'level', 'code' and 'message' columns, in this order.
while(rs.next()) {
int code = rs.getInt(2);
String message = rs.getString(3);
SQLWarning w = new SQLWarning(message, SQLExceptionMapper.mapMySQLCodeToSQLState(code), code);
if (first == null) {
first = w;
last = w;
}
else {
last.setNextWarning(w);
last = w;
}
}
}
finally {
if (rs != null)
rs.close();
if(st != null)
st.close();
}
return first;
}
/**
* Clears all warnings reported for this <code>Connection</code> object. After a call to this method, the method
* <code>getWarnings</code> returns <code>null</code> until a new warning is reported for this
* <code>Connection</code> object.
*
* @throws java.sql.SQLException SQLException if a database access error occurs or this method is called on a closed
* connection
*/
public void clearWarnings() throws SQLException {
warningsCleared = true;
}
/**
* Reenable warnings, when next statement is executed
*/
public void reenableWarnings() {
warningsCleared = false;
}
/**
* Creates a <code>Statement</code> object that will generate <code>ResultSet</code> objects with the given type and
* concurrency. This method is the same as the <code>createStatement</code> method above, but it allows the default
* result set type and concurrency to be overridden. The holdability of the created result sets can be determined by
* calling {@link #getHoldability}.
*
* @param resultSetType a result set type; one of <code>ResultSet.TYPE_FORWARD_ONLY</code>,
* <code>ResultSet.TYPE_SCROLL_INSENSITIVE</code>, or <code>ResultSet.TYPE_SCROLL_SENSITIVE</code>
* @param resultSetConcurrency a concurrency type; one of <code>ResultSet.CONCUR_READ_ONLY</code> or
* <code>ResultSet.CONCUR_UPDATABLE</code>
* @return a new <code>Statement</code> object that will generate <code>ResultSet</code> objects with the given type
* and concurrency
* @throws java.sql.SQLException if a database access error occurs, this method is called on a closed connection or
* the given parameters are not <code>ResultSet</code> constants indicating type and
* concurrency
*/
public Statement createStatement(final int resultSetType, final int resultSetConcurrency) throws SQLException {
// for now resultSetType and resultSetConcurrency are ignored
// TODO: fix
return createStatement();
}
/**
* Creates a <code>PreparedStatement</code> object that will generate <code>ResultSet</code> objects with the given
* type and concurrency. This method is the same as the <code>prepareStatement</code> method above, but it allows
* the default result set type and concurrency to be overridden. The holdability of the created result sets can be
* determined by calling {@link #getHoldability}.
*
* @param sql a <code>String</code> object that is the SQL statement to be sent to the database;
* may contain one or more '?' IN parameters
* @param resultSetType a result set type; one of <code>ResultSet.TYPE_FORWARD_ONLY</code>,
* <code>ResultSet.TYPE_SCROLL_INSENSITIVE</code>, or <code>ResultSet.TYPE_SCROLL_SENSITIVE</code>
* @param resultSetConcurrency a concurrency type; one of <code>ResultSet.CONCUR_READ_ONLY</code> or
* <code>ResultSet.CONCUR_UPDATABLE</code>
* @return a new PreparedStatement object containing the pre-compiled SQL statement that will produce
* <code>ResultSet</code> objects with the given type and concurrency
* @throws java.sql.SQLException if a database access error occurs, this method is called on a closed connection or
* the given parameters are not <code>ResultSet</code> constants indicating type and
* concurrency
*/
public PreparedStatement prepareStatement(final String sql, final int resultSetType, final int resultSetConcurrency)
throws SQLException {
// for now resultSetType and resultSetConcurrency are ignored
// TODO: fix
return prepareStatement(sql);
}
/**
* Creates a <code>CallableStatement</code> object that will generate <code>ResultSet</code> objects with the given
* type and concurrency. This method is the same as the <code>prepareCall</code> method above, but it allows the
* default result set type and concurrency to be overridden. The holdability of the created result sets can be
* determined by calling {@link #getHoldability}.
*
* @param sql a <code>String</code> object that is the SQL statement to be sent to the database;
* may contain on or more '?' parameters
* @param resultSetType a result set type; one of <code>ResultSet.TYPE_FORWARD_ONLY</code>,
* <code>ResultSet.TYPE_SCROLL_INSENSITIVE</code>, or <code>ResultSet.TYPE_SCROLL_SENSITIVE</code>
* @param resultSetConcurrency a concurrency type; one of <code>ResultSet.CONCUR_READ_ONLY</code> or
* <code>ResultSet.CONCUR_UPDATABLE</code>
* @return a new <code>CallableStatement</code> object containing the pre-compiled SQL statement that will produce
* <code>ResultSet</code> objects with the given type and concurrency
* @throws java.sql.SQLException if a database access error occurs, this method is called on a closed connection or
* the given parameters are not <code>ResultSet</code> constants indicating type and
* concurrency
* @throws java.sql.SQLFeatureNotSupportedException
* if the JDBC driver does not support this method or this method is not supported for
* the specified result set type and result set concurrency.
*/
public CallableStatement prepareCall(final String sql, final int resultSetType, final int resultSetConcurrency) throws SQLException {
return new MySQLCallableStatement(this,sql);
}
/**
* Retrieves the <code>Map</code> object associated with this <code>Connection</code> object. Unless the application
* has added an entry, the type map returned will be empty.
*
* @return the <code>java.util.Map</code> object associated with this <code>Connection</code> object
* @throws java.sql.SQLException if a database access error occurs or this method is called on a closed connection
* @throws java.sql.SQLFeatureNotSupportedException
* if the JDBC driver does not support this method
* @see #setTypeMap
* @since 1.2
*/
public Map<String, Class<?>> getTypeMap() throws SQLException {
return null;
}
/**
* Installs the given <code>TypeMap</code> object as the type map for this <code>Connection</code> object. The type
* map will be used for the custom mapping of SQL structured types and distinct types.
*
* @param map the <code>java.util.Map</code> object to install as the replacement for this <code>Connection</code>
* object's default type map
* @throws java.sql.SQLException if a database access error occurs, this method is called on a closed connection or
* the given parameter is not a <code>java.util.Map</code> object
* @throws java.sql.SQLFeatureNotSupportedException
* if the JDBC driver does not support this method
* @see #getTypeMap
*/
public void setTypeMap(final Map<String, Class<?>> map) throws SQLException {
throw SQLExceptionMapper.getFeatureNotSupportedException("Not yet supported");
}
/**
* Changes the default holdability of <code>ResultSet</code> objects created using this <code>Connection</code>
* object to the given holdability. The default holdability of <code>ResultSet</code> objects can be be determined
* by invoking {@link java.sql.DatabaseMetaData#getResultSetHoldability}.
*
* @param holdability a <code>ResultSet</code> holdability constant; one of <code>ResultSet.HOLD_CURSORS_OVER_COMMIT</code>
* or <code>ResultSet.CLOSE_CURSORS_AT_COMMIT</code>
* @throws java.sql.SQLException if a database access occurs, this method is called on a closed connection, or the
* given parameter is not a <code>ResultSet</code> constant indicating holdability
* @throws java.sql.SQLFeatureNotSupportedException
* if the given holdability is not supported
* @see #getHoldability
* @see java.sql.DatabaseMetaData#getResultSetHoldability
* @see java.sql.ResultSet
* @since 1.4
*/
public void setHoldability(final int holdability) throws SQLException {
}
/**
* Retrieves the current holdability of <code>ResultSet</code> objects created using this <code>Connection</code>
* object.
*
* @return the holdability, one of <code>ResultSet.HOLD_CURSORS_OVER_COMMIT</code> or
* <code>ResultSet.CLOSE_CURSORS_AT_COMMIT</code>
* @throws java.sql.SQLException if a database access error occurs or this method is called on a closed connection
* @see #setHoldability
* @see java.sql.DatabaseMetaData#getResultSetHoldability
* @see java.sql.ResultSet
* @since 1.4
*/
public int getHoldability() throws SQLException {
return ResultSet.HOLD_CURSORS_OVER_COMMIT;
}
/**
* Creates an unnamed savepoint in the current transaction and returns the new <code>Savepoint</code> object that
* represents it.
*
* if setSavepoint is invoked outside of an active transaction, a transaction will be started at this newly
* created savepoint.
*
* @return the new <code>Savepoint</code> object
* @throws java.sql.SQLException if a database access error occurs, this method is called while participating in a
* distributed transaction, this method is called on a closed connection or this
* <code>Connection</code> object is currently in auto-commit mode
* @throws java.sql.SQLFeatureNotSupportedException
* if the JDBC driver does not support this method
* @see java.sql.Savepoint
* @since 1.4
*/
public Savepoint setSavepoint() throws SQLException {
return setSavepoint("unnamed");
}
/**
* Creates a savepoint with the given name in the current transaction and returns the new <code>Savepoint</code>
* object that represents it.
*
* if setSavepoint is invoked outside of an active transaction, a transaction will be started at this newly
* created savepoint.
*
* @param name a <code>String</code> containing the name of the savepoint
* @return the new <code>Savepoint</code> object
* @throws java.sql.SQLException if a database access error occurs, this method is called while participating in a
* distributed transaction, this method is called on a closed connection or this
* <code>Connection</code> object is currently in auto-commit mode
* @throws java.sql.SQLFeatureNotSupportedException
* if the JDBC driver does not support this method
* @see java.sql.Savepoint
* @since 1.4
*/
public Savepoint setSavepoint(final String name) throws SQLException {
Savepoint savepoint = new MySQLSavepoint(name, savepointCount++);
Statement st = createStatement();
st.execute("SAVEPOINT " + savepoint.toString());
return savepoint;
}
/**
* Undoes all changes made after the given <code>Savepoint</code> object was set.
*
* This method should be used only when auto-commit has been disabled.
*
* @param savepoint the <code>Savepoint</code> object to roll back to
* @throws java.sql.SQLException if a database access error occurs, this method is called while participating in a
* distributed transaction, this method is called on a closed connection, the
* <code>Savepoint</code> object is no longer valid, or this <code>Connection</code>
* object is currently in auto-commit mode
* @throws java.sql.SQLFeatureNotSupportedException
* if the JDBC driver does not support this method
* @see java.sql.Savepoint
* @see #rollback
* @since 1.4
*/
public void rollback(final Savepoint savepoint) throws SQLException {
Statement st = createStatement();
st.execute("ROLLBACK TO SAVEPOINT " + savepoint.toString());
st.close();
}
/**
* Removes the specified <code>Savepoint</code> and subsequent <code>Savepoint</code> objects from the current
* transaction. Any reference to the savepoint after it have been removed will cause an <code>SQLException</code> to
* be thrown.
*
* @param savepoint the <code>Savepoint</code> object to be removed
* @throws java.sql.SQLException if a database access error occurs, this method is called on a closed connection or
* the given <code>Savepoint</code> object is not a valid savepoint in the current
* transaction
* @throws java.sql.SQLFeatureNotSupportedException
* if the JDBC driver does not support this method
* @since 1.4
*/
public void releaseSavepoint(final Savepoint savepoint) throws SQLException {
Statement st = createStatement();
st.execute("RELEASE SAVEPOINT " + savepoint.toString());
st.close();
}
/**
* Creates a <code>Statement</code> object that will generate <code>ResultSet</code> objects with the given type,
* concurrency, and holdability. This method is the same as the <code>createStatement</code> method above, but it
* allows the default result set type, concurrency, and holdability to be overridden.
*
* @param resultSetType one of the following <code>ResultSet</code> constants: <code>ResultSet.TYPE_FORWARD_ONLY</code>,
* <code>ResultSet.TYPE_SCROLL_INSENSITIVE</code>, or <code>ResultSet.TYPE_SCROLL_SENSITIVE</code>
* @param resultSetConcurrency one of the following <code>ResultSet</code> constants: <code>ResultSet.CONCUR_READ_ONLY</code>
* or <code>ResultSet.CONCUR_UPDATABLE</code>
* @param resultSetHoldability one of the following <code>ResultSet</code> constants: <code>ResultSet.HOLD_CURSORS_OVER_COMMIT</code>
* or <code>ResultSet.CLOSE_CURSORS_AT_COMMIT</code>
* @return a new <code>Statement</code> object that will generate <code>ResultSet</code> objects with the given
* type, concurrency, and holdability
* @throws java.sql.SQLException if a database access error occurs, this method is called on a closed connection or
* the given parameters are not <code>ResultSet</code> constants indicating type,
* concurrency, and holdability
* @throws java.sql.SQLFeatureNotSupportedException
* if the JDBC driver does not support this method or this method is not supported for
* the specified result set type, result set holdability and result set concurrency.
* @see java.sql.ResultSet
* @since 1.4
*/
public Statement createStatement(final int resultSetType, final int resultSetConcurrency, final int resultSetHoldability)
throws SQLException {
if (resultSetConcurrency != ResultSet.CONCUR_READ_ONLY) {
throw SQLExceptionMapper.getFeatureNotSupportedException("Only read-only result sets allowed");
}
return createStatement();
}
/**
* Creates a <code>PreparedStatement</code> object that will generate <code>ResultSet</code> objects with the given
* type, concurrency, and holdability.
*
* This method is the same as the <code>prepareStatement</code> method above, but it allows the default result set
* type, concurrency, and holdability to be overridden.
*
* @param sql a <code>String</code> object that is the SQL statement to be sent to the database;
* may contain one or more '?' IN parameters
* @param resultSetType one of the following <code>ResultSet</code> constants: <code>ResultSet.TYPE_FORWARD_ONLY</code>,
* <code>ResultSet.TYPE_SCROLL_INSENSITIVE</code>, or <code>ResultSet.TYPE_SCROLL_SENSITIVE</code>
* @param resultSetConcurrency one of the following <code>ResultSet</code> constants: <code>ResultSet.CONCUR_READ_ONLY</code>
* or <code>ResultSet.CONCUR_UPDATABLE</code>
* @param resultSetHoldability one of the following <code>ResultSet</code> constants: <code>ResultSet.HOLD_CURSORS_OVER_COMMIT</code>
* or <code>ResultSet.CLOSE_CURSORS_AT_COMMIT</code>
* @return a new <code>PreparedStatement</code> object, containing the pre-compiled SQL statement, that will
* generate <code>ResultSet</code> objects with the given type, concurrency, and holdability
* @throws java.sql.SQLException if a database access error occurs, this method is called on a closed connection or
* the given parameters are not <code>ResultSet</code> constants indicating type,
* concurrency, and holdability
* @throws java.sql.SQLFeatureNotSupportedException
* if the JDBC driver does not support this method or this method is not supported for
* the specified result set type, result set holdability and result set concurrency.
* @see java.sql.ResultSet
* @since 1.4
*/
public PreparedStatement prepareStatement(final String sql,
final int resultSetType,
final int resultSetConcurrency,
final int resultSetHoldability) throws SQLException {
if (resultSetConcurrency != ResultSet.CONCUR_READ_ONLY) {
throw SQLExceptionMapper.getFeatureNotSupportedException("Only read-only result sets allowed");
}
// resultSetType is ignored since we always are scroll insensitive
return prepareStatement(sql);
}
/**
* Creates a <code>CallableStatement</code> object that will generate <code>ResultSet</code> objects with the given
* type and concurrency. This method is the same as the <code>prepareCall</code> method above, but it allows the
* default result set type, result set concurrency type and holdability to be overridden.
*
* @param sql a <code>String</code> object that is the SQL statement to be sent to the database;
* may contain on or more '?' parameters
* @param resultSetType one of the following <code>ResultSet</code> constants: <code>ResultSet.TYPE_FORWARD_ONLY</code>,
* <code>ResultSet.TYPE_SCROLL_INSENSITIVE</code>, or <code>ResultSet.TYPE_SCROLL_SENSITIVE</code>
* @param resultSetConcurrency one of the following <code>ResultSet</code> constants: <code>ResultSet.CONCUR_READ_ONLY</code>
* or <code>ResultSet.CONCUR_UPDATABLE</code>
* @param resultSetHoldability one of the following <code>ResultSet</code> constants: <code>ResultSet.HOLD_CURSORS_OVER_COMMIT</code>
* or <code>ResultSet.CLOSE_CURSORS_AT_COMMIT</code>
* @return a new <code>CallableStatement</code> object, containing the pre-compiled SQL statement, that will
* generate <code>ResultSet</code> objects with the given type, concurrency, and holdability
* @throws java.sql.SQLException if a database access error occurs, this method is called on a closed connection or
* the given parameters are not <code>ResultSet</code> constants indicating type,
* concurrency, and holdability
* @throws java.sql.SQLFeatureNotSupportedException
* if the JDBC driver does not support this method or this method is not supported for
* the specified result set type, result set holdability and result set concurrency.
* @see java.sql.ResultSet
* @since 1.4
*/
public CallableStatement prepareCall(final String sql,
final int resultSetType,
final int resultSetConcurrency,
final int resultSetHoldability) throws SQLException {
return prepareCall(sql);
}
/**
* Creates a default <code>PreparedStatement</code> object that has the capability to retrieve auto-generated keys.
* The given constant tells the driver whether it should make auto-generated keys available for retrieval. This
* parameter is ignored if the SQL statement is not an <code>INSERT</code> statement, or an SQL statement able to
* return auto-generated keys (the list of such statements is vendor-specific).
*
* <B>Note:</B> This method is optimized for handling parametric SQL statements that benefit from precompilation. If
* the driver supports precompilation, the method <code>prepareStatement</code> will send the statement to the
* database for precompilation. Some drivers may not support precompilation. In this case, the statement may not be
* sent to the database until the <code>PreparedStatement</code> object is executed. This has no direct effect on
* users; however, it does affect which methods throw certain SQLExceptions.
*
* Result sets created using the returned <code>PreparedStatement</code> object will by default be type
* <code>TYPE_FORWARD_ONLY</code> and have a concurrency level of <code>CONCUR_READ_ONLY</code>. The holdability of
* the created result sets can be determined by calling {@link #getHoldability}.
*
* @param sql an SQL statement that may contain one or more '?' IN parameter placeholders
* @param autoGeneratedKeys a flag indicating whether auto-generated keys should be returned; one of
* <code>Statement.RETURN_GENERATED_KEYS</code> or <code>Statement.NO_GENERATED_KEYS</code>
* @return a new <code>PreparedStatement</code> object, containing the pre-compiled SQL statement, that will have
* the capability of returning auto-generated keys
* @throws java.sql.SQLException if a database access error occurs, this method is called on a closed connection or
* the given parameter is not a <code>Statement</code> constant indicating whether
* auto-generated keys should be returned
* @throws java.sql.SQLFeatureNotSupportedException
* if the JDBC driver does not support this method with a constant of
* Statement.RETURN_GENERATED_KEYS
* @since 1.4
*/
public PreparedStatement prepareStatement(final String sql, final int autoGeneratedKeys) throws SQLException {
return prepareStatement(sql);
}
/**
* Creates a default <code>PreparedStatement</code> object capable of returning the auto-generated keys designated
* by the given array. This array contains the indexes of the columns in the target table that contain the
* auto-generated keys that should be made available. The driver will ignore the array if the SQL statement is not
* an <code>INSERT</code> statement, or an SQL statement able to return auto-generated keys (the list of such
* statements is vendor-specific).
*
* An SQL statement with or without IN parameters can be pre-compiled and stored in a <code>PreparedStatement</code>
* object. This object can then be used to efficiently execute this statement multiple times.
*
* <B>Note:</B> This method is optimized for handling parametric SQL statements that benefit from precompilation. If
* the driver supports precompilation, the method <code>prepareStatement</code> will send the statement to the
* database for precompilation. Some drivers may not support precompilation. In this case, the statement may not be
* sent to the database until the <code>PreparedStatement</code> object is executed. This has no direct effect on
* users; however, it does affect which methods throw certain SQLExceptions.
*
* Result sets created using the returned <code>PreparedStatement</code> object will by default be type
* <code>TYPE_FORWARD_ONLY</code> and have a concurrency level of <code>CONCUR_READ_ONLY</code>. The holdability of
* the created result sets can be determined by calling {@link #getHoldability}.
*
* @param sql an SQL statement that may contain one or more '?' IN parameter placeholders
* @param columnIndexes an array of column indexes indicating the columns that should be returned from the inserted
* row or rows
* @return a new <code>PreparedStatement</code> object, containing the pre-compiled statement, that is capable of
* returning the auto-generated keys designated by the given array of column indexes
* @throws java.sql.SQLException if a database access error occurs or this method is called on a closed connection
* @throws java.sql.SQLFeatureNotSupportedException
* if the JDBC driver does not support this method
* @since 1.4
*/
public PreparedStatement prepareStatement(final String sql, final int[] columnIndexes) throws SQLException {
return prepareStatement(sql);
}
/**
* Creates a default <code>PreparedStatement</code> object capable of returning the auto-generated keys designated
* by the given array. This array contains the names of the columns in the target table that contain the
* auto-generated keys that should be returned. The driver will ignore the array if the SQL statement is not an
* <code>INSERT</code> statement, or an SQL statement able to return auto-generated keys (the list of such
* statements is vendor-specific).
*
* An SQL statement with or without IN parameters can be pre-compiled and stored in a <code>PreparedStatement</code>
* object. This object can then be used to efficiently execute this statement multiple times.
*
* <B>Note:</B> This method is optimized for handling parametric SQL statements that benefit from precompilation. If
* the driver supports precompilation, the method <code>prepareStatement</code> will send the statement to the
* database for precompilation. Some drivers may not support precompilation. In this case, the statement may not be
* sent to the database until the <code>PreparedStatement</code> object is executed. This has no direct effect on
* users; however, it does affect which methods throw certain SQLExceptions.
*
* Result sets created using the returned <code>PreparedStatement</code> object will by default be type
* <code>TYPE_FORWARD_ONLY</code> and have a concurrency level of <code>CONCUR_READ_ONLY</code>. The holdability of
* the created result sets can be determined by calling {@link #getHoldability}.
*
* @param sql an SQL statement that may contain one or more '?' IN parameter placeholders
* @param columnNames an array of column names indicating the columns that should be returned from the inserted row
* or rows
* @return a new <code>PreparedStatement</code> object, containing the pre-compiled statement, that is capable of
* returning the auto-generated keys designated by the given array of column names
* @throws java.sql.SQLException if a database access error occurs or this method is called on a closed connection
* @throws java.sql.SQLFeatureNotSupportedException
* if the JDBC driver does not support this method
* @since 1.4
*/
public PreparedStatement prepareStatement(final String sql, final String[] columnNames) throws SQLException {
return prepareStatement(sql);
}
/**
* Constructs an object that implements the <code>Clob</code> interface. The object returned initially contains no
* data. The <code>setAsciiStream</code>, <code>setCharacterStream</code> and <code>setString</code> methods of the
* <code>Clob</code> interface may be used to add data to the <code>Clob</code>.
*
* @return An object that implements the <code>Clob</code> interface
* @throws java.sql.SQLException if an object that implements the <code>Clob</code> interface can not be
* constructed, this method is called on a closed connection or a database access
* error occurs.
* @throws java.sql.SQLFeatureNotSupportedException
* if the JDBC driver does not support this data type
* @since 1.6
*/
public Clob createClob() throws SQLException {
return new MySQLClob();
}
/**
* Constructs an object that implements the <code>Blob</code> interface. The object returned initially contains no
* data. The <code>setBinaryStream</code> and <code>setBytes</code> methods of the <code>Blob</code> interface may
* be used to add data to the <code>Blob</code>.
*
* @return An object that implements the <code>Blob</code> interface
* @throws java.sql.SQLException if an object that implements the <code>Blob</code> interface can not be
* constructed, this method is called on a closed connection or a database access
* error occurs.
* @throws java.sql.SQLFeatureNotSupportedException
* if the JDBC driver does not support this data type
* @since 1.6
*/
public Blob createBlob() throws SQLException {
return new MySQLBlob();
}
/**
* Constructs an object that implements the <code>NClob</code> interface. The object returned initially contains no
* data. The <code>setAsciiStream</code>, <code>setCharacterStream</code> and <code>setString</code> methods of the
* <code>NClob</code> interface may be used to add data to the <code>NClob</code>.
*
* @return An object that implements the <code>NClob</code> interface
* @throws java.sql.SQLException if an object that implements the <code>NClob</code> interface can not be
* constructed, this method is called on a closed connection or a database access
* error occurs.
* @throws java.sql.SQLFeatureNotSupportedException
* if the JDBC driver does not support this data type
* @since 1.6
*/
public java.sql.NClob createNClob() throws SQLException {
return new MySQLClob();
}
/**
* Constructs an object that implements the <code>SQLXML</code> interface. The object returned initially contains no
* data. The <code>createXmlStreamWriter</code> object and <code>setString</code> method of the <code>SQLXML</code>
* interface may be used to add data to the <code>SQLXML</code> object.
*
* @return An object that implements the <code>SQLXML</code> interface
* @throws java.sql.SQLException if an object that implements the <code>SQLXML</code> interface can not be
* constructed, this method is called on a closed connection or a database access
* error occurs.