JDBC获取和操纵Oracle集合的方法

上周需要在ibatis里调用oracle的一个存储过程,这个存储过程有一个参数是index table,需要实现TypeHandler或者TypeHandlerCallback。上网查g.cn一下,发现没有多少文章介绍,只有少数不全的,倒是有一篇鬼佬写的,比较详细,但只介绍到nested table的情况。Oracle里面三种集合类型,分别是variable array、nested table、index table,前两种已经有例子,但index table呢,如何实现?这让挺伤脑筋的!很自然的想到,看JDBC规范,发现没有相应扩展类型的介绍。想想,各大数据库厂商,都应该是有自己的JDBC实现和使用文档的。于是,上Oracle官网,下了好几篇文档。于是,在JDBC 3.0和4.0规范,Oracle8i、Oracle9i和Oracle10g的JDBC开发指引文档下,总算搞清楚了。既然费劲找到原因了,不写篇东西记下,对不起自己!加上年纪大了,记性不好,记下以后好翻查,而且自己一直说想写写技术文章的,种种原因,导致我这么多废话的记下这篇东西。
     首先,你如果是使用JDK6.0的话,那么你很幸运。JDK 6.0支持JDBC 4.0,这让你在这个问题面前,不用多几条白头发。如果是JDK5.0或者之前的版本,像我公司使用的是1.4,那么你就纠结了,需要使用Oracle的JDBC扩展去实现,像index table这种情况,还要依赖于你使用的Oracle JDBC Driver。相信很多时候,我们都是纠结的。当然,可能还有其他方法处理,因为我自己本身这类数据库应用开发经验很少。
     1. 通过Oracle的JDBC扩展实现获取和操纵Oracle集合
     不管是variable array或者nested table,在Java对应的实现,都是为JDBC里的Array类型,这两种类型后面补充。要注意,只能处理命名的集合类型。
     1.1确定你使用的Oracle数据库的版本
     你的数据库版本决定你能否操纵的集合类型。在Oracle8i的文档里,只有对Array类型进行说明,标题为“Working with Arrays”,显示没有集合这个概念。而Oracle9i的文档是,有专门的“Working with Oracle Collections”。
当然,我没有细看,文档查阅的也有限。在有限的了解下,得出只有Oracle9i以上的情况下,才有可能对index table类型支持。
     1.2其次是Driver的版本
     必须是JDBC OCI Driver才能支持。这部分文档在JDBC OCI Extensions里有介绍。支持常用的PL SQL的整数和字符串类型,类型列表文档也有列出。
     1.3使用OCI Driver下内置方法
     前面第1、2点满足后,使用OraclePreparedStatement和OracleCallableStatement内置方法支持,如下:
    

Java代码 复制代码  收藏代码
  1. <SPAN style="FONT-SIZE: small">setPlsqlIndexTable()   
  2. registerIndexTableOutParameter()   
  3. getOraclePlsqlIndexTable()   
  4. getPlsqlIndexTable()</SPAN>  

 

    把文档里的例子贴出来,看看也大概知道怎么使用。
    1.3.1 对于IN参数

    

Java代码 复制代码  收藏代码
  1. <SPAN style="FONT-SIZE: small">// Prepare the statement  
  2. OracleCallableStatement procin = (OracleCallableStatement)   
  3. conn.prepareCall ("begin procin (?); end;");   
  4. // index-by table bind value   
  5. int[] values = { 123 };   
  6. // maximum length of the index-by table bind value. This  
  7. // value defines the maximum possible "currentLen" for batch  
  8. // updates. For standalone binds, "maxLen" should be the  
  9. // same as "currentLen".   
  10. int maxLen = values.length;   
  11. // actual size of the index-by table bind value  
  12. int currentLen = values.length;   
  13. // index-by table element type   
  14. int elemSqlType = OracleTypes.NUMBER;   
  15. // index-by table element length in case the element type  
  16. // is CHAR, VARCHAR or RAW. This value is ignored for other  
  17. // types.   
  18. int elemMaxLen = 0;   
  19. // set the value   
  20. procin.setPlsqlIndexTable (1, values,   
  21. maxLen, currentLen,   
  22. elemSqlType, elemMaxLen);   
  23. // execute the call   
  24. procin.execute ();</SPAN>  

 
    1.3.2 对于OUT参数

    

Java代码 复制代码  收藏代码
  1. <SPAN style="FONT-SIZE: small">// maximum length of the index-by table value. This  
  2. // value defines the maximum table size to be returned.  
  3. int maxLen = 10;   
  4. // index-by table element type   
  5. int elemSqlType = OracleTypes.NUMBER;   
  6. // index-by table element length in case the element type  
  7. // is CHAR, VARCHAR or RAW. This value is ignored for other  
  8. // types   
  9. int elemMaxLen = 0;   
  10. // register the return value   
  11. funcnone.registerIndexTableOutParameter   
  12. (1, maxLen, elemSqlType, elemMaxLen);</SPAN>  

     
    1.3.3 获取OUT参数的值
    有三个方法能获取index table(OUT参数)中的值,如下:
   (1) Object getPlsqlIndexTable (int paramIndex)
    该方法返回Object类型,强制类型转换为JDBC默认对应的Java类型。

   

Java代码 复制代码  收藏代码
  1. <SPAN style="FONT-SIZE: small">// access the value using JDBC default mapping  
  2. BigDecimal[] values =   
  3. (BigDecimal[])funcnone.getPlsqlIndexTable (1);</SPAN>  

 
   (2) Datum[] getOraclePlsqlIndexTable (int paramIndex)
    该方法返回Oracel JDBC的类型,oracle.sql.Datum,使用该类获取相应类型的值。

   

