Java データベース接続

Java Database Connectivity ( JDBC ) は、クライアントがデータベースにアクセスする方法を定義するJavaプログラミング言語のアプリケーション プログラミング インターフェイス(API) です。これは、Java データベース接続に使用される Java ベースのデータ アクセス テクノロジです。これは、Oracle CorporationのJava Standard Editionプラットフォームの一部です。これは、データベース内のデータを照会および更新する方法を提供し、リレーショナル データベースを対象としています。JDBC からODBCへのブリッジにより、 Java 仮想マシン(JVM) ホスト環境内の ODBC アクセス可能な任意のデータ ソースに接続できます。

Sun Microsystemsは、1997年2月19日にJava Development Kit (JDK) 1.1の一部としてJDBCをリリースしました。 ^[1] それ以来、JDBCはJava Platform, Standard Edition (Java SE)の一部となっています。

JDBC クラスはJava パッケージ に 含まれておりjava.sql、javax.sql

バージョン3.1以降、JDBCはJava Community Processの下で開発されています。JSR 54はJDBC 3.0（J2SE 1.4に含まれる）を規定し、JSR 114はJDBC Rowsetの追加を規定し、JSR 221はJDBC 4.0（Java SE 6に含まれる）の仕様です。^[2]

JDBC 4.1は、JSR 221のメンテナンスリリース1 ^[3]で指定されており、Java SE 7に含まれています。^[4]

JDBC 4.2は、JSR 221のメンテナンスリリース2 ^[5]で指定されており、Java SE 8に含まれています。^[6]

^{最新バージョンのJDBC 4.3は、JSR 221 [7]}のメンテナンスリリース3で指定されており、Java SE 9に含まれています。^[8]

JDBC ('Java Database Connectivity') は主にインターフェイス定義と仕様の集合であるため、これらのインターフェイスの複数の実装が存在し、実行時に同じアプリケーションで使用できます。 API は、適切な Java パッケージを動的にロードし、JDBC ドライバー マネージャー ( DriverManager) に登録するメカニズムを提供します。は、JDBC 接続を作成するためのファクトリDriverManagerとして使用されます。 Connection

JDBC 接続は、ステートメントの作成と実行をサポートします。JDBC 接続は、SQL のCREATE、INSERT、UPDATE、DELETEなどの更新ステートメント、またはSELECTなどのクエリ ステートメントをサポートします。さらに、ストアド プロシージャは、JDBC 接続を通じて呼び出すことができます。JDBC は、次のいずれかのクラスを使用してステートメントを表します。

• Statement– はStatement毎回データベースサーバーに送信されます。言い換えれば、StatementメソッドはSQL文を使用して実行され、ResultSetデータを含むオブジェクトを取得します。^[9]
• PreparedStatement–はインターフェースPreparedStatementのサブインターフェースですStatement。^[9]ステートメントはキャッシュされ、実行パスがデータベースサーバー上で事前に決定され、効率的に複数回実行できるようになります。^{[9] は} PreparedStatement、プリコンパイルされたSQLステートメントを実行するために使用されます。^[9]プリコンパイルされたステートメントを実行すると、ステートメントの実行効率とパフォーマンスが向上します。は、PreparedStatementいくつかの入力パラメータをターゲットデータベースに渡す必要がある動的ステートメントによく使用されます。[ ^10]

PreparedStatementクエリパラメータに応じて動的クエリを変化させることができる。^[11]

• CallableStatement–はインターフェースCallableStatementのサブインターフェースですStatement。^[11]データベース上でストアドプロシージャを実行するために使用されます。 ^{[11] [12]}ストアドプロシージャでは、入力パラメータと出力パラメータの両方をデータベースに渡す必要があります。^[13]

INSERT、UPDATE、DELETEなどの更新文は、データベース内で影響を受けた行の数を示す更新カウントを整数で返します。 ^[13]これらの文は他の情報を返しません。

クエリ ステートメントは、JDBC 行結果セットを返します。行結果セットは、結果セットを調べるために使用されます。行内の個々の列は、名前または列番号で取得されます。結果セットには任意の数の行が含まれる場合があります。行結果セットには、列の名前とそのタイプを記述するメタデータが含まれます。

には、基本的な JDBC API の拡張機能がありますjavax.sql。

JDBC接続は、ドライバから直接取得されるのではなく、接続プールを介して管理されることが多い。 ^[14]

Java アプリケーションがデータベース接続を必要とする場合、DriverManager.getConnection()メソッドの 1 つを使用して JDBC を作成しますConnection。使用される URL は、特定のデータベースと JDBC ドライバーによって異なります。URL は常に「jdbc:」プロトコルで始まりますが、残りは特定のベンダーによって異なります。

