目次

図一覧

表一覧

タイトルおよび著作権情報

はじめに

ドキュメントのアクセシビリティについて

このマニュアルの構成

関連ドキュメント

サポートおよびサービス

1 JPublisherの概要

1.1 JPublisherの概要

1.2 JPublisherに関する初期の考慮事項

1.2.1 Oracle Database 10gのJPublisherの新機能

1.2.1.1 Webサービスの新機能

1.2.1.2 Java環境の認識

1.2.1.3 暗黙的なSQLJ変換

1.2.2 JPublisherによるSQLJ実装の使用

1.2.2.1 SQLJ使用の概要

1.2.2.2 SQLJの概念の概要

1.2.2.3 SQLJソース・ファイルに影響する下位互換性モード

1.2.3 JPublisherの一般的な要件

1.2.4 必要なデータベース設定

1.2.4.1 SQLJUTLおよびSQLJUTL2パッケージの確認またはインストール

1.2.4.2 sqljutl.jarファイルの確認またはロード

1.2.4.3 UTL_DBWSパッケージの確認またはインストール

1.2.4.4 dbwsclient.jarファイルの確認またはロード

1.2.4.5 Oracle9iまたはOracle8iでWebサービスのコールアウトに使用するJARファイルのロード

1.2.4.6 リモートSYSログインのためのパスワード・ファイルの設定

1.2.5 要件が緩和される場合

1.2.6 JPublisherの制限事項

1.3 JPublisherで公開できる内容

1.4 JPublisherマッピングとマッピング・カテゴリ

1.4.1 ユーザー定義型とPL/SQL型のJPublisherマッピング

1.4.1.1 JPublisherを介したユーザー定義SQL型の表現方法

1.4.1.2 ORAData実装の強い型指定を持つオブジェクト参照の使用

1.4.1.3 JPublisherを介したPL/SQL型の使用

1.4.2 JPublisherのマッピング・カテゴリ

1.4.2.1 JDBCマッピング

1.4.2.2 Object JDBCマッピング

1.4.2.3 BigDecimalマッピング

1.4.2.4 Oracleマッピング

1.5 JPublisherの入力および出力

1.5.1 JPublisherへの入力

1.5.2 JPublisherからの出力

1.5.2.1 ユーザー定義オブジェクト型のJava出力

1.5.2.2 ユーザー定義コレクション型のJava出力

1.5.2.3 OPAQUE型のJava出力

1.5.2.4 PL/SQLパッケージのJava出力

1.5.2.5 サーバー・サイドJavaクラスとWebサービスのコールアウトのJava出力

1.5.2.6 SQL問合せまたはDML文のJava出力

1.5.2.7 AQおよびストリームのJava出力

1.5.2.8 PL/SQL出力

1.6 JPublisherの操作

1.6.1 公開プロセスの概要: 出力の生成および使用

1.6.2 JPublisherコマンドライン構文

1.6.3 JPublisher変換の例

2 JPublisherの使用方法

2.1 ユーザー定義のSQL型の公開

2.2 PL/SQLパッケージの公開

2.3 Oracle Streams AQの公開

2.3.1 Javaクラスとしてのキューの公開

2.3.2 Javaクラスとしてのトピックの公開

2.3.3 Javaクラスとしてのストリームの公開

2.4 ネイティブJavaインタフェースを介したサーバー・サイドJavaクラスの公開

2.5 PL/SQLラッパーを介したサーバー・サイドJavaクラスの公開

2.6 PL/SQLへのサーバー・サイドJavaクラスの公開

2.7 テーブル・ファンクションへのサーバー・サイドJavaクラスの公開

2.8 PL/SQLへのWebサービス・クライアントの公開

3 データ型およびJava間の型マッピング

3.1 JPublisherのデータ型マッピング

3.1.1 JPublisherのデータ型マッピングの概要

3.1.2 OracleおよびJDBC型へのSQLとPL/SQLのマッピング

3.1.3 JPublisherのユーザー型マップとデフォルトの型マップ

3.1.4 データ型マッピングに関するJPublisherの論理進行

3.1.5 オブジェクト属性の型

3.1.6 REF CURSOR型と結果セットのマッピング

3.1.7 JDBCマッピングにおける接続

3.2 PL/SQLデータ型のサポート

3.2.1 OPAQUE型の型マッピング・サポート

3.2.1.1 OPAQUE型のサポート

3.2.1.2 XMLTYPEのサポート

3.2.2 スカラーの索引付き表の型マッピング・サポート

3.2.3 PL/SQL変換ファンクションを介した型マッピングのサポート

3.2.4 PL/SQLのRECORD型と索引付き表の型の型マッピング・サポート

3.2.4.1 RECORD型と索引付き表の型のサポートを示すサンプル・パッケージ

