パッケージ java.sql

Java^TM プログラミング言語を使用してデータソース (通常はリレーショナルデータベース) のデータにアクセスして処理する API を提供します。

参照:
説明

インタフェースの概要

Array	SQL 型 ARRAY の Java プログラミング言語でのマッピングです。
Blob	SQL BLOB 値の JavaTM プログラミング言語での表現 (マッピング) です。
CallableStatement	SQL ストアドプロシージャを実行するのに使用されるインタフェースです。
Clob	SQL CLOB の型の JavaTM プログラミング言語でのマッピングです。
Connection	特定のデータベースとの接続 (セッション) を表現します。
DatabaseMetaData	データベースに関する包括的な情報です。
Driver	すべてのドライバクラスが実装しなければならないインタフェースです。
ParameterMetaData	PreparedStatement オブジェクト内のパラメータの型とプロパティについての情報の取得に使用するオブジェクトです。
PreparedStatement	プリコンパイルされた SQL 文を表すオブジェクトです。
Ref	Java プログラミング言語での SQL REF 値のマッピングで、データベースの SQL 構造化型の値への参照となります。
ResultSet	データベースの結果セットを表すデータのテーブルで、通常、データベースに照会する文を実行することによって生成されます。
ResultSetMetaData	ResultSet オブジェクトの列の型とプロパティに関する情報を取得するのに使用できるオブジェクトです。
Savepoint	Connection.rollback メソッドから参照される現在のトランザクション内のポイントであるセーブポイントの表現です。
SQLData	SQL ユーザ定義型 (UDT) を Java プログラミング言語のクラスにカスタムマッピングするのに使用されるインタフェースです。
SQLInput	SQL 構造化型または SQL の個別の型のインスタンスを表す値のストリームを格納する入力ストリームです。
SQLOutput	ユーザ定義型の属性をデータベースに書き戻すための出力ストリームです。
Statement	静的 SQL 文を実行し、作成された結果を返すために使用されるオブジェクトです。
Struct	SQL 構造化型の Java プログラミング言語の標準のマッピングです。

クラスの概要

Date	ミリ秒の値をラップする thin ラッパーであり、これによって JDBC がミリ秒の値を SQL DATE 値として扱うことができるようになります。
DriverManager	JDBC ドライバを管理するための基本的なサービスです。
DriverPropertyInfo	接続を行うためのドライバプロパティです。
SQLPermission	アプレットで実行されているコードが DriverManager.setLogWriter メソッドまたは DriverManager.setLogStream メソッド (推奨されない) を呼び出すときに、SecurityManager の確認対象となるアクセス権です。
Time	java.util.Date クラスの thin ラッパーで、このラッパーによって JDBC API はこれを SQL TIME 値として識別できます。
Timestamp	このクラスは、java.util.Date の thin ラッパーで、このラッパーによって JDBC API はこれを SQL TIMESTAMP 値として識別できます。
Types	JDBC 型と呼ばれる、汎用の SQL 型を識別するために使用する定数を定義するクラスです。

例外の概要

BatchUpdateException	バッチ更新オペレーション中にエラーが発生したときにスローされる例外です。
DataTruncation	JDBC が予期せずデータの値を切り捨てる場合に、DataTruncation 警告を通知する (読み込み時) か、DataTruncation 例外をスローする (書き込み時) 例外です。
SQLException	データベースアクセスエラーまたはその他のエラーに関する情報を提供する例外です。
SQLWarning	データベースアクセスの警告に関する情報を提供する例外です。

パッケージ java.sql の説明

Java^TM プログラミング言語を使用してデータソース (通常はリレーショナルデータベース) のデータにアクセスして処理する API を提供します。この API に含まれているフレームワークで、複数のドライバをインストールして複数のデータソースに動的にアクセスすることができます。JDBC^TM API は主に SQL 文をデータベースに渡すために作られていますが、表形式の任意のデータソースのデータの読み込みおよび書き込みを提供します。javax.sql.RowSet インタフェースグループを介して使用可能な読み込み/書き込み機能は、スプレッドシート、フラットファイル、または他の表形式のデータソースのデータを使用したり更新するためにカスタマイズできます。

JDBC^TM 3.0 API に含まれるもの

