Mimer JDBC Driver Guide April 2020 Mimer JDBC, Driver Guide © Copyright Mimer Information Technology AB. The contents of this manual may be printed in limited quantities for use at a Mimer SQL installation site. No parts of the manual may be reproduced for sale to a third party. Information in this document is subject to change without notice. All registered names, product names and trademarks of other companies mentioned in this documentation are used for identification purposes only and are acknowledged as the property of the respective company. Companies, names and data used in examples herein are fictitious unless otherwise noted. Produced and published by Mimer Information Technology AB, Uppsala, Sweden. P.O. Box 1713, SE-751 47 Uppsala, Sweden. Tel +46(0)18-780 92 00. Mimer SQL Web Sites: https://developer.mimer.com https://www.mimer.com Mimer JDBC i Driver Guide Contents Chapter 1 Introduction .......................................................................................1 About this Guide ............................................................................................................1 Definitions, Terms and Trademarks ............................................................................... 1 Requirements .................................................................................................................2 Environment ...................................................................................................................3 Logging...........................................................................................................................3 Chapter 2 Using the Mimer JDBC Driver.......................................................... 5 Loading a Driver.............................................................................................................5 Connecting the Traditional Way ...................................................................................6 Connecting With URL....................................................................................................... 7 URL Syntax................................................................................................................. 7 Connecting the J2EE Way.............................................................................................9 Deploying Mimer JDBC in JNDI...................................................................................... 9 Deploying Mimer JDBC in a Connection Pool ............................................................ 10 Deploying Mimer JDBC in Distributed Transaction Environments........................... 10 Error Handling..............................................................................................................10 The Class SQLException............................................................................................... 11 The Class SQLWarning ................................................................................................. 11 Viewing Driver Characteristics ...................................................................................12 The mimcomm JNI library ...........................................................................................12 Java Program Examples .............................................................................................13 JDBC Application Example............................................................................................ 13 JDBC Application Example for J2EE............................................................................ 14 Using the Driver from Applets ....................................................................................... 15 Executing the Java Applet Example.......................................................................... 16 Chapter 3 Programming With JDBC ............................................................... 17 Examples in this Chapter ............................................................................................17 Transaction Processing ..............................................................................................17 JDBC Transactions......................................................................................................... 17 Auto-commit Mode.................................................................................................... 17 Manual-commit Mode................................................................................................ 18 ii Contents Setting the Transaction Isolation Level .................................................................... 19 Executing an SQL Statement ......................................................................................19 Using a Statement Object ............................................................................................. 19 Using a PreparedStatement Object............................................................................. 19 Using a CallableStatement Object............................................................................... 20 Batch Update Operations ............................................................................................20 Enhancing Performance................................................................................................ 21 Result Set Processing .................................................................................................22 Scrolling in Result Sets.................................................................................................. 23 Positioning the Cursor.............................................................................................. 23 Result Set Capabilities .................................................................................................. 24 Holdable cursors ............................................................................................................ 24 Updating Data...............................................................................................................24 User-Defined Types......................................................................................................25 Default Type Mapping.................................................................................................... 25 Custom Java Classes With Type Mapping................................................................. 26 Programming Considerations.....................................................................................27 Interval Data.................................................................................................................... 27 Closing Objects .............................................................................................................. 27 Increasing Performance ................................................................................................ 27 Appendix A Change History ............................................................................ 29 New Functions..............................................................................................................29 New Functions in 3.39................................................................................................... 29 New Functions in 3.38................................................................................................... 29 New Functions in 3.35................................................................................................... 29 New Functions in 3.31................................................................................................... 30 New Functions in 3.30................................................................................................... 30 New Functions in 3.28................................................................................................... 30 New Functions in 3.26................................................................................................... 31 New Functions in 3.25................................................................................................... 31 New Functions in 3.24 and 2.24................................................................................... 31 New Functions in 3.18, 2.18 and 1.18......................................................................... 32 New Functions in 3.17, 2.17 and 1.17......................................................................... 32 New Functions in 3.16, 2.16 and 1.16......................................................................... 32 New Functions in 3.15................................................................................................... 32 New Functions in 2.9 ..................................................................................................... 32 New Functions in 2.8 ..................................................................................................... 32 New Functions in 2.7 ..................................................................................................... 32 New Functions in 2.5 ..................................................................................................... 32 New Functions in 2.4 ..................................................................................................... 33 New Functions in 2.3 ..................................................................................................... 33 New Functions in 2.0 ....................................................................................................