目次

• 表一覧
• タイトルおよび著作権情報
• はじめに
  • 対象読者
  • 関連ドキュメント
  • ドキュメントのアクセシビリティについて
  • 表記規則
• 1 『Oracle Database SQLJ開発者ガイド』のこのリリースでの変更点
• 2 スタート・ガイド
  • 2.1 前提と要件
    • 2.1.1 環境に対する前提
    • 2.1.2 Oracle SQLJ実装を使用するための要件
    • 2.1.3 SQLJ環境
    • 2.1.4 環境に関する考慮事項
    • 2.1.5 SQLJの下位互換性
  • 2.2 インストールおよび設定の確認
    • 2.2.1 SQLJおよびデモ用アプリケーションの可用性の確認
    • 2.2.2 インストール先のディレクトリとファイルの確認
    • 2.2.3 PATHとCLASSPATHの設定
    • 2.2.4 sqljutlパッケージのインストールの確認
  • 2.3 設定のテスト
    • 2.3.1 ランタイム接続の設定
    • 2.3.2 データベース検証用の表の作成
    • 2.3.3 JDBCドライバの検証
    • 2.3.4 SQLJトランスレータとランタイムの検証
    • 2.3.5 SQLJトランスレータからデータベースへの接続の検証
• 3 SQLJについて
  • 3.1 SQLJの概要
  • 3.2 SQLJコンポーネントの概要
    • 3.2.1 SQLJトランスレータ機能
    • 3.2.2 SQLJランタイム
  • 3.3 SQLJ規格に準拠したOracle拡張型の概要
    • 3.3.1 SQLJの拡張型
    • 3.3.2 SQLJの拡張機能
  • 3.4 基本的な変換処理とランタイム処理
    • 3.4.1 SQLJ変換処理
    • 3.4.2 トランスレータ入出力の概要
      • 3.4.2.1 トランスレータへの入力
      • 3.4.2.2 トランスレータの出力
      • 3.4.2.3 ファイルの出力先
    • 3.4.3 SQLJランタイム処理
  • 3.5 SQLJのサンプル・コード
    • 3.5.1 SQLJバージョンのサンプル・コード
    • 3.5.2 JDBCバージョンのサンプル・コード
  • 3.6 他のデプロイメント例
    • 3.6.1 アプレットでのSQLJの実行
      • 3.6.1.1 開発およびデプロイメントに関する一般的な考慮事項
      • 3.6.1.2 エンド・ユーザーのための一般的な考慮事項
      • 3.6.1.3 Java環境およびJavaプラグイン
  • 3.7 他の開発環境
    • 3.7.1 SQLJグローバリゼーション・サポート
    • 3.7.2 Oracle JDeveloper 10g などのIDEでのSQLJの使用
    • 3.7.3 Windowsに関する注意事項