JDBC^TM 3.0 API には、JDBC コア API と呼ばれる java.sql および JDBC オプションパッケージ API と呼ばれる javax.sql が含まれます。この完全な JDBC API は Java^TM 2 SDK, Standard Edition (J2SE^TM), バージョン 1.4 に含まれています。javax.sql パッケージは JDBC API の機能をクライアント側 API からサーバ側 API へ拡張するもので、Java^TM 2 SDK, Enterprise Edition (J2EE^TM) の必須部分です。(J2EE にも完全な JDBC API が含まれています。JDBC 3.0 API の新機能は J2EE バージョン 1.3 に含まれます。)

バージョン

JDBC 3.0 API には以前のバージョンの JDBC API がすべて組み込まれています。

• JDBC 2.1 コア API
• JDBC 2.0 オプションパッケージ API (JDBC 2.1 コア API と JDBC 2.0 オプションパッケージ API を併せて JDBC 2.0 API と呼びます。)
• JDBC 1.2 API
• JDBC 1.0 API

クラス、インタフェース、メソッド、フィールド、コンストラクタ、および例外には、これらがいつ Java プラットフォームに導入されたのかを示す次の since タグがあります。since タグが JDBC API の Javadoc^TM のコメントで使用されている場合、その意味は次のとおりです。

• since 1.4 -- JDBC 3.0 API に新しく追加。J2SE プラットフォーム, バージョン 1.4 の部分
• since 1.2 -- JDBC 2.0 API に新しく追加。J2SE プラットフォーム, バージョン 1.2 の部分
• since 1.1 または since タグなし -- JDBC 1.0 API に新しく追加。JDK^TM, バージョン 1.1 の部分

注: 新機能の多くはオプションです。したがって、ドライバおよびドライバがサポートする機能にはいくつかのバリエーションがあります。機能を使用する前に、その機能がサポートされているかどうかをドライバのドキュメントで必ず確認してください。

注: クラス SQLPermission が Java^TM 2 SDK, Standard Edition, バージョン 1.3 リリースで追加されました。このクラスを使用すると、テーブル名、列データなどの情報を格納する DriverManager に関連したログストリームへの無権限でのアクセスを防止できます。

java.sql パッケージに含まれるもの

java.sql パッケージは、次の用途の API を含んでいます。

• DriverManager 機能を介したデータソースとの接続
  • DriverManager クラス -- ドライバとの接続
  • SQLPermission クラス -- アプレットなどのセキュリティマネージャ内で実行されるコードが DriverManager を介してログストリームを設定しようとするときにアクセス権を許可する
  • Driver インタフェース -- JDBC テクノロジに基づくドライバ (JDBC ドライバ) の登録および接続を API に提供する。通常は DriverManager クラスだけが使用する
  • DriverPropertyInfo クラス -- JDBC ドライバのプロパティを提供する。一般ユーザは使用しない
• データベースへの SQL 文の送信
  • Statement -- 基本 SQL 文を送信する
  • PreparedStatement -- 用意された文または基本 SQL 文を送信する (Statement から派生)
  • CallableStatement -- データベースストアドプロシージャを呼び出す (PreparedStatement から派生)
  • Connection インタフェース -- 文を作成し、接続とそのプロパティを管理するメソッドを提供する
  • Savepoint -- トランザクションにおいてセーブポイントを提供する
• クエリー結果の取得と更新
  • ResultSet インタフェース
• SQL 型を Java プログラミング言語のクラスおよびインタフェースへ標準マッピング
  • Array インタフェース -- SQL ARRAY をマッピングする
  • Blob インタフェース -- SQL BLOB をマッピングする
  • Clob インタフェース -- SQL CLOB をマッピングする
  • Date クラス -- SQL DATE をマッピングする
  • Ref インタフェース -- SQL REF をマッピングする
  • Struct インタフェース -- SQL STRUCT をマッピングする
  • Time クラス -- SQL TIME をマッピングする
  • Timestamp クラス -- SQL TIMESTAMP をマッピングする
  • Types クラス -- SQL 型の定数を提供する
• SQL ユーザ定義型 (UDT) を Java プログラミング言語のクラスへカスタムマッピング
  • SQLData インタフェース -- このクラスのインスタンスへの UDT のマッピングを指定する
  • SQLInput インタフェース -- ストリームから UDT 属性を読み込むメソッドを提供する
  • SQLOutput インタフェース -- ストリームへ UDT 属性を書き込むメソッドを提供する
