目次

図一覧

表一覧

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

はじめに

• 対象読者
• ドキュメントのアクセシビリティについて
• このマニュアルの構成
• 関連ドキュメント
• 表記規則

1 JPublisherの概要

• JPublisherの概要
• JPublisherに関する初期の考慮事項
  • Oracle Database 11gリリース2のJPublisherの新機能
  • JPublisherの一般的な要件
  • JPublisherのインストール
  • JPublisherのインストールの検証
    • SQLJUTLおよびSQLJUTL2パッケージの確認またはインストール
    • UTL_DBWSパッケージの確認またはインストール
    • dbwsclient.jarファイルの確認またはロード
    • Oracle9iまたはOracle8iでWebサービスのコールアウトに使用するJARファイルのロード
    • リモートSYSログインのためのパスワード・ファイルの設定
  • JPublisherによるSQLJ実装の使用
    • SQLJ使用の概要
    • SQLJの概念の概要
    • SQLJソース・ファイルに影響する下位互換性モード
  • 要件が緩和される場合
  • JPublisherの制限事項
• JPublisherで公開できる内容
• JPublisherマッピングとマッピング・カテゴリ
  • ユーザー定義型とPL/SQL型のJPublisherマッピング
    • JPublisherを介したユーザー定義SQL型の表現方法
    • ORAData実装の強い型指定を持つオブジェクト参照の使用
    • JPublisherを介したPL/SQL型の使用
  • JPublisherのマッピング・カテゴリ
    • JDBCマッピング
    • Object JDBCマッピング
    • BigDecimalマッピング
    • Oracleマッピング
• JPublisherの入力および出力
  • JPublisherへの入力
  • JPublisherからの出力
    • ユーザー定義オブジェクト型のJava出力
    • ユーザー定義コレクション型のJava出力
    • OPAQUE型のJava出力
    • PL/SQLパッケージのJava出力
    • サーバー・サイドJavaクラスとWebサービスのコールアウトのJava出力
    • SQL問合せまたはDML文のJava出力
    • AQおよびストリームのJava出力
    • PL/SQL出力
• JPublisherの操作
  • 公開プロセスの概要: 出力の生成および使用
  • JPublisherコマンドライン構文
  • JPublisher変換の例

2 JPublisherの使用方法

• ユーザー定義のSQL型の公開
• PL/SQLパッケージの公開
• Oracle Streams AQの公開
  • Javaクラスとしてのキューの公開
  • Javaクラスとしてのトピックの公開
  • Javaクラスとしてのストリームの公開
• ネイティブJavaインタフェースを介したサーバー・サイドJavaクラスの公開
• PL/SQLラッパーを介したサーバー・サイドJavaクラスの公開
• PL/SQLへのサーバー・サイドJavaクラスの公開
• テーブル・ファンクションへのサーバー・サイドJavaクラスの公開
• PL/SQLへのWebサービス・クライアントの公開

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

• JPublisherのデータ型マッピング
  • JPublisherのデータ型マッピングの概要
  • OracleおよびJDBC型へのSQLとPL/SQLのマッピング
  • JPublisherのユーザー型マップとデフォルトの型マップ
  • データ型マッピングに関するJPublisherの論理進行
  • オブジェクト属性の型
  • REF CURSOR型と結果セットのマッピング
  • JDBCマッピングにおける接続
• PL/SQLデータ型のサポート
  • OPAQUE型の型マッピング・サポート
  • スカラーの索引付き表の型マッピング・サポート
  • PL/SQL変換ファンクションを介した型マッピングのサポート
  • PL/SQLのRECORD型と索引付き表の型の型マッピング・サポート
    • RECORD型と索引付き表の型のサポートを示すサンプル・パッケージ
    • RECORD型のサポート
    • 索引付き表の型のサポート
  • PL/SQL変換ファンクションを直接使用する場合とラッパー・ファンクションを使用する場合
  • JDBCでサポートされないデータ型に対するその他の代替方法
• JPublisherのスタイルとスタイル・ファイル
  • スタイル・ファイルの指定と位置
  • スタイル・ファイルの形式
    • スタイル・ファイルのTRANSFORMATIONセクション
    • スタイル・ファイルのOPTIONSセクション
  • Oracleスタイル・ファイルでの主要なJava間の型マッピングのサマリー
  • 複数のスタイル・ファイルの使用

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

• JPublisherによるWebサービス・サポートの概要
  • データベースに対するWebサービスのコールインのサポート概要
  • データベースからのWebサービスのコールアウトに対するサポート
    • 静的プロキシとJPublisherを使用したWebサービスのコールアウトの実行方法
  • サーバー・サイドJavaのコール(コールイン)
• JPublisher出力のフィルタ機能
  • ファンクションまたはプロシージャの指定サブセットの公開
  • パラメータのモードまたは型に従ったファンクションまたはプロシージャの公開
  • 生成されるメソッドのJavaBeans仕様への準拠の保証
• 下位互換性および移行
  • JPublisherの下位互換性
  • Oracle Database 10gリリース1とリリース2の間でのJPublisherの動作変更
  • Oracle9i DatabaseとOracle Database 10gの間でのJPublisherの動作変更
  • Oracle8i DatabaseとOracle9i Databaseの間でのJPublisherの動作変更
  • JPublisherの下位互換性モードと設定
    • .sqljファイルの明示的生成
    • Oracle9i互換モード
    • Oracle8i互換モード
    • JPublisherにOracle8iでの動作を強制する個々の設定

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

