Jaybird 2.1 JDBC driver Java Programmer's Manual - Firebird

More documents

Recommendations

Info

• The JCA layer represents the heart of the driver. Here all connection and transaction management happens. Additionally this layer adapts the GDS API and proxies the calls to the GDS implementation. id Architecture ManagedConnection «delegate» JDBC JCA GDS • The JDBC layer is an implementation of the JDBC specification. • The Pool component represents implementation of ConnectionPoolDataSource, DataSource and XADataSource interfaces from the JDBC 2.0 Optional Package. The pool implementation uses ManagedConnectionFactory to create physical connections to the database. • The Manager component represents a JMX 1.0 compatible implementation that uses The Services API to manage the database and the server itself. Currently only calls to create and drop database are available, but in the future a full range of services will be made public: database backup/restore, user management, statistics gathering, etc. Supported Servers Jaybird 2.1 supports all current Firebird servers, however no support for the optimized wire protocol from the Firebird 2.1 is being implemented. Jaybird versions 2.x in current distribution won't work with InterBase and Yaffil servers, however the compatibility might be restored in the future. Jaybird supports the following specifications: ManagedConnectionFactory «delegate» Type 4 Type 2 Illustration 1.1 Jaybird internal structure. Pool JMX Manager Supported Specifications Chapter 1. Introduction 6
Specification Details JDBC 3.0 Driver passes the complete JDBC compatibility test suite, though some features are not implemented. It is not officially JDBC compliant, because of the high certification costs. JDBC 2.0 Optional Package (formerly Standard Extension API) Jaybird provides an implementation of following interfaces from javax.sql.* package: ● The ConnectionPoolDataSource implementation provides connection and prepared statement pooling. ● The DataSource implementation provides seamless integration with major web and application servers. ● The XADataSource implementation provides means to use driver in distributed transactions. JCA 1.0 Jaybird provides an implementation of javax.resource.spi.ManagedConnectionFactory and related interfaces. CCI interfaces are not supported. JTA 1.0.1 The driver provides implementation of the javax.transaction.xa.XAResource interface via the JCA framework and a javax.sql.XADataSource implementation. JAAS 1.0 JMX 1.2 Jaybird provides an MBean that allows creating and dropping databases via JMX agent. Distribution package Jaybird driver has compile-time and run-time dependencies to JCA 1.0, JTA 1.0.1, JAAS 1.0 and JDBC 2.0 Optional Package. Additionally, if Log4J classes are found in the class path, it is possible to enable extensive logging inside the driver. Following file groups can be found in distribution package: File name Description jaybird-2.1.6.jar An archive containing the JDBC driver, the JCA connection manager, the Services API and event management classes. jaybird-full-2.1.6.jar Same as above but also the connection pooling classes. jaybird21.dll Precompiled version of the JNI library for Type 2 and Embedded Server drivers for 32-bit Windows platform. libjaybird21.so Precompiled version of the JNI library for Type 2 and Embedded Server drivers for 32-bit Linux platforms. Quality Assurance The Jaybird team uses JUnit test cases to assure the quality of the released driver. Also during development unit tests are extensively used. It is not allowed to commit a code to the CVS until it passes all existing unit tests. Also each Chapter 1. Introduction 7
Page 1 and 2: Jaybird 2.1 JDBC driver Java Progra
Page 3 and 4: Table Of Contents Table of Contents
Page 5: 1. Introduction Chapter 1. Jaybird
Page 9 and 10: 2. Obtaining a connection Chapter 2
Page 11 and 12: uns. On Windows it must include the
Page 13 and 14: this purpose showed on Illustration
Page 15 and 16: jdbc:firebirdsql:embedded: jdbc:fir
Page 17 and 18: will close the physical connection
Page 19 and 20: Illustration 2.10 Shows how to acce
Page 21 and 22: Chapter 2. Obtaining a connection 2
Page 23 and 24: checking the error code which is se
Page 25 and 26: application will always use the min
Page 27 and 28: Constant name Constant value SQL_ST
Page 29 and 30: collation. isc_dsql_command_err "In
Page 31 and 32: 4. Executing statements Chapter 4.
Page 33 and 34: It is also allowed to use the same
Page 35 and 36: Statement behind the scenes The exa
Page 37 and 38: dynamics” chapter, it allows to g
Page 39 and 40: code. So, the refactoring on the Il
Page 41 and 42: Therefore, if structure modificatio
Page 43 and 44: CREATE PROCEDURE factorial( max_val
Page 45 and 46: PreparedStatement stmt = connection
Page 47 and 48: import java.sql.*; import org.fireb
Page 49 and 50: Using batch updates with a prepared
Page 51 and 52: 5. Working with result sets Chapter
Page 53 and 54: Note, current implementation does n
Page 55 and 56: Statement selectStmt = connection.c
Page 57 and 58:
1 2 3 4 Connection connection = ...
Page 59 and 60:
1 2 3 Statement selectStmt = connec
Page 61 and 62:
ead-committed mode sees all committ
Page 63 and 64:
FirebirdConnection fbConnection = (
Page 65 and 66:
Read-committed Concurrency Consiste
Page 67 and 68:
7. Working with Services Chapter 7.
Page 69 and 70:
e created, use addBackupPath(String
Page 71 and 72:
specified via the properties of thi
Page 73 and 74:
Constant Description RESTORE_ONE_AT
Page 75 and 76:
The database shutdown is performed
Page 77 and 78:
gfix -mend command. After this oper
Page 79 and 80:
Method Description ● PAGE_FILL_RE
Page 81 and 82:
It can also happen that multiple tr
Page 83 and 84:
EventManager eventManager = new FBE
Page 85 and 86:
DPB Parameter and its Alias(es) isc
Page 87 and 88:
JDBC Type Firebird Type Java Object
Page 89 and 90:
This group of properties are specif
Page 91 and 92:
specialized use, because there's no
Page 93 and 94:
Firebird uses following algorithm w
Page 95 and 96:
It is clear that the conversion usi
Page 97 and 98:
Firebird encoding Java encoding Siz
Page 99 and 100:
JDBC Jaybird built-in UDF mode Nume
Page 101 and 102:
JDBC Jaybird REPLACE(strin g1, stri
Page 103:
JDBC Jaybird (interval, timestamp1,
show all

Jaybird 2.1 JDBC driver Java Programmer's Manual - Firebird

Create successful ePaper yourself

Delete template?

Save as template?