• メタデータ
  • DatabaseMetaData インタフェース -- データベースに関する情報を提供する
  • ResultSetMetaData インタフェース -- ResultSet オブジェクトの列に関する情報を提供する
  • ParameterMetaData インタフェース -- PreparedStatement コマンドのパラメータに関する情報を提供する
• 例外
  • SQLException -- データアクセスの障害などの場合にメソッドがスローする
  • SQLWarning -- 警告を示すためにスローされる
  • DataTruncation -- データが切り捨てられた可能性があることを示すためにスローされる
  • BatchUpdateException -- バッチ更新のコマンドがすべては正常に実行されなかったことを示すためにスローされる

JDBC 3.0 API で導入された java.sql と javax.sql の機能

• プール文 -- プール接続に関連した文を再利用する
• セーブポイント -- 指定されたセーブポイントまでトランザクションをロールバックする
• ConnectionPoolDataSource に定義されたプロパティ -- 接続のプール方法を指定する
• PreparedStatement オブジェクトのパラメータのメタデータ
• 自動生成された列から値を取得する
• 同時にオープンされた CallableStatement オブジェクトから返された複数の ResultSet オブジェクトを持つ
• CallableStatement オブジェクトへのパラメータを名前とインデックスによって識別する
• ResultSet 保持機能 -- トランザクションの終了でカーソルをオープンの状態に保持するかクローズの状態に保持するかを指定する
• Ref オブジェクトが参照する SQL 構造化型インスタンスを取得および更新する
• BLOB、CLOB、ARRAY、および REF の各値をプログラムによって更新する
• java.sql.Types.DATALINK データ型の追加 -- JDBC ドライバがデータソースの外部に格納されたオブジェクトにアクセスできるようにする
• SQL 型階層を取得するメタデータの追加

JDBC 2.1 コア API で導入された java.sql 機能

• スクロール可能な結果セット -- 現在位置に関連する特定の行または位置へのカーソルの移動を可能にする、ResultSet インタフェースの新しいメソッドを使用
• バッチ更新
• プログラムの更新 -- ResultSet 更新用メソッドを使用
• 新しいデータ型 -- SQL3 データ型をマッピングするインタフェース
• ユーザ定義型 (UDT) のカスタムマッピング
• その他の機能として、パフォーマンスのヒント、文字ストリームの使用、java.math.BigDecimal 値の全精度、追加セキュリティ、日、時間、およびタイムスタンプの各値でのタイムゾーンのサポートなど

JDBC 2.0 オプションパッケージ API で導入された javax.sql 機能

• 接続を確立するための手段としての DataSource インタフェース。Java Naming and Directory Interface^TM (JNDI) は DataSource オブジェクトをネームサービスに登録し、それを取得するのに使用する
• プール接続 -- 接続の使用と再利用を可能にする
• 分散トランザクション -- 多様な DBMS サーバに及ぶトランザクションを可能にする
• RowSet テクノロジ -- データを処理して渡す便利な手段を提供する

UDT のカスタムマッピング

SQL で定義したユーザ定義型 (UDT) を Java プログラミング言語のクラスにマッピングすることができます。SQL 構造化型または SQL DISTINCT 型が、カスタムマッピングできる UDT です。次の 3 つのステップで、カスタムマッピングを設定します。

1. SQL 構造化型または SQL DISTINCT 型を SQL で定義します。
2. SQL UDT をマッピングする Java プログラミング言語のクラスを定義します。このクラスは SQLData インタフェースを実装している必要があります。
3. 次の 2 項目を含む Connection オブジェクトの型マップにエントリを作成します。
   • UDT の完全指定された SQL 名
   • SQLData インタフェースを実装するクラスの Class オブジェクト

これらが UDT の該当位置にあると、メソッド ResultSet.getObject またはメソッド CallableStatement.getObject を呼び出した場合に UDT は自動的に UDT へのカスタムマッピングを取得します。また、PreparedStatement.setObject はオブジェクトをその SQL 型へ自動的にマッピングしてデータソースにオブジェクトを格納します。

パッケージの仕様

• 「Specification of the JDBC 3.0 API」

関連項目

• 「JDBC API 入門」 -- 主なインタフェースの概要

• JDBC API の章 -- 「The Java Tutorial Continued」 のオンラインバージョンより

• 「JDBC^TMAPI Tutorial and Reference, Second Edition: Universal Data Access for the Java 2 Platform」 -- JDBC 2.0 API の完全なリファレンスとチュートリアル

導入されたバージョン:

1.1