• 4 プログラミング上の主な考慮事項
  • 4.1 JDBCドライバの選択
    • 4.1.1 Oracle JDBCドライバの概要
    • 4.1.2 変換用ドライバの選択
    • 4.1.3 実行時に使用するドライバの選択および登録
  • 4.2 接続の際の考慮事項
    • 4.2.1 DefaultContextを使用した単一接続または複数接続
    • 4.2.2 接続の終了
    • 4.2.3 宣言済の接続コンテキスト・クラスを使用した複数接続
    • 4.2.4 Oracleクラスについて
    • 4.2.5 DefaultContextクラスについて
    • 4.2.6 変換時の接続
    • 4.2.7 カスタマイズ時の接続
  • 4.3 NULLの処理
    • 4.3.1 NULL処理用のラッパー・クラス
    • 4.3.2 NULL処理の例
  • 4.4 例外処理の基本
    • 4.4.1 SQLJおよびJDBCの例外処理要件
    • 4.4.2 例外の処理
    • 4.4.3 SQLExceptionサブクラスの使用方法
  • 4.5 基本的なトランザクション制御
    • 4.5.1 トランザクションの概要
    • 4.5.2 自動コミットと手動コミットとの違い
    • 4.5.3 接続を定義する際の自動コミットの指定
    • 4.5.4 既存の接続の自動コミットに対する変更
    • 4.5.5 手動COMMITまたはROLLBACKの使用方法
    • 4.5.6 イテレータおよび結果セットに対するコミットおよびロールバックの影響
    • 4.5.7 セーブポイントの使用
  • 4.6 概要: 簡単なSQLJコード
  • 4.7 Oracle固有コード生成(プロファイルなし)
    • 4.7.1 Oracle固有コード生成用環境の要件
    • 4.7.2 Oracle固有コード生成でのコード上の考慮事項と制限事項
    • 4.7.3 Oracle固有コード生成時のSQLJ使用方法の変更
    • 4.7.4 Oracle固有コード生成のメリットとデメリット
  • 4.8 ISO標準コード生成
    • 4.8.1 ISO標準コード生成用環境の要件
    • 4.8.2 SQLJトランスレータとSQLJランタイム
    • 4.8.3 SQLJプロファイル
      • 4.8.3.1 プロファイルの概要
      • 4.8.3.2 バイナリ移植性
    • 4.8.4 SQLJ変換処理
    • 4.8.5 トランスレータ入出力の概要
      • 4.8.5.1 トランスレータへの入力
      • 4.8.5.2 トランスレータの出力
      • 4.8.5.3 ファイルの出力先
    • 4.8.6 SQLJランタイム処理
    • 4.8.7 デプロイメント例
  • 4.9 Oracle固有コード生成とISO標準コード生成との違い
  • 4.10 ネーミングの要件および制限事項
    • 4.10.1 Javaのネームスペース: ローカル変数およびクラスのネーミングに関する制限事項
    • 4.10.2 SQLJのネームスペース
    • 4.10.3 SQLのネームスペース
    • 4.10.4 ファイル名の要件と制限
  • 4.11 中間層のSQLJに関する考慮事項
• 5 基本的な言語機能
  • 5.1 SQLJ宣言の概要
    • 5.1.1 SQLJ宣言の規則
    • 5.1.2 イテレータ宣言
    • 5.1.3 接続コンテキスト宣言
    • 5.1.4 IMPLEMENTS句宣言
    • 5.1.5 WITH句宣言
      • 5.1.5.1 標準WITH句の使用例
      • 5.1.5.2 Oracle固有のWITH句の使用例
      • 5.1.5.3 returnabilityの例
  • 5.2 SQLJ実行文の概要
    • 5.2.1 SQLJ実行文の規則
    • 5.2.2 SQLJ句
    • 5.2.3 接続コンテキスト・インスタンスと実行コンテキスト・インスタンスの指定
    • 5.2.4 実行文の例
    • 5.2.5 実行文のPL/SQLブロック
  • 5.3 Javaホスト式、コンテキスト式および結果式
    • 5.3.1 ホスト式の概要
    • 5.3.2 基本的なホスト式の構文
    • 5.3.3 ホスト式の例
    • 5.3.4 結果式とコンテキスト式の概要
    • 5.3.5 Java式の実行時評価
    • 5.3.6 Java式の実行時評価の例(ISOコード生成)
    • 5.3.7 ホスト式の制限事項
  • 5.4 単一行の問合せ結果: SELECT INTO文
    • 5.4.1 SELECT INTO構文
    • 5.4.2 SELECT INTO文の例
    • 5.4.3 SELECTリストにホスト式を使用する例
    • 5.4.4 SELECT INTOエラー状態
  • 5.5 複数行の問合せ結果: SQLJイテレータ
    • 5.5.1 イテレータの概念
      • 5.5.1.1 強い型指定のイテレータの概要
      • 5.5.1.2 弱い型指定のイテレータの概要
    • 5.5.2 イテレータの使用手順
    • 5.5.3 名前付きイテレータ、位置イテレータおよび結果セット・イテレータ
    • 5.5.4 名前付きイテレータの使用
    • 5.5.5 位置イテレータの使用
    • 5.5.6 ホスト変数としてのイテレータおよび結果セットの使用
    • 5.5.7 イテレータ列としてのイテレータおよび結果セットの使用
  • 5.6 代入文(SET)
  • 5.7 ストアド・プロシージャおよびストアド・ファンクションのコール
    • 5.7.1 ストアド・プロシージャのコール
    • 5.7.2 ストアド・ファンクションのコール
    • 5.7.3 ストアド・ファンクションの戻り値としてのイテレータおよび結果セットの使用
