3. JDBCアプリケーションの開発

3.1. プログラミング・開発ガイド

• JDBC2.0/JDBC3.0/JDBC4.0/JDBC4.1
• JDBC Optional Package
• JNDI
• JDBCデータソースのAPI

• 3.1.2. JDBCアプリケーションでのimport文について
• 3.1.3. 一般的なJDBCコネクションの取得方法
• 3.1.4. AutoCommitモードの変更方法
• 3.1.5. JTAのトランザクションで、同時に複数のJDBCコネクションを利用する方法
• 3.1.6. JDBCドライバベンダのJDBCコネクションの取得方法
• 3.1.7. JNDIを利用せずにJDBCデータソースを利用する方法

3.1.1. JDBCアプリケーションの動作環境について

3.1.1.1. 実行環境（サーバ）

• CLASSPATH
  実行するときは以下のライブラリをクラスパスに追加してください。 ただし、Linux(x64)でIRS(InfoFrame Relational Store) JDBCドライバの場合には、追加は不要です。
  • JDBCドライバベンダのライブラリ

3.1.1.2. 実行環境（クライアント）

• CLASSPATH
  実行するときは以下のライブラリをクラスパスに追加してください。
  • ${INSTALL_ROOT}/lib/wojdbc61.jar
  • JDBCドライバベンダのライブラリ
  これらに加えて、JNDIサーバを利用する場合は、 4. JNDIアプリケーションの開発 に記載されているライブラリをクラスパスに追加してください。
• システムプロパティ
  JNDIサーバを利用する場合は、 4. JNDIアプリケーションの開発 に記載されているシステムプロパティを設定してください。

3.1.2. JDBCアプリケーションでのimport文について

3.1.2.1. コーディング例

//　JDBCのインタフェース
import java.sql.*;
import javax.sql.DataSource;
 
// JNDIのインタフェース
import javax.naming.*;
 
// JDBCデータソース固有のインタフェース
import jp.co.nec.WebOTX.WODataSource;
import com.nec.wojdbc.WOConnectionWrapper;

3.1.3. 一般的なJDBCコネクションの取得方法

3.1.3.1. コーディング例