Connection conn = DriverManager.getConnection ( "jdbc:somejdbcvendor:other data needed by some jdbc vendor" , " myLogin" , "myPassword" ); try { / * ここで接続を使用します */ } finally { // 使用後は接続を閉じることが重要ですtry { conn.close (); } catch ( Throwable e ) { /* ログに記録し                                たいこの例外ではなく、元の例外を伝播します* / logger.warn ( "JDBC 接続を閉じることができませんでした" , e ); } }   
     
     
     
 
     
  
    
      
        
         
 
         
    

Java SE 7 以降では、Java の try-with-resources ステートメントを使用して上記のコードを簡略化できます。

try ( Connection conn = DriverManager . getConnection ( "jdbc:somejdbcvendor:other data needed by some jdbc vendor" , "myLogin" , "myPassword" )) { /* ここで接続を使用します */ } // VM が接続を閉じる処理を行います    
     
     
      
     
  

接続が確立されると、 をStatement作成できます。

try (ステートメントstmt = conn . createStatement ()) { stmt . executeUpdate ( "INSERT INTO MyTable(name) VALUES ('my name')" ); }     
    

Connections、Statements、 s は、ソケットやファイル記述子などのオペレーティング システムResultSetリソースを拘束することが多いことに注意してください。リモート データベース サーバーへの s の場合、現在開いているsのカーソルなど、サーバー上のさらなるリソースが拘束されます。これは、役割を果たしたらすぐにすべての JDBC オブジェクト にとって重要になります。ガベージ コレクションに依存すべきではありません。上記の try-with-resources 構造は、これを回避するコード パターンです。 ConnectionResultSetclose()

データは、データベース クエリ メカニズムを使用してデータベースから取得されます。以下の例は、ステートメントの作成とクエリの実行を示しています。

try ( Statement stmt = conn.createStatement (); ResultSet rs = stmt.executeQuery ( " SELECT * FROM MyTable" ) ) { while ( rs.next ( ) ) { int numColumns = rs.getMetaData (). getColumnCount ( ) ; for ( int i = 1 ; i <= numColumns ; i ++ ) { // 列番号は 1 から始まります。 // また、結果セットには、列を特定の型として返すメソッドが多数あります。有効な変換のリストについては、Sun のドキュメントを参照してください。System.out.println ( " COLUMN " + i + " = " + rs.getObject ( i ) ) ; } } }    
       
 
      
           
                 
           
           
           
           
                  
        
    

次のコードは、最初の例のクラスを PreparedStatement使用するクエリの例です。conn

try ( PreparedStatement ps = conn . prepareStatement ( "SELECT i.*, j.* FROM Omega i, Zappa j WHERE i.name = ? AND j.num = ?" ) ) { // 準備中の SQL 文では、各疑問符はプレースホルダーであり、// 「set」メソッド呼び出しで指定した値に置き換える必要があります。// 次の 2 つのメソッド呼び出しは、2 つのプレースホルダーを置き換えます。最初のプレースホルダーは文字列値に置き換えられ、2 番目のプレースホルダーは整数値に置き換えられます。ps . setString ( 1 , "Poor Yorick" ); ps . setInt ( 2 , 8008 );   
    
 
    
    
    
    
     
     

    // ResultSet rs は、SQL 文の実行結果を伝えます。
// rs.next() を呼び出すたびに、内部の行ポインタ、つまりカーソルが、結果の次の行に進みます。カーソルは、最初は最初の行の前にあります。try ( ResultSet rs = ps . executeQuery ()) { while ( rs . next ()) { int numColumns = rs . getMetaData (). getColumnCount (); for ( int i = 1 ; i <= numColumns ; i ++ ) { // 列番号は 1 から始まります。 // また、結果セットには、列を特定の型として返すメソッドが多数あります。有効な変換のリストについては、Sun のドキュメントを参照してください。System . out . println ( "COLUMN " + i + " = " + rs . getObject ( i )); } // for } // while } // try } // try    
    
    
         
          
               
                     
                
                
                
                
                      
             
         
     
 

データベース操作が失敗すると、JDBC は を発生させますSQLException。通常、できるだけ詳細にログに記録する以外に、このようなエラーから回復する方法はほとんどありません。 をSQLExceptionアプリケーション ドメイン例外 (未チェック例外) に変換して、最終的にトランザクションのロールバックとユーザーへの通知を行うことをお勧めします。

次のコードはデータベース トランザクションの例です。

ブール値autoCommitDefault = conn.getAutoCommit ( );試してください{ conn.setAutoCommit ( false ) ;   
 
    

    /* ここで conn に対してトランザクション的にステートメントを実行します */

    conn.commit (); } catch ( Throwable e ) { try { conn.rollback (); } catch ( Throwable e ) { logger.warn ( "トランザクションをロールバックできませんでした" 、e ) ; } throw e ; } finally { try { conn.setAutoCommit ( autoCommitDefault ) ; } catch ( Throwable e ) { logger.warn ( " AutoCommit設定を復元できませんでした" 、e ) ; } }
    
              
     
  
             

CallableStatement(データベース内のストアド プロシージャを呼び出す) の例については、JDBC API ガイドのドキュメントを参照してください。

java.sql.Connectionをインポートします。java.sql.DriverManagerをインポートします。java.sql.Statementをインポートします。 
 
 

パブリッククラスMydb1 {静的文字列URL = "jdbc:mysql://localhost/mydb" ;   
       

   パブリック静的void main ( String [] args ) { try { Class . forName ( "com.mysql.jdbc.Driver" );     
       
        

        接続conn = DriverManager.getConnection ( URL , "root" , "root" );ステートメントstmt = conn.createStatement ( );文字列sql = " INSERT INTO emp1 VALUES ('pctb5361' , 'kiril', 'john', 968666668)" ; stmt.executeUpdate ( sql ) ; System.out.println ( "テーブルにレコードを挿入しました... " ) ; } catch (例外e ) { e.printStackTrace ( ) ; } } }     
           
      
           
        
           
        
          
        
      
   

JDBC ドライバーは、Java プログラムからの要求を DBMS が理解できるプロトコルに変換する クライアント側アダプター(サーバーではなくクライアント マシンにインストールされます) です。

商用および無料のドライバーは、ほとんどのリレーショナル データベース サーバーへの接続を提供します。これらのドライバーは、次のいずれかのタイプに分類されます。

• タイプ1は、ローカルで利用可能なODBCドライバのネイティブコードを呼び出す。（注：JDBC 4.2では、JDBC-ODBCブリッジは削除されました^[15]）
• タイプ 2は、クライアント側でデータベース ベンダーのネイティブ ライブラリを呼び出します。このコードは、ネットワーク経由でデータベースと通信します。
• タイプ 3 は、サーバー側ミドルウェアと通信し、その後データベースと通信する純粋な Java ドライバーです。
• タイプ 4、データベース ネイティブ プロトコルを使用する純粋な Java ドライバー。

また、内部 JDBC ドライバーと呼ばれるタイプにも注目してください。これは、Java 対応 SQL データベースにJREとともに埋め込まれたドライバーです。これは、Java ストアド プロシージャに使用されます。これは上記の分類体系には当てはまりませんが、データベース自体が Java で実装されているかどうかによって、タイプ 2 またはタイプ 4 ドライバーに似ている可能性があります。この例としては、Oracle RDBMS に付属するKPRB (Kernel Program Bundled) ドライバー^[16]があります。"jdbc:default:connection" は、このような接続を行う比較的標準的な方法を提供します (少なくとも Oracle データベースとApache Derby はこれをサポートしています)。ただし、内部 JDBC ドライバーの場合、JDBC クライアントは実際にはアクセス対象のデータベースの一部として実行されるため、ネットワーク プロトコルを介さずに直接データにアクセスできます。

• OracleはいくつかのJDBCドライバとベンダーのリストを提供しています。
• Simba Technologiesは、カスタム/独自のリレーショナルデータソース用のカスタムJDBCドライバーを構築するためのSDKを提供しています。
• CData Softwareは、さまざまなアプリケーション、データベース、Web API用のタイプ4 JDBCドライバーを提供しています。^[17]
• アプリケーション、データベース、Webサービス用のRSSBus Type 4 JDBCドライバ^[18]
• データダイレクトテクノロジーズは、タイプ5として宣伝されているすべての主要なデータベースに対して、包括的な高速タイプ4JDBCドライバスイートを提供しています^[19]
• IDS Softwareは、すべての主要データベースへの同時アクセスを可能にするタイプ3JDBCドライバを提供しています。サポートされている機能には、結果セットのキャッシュ、SSL暗号化、カスタムデータソース、dbShieldなどがあります。
• JDBaccess は、 MySQLおよびOracle用の Java 永続ライブラリであり、主要なデータベース アクセス操作を JDBC 上で簡単に使用できる API で定義します。
• JNetDirect は、完全に Sun J2EE 認定された高性能 JDBC ドライバー スイートを提供します。
• JDBCR4は、 IBM i上のRPGからJDBCにアクセスできるようにするためにスコット・クレメントによって書かれたサービスプログラムです。^[20]
• HSQLDB は、JDBC ドライバーを備えたRDBMSであり、BSD ライセンスの下で利用できます。
• SchemaCrawler ^[21]はJDBCを活用し、データベースメタデータをPOJO（Plain Old Java Object）として利用できるようにするオープンソースAPIである。

• GNU データ アクセス(GDA)
• JDBCファサード
• オープン データベース コネクティビティ(ODBC)
• オブジェクトリレーショナルマッピング(ORM)

• Bai, Ying (2022). SQL Server データベースプログラミング with Java . Cham: Springer International Publishing . doi :10.1007/978-3-031-06553-8. ISBN 978-3-030-92686-1。
• ケイ州ホーストマン（2022年4月15日）。コア Java。オラクルプレスJava。ISBN 978-0-13-787107-0。

ウィキメディア・コモンズには、 JDBCに関連するメディアがあります。

Wikibooks には、 Java プログラミング/データベース プログラミングに関する書籍があります。

• JDBC API ガイド
• java.sqlAPI Javadocドキュメント
• javax.sqlAPI Javadoc ドキュメント
• O/R ブローカー Scala JDBC フレームワーク
• SqlTool オープンソース、コマンドライン、汎用 JDBC クライアント ユーティリティ。JDBC をサポートする任意のデータベースで動作します。
• すべてのデータベースの JDBC URL 文字列と関連情報。