• 6 型のサポート
  • 6.1 ホスト式での型サポート
    • 6.1.1 サポートされている型の概要
    • 6.1.2 JDBC 2.0でサポートされている型と要件
    • 6.1.3 PL/SQLのBOOLEAN型、RECORD型およびTABLE型の使用
    • 6.1.4 Oracle JDBCの旧リリースとの下位互換性
  • 6.2 ストリームのサポート
    • 6.2.1 SQLJストリームの一般的な使用方法
    • 6.2.2 ストリームをサポートするクラスの主な特長
    • 6.2.3 データ送信時のSQLJストリームの使用
    • 6.2.4 ストリームへのデータの取出し: 注意
    • 6.2.5 データ取得時のSQLJストリームの使用
    • 6.2.6 ストリーム・クラスのメソッド
    • 6.2.7 ストリーム・データの取出しおよび処理例
    • 6.2.8 出力パラメータおよびファンクションの戻り値としてのSQLJストリーム・オブジェクト
  • 6.3 JDBC 2.0 LOB型とOracle拡張型のサポート
    • 6.3.1 パッケージoracle.sql
    • 6.3.2 BLOB、CLOBおよびBFILEのサポート
    • 6.3.3 Oracle ROWIDのサポート
    • 6.3.4 OracleのREF CURSOR型のサポート
    • 6.3.5 その他のOracle Database 11g データ型のサポート
    • 6.3.6 BigDecimalのサポート強化
• 7 オブジェクト、コレクションおよびOPAQUE型
  • 7.1 Oracleのオブジェクトとコレクションについて
    • 7.1.1 オブジェクトとコレクションの概要
    • 7.1.2 Oracleオブジェクトの基本概念
    • 7.1.3 Oracleコレクションの基本概念
    • 7.1.4 オブジェクトとコレクションのデータ型
  • 7.2 カスタムJavaクラス
    • 7.2.1 カスタムJavaクラスのインタフェース指定
    • 7.2.2 オブジェクト・メソッドでのカスタムJavaクラスのサポート
    • 7.2.3 カスタムJavaクラスの要件
    • 7.2.4 カスタムJavaクラスのコンパイル
    • 7.2.5 カスタム・データの読込みと書込み
    • 7.2.6 ORAData実装のその他の使用例
  • 7.3 ユーザー定義データ型
  • 7.4 SQLJ実行文の強い型指定のオブジェクトと参照
    • 7.4.1 オブジェクトとオブジェクト参照のイテレータ列への取出し
    • 7.4.2 オブジェクトの更新
    • 7.4.3 各オブジェクト属性から作成したオブジェクトの挿入
    • 7.4.4 オブジェクト参照の更新
  • 7.5 SQLJ実行文の強い型指定のコレクション
    • 7.5.1 ネストした表へのアクセス: TABLE構文とCURSOR構文
    • 7.5.2 ネストした表を含む行の挿入
    • 7.5.3 ホスト式へのネストした表の取出し
    • 7.5.4 TABLE構文によるネストした表の操作
    • 7.5.5 ネスト・イテレータによるネストした表からのデータの選択
    • 7.5.6 ホスト式へのVARRAYの取出し
    • 7.5.7 VARRAY行への挿入
  • 7.6 シリアライズされたJavaオブジェクト
    • 7.6.1 RAWおよびBLOB列に対するJavaクラスのシリアライズ
    • 7.6.2 SerializableDatum: ORADataの実装
    • 7.6.3 SQLJアプリケーションのSerializableDatum
    • 7.6.4 SerializableDatum(クラス全体)
  • 7.7 弱い型指定のオブジェクト、参照およびコレクション
    • 7.7.1 弱い型指定のオブジェクト、参照およびコレクションのサポート
    • 7.7.2 弱い型指定のオブジェクト、参照およびコレクションの使用制限
  • 7.8 Oracle OPAQUE型