• 出力パラメータの取扱い
  • 配列を使用した出力パラメータ渡し
  • JAX-RPCホルダーを使用した出力パラメータ渡し
  • ファンクションの戻りを使用した出力パラメータ渡し
• オーバーロードされたメソッドの変換
• SQLJクラスの生成
  • SQLJクラスの生成に関する重要な注意事項
  • PL/SQLパッケージ用のSQLJクラスの使用
  • オブジェクト型用のSQLJクラスの使用
  • SQLJクラスでの接続コンテキストおよびインスタンス
  • setFrom()、setValueFrom()およびsetContextFrom()メソッド
• 非SQLJクラスの生成
• Javaインタフェースの生成
• JPublisherのサブクラス
  • JPublisherで生成されたクラスの拡張
    • 代替クラスへのマッピングの構文
    • 生成クラスを拡張するクラスの書式化
• 継承のサポート
  • ORADataのオブジェクト型および継承
    • 部分的に生成された型階層を組み合せる場合の事前作業
    • JPublisherで生成されたコードでの型階層のマッピング
  • ORADataの参照型および継承
    • 別の参照型への参照型のインスタンスのキャスト
    • 参照型の継承がオブジェクト型の継承に従わない理由
    • 参照型間の手動変換
    • 例: 参照型間の手動変換
  • SQLDataのオブジェクト型および継承
  • SQL FINAL、NOT FINAL、NOT INSTANTIABLEを使用する効果

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

• JPublisherオプション
  • JPublisherのオプションのサマリー
  • JPublisherオプションのヒント
  • 表記規則
  • 入力ファイルおよび公開する項目に関するオプション
    • 変換対象のオブジェクトとパッケージの名前を含むファイル
    • 公開対象のサーバー・サイドJavaクラスの宣言
    • 公開対象のサーバー・サイドJavaクラスの宣言
    • 公開対象のサーバー・サイドJavaクラスの宣言
    • JavaおよびPL/SQLラッパー生成用の設定
    • 入力プロパティ・ファイル
    • 変換対象のオブジェクト型およびパッケージの宣言
    • 変換対象のSQL文の宣言
    • 変換対象のオブジェクト型の宣言
  • 接続オプション
    • SQLJ接続コンテキスト・クラス
    • デフォルトのdatasourceオプション
    • データベース接続用のJDBCドライバ・クラス
    • ターゲット・データベースへの接続URL
    • データベース接続用のユーザー名とパスワード
  • データ型マッピングのオプション
    • 組込み型のマッピング
    • LOB型のマッピング
    • 数値型のマッピング
    • ユーザー定義型のマッピング
    • すべての型のマッピング
    • Java間の型マッピング用のスタイル・ファイル
  • 型マップのオプション
    • デフォルトの型マップへのエントリの追加
    • ユーザー型マップへの追加エントリ
    • JPublisherのデフォルトの型マップ
    • JPublisherの型マップの置換
  • Javaコード生成オプション
    • メソッドのアクセス
    • Java識別名の大/小文字の区別
    • コード生成のタイプ
    • パラメータ・モードに従ったメソッドのフィルタリング
    • パラメータ型に従ったメソッドのフィルタリング
    • JavaBeans仕様に準拠したコード生成
    • クラスとインタフェースのネーミング・パターン
    • ユーザー・サブクラスの生成
    • パッケージのクラスおよびラッパー・メソッドの生成
    • 名前参照からのスキーマ名の省略
    • 出力引数のホルダー型
    • 生成されたJavaパッケージの名前
    • 生成されたオブジェクト・ラッパー・クラスのシリアライズ可能性
    • オブジェクト・ラッパー・クラスのtoString()メソッドの生成
    • mainメソッドの名前の変更
  • PL/SQLコード生成オプション
    • SQL型の生成
    • PL/SQLスクリプトのファイル名
    • PL/SQLラッパー・ファンクションの生成
    • 生成されたPL/SQLコード用のパッケージ
    • PL/SQLの索引付き表用のパッケージ
  • 出入力オプション
    • コンパイルまたは変換の抑制
    • 生成されたソース・ファイルとクラス・ファイルの出力ディレクトリ
    • Javaにおける文字のエンコーディング
  • Webサービスのコールアウトを容易にするオプション
    • JavaおよびPL/SQLラッパー生成用のWSDLドキュメント
    • Webサービスのエンドポイント
    • WSDLのプロキシURL
    • クライアント・プロキシを実行するスーパーユーザー・パーミッション
  • SQLJ機能にアクセスするためのオプション
    • SQLJ Translator用の設定
  • 下位互換性オプション
    • ユーザー定義型用の下位互換性を持つOracleマッピング
  • Java環境オプション
    • 変換およびコンパイル用のCLASSPATH
    • Javaコンパイラ
    • Javaのバージョン
  • SQLJ移行オプション
• JPublisher入力ファイル
  • プロパティ・ファイルの構造および構文
  • INPUTファイルの構造および構文
    • 変換文について
    • 変換文の例
  • INPUTファイルの事前注意事項
    • 複数の異なるオブジェクト型に対する同じJavaクラス名の要求
    • 複数の異なるオブジェクト属性に対する同じ属性名の要求
    • 存在しない属性の指定
    • JPublisherの予約語

A 生成されるコードの例

• 生成されるコード: SQL文
• 生成されるコード: サーバー・サイドJavaのコールイン
  • ソース・ファイル
  • サーバー・サイドJavaクラスの公開
  • 生成されるファイル
  • 公開されたファイルのテスト

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

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

索引