Java代码 复制代码  收藏代码
  1. <SPAN style="FONT-SIZE: small">// access the value using Oracle JDBC mapping  
  2. Datum[] outvalues = funcnone.getOraclePlsqlIndexTable (1);   
  3. // print the elements   
  4. for (int i=0; i<outvalues.length; i++)   
  5. System.out.println (outvalues[i].intValue());</SPAN>  

 
   (3) Object getPlsqlIndexTable (int paramIndex, Class primitiveType)
    该方法要指定对应的Java类型。

   

Java代码 复制代码  收藏代码
  1. <SPAN style="FONT-SIZE: small">// access the value as a Java primitive array.  
  2. int[] values = (int[])   
  3. funcnone.getPlsqlIndexTable (1, java.lang.Integer.TYPE);</SPAN>  

 
    2.  补充:variable array、nested table的操纵方法
    2.1 创建oracle.sql.ARRAY对象
    首先,需要 创建oracle.sql.ArrayDescriptor对象,该类型是用来描述Array类型的,在构造函数中需要指名类型名称。

    

Java代码 复制代码  收藏代码
  1. <SPAN style="FONT-SIZE: small">ArrayDescriptor arraydesc = ArrayDescriptor.createDescriptor   
  2. (sql_type_name, connection);</SPAN>  

 
    sql_type_name指定使用集合类型,connection使用当前连接。
    接着,就可以使用这个ArrayDescriptor对象,来创建对应的oracle.sql.ARRAY对象。

   

Java代码 复制代码  收藏代码
  1. <SPAN style="FONT-SIZE: small">ARRAY array = new ARRAY(arraydesc, connection, elements);</SPAN>  

 
    elements指定集合包含的值,可以是Java基本类型或者对象数组。

    直接看文档的示例,可能更清楚,如下。

   

Java代码 复制代码  收藏代码
  1. <SPAN style="FONT-SIZE: small">Connection conn = ...; // make a JDBC connection  
  2. // create the collection types   
  3. Statement stmt = conn.createStatement ();   
  4. stmt.execute ("CREATE TYPE varray1 AS VARRAY(10) OF NUMBER(12, 2)"); // one  
  5. // layer   
  6. stmt.execute ("CREATE TYPE varray2 AS VARRAY(10) OF varray1"); // two layers  
  7. stmt.execute ("CREATE TYPE varray3 AS VARRAY(10) OF varray2"); // three layers  
  8. stmt.execute ("CREATE TABLE tab2 (col1 index, col2 value)");   
  9. stmt.close ();   
  10. // obtain a type descriptor of "SCOTT.VARRAY3"  
  11. ArrayDescriptor desc = ArrayDescriptor.createDescriptor("SCOTT.VARRAY3", conn);   
  12. // prepare the multi level collection elements as a nested Java array  
  13. int[][][] elems = { {{1}, {12}}, {{2}, {23}}, {{3}, {34}} };   
  14. // create the ARRAY by calling the constructor  
  15. ARRAY array3 = new ARRAY (desc, conn, elems);   
  16. // some operations   
  17. ...   
  18. // close the database connection   
  19. conn.close();</SPAN>  

 
    2.2 获取Array对象的值
    主要有三个方法

   

Java代码 复制代码  收藏代码
  1. <SPAN style="FONT-SIZE: small">getArray()   
  2. getOracleArray()   
  3. getResultSet()</SPAN>  

 
    不用多说,直接上文档示例代码。

   

Java代码 复制代码  收藏代码
  1. <SPAN style="FONT-SIZE: small">stmt.execute ("CREATE TYPE num_varray AS VARRAY(10) OF NUMBER(12, 2)");   
  2. stmt.execute ("CREATE TABLE varray_table (col1 num_varray)");   
  3. stmt.execute ("INSERT INTO varray_table VALUES (num_varray(100, 200))");   
  4. ResultSet rs = stmt.executeQuery("SELECT * FROM varray_table");   
  5. ARRAY my_array = ((OracleResultSet)rs).getARRAY(1);   
  6. // return the SQL type names, integer codes,  
  7. // and lengths of the columns   
  8. System.out.println ("Array is of type " + array.getSQLTypeName());   
  9. System.out.println ("Array element is of typecode " + array.getBaseType());   
  10. System.out.println ("Array is of length " + array.length());   
  11. // get Array elements   
  12. BigDecimal[] values = (BigDecimal[]) my_array.getArray();   
  13. for (int i=0; i<values.length; i++)   
  14. {   
  15. BigDecimal out_value = (BigDecimal) values[i];   
  16. System.out.println(">> index " + i + " = " + out_value.intValue());   
  17. }   
  18.  ResultSet rset = my_array.getResultSet();   
  19. while (rset.next())   
  20. {   
  21. // The first column contains the element index and the  
  22. // second column contains the element value  
  23. System.out.println(">> index " + rset.getInt(1)+" = " + rset.getInt(2));   
  24. }</SPAN>  

 
    2.3 使用Array对象作为过程函数的参数
    很简单,直接使用OraclePreparedStatement.setARRAY或者OracleCallableStatement.registerOutParameter传入。

 

后记
     这篇东西上年就写了一点,回家过年,闲着没事就写完了。回来电脑又坏了,直到今天才想起贴出来。不是什么大作,记下东西,以前没有这习惯总结,现在争取想有空写点,练练笔头。

 

参考:
     Oracle JDBC JavaDoc
     Oracle9i JDBC Developer’s Guide and Reference
     Oracle8i JDBC Developer’s Guide and Reference

你可能感兴趣的:(JDBC获取和操纵Oracle集合的方法)