• 8 高度な言語機能
  • 8.1 接続コンテキスト
    • 8.1.1 接続コンテキストの概要
    • 8.1.2 接続コンテキストのロジスティクス
    • 8.1.3 接続コンテキスト・クラスの宣言と使用方法
    • 8.1.4 複数の接続コンテキストの例
    • 8.1.5 接続コンテキスト・クラスの実装と機能
    • 8.1.6 接続コンテキスト宣言でのIMPLEMENTS句の使用
    • 8.1.7 接続コンテキストのセマンティクス・チェック
    • 8.1.8 標準データ・ソースのサポート
    • 8.1.9 SQLJ固有のデータ・ソース
    • 8.1.10 JavaServer Pages用のSQLJ固有の接続JavaBeans
    • 8.1.11 グローバル・トランザクションのSQLJサポート
    • 8.1.12 PDBへの接続
  • 8.2 実行コンテキスト
    • 8.2.1 実行コンテキストと接続コンテキストとの関係
    • 8.2.2 実行コンテキスト・インスタンスの作成と指定
    • 8.2.3 実行コンテキストの同期
    • 8.2.4 実行コンテキストのメソッド
      • 8.2.4.1 状態メソッド
      • 8.2.4.2 制御メソッド
      • 8.2.4.3 取消しメソッド
      • 8.2.4.4 バッチ更新メソッド
      • 8.2.4.5 セーブポイント・メソッド
      • 8.2.4.6 クローズ・メソッド
      • 8.2.4.7 例: ExecutionContextメソッドの使用
    • 8.2.5 実行コンテキストとマルチスレッドの関係
  • 8.3 SQLJでのマルチスレッド
  • 8.4 イテレータ・クラスの実装と拡張機能
    • 8.4.1 イテレータ・クラスの実装と機能
    • 8.4.2 イテレータ宣言でのIMPLEMENTS句の使用
    • 8.4.3 イテレータ・クラスの拡張のサポート
    • 8.4.4 結果セット・イテレータ
    • 8.4.5 スクロール可能なイテレータ
  • 8.5 詳細なトランザクション制御
    • 8.5.1 SET TRANSACTION構文
    • 8.5.2 アクセス・モードの設定
    • 8.5.3 分離レベルの設定
    • 8.5.4 JDBC接続クラスのメソッドの使用
  • 8.6 SQLJとJDBCの連係動作
    • 8.6.1 SQLJ接続コンテキストとJDBC接続の連係動作
    • 8.6.2 SQLJイテレータとJDBC結果セットの連係動作
  • 8.7 動的SQLのサポート
    • 8.7.1 メタ・バインド式
    • 8.7.2 SQLJ動的SQLの例
  • 8.8 ストアド・アウトラインの使用
  • 8.9 計画ベースラインの使用
    • 8.9.1 計画ベースラインの生成
    • 8.9.2 コマンドラインおよびプロパティ・ファイルのオプション
      • 8.9.2.1 plan_baseline
      • 8.9.2.2 plan_prefix
      • 8.9.2.3 plan_run
      • 8.9.2.4 plan_fixed
      • 8.9.2.5 plan_enabled
    • 8.9.3 生成されるSQLファイル
      • 8.9.3.1 生成されるSQLファイルの名前
      • 8.9.3.2 生成されるSQLファイルの形式
    • 8.9.4 生成されるログ・ファイル
      • 8.9.4.1 生成されるログ・ファイルの名前
      • 8.9.4.2 生成されるログ・ファイルの形式
    • 8.9.5 生成されるJavaファイル
