JavaTM Platform
Standard Ed. 6

パッケージ java.sql

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

参照先:
          説明

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

クラスの概要
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 型を識別するために使用する定数を定義するクラスです。
 

列挙型の概要
ClientInfoStatus Connection.setClientInfo の呼び出しによってプロパティーを設定できない理由の状態の列挙です。
RowIdLifetime RowId の寿命の値の列挙です。
 

例外の概要
BatchUpdateException バッチ更新操作中にエラーが発生したときにスローされる SQLException のサブクラスです。
DataTruncation MaxFieldSize を超過した以外の理由でデータ値が予期せず切り詰められたときに、DataTruncation 例外としてスローされる例外 (書き込み時)、または DataTruncation 警告として報告される例外 (読み込み時) です。
SQLClientInfoException 1 つ以上のクライアント情報プロパティーを Connection で設定できなかったときに、SQLException のサブクラスがスローされます。
SQLDataException SQLState クラス値が '22' のときにスローされる SQLException のサブクラスです。
SQLException  データベースアクセスエラーまたはその他のエラーに関する情報を提供する例外です。
SQLFeatureNotSupportedException SQLState クラス値が '0A' (ゼロ A) のときにスローされる SQLException のサブクラスです。
SQLIntegrityConstraintViolationException SQLState クラス値が '23' のときにスローされる SQLException のサブクラスです。
SQLInvalidAuthorizationSpecException SQLState クラス値が '28' のときにスローされる SQLException のサブクラスです。
SQLNonTransientConnectionException   SQLState クラス値が '08' のときにスローされる SQLException のサブクラスです。
SQLNonTransientException SQLException の原因が修正されないかぎり、同じ操作を再試行してもインスタンスが失敗するときにスローされる SQLException のサブクラスです。
SQLRecoverableException アプリケーションが回復手順を実行してトランザクション全体 (分散トランザクションの場合はトランザクションブランチ) を再試行すれば前回失敗した操作が成功する可能性があるときにスローされる SQLException のサブクラスです。
SQLSyntaxErrorException SQLState クラス値が '42' のときにスローされる SQLException のサブクラスです。
SQLTimeoutException  Statement で指定したタイムアウトが経過したときにスローされる SQLException のサブクラスです。
SQLTransactionRollbackException SQLState クラス値が '40' のときにスローされる SQLException のサブクラスです。
SQLTransientConnectionException SQLState クラス値が '08' のときにスローされる SQLException のサブクラスです。
SQLTransientException 前回失敗した操作が、アプリケーションレベルの機能による介入がなくても再試行時に成功する可能性がある状況では SQLException のサブクラスがスローされます。
SQLWarning  データベースアクセスの警告に関する情報を提供する例外です。
 

パッケージ java.sql の説明

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

JDBCTM 4.0 API に含まれるもの

JDBCTM 4.0 API には、JDBC コア API と呼ばれる java.sql パッケージと、JDBC オプションパッケージ API と呼ばれる javax.sql パッケージの両方が含まれます。この完全な JDBC API は、JavaTM Standard Edition (Java SETM) の Versio 6 に含まれます。javax.sql パッケージは JDBC API の機能をクライアント側 API からサーバー側 API へ拡張するもので、JavaTM Enterprise Edition (Java EETM) 技術の必須部分です。

バージョン

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

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

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

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

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

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

JDBC 4.0 API で導入された java.sqljavax.sql の機能

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

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

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

UDT のカスタムマッピング

SQL で定義したユーザー定義型 (UDT) を Java プログラミング言語のクラスにマッピングできます。SQL 構造化型または SQL DISTINCT 型が、カスタムマッピングできる UDT です。次の 3 つのステップで、カスタムマッピングを設定します。
  1. SQL 構造化型または SQL DISTINCT 型を SQL で定義します。
  2. SQL UDT をマッピングする Java プログラミング言語のクラスを定義します。このクラスは SQLData インタフェースを実装している必要があります。
  3. 次の 2 項目を含む Connection オブジェクトの型マップにエントリを作成します。

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

パッケージの仕様

関連ドキュメント

導入されたバージョン:
1.1

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。