JDBC API是一個Java API,能夠訪問任何類型表列數據,特別是存儲在關係數據庫中的數據。JDBC表明Java數據庫鏈接。html
JDBC庫中所包含的API任務一般與數據庫使用:java
鏈接到數據庫mysql
建立SQL或MySQL語句sql
在數據庫中執行SQL或MySQL查詢數據庫
查看和修改記錄編程
學習JDBC,須要在如下兩個主題有必定的瞭解:數組
JAVA核心編程服務器
SQL或MySQL數據庫yii
請確認您已完成如下設置:curl
核心JAVA安裝
SQL 或 MySQL數據庫安裝
除上述者外,須要創建一個數據庫,爲本程測試項目使用。假設這是EMP,在同一個數據庫上建立表Employees。
參與創建一個JDBC應用程序,本教程中按六個步驟進行:
這須要你有軟件包包含了數據庫編程所需的JDBC類。大多數狀況下,使用import java.sql.* 就足夠了,以下所示:
//STEP 1. Import required packages import java.sql.*;
這須要初始化驅動程序,這樣就能夠打開與數據庫的通訊信道。如下是代碼片斷實現這一目標:
//STEP 2: Register JDBC driver Class.forName("com.mysql.jdbc.Driver");
這須要使用DriverManager.getConnection()方法來建立一個Connection對象,它表明一個物理鏈接的數據庫,以下所示:
//STEP 3: Open a connection // Database credentials static final String USER = "username"; static final String PASS = "password"; System.out.println("Connecting to database..."); conn = DriverManager.getConnection(DB_URL,USER,PASS);
這須要使用一個對象類型Statement或PreparedStatement構建,並提交一個SQL語句到數據庫。以下:
//STEP 4: Execute a query System.out.println("Creating statement..."); stmt = conn.createStatement(); String sql; sql = "SELECT id, first, last, age FROM Employees"; ResultSet rs = stmt.executeQuery(sql);
若是有一個SQL UPDATE,INSERT或DELETE語句,那麼須要下面的代碼片斷:
//STEP 4: Execute a query System.out.println("Creating statement..."); stmt = conn.createStatement(); String sql; sql = "DELETE FROM Employees"; ResultSet rs = stmt.executeUpdate(sql);
這一步是必需的狀況下,從數據庫中獲取數據。可使用適當的ResultSet.getXXX()方法來檢索的數據結果以下:
//STEP 5: Extract data from result set while(rs.next()){ //Retrieve by column name int id = rs.getInt("id"); int age = rs.getInt("age"); String first = rs.getString("first"); String last = rs.getString("last"); //Display values System.out.print("ID: " + id); System.out.print(", Age: " + age); System.out.print(", First: " + first); System.out.println(", Last: " + last); }
應該明確地關閉全部的數據庫資源,對依賴於JVM的垃圾收集以下:
//STEP 6: Clean-up environment rs.close(); stmt.close(); conn.close();
基於上面的步驟,咱們能夠有如下綜合示例代碼,咱們能夠用它做爲模板而寫JDBC代碼:
此示例代碼已被寫入基於對環境和數據庫環境一章中設置完成。
//STEP 1. Import required packages import java.sql.*; public class FirstExample { // JDBC driver name and database URL static final String JDBC_DRIVER = "com.mysql.jdbc.Driver"; static final String DB_URL = "jdbc:mysql://localhost/EMP"; // Database credentials static final String USER = "username"; static final String PASS = "password"; public static void main(String[] args) { Connection conn = null; Statement stmt = null; try{ //STEP 2: Register JDBC driver Class.forName("com.mysql.jdbc.Driver"); //STEP 3: Open a connection System.out.println("Connecting to database..."); conn = DriverManager.getConnection(DB_URL,USER,PASS); //STEP 4: Execute a query System.out.println("Creating statement..."); stmt = conn.createStatement(); String sql; sql = "SELECT id, first, last, age FROM Employees"; ResultSet rs = stmt.executeQuery(sql); //STEP 5: Extract data from result set while(rs.next()){ //Retrieve by column name int id = rs.getInt("id"); int age = rs.getInt("age"); String first = rs.getString("first"); String last = rs.getString("last"); //Display values System.out.print("ID: " + id); System.out.print(", Age: " + age); System.out.print(", First: " + first); System.out.println(", Last: " + last); } //STEP 6: Clean-up environment rs.close(); stmt.close(); conn.close(); }catch(SQLException se){ //Handle errors for JDBC se.printStackTrace(); }catch(Exception e){ //Handle errors for Class.forName e.printStackTrace(); }finally{ //finally block used to close resources try{ if(stmt!=null) stmt.close(); }catch(SQLException se2){ }// nothing we can do try{ if(conn!=null) conn.close(); }catch(SQLException se){ se.printStackTrace(); }//end finally try }//end try System.out.println("Goodbye!"); }//end main }//end FirstExample - by www.yiibai.com
如今讓咱們來編譯上面的例子以下:
C:\>javac FirstExample.java C:\>
當你運行FirstExample的,它會產生如下結果:
C:\>java FirstExample Connecting to database... Creating statement... ID: 100, Age: 18, First: Zara, Last: Ali ID: 101, Age: 25, First: Mahnaz, Last: Fatma ID: 102, Age: 30, First: Zaid, Last: Khan ID: 103, Age: 28, First: Sumit, Last: Mittal C:\>
一個SQLException既能夠發生在驅動程序和數據庫。當這樣的異常時,SQLException類型的對象將被傳遞到catch子句。
經過SQLException對象有如下幾種方法可用於獲取更多的關於異常的信息:
方法 | 描述 |
---|---|
getErrorCode() | 獲取與異常關聯的錯誤號。 |
getMessage() | 獲取的JDBC驅動程序的錯誤處理錯誤消息的驅動程序,或獲取Oracle錯誤號和消息的數據庫錯誤。 |
getSQLState() | 獲取XOPEN SQLSTATE字符串。對於JDBC驅動程序錯誤,沒有有用的信息,從該方法返回。對於一個數據庫錯誤,五位的XOPEN SQLSTATE代碼返回。這種方法能夠返回null。 |
getNextException() | 獲取異常鏈中的下一個Exception對象。 |
printStackTrace() | 打印當前的異常,或可拋出,並回溯到標準錯誤流。 |
printStackTrace(PrintStream s) | 打印此拋出對象及其回溯到指定的打印流。 |
printStackTrace(PrintWriter w) | 打印此拋出對象及其回溯您指定打印做家。 |
經過利用從Exception對象提供的信息,能夠捕獲一個異常,並適當地繼續運行程序。這是一個try塊中的通常形式:
try { // Your risky code goes between these curly braces!!! } catch(Exception ex) { // Your exception handling code goes between these // curly braces, similar to the exception clause // in a PL/SQL block. } finally { // Your must-always-be-executed code goes between these // curly braces. Like closing database connection. }
下表總結了默認的JDBC數據類型的Java數據類型轉換,當調用PreparedStatement或CallableStatement對象的setXXX()方法,或ResultSet.updateXXX()方法。
SQL | JDBC/Java | setXXX | updateXXX |
---|---|---|---|
VARCHAR | java.lang.String | setString | updateString |
CHAR | java.lang.String | setString | updateString |
LONGVARCHAR | java.lang.String | setString | updateString |
BIT | boolean | setBoolean | updateBoolean |
NUMERIC | java.math.BigDecimal | setBigDecimal | updateBigDecimal |
TINYINT | byte | setByte | updateByte |
SMALLINT | short | setShort | updateShort |
INTEGER | int | setInt | updateInt |
BIGINT | long | setLong | updateLong |
REAL | float | setFloat | updateFloat |
FLOAT | float | setFloat | updateFloat |
DOUBLE | double | setDouble | updateDouble |
VARBINARY | byte[ ] | setBytes | updateBytes |
BINARY | byte[ ] | setBytes | updateBytes |
DATE | java.sql.Date | setDate | updateDate |
TIME | java.sql.Time | setTime | updateTime |
TIMESTAMP | java.sql.Timestamp | setTimestamp | updateTimestamp |
CLOB | java.sql.Clob | setClob | updateClob |
BLOB | java.sql.Blob | setBlob | updateBlob |
ARRAY | java.sql.Array | setARRAY | updateARRAY |
REF | java.sql.Ref | SetRef | updateRef |
STRUCT | java.sql.Struct | SetStruct | updateStruct |
JDBC3.0的加強支持BLOB,CLOB,ARRAY,REF數據類型。的ResultSet對象UPDATEBLOB(),updateCLOB(),updateArray()和updateRef()方法,使您能夠在服務器上直接操做相應的數據。
setXXX()和updateXXX()方法,能夠轉換成特定的Java類型到特定的JDBC數據類型。setObject()和updateObject()方法,幾乎全部的Java類型映射到JDBC數據類型。
ResultSet對象提供相應的getXXX()方法爲每一個數據類型來檢索列值。每一種方法,可使用與列名或由它的序號位置。
SQL | JDBC/Java | setXXX | getXXX |
---|---|---|---|
VARCHAR | java.lang.String | setString | getString |
CHAR | java.lang.String | setString | getString |
LONGVARCHAR | java.lang.String | setString | getString |
BIT | boolean | setBoolean | getBoolean |
NUMERIC | java.math.BigDecimal | setBigDecimal | getBigDecimal |
TINYINT | byte | setByte | getByte |
SMALLINT | short | setShort | getShort |
INTEGER | int | setInt | getInt |
BIGINT | long | setLong | getLong |
REAL | float | setFloat | getFloat |
FLOAT | float | setFloat | getFloat |
DOUBLE | double | setDouble | getDouble |
VARBINARY | byte[ ] | setBytes | getBytes |
BINARY | byte[ ] | setBytes | getBytes |
DATE | java.sql.Date | setDate | getDate |
TIME | java.sql.Time | setTime | getTime |
TIMESTAMP | java.sql.Timestamp | setTimestamp | getTimestamp |
CLOB | java.sql.Clob | setClob | getClob |
BLOB | java.sql.Blob | setBlob | getBlob |
ARRAY | java.sql.Array | setARRAY | getARRAY |
REF | java.sql.Ref | SetRef | getRef |
STRUCT | java.sql.Struct | SetStruct | getStruct |
批處理容許一個批處理組相關的SQL語句,並將其提交的一個調用到數據庫。
當幾個SQL語句一次發送到數據庫中,能夠減小通訊開銷,從而提升性能。
JDBC驅動程序不支持此功能。您應該使用DatabaseMetaData.supportsBatchUpdates()方法來肯定目標數據庫支持批量更新處理。若是你的JDBC驅動程序支持此功能,則該方法返回true。
addBatch()方法的聲明,PreparedStatement和CallableStatementis用於添加單個語句的批處理。 executeBatch()將開始執行的全部語句組合到一塊兒。
executeBatch()將返回一個整數數組,每一個數組元素的表示爲相應的更新語句的更新計數。
能夠添加語句進行批處理,能夠clearBatch()方法刪除它們。此方法將刪除addBatch()方法添加的全部語句。可是,你不能有選擇性地選擇語句來刪除。
PreparedStatement對象有能力使用提供參數數據的輸入和輸出流。這使您能夠將整個文件到數據庫中,可容納較大的值,如CLOB和BLOB數據類型的列。
有下列方法可用於流數據:
setAsciiStream(): 此方法用於提供大的ASCII值。
setCharacterStream(): 此方法用於提供大的UNICODE值。
setBinaryStream(): 使用此方法,以提供大的二進制值。
setXXXStream()方法須要一個額外的參數,文件大小,除了參數佔位符。此參數通知應發送多少數據的數據庫,使用流的驅動程序。
對於一個詳細的關於全部這些概念,須要去經過學習完整的教程。
(原文地址:http://www.yiibai.com/jdbc/jdbc_quick_guide.html)