3.2.4.2 RECORD型のサポート

3.2.4.3 索引付き表の型のサポート

3.2.5 PL/SQL変換ファンクションを直接使用する場合とラッパー・ファンクションを使用する場合

3.2.6 JDBCでサポートされないデータ型に対するその他の代替方法

3.3 JPublisherのスタイルとスタイル・ファイル

3.3.1 スタイル・ファイルの指定と位置

3.3.2 スタイル・ファイルの形式

3.3.2.1 スタイル・ファイルのTRANSFORMATIONセクション

3.3.2.2 スタイル・ファイルのOPTIONSセクション

3.3.3 Oracleスタイル・ファイルでの主要なJava間の型マッピングのサマリー

3.3.4 複数のスタイル・ファイルの使用

4 生成されるクラスおよびインタフェース

4.1 出力パラメータの取扱い

4.1.1 配列を使用した出力パラメータ渡し

4.1.2 JAX-RPCホルダーを使用した出力パラメータ渡し

4.1.3 ファンクションの戻りを使用した出力パラメータ渡し

4.2 オーバーロードされたメソッドの変換

4.3 SQLJクラスの生成

4.3.1 SQLJクラスの生成に関する重要な注意事項

4.3.2 PL/SQLパッケージ用のSQLJクラスの使用

4.3.3 オブジェクト型用のSQLJクラスの使用

4.3.4 SQLJクラスでの接続コンテキストおよびインスタンス

4.3.5 setFrom()、setValueFrom()およびsetContextFrom()メソッド

4.4 非SQLJクラスの生成

4.5 Javaインタフェースの生成

4.6 JPublisherのサブクラス

4.6.1 JPublisherで生成されたクラスの拡張

4.6.1.1 代替クラスへのマッピングの構文

4.6.1.2 生成クラスを拡張するクラスの書式化

4.6.2 Java間の型変換用にJPublisherで生成されるサブクラス

4.7 継承のサポート

4.7.1 ORADataのオブジェクト型および継承

4.7.1.1 部分的に生成された型階層を組み合せる場合の事前作業

4.7.1.2 JPublisherで生成されたコードでの型階層のマッピング

4.7.2 ORADataの参照型および継承

4.7.2.1 別の参照型への参照型のインスタンスのキャスト

4.7.2.2 参照型の継承がオブジェクト型の継承に従わない理由

4.7.2.3 参照型間の手動変換

4.7.2.4 例: 参照型間の手動変換

4.7.3 SQLDataのオブジェクト型および継承

4.7.4 SQL FINAL、NOT FINAL、NOT INSTANTIABLEを使用する効果

5 その他の機能と考慮事項

5.1 JPublisherによるWebサービス・サポートの概要

5.1.1 データベースに対するWebサービスのコールインのサポート概要

5.1.2 データベースからのWebサービスのコールアウトに対するサポート

5.1.3 サーバー・サイドJavaのコール（コールイン）

5.2 JPublisher出力のフィルタ機能

5.2.1 ファンクションまたはプロシージャの指定サブセットの公開

5.2.2 パラメータのモードまたは型に従ったファンクションまたはプロシージャの公開

5.2.3 生成されるメソッドのJavaBeans仕様への準拠の保証

5.3 下位互換性および移行

5.3.1 JPublisherの下位互換性

5.3.2 Oracle Database 10gリリース1とリリース2の間でのJPublisherの動作変更

5.3.3 Oracle9i DatabaseとOracle Database 10gの間でのJPublisherの動作変更

5.3.4 Oracle8i データベースとOracle9i Databaseの間でのJPublisherの動作変更

5.3.5 JPublisherの下位互換性モードと設定

5.3.5.1 .sqljファイルの明示的生成

5.3.5.2 Oracle9i互換モード

5.3.5.3 Oracle8i互換モード

5.3.5.4 JPublisherにOracle8iでの動作を強制する個々の設定

6 コマンドライン・オプションおよび入力ファイル

6.1 JPublisherオプション

6.1.1 JPublisherのオプションのサマリー

6.1.2 JPublisherオプションのヒント

6.1.3 表記規則

6.1.4 入力ファイルおよび公開する項目に関するオプション

6.1.4.1 変換対象のオブジェクトとパッケージの名前を含むファイル

6.1.4.2 公開対象のサーバー・サイドJavaクラスの宣言

6.1.4.3 公開対象のサーバー・サイドJavaクラスの宣言

6.1.4.4 公開対象のサーバー・サイドJavaクラスの宣言

6.1.4.5 JavaおよびPL/SQLラッパー生成用の設定

6.1.4.6 入力プロパティ・ファイル

6.1.4.7 変換対象のオブジェクト型およびパッケージの宣言