InitialContext ic;
DataSource ds;
public void method_init ()
{
    try {
        // JDBC データソースの取得
        ic = new InitialContext();
        ds = (DataSource)ic.lookup("jdbc/Oracle");
    } catch(Exception ex) {
        ex.printStackTrace();
    }
}
public void method_1 ()
{
    Connection conn = null;
    try {
        // JDBC コネクションの取得
        conn = ds.getConnection();
 
        // SQL 命令の実行
    } catch(Exception ex) {
        ex.printStackTrace();
    } finally {
        if ( conn != null ) {
            try {
                // JDBC コネクションのクローズ
                conn.close();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

3.1.3.2. JDBCデータソースの取得

3.1.3.3. JDBCコネクションの取得

Memo
JDBCデータソースのプロパティの詳細は、 [ リファレンス集 運用管理・設定編 > 1. コンフィグレーション(設定一覧) > 1.8. JDBCデータソース ] を参照してください。

3.1.3.4. JDBCコネクションのクローズ

3.1.4. AutoCommitモードの変更方法

3.1.4.1. コーディング例

DataSource ds;
public void method_2 ()
{
    Connection conn = null;
    try {
        // JDBC コネクションの取得
        conn = ds.getConnection();
        // AutoCommit モードの変更
        conn.setAutoCommit(false);

        // SQL命令の実行
 
        // 更新内容のコミット
        conn.commit();
    } catch(Exception ex) {
        if ( conn != null ) {
            try {
                // 更新内容のロールバック
                conn.rollback();
            } catch (Exception e) {}
        }
        ex.printStackTrace();
    } finally {
        if ( conn != null ) {
            try{
                // JDBC コネクションのクローズ
                conn.close();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

3.1.4.2. AutoCommitモードの変更

Memo
JDBCデータソースのプロパティの詳細は、 [ リファレンス集 運用管理・設定編 > 1. コンフィグレーション(設定一覧) > 1.8. JDBCデータソース ] を参照してください。

3.1.4.3. 更新内容のコミット

3.1.5. JTAのトランザクションで、同時に複数のJDBCコネクションを利用する方法

3.1.5.1. コーディング例

DataSource ds;
public void method_3 ()
{
    Connection conn1 = null;
    try {
        // JDBC コネクションの取得(1)
        conn1 = ds.getConnection();
        // EJBのメソッド呼び出し
        method_4();

        // SQL命令の実行
    } catch(Exception ex) {
        ex.printStackTrace();
    } finally{
         if ( conn1 != null ) {
             try{
                // JDBC コネクションのクローズ(1)
                conn1.close();
             } catch (Exception e) {
                 e.printStackTrace();
             }
         }
    }
}
public void method_4 ()
{   
    Connection conn2 = null;
    try {
        // JDBC コネクションの取得(2)
        conn2 = ds.getConnection();

        // SQL命令の実行
    } catch(Exception ex) {
        ex.printStackTrace();
    } finally {
        if ( conn2 != null ) {
            try{
                // JDBC コネクションのクローズ(2)
                conn2.close();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

3.1.5.2. JDBCコネクションの取得

Memo
JDBCデータソースのプロパティの詳細は、 [ リファレンス集 運用管理・設定編 > 1. コンフィグレーション(設定一覧) > 1.8. JDBCデータソース ] を参照してください。

3.1.5.3. JDBCコネクションのクローズ

3.1.6. JDBCドライバベンダのJDBCコネクションの取得方法

3.1.6.1. コーディング例（WebOTX固有インタフェースの利用例）

DataSource ds;
public void method_5 ()
{
    Connection conn = null;
    try {
        // JDBCドライバベンダのJDBCコネクション
        Connection realconn = null;
        // JDBC コネクションの取得
        conn = ds.getConnection();
        // JDBCドライバベンダのJDBCコネクションの取得
        if (conn instanceof com.nec.wojdbc.WOConnectionWrapper) {
            WOConnectionWrapper wocon = (com.nec.wojdbc.WOConnectionWrapper)conn;
            realconn = wocon.getRealConnection();
        }
        else {
           realconn = conn;
        }
        // JDBC ドライバベンダ固有のAPI呼び出し
//     try{   
//         String tmzone = ((oracle.jdbc.OracleConnection)realconn).getSessionTimeZone();
//         System.out.println("Session TimeZone: " + tmzone );
//      } catch(Throwable t ){
//         System.out.println("getSessionTimeZone() not supported. :" + t );
//      }
 
        // SQL命令の実行
    } catch(Exception ex) {
        ex.printStackTrace();
    } finally {
        if ( conn != null ) {
            try {
                // JDBC コネクションのクローズ
                conn.close();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

3.1.6.2. JDBCドライバベンダのJDBCコネクションの取得

• dataSourceTypeプロパティの値が次のいずれかであること
  JDBCEX_Oracle、JDBCEX_SequeLink、JDBCEX_Cloudscape
• checkGarbageOptionプロパティの値がnoneであること
  
• useOneConnectionPerTransactionプロパティの値がfalseであること
  
• wrapStatementプロパティの値がfalseであること
  
• モニタリングレベルがHIGHではないこと
  
• JDBCドライバログのレベルがデフォルトのWARNであること
  

Memo
JDBCデータソースのプロパティの詳細は、 [ リファレンス集 運用管理・設定編 > 1. コンフィグレーション(設定一覧) > 1.8. JDBCデータソース ] を参照してください。

3.1.6.3. JDBCコネクションのクローズ

3.1.6.4. コーディング例（JDBC4.0の利用例）

DataSource ds;
public void method_5 ()
{
    Connection conn = null;
    Statement stmt = null;
    try {
        // JDBC ドライバベンダのJDBCコネクション
        oracle.jdbc.OracleConnection realconn = null;
        // JDBC コネクションの取得
        conn = ds.getConnection();
        // JDBC ドライバベンダのJDBCコネクションの取得
        Class cl = Class.forName(“oracle.jdbc.OracleConnection”);
        if (conn.isWrapperFor(cl)) {
           realconn = conn.unwrap(cl);
        }
         // JDBC ドライバベンダ固有のAPI呼び出し
//     try{   
//         String tmzone = realconn.getSessionTimeZone();
//         System.out.println("Session TimeZone: " + tmzone );
//      } catch(Throwable t ){
//         System.out.println("getSessionTimeZone() not supported. :" + t );
//      }

        // JDBC ドライバベンダのJDBCステートメント
        oracle.jdbc.driver.OracleStatement realstmt = null;
        // JDBC ステートメントの取得
        stmt = conn.createStatement();
        // JDBC ドライバベンダのJDBCステートメントの取得
        cl = Class.forName(“oracle.jdbc.driver.OracleStatement”);
        if (stmt.isWrapperFor(cl)) {
           realstmt = stmt.unwrap(cl);
        }
 
        // SQL命令の実行

    } catch(Exception ex) {
        ex.printStackTrace();
    } finally {
        if ( stmt != null ) {
           try {
               // JDBC ステートメントのクローズ
                stmt.close();
            } catch (Exception e) {  
                e.printStackTrace();
            }
        }
        if ( conn != null ) {
           try {
               // JDBC コネクションのクローズ
                conn.close();
            } catch (Exception e) {  
                e.printStackTrace();
            }
        }
    }
}

3.1.6.5. JDBCドライバベンダのJDBCコネクションの取得

3.1.6.6. JDBCドライバベンダのJDBCステートメントの取得

3.1.6.7. JDBCドライバベンダのJDBCリザルトセットの取得

3.1.6.8. JDBCコネクションのクローズ

3.1.7. JNDIを利用せずにJDBCデータソースを利用する方法

3.1.7.1. コーディング例

DataSource ds;
public void method_5 ()
{
    Connection conn = null;
    try {
        // WODataSource クラスインスタンスの作成
        WODataSource wods = new WODataSource();
        // プロパティ値の取得
        String filename = System.getProperty("MY_PROPERTY_FILE_NAME");
        java.util.Properties props = new java.util.Properties();
        java.io.FileInputStream fin = new java.io.FileInputStream(filename);
        try {
            props.load(fin);
        } finally {
            if (fin != null) fin.close();
        }
        // プロパティ値の設定
        wods.setDataSourceName(props.getProperty("dataSourceName"));
        wods.setDataSourceType(props.getProperty("dataSourceType"));
        wods.setUserName(props.getProperty("userName"));
        wods.setPassword(props.getProperty("password"));
        wods.setUseJTA(Boolean.valueOf(props.getProperty("useJTA")).booleanValue());
        ds = wods;
        // JDBCコネクションの取得
        conn = ds.getConnection();
 
        // SQL命令の実行
    } catch(Exception ex) {
        ex.printStackTrace();
    } finally {
        if ( conn != null ) {
            try {
                // JDBC コネクションのクローズ
                conn.close();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

3.1.7.2. WODataSourceクラスインスタンスの作成

3.1.7.3. プロパティ値の取得

3.1.7.4. プロパティ値の設定

Memo
JDBCデータソースのプロパティの詳細は、 [ リファレンス集 運用管理・設定編 > 1. コンフィグレーション(設定一覧) > 1.8. JDBCデータソース ] を参照してください。