• 9 トランスレータのコマンドラインとオプション
  • 9.1 トランスレータのコマンドラインとプロパティ・ファイル
    • 9.1.1 SQLJのオプション、フラグおよび接頭辞
    • 9.1.2 コマンドラインの構文と処理
    • 9.1.3 プロパティ・ファイルによるオプション設定
    • 9.1.4 環境変数SQLJ_OPTIONSによるオプションの設定
    • 9.1.5 オプション設定の優先順位
  • 9.2 基本的なトランスレータ・オプション
    • 9.2.1 基本的なコマンドライン専用オプション
    • 9.2.2 出力ファイルとディレクトリのオプション
    • 9.2.3 接続オプション
    • 9.2.4 レポートと行マッピングのオプション
    • 9.2.5 DMSのオプション
    • 9.2.6 コード生成、最適化およびCHAR比較のオプション
  • 9.3 高度なトランスレータ・オプション
    • 9.3.1 オプション設定を他の実行可能プログラムに渡す接頭辞
    • 9.3.2 特殊処理のフラグ
    • 9.3.3 セマンティクス・チェックとオフライン解析のオプション
  • 9.4 トランスレータによる代替環境のサポートとオプション
    • 9.4.1 Javaおよびコンパイラのオプション
    • 9.4.2 カスタマイズのオプション
• 10 トランスレータとランタイムの検証
  • 10.1 トランスレータの内部操作
    • 10.1.1 JavaとSQLJのコード解析と構文チェック
    • 10.1.2 SQLのセマンティクス・チェックとオフライン解析
    • 10.1.3 コードの生成
    • 10.1.4 Javaコンパイル
    • 10.1.5 プロファイルのカスタマイズ(ISOコード生成の場合)
  • 10.2 トランスレータのエラー、メッセージおよび終了コード
    • 10.2.1 トランスレータのエラー、警告および情報メッセージ
    • 10.2.2 トランスレータのステータス・メッセージ
    • 10.2.3 トランスレータの終了コード
  • 10.3 SQLJランタイム
    • 10.3.1 SQLJランタイム・パッケージ
    • 10.3.2 ランタイム・エラーの分類
  • 10.4 トランスレータおよびランタイムでのグローバリゼーション・サポート
    • 10.4.1 文字エンコーディングと言語サポート
    • 10.4.2 SQLJおよびJavaの文字エンコーディングと言語サポートの設定
    • 10.4.3 SQLJ拡張グローバリゼーション・サポート
    • 10.4.4 SQLJ外部でのグローバリゼーション・サポート用の操作
• 11 パフォーマンスとデバッグ
  • 11.1 パフォーマンス強化の機能
    • 11.1.1 行プリフェッチ
    • 11.1.2 文のキャッシング
    • 11.1.3 バッチ更新機能
    • 11.1.4 列の定義
    • 11.1.5 パラメータ・サイズの定義
  • 11.2 SQLJのデバッグ機能
    • 11.2.1 デバッグ用のSQLJ -linemapフラグ
    • 11.2.2 AuditorInstaller専用カスタマイザの概要
    • 11.2.3 Oracle10g JDeveloperでの開発とデバッグの概要
  • 11.3 Oracle Performance MonitoringのSQLJサポート
    • 11.3.1 SQLJ DMSサポートの概要
    • 11.3.2 DMS用のSQLJコマンドライン・オプションの概要
    • 11.3.3 DMS用のSQLJランタイム・コマンドおよびプロパティ・ファイル設定
    • 11.3.4 SQLJ DMSセンサーとメトリック
    • 11.3.5 SQLJ DMSの例