6.1.4.8 変換対象のSQL文の宣言

6.1.4.9 変換対象のオブジェクト型の宣言

6.1.5 接続オプション

6.1.5.1 SQLJ接続コンテキスト・クラス

6.1.5.2 デフォルトのdatasourceオプション

6.1.5.3 データベース接続用のJDBCドライバ・クラス

6.1.5.4 ターゲット・データベースへの接続URL

6.1.5.5 データベース接続用のユーザー名とパスワード

6.1.6 データ型マッピングのオプション

6.1.6.1 組込み型のマッピング

6.1.6.2 LOB型のマッピング

6.1.6.3 数値型のマッピング

6.1.6.4 ユーザー定義型のマッピング

6.1.6.5 すべての型のマッピング

6.1.6.6 Java間の型マッピング用のスタイル・ファイル

6.1.7 型マップのオプション

6.1.7.1 デフォルトの型マップへのエントリの追加

6.1.7.2 ユーザー型マップへの追加エントリ

6.1.7.3 JPublisherのデフォルトの型マップ

6.1.7.4 JPublisherの型マップの置換

6.1.8 Javaコード生成オプション

6.1.8.1 メソッドのアクセス

6.1.8.2 Java識別名の大文字小文字の区別

6.1.8.3 パラメータ・モードに従ったメソッドのフィルタリング

6.1.8.4 パラメータ型に従ったメソッドのフィルタリング

6.1.8.5 JavaBeans仕様に準拠したコード生成

6.1.8.6 クラスとインタフェースのネーミング・パターン

6.1.8.7 ユーザー・サブクラスの生成

6.1.8.8 パッケージのクラスおよびラッパー・メソッドの生成

6.1.8.9 名前参照からのスキーマ名の省略

6.1.8.10 出力引数のホルダー型

6.1.8.11 生成されたJavaパッケージの名前

6.1.8.12 生成されたオブジェクト・ラッパー・クラスのシリアライズ可能性

6.1.8.13 オブジェクト・ラッパー・クラスのtoString()メソッドの生成

6.1.8.14 mainメソッドの名前の変更

6.1.9 PL/SQLコード生成オプション

6.1.9.1 SQL型の生成

6.1.9.2 PL/SQLスクリプトのファイル名

6.1.9.3 PL/SQLラッパー・ファンクションの生成

6.1.9.4 生成されたPL/SQLコード用のパッケージ

6.1.9.5 PL/SQLの索引付き表用のパッケージ

6.1.10 出入力オプション

6.1.10.1 コンパイルまたは変換の抑制

6.1.10.2 生成されたソース・ファイルとクラス・ファイルの出力ディレクトリ

6.1.10.3 Javaにおける文字のエンコーディング

6.1.11 Webサービスのコールアウトを容易にするオプション

6.1.11.1 JavaおよびPL/SQLラッパー生成用のWSDLドキュメント

6.1.11.2 Webサービスのエンドポイント

6.1.11.3 WSDLのプロキシURL

6.1.11.4 クライアント・プロキシを実行するスーパーユーザー・パーミッション

6.1.12 SQLJ機能にアクセスするためのオプション

6.1.12.1 SQLJ Translator用の設定

6.1.13 下位互換性オプション

6.1.13.1 ユーザー定義型用の下位互換性を持つOracleマッピング

6.1.14 Java環境オプション

6.1.14.1 変換およびコンパイル用のCLASSPATH

6.1.14.2 Javaコンパイラ

6.1.14.3 Javaのバージョン

6.1.15 SQLJ移行オプション

6.2 JPublisher入力ファイル

6.2.1 プロパティ・ファイルの構造および構文

6.2.2 INPUTファイルの構造および構文

6.2.2.1 変換文について

6.2.2.2 変換文の例

6.2.3 INPUTファイルの事前注意事項

6.2.3.1 複数の異なるオブジェクト型に対する同じJavaクラス名の要求

6.2.3.2 複数の異なるオブジェクト属性に対する同じ属性名の要求

6.2.3.3 存在しない属性の指定

6.2.3.4 JPublisherの予約語

A 生成されるコードの例

A.1 生成されるコード: Java間変換用のユーザー・サブクラス

A.1.1 インタフェース・コード

A.1.2 ベース・クラス・コード

A.1.3 ユーザー・サブクラス・コード

A.2 生成されるコード: SQL文

A.3 生成されるコード: サーバー・サイドJavaのコールイン

A.3.1 ソース・ファイル

A.3.2 サーバー・サイドJavaクラスの公開

A.3.3 生成されるファイル

A.3.4 公開されたファイルのテスト

B トラブルシューティング

B.1 Webサービス・クライアントを公開中のエラー

索引