ORACLE自帶的JDBC源代碼解析

約定：
        1、如果出現 java.lang.UnsatisfiedLinkError: do_open，則你需要把 DriverManager.getConnection() 方法的 url 修改成 jdbc:oracle:thin:@127.0.0.1:1521:oradb，具體原因未知；
        2、如果出現 java.sql.SQLException: 不支持的字符集: oracle-character-set-852，則你需要把 nls_charset12.zip加入你的工程中(此文件與 classes12.zip 同目錄)；
        下面我就把文件夾\samples\oci8\object-samples下的文件做一個詳細的功能描述：
        1、PersonObject.java
        這個例子演示了表 people 中存在ADT字段 empid，其類型為 PERSON，而且類型 PERSON中存在ADT字段 home，其類型為 ADDRESS，而且類型 ADDRESS是一個ADT。
        如果使用常規SQL語句，其插入語句與在sql/plus中無異，即：使用構造函數嵌套構造。
        另有一種方法，使用 STRUCT 的構造函數 STRUCT(StructDescriptor, Connection, Object[]) 構造出一個STRUCT對象，即一個ADT對象。同時，如果有嵌套則需要嵌套構造ADT對象。最后通過 PreparedStatement的 setObject方法指定ADT對象即可。
        讀取數據時則采用與上述方法相逆的辦法：如果是簡單類型，則直接讀??；如果是ADT，則使用ResultSet的getObject()，再強制轉換成STRUCT，然后調用STRUCT的getAttributes()方法取得 Object[] 類型數據，如是遞歸。
        2、SQLDataExample.java與EmployeeObj.java
        此例與1中相似，也是對ADT的處理，不同的是類型沒有嵌套。
        比較而言，2比1的代碼簡潔了很多，不過也是付出了代價：為類型 EMPLOYEE 抽象出一個類EmployeeObj，它實現了SQLData接口，并重寫了三個方法(必須的)。
        前臺的調用比1中的第二種方法簡潔了很多，只需要直接使用PreparedStatement的 setObject方法指定ADT對象即可(不過需要指定其類型為OracleTypes.STRUCT)。讀取時也可直接使用OracleResultSet的getObject()并強制轉換成EmployeeObj對象即可。
        真可謂是：有得必有失!!
        另，此例中有幾處需要注意的地方：
        2.1 EmployeeObj.java中的 import oracle.jdbc2.*; 改成 import oracle.jdbc.*; 原因未知；
        2.2 SQLDataExample.java 中的 Dictionary map = conn.getTypeMap(); 改成 java.util.Map map = conn.getTypeMap(); 原因：NOTE:  This class(指的是Dictionary) is obsolete. New implementations should implement the Map interface, rather than extendidng this class.(來源：javadoc)；
        2.3 SQLDataExample.java 中的 pstmt.executeQuery(); 改成 pstmt.executeUpdate(); 更合理些，因為這是更新而非查詢(不改也不會影響功能，只是建議)；
        3、CustomDatumExample.java與Employee.java
        此例與2完全相同。不同的是采用了另外一種抽象技術，并實現了接口CustomDatum 與 CustomDatumFactory，并重寫了二個方法toDatum()與create()。在前臺訪問數據時亦有少許不同：采用了OracleResultSet的getCustomDatum()方法并把它強制轉換成Employee。從外觀上看，2中SQLData接口存在于 java.sql.* 包中；而接口CustomDatum 與 CustomDatumFactory則存在于oracle.sql.*包中，可以認為是Oracle公司對自己產品的專門實現?；蛟S有更高的性能、更小的開銷？不過3不如2來得直接，個人認為。
        4、ArrayExample.java
        從文件名可看出，此示例演示的是VARRAY類型。
        同1，插入亦有兩種方法。一種可直接使用SQL；另外，可使用OraclePreparedStatement的setARRAY方法，構造ARRAY的過程與構造 STRUCT 無異。數據的讀取過程與此相反：先使用OracleResultSet的getARRAY()方法取得ARRAY對象，再調用此對象的getArray()方法并強制轉換成對象數組，然后對此數組操作即可。
        5、PersonRef.java與StudentRef.java
        不知是不是ORACLE與我們開玩笑，這兩個文件除了類名不同外，其余一切相同。
        這個例子給我們演示的是對象表的概念。對象表的插入與普通表沒有任何不同，數據的讀取首先體現在其SQL上，需要使用REF函數，然后調用ResultSet的getObject()方法并強制轉換成REF對象，再利用此對象的getValue()并轉換成STRUCT對象，再利用此對象 的getAttributes()方法得到Object[]，然后對此數組操作即可。
        6、RefClient.java與GenREF.java
        This sample demonstrates using REF over two different Sessions.
        類GenREF用來封裝REF對象所指向的類型及其二進制內容。程序先Materialize into GenREF，然后在另一會話中De-materialize REF from GenREF，下面就與處理REF相同：利用此對象的getValue()并轉換成STRUCT對象，再利用此對象 的getAttributes()方法得到Object[]，然后對此數組操作即可。
        7、FileExample.java與PLSQL_FileExample.java
        此示例使用 BFILE 數據類型，Contains a locator(定位器) to a large binary file stored outside the database。數據插入時需要使用函數 bfilename，這個函數需要目錄對象，此對象需要使用create directory mydir來創建(此用戶需具有CREATE ANY DIRECTORY系統權限)。我曾在這個地方有個大教訓：按著步驟做，可在讀取時總是提示我沒有此目錄!!最后，我把BFILENAME函數的第一個參數(即目錄名)大寫就好了。原因：目錄名在函數中區分大小寫，雖然我們創建它時用的是小寫，可到了數據庫中后就自動變成了大寫。
        讀取BFILE類型的數據時，首先通過其getBinaryStream()方法得到二進制的輸入流，然后操作這個輸入流就可以了。The limitation is your imagination。
        PLSQL_FileExample.java實現的功能與上述的相同，只不過所有針對BFILE的操作都是通過調用pl/sql匿名塊來完成的，并使用了OracleCallableStatement。如果沒有必要，使用前者即可。
        8、LobExample.java與PLSQL_LobExample.java
        此示例使用了CLOB和BLOB數據類型。
        插入數據時，需要分別通過getBinaryOutputStream()和getCharacterOutputStream()得到二進制輸出流和字符輸出流，然后就是針對此輸出流的操作了，與傳統的 java I/O 相同。
        讀取數據時，需要分別通過getBinaryStream()和getCharacterStream()得到二進制輸入流和字符輸入流，然后就是針對此輸入流的操作了，與傳統的 java I/O 相同。
        PLSQL_LobExample.java實現的功能與上述的相同，只不過所有針對CLOB和BLOB的操作都是通過調用pl/sql匿名塊來完成的，并使用了OracleCallableStatement。如果沒有必要，使用前者即可。
    
        注：7、8的第二個示例中均使用到了dbms_lob程序包。 　　

原文轉自：http://www.kjueaiud.com