• A カスタマイズおよび専用カスタマイザ
  • A.1 プロファイルについて
    • A.1.1 コード生成時のプロファイルの生成
    • A.1.2 プロファイル・エントリの例
      • A.1.2.1 SQLJ実行文
      • A.1.2.2 対応するSQLJプロファイル・エントリ
  • A.2 プロファイルのカスタマイズについて
    • A.2.1 カスタマイザ・ハーネスおよびカスタマイザの概要
    • A.2.2 カスタマイズ処理の手順
    • A.2.3 プロファイルのカスタマイズと登録
    • A.2.4 カスタマイズ時のエラー・メッセージとステータス・メッセージ
    • A.2.5 カスタマイズされたプロファイルの実行時の機能
  • A.3 カスタマイズ・オプションとカスタマイザの選択
    • A.3.1 カスタマイザ・ハーネスのオプションの概要
      • A.3.1.1 カスタマイザ・ハーネスのオプションの構文
      • A.3.1.2 カスタマイザ・ハーネスでサポートされているオプション
    • A.3.2 カスタマイザ・ハーネスの一般オプション
      • A.3.2.1 プロファイル・バックアップ・オプション(backup)
      • A.3.2.2 カスタマイズ接続コンテキスト・オプション(context)
      • A.3.2.3 カスタマイザ・オプション(customizer)
      • A.3.2.4 カスタマイズ用JARファイルのダイジェスト・オプション(digests)
      • A.3.2.5 カスタマイズ用ヘルプ・オプション(help)
      • A.3.2.6 カスタマイズ用の詳細オプション(verbose)
    • A.3.3 カスタマイザ・ハーネスの接続用オプション
      • A.3.3.1 カスタマイズ用ユーザー・オプション(user)
      • A.3.3.2 カスタマイズ用パスワード・オプション(password)
      • A.3.3.3 カスタマイズ用URL・オプション(url)
      • A.3.3.4 カスタマイズ用JDBCドライバ・オプション(driver)
    • A.3.4 専用のカスタマイザの起動に使用するカスタマイザ・ハーネスのオプション
      • A.3.4.1 専用カスタマイザ: プロファイル・デバッグ・オプション(debug)
      • A.3.4.2 専用カスタマイザ: プロファイル出力オプション(print)
      • A.3.4.3 専用カスタマイザ: プロファイルのセマンティクス・チェック用オプション(verify)
    • A.3.5 カスタマイザ固有のオプションの概要
    • A.3.6 Oracleカスタマイザのオプション
      • A.3.6.1 Oracleカスタマイザでサポートされているオプション
      • A.3.6.2 Oracleカスタマイザのバージョン互換性オプション(compat)
      • A.3.6.3 Oracleカスタマイザの強制オプション(force)
      • A.3.6.4 Oracleカスタマイザの列定義オプション(optcols)
      • A.3.6.5 Oracleカスタマイザのパラメータ定義オプション(optparams)
      • A.3.6.6 Oracleカスタマイザ用パラメータのデフォルト・サイズ・オプション(optparamdefaults)
      • A.3.6.7 Oracleカスタマイザによる空白埋めを考慮したCHAR比較(fixedchar)
      • A.3.6.8 OracleカスタマイザのSQL表示オプション(showSQL)
      • A.3.6.9 Oracleカスタマイザ用の文のキャッシュ・サイズ・オプション(stmtcache)
      • A.3.6.10 Oracleカスタマイザのサマリー・オプション(summary)
    • A.3.7 他のカスタマイザ用のオプション
    • A.3.8 プロファイルのカスタマイズ用のSQLJトランスレータのオプション
  • A.4 プロファイルのJARファイル
    • A.4.1 JARファイルの要件
    • A.4.2 JARファイルのロジスティクス
  • A.5 プロファイルのセマンティクス・チェック用のSQLCheckerCustomizer
    • A.5.1 カスタマイザ・ハーネスのverifyオプションによるSQLCheckerCustomizerの起動
    • A.5.2 SQLCheckerCustomizerオプション
      • A.5.2.1 SQLCheckerCustomizerセマンティクス・チェッカのオプション(checker)
      • A.5.2.2 SQLCheckerCustomizerの警告オプション(warn)
  • A.6 デバッグ用のAuditorInstallerカスタマイザ
    • A.6.1 オーディタとコード・レイヤーの概要
    • A.6.2 カスタマイザ・ハーネスの-debugオプションによるAuditorInstallerの起動
    • A.6.3 AuditorInstallerのランタイム出力
    • A.6.4 AuditorInstallerオプション
      • A.6.4.1 AuditorInstallerのdepthオプション(depth)
      • A.6.4.2 AuditorInstallerのログ・ファイル・オプション(log)
      • A.6.4.3 AuditorInstallerのprefixオプション(prefix)
      • A.6.4.4 AuditorInstallerの戻り引数オプション(showReturns)
      • A.6.4.5 AuditorInstallerのスレッド名オプション(showThreads)
      • A.6.4.6 AuditorInstallerのuninstallオプション(uninstall)
    • A.6.5 完全なコマンドラインの例
• 索引