complianceドキュメントに従ってJava™SE 6で実装される「IDL-to-Java言語マッピング仕様」に従って、IDL-to-Javaコンパイラによって生成されるファイル。
一般に、IDL名および識別子は、変更なしでJava名および識別子にマッピングされます。 Java言語の性質のために、1つのIDL構文が複数の(名前が異なる) Java構文にマッピングされることがあります。 追加の名前は、説明用の接尾辞を付加して構築されます。 たとえば、IDLインタフェースfooはJavaインタフェースfooとfooOperations、および追加のJavaクラスfooHelper、fooHolder、fooPOA、および(オプションで) fooPOATieにマッピングされます。
実質的に、マッピングでは特定の目的に合わせて複数の名前の使用が予約されます。 次に初期参照を示します。
<type>Helper。ここで、<type>はIDL定義型の名前です。
<type>Holder。ここで、<type>はIDL定義型(typedef別名などの特定の例外があります)の名前です。
<basicJavaType>Holder (<basicJavaType>は、いずれかのIDL基本データ型で使用される、いずれかのJavaプリミティブ・データ型)。
<interface>Operations、<interface>POA、および<interface>POATie。ここで、<interface>はIDLインタフェース型の名前です。
<interface>Package (<interface>は、IDLインタフェースの名前)。
ヘルパー・ファイルは、型の操作に必要な複数のstaticメソッドを提供します。 これらには、リポジトリIDの取得、型コードの取得、ストリームに対する型の読み書きなど、型の挿入および抽出オペレーションすべてが含まれます。
マップされたIDLインタフェースまたは抽象インタフェースのヘルパー・クラスにはナロー操作も含まれます。 staticナロー・メソッドにより、org.omg.CORBA.Objectがさらに特定の型のオブジェクト参照にナロー変換されます。 オブジェクト参照がリクエストされた型をサポートしないためにナロー変換に失敗した場合は、IDL例外CORBA::BAD_PARAMがスローされます。 その他の種類のエラーを示す場合は、異なるシステム例外がスローされます。 nullのナロー変換は常に成功し、null値が返されます。
outおよびinoutパラメータの引渡しモードをサポートするには、追加のホルダー・クラスが必要です。 これらのクラスは、org.omg.CORBAパッケージ内のすべての基本IDLデータ型に使用でき、typedefsで定義されたものを除くすべての名前付きユーザー定義IDL型についても生成されます。 この場合、ユーザー定義には、インタフェース・リポジトリ用などのOMG仕様、およびその他のOMGサービスで定義される型が含まれます。
各ホルダー・クラスは、インスタンスからのコンストラクタ(デフォルトのコンストラクタ)と型の値であるpublicインスタンス・メンバーvalueを持ちます。 デフォルトのコンストラクタは、値フィールドをJava言語で定義された型のデフォルト値に設定します。booleanの場合はfalse、数値およびchar型の場合は0、文字列の場合はnull、オブジェクト参照の場合はnullです。
ポータブル・スタブおよびスケルトンをサポートするため、ホルダー・クラスはorg.omg.CORBA.portable.Streamableインタフェースも実装します。
非抽象IDLインタフェースは、シグネチャ・インタフェースとオペレーション・インタフェースの2つのパブリックJavaインタフェースにマップされています。 シグネチャ・インタフェースは、IDLEntityを拡張したものでIDLインタフェース名と同じ名前を持ち、指定した型のインタフェースを他のインタフェースで使用する場合にメソッド宣言のシグネチャ型として使用します。 オペレーション・インタフェースの名前はIDLインタフェースと同じですが、Operationsという接尾辞があり、同一の場所にあるクライアントとサーバーのために最適化された呼出しを提供するメカニズムとしてサーバー側マッピングで使用されます。
Javaオペレーション・インタフェースには、マップされたオペレーション・シグネチャが含まれます。 Javaシグニチャ・インタフェースは、オペレーション・インタフェースである(マップされた)基底org.omg.CORBA.Objectおよびorg.omg.portable.IDLEntityを拡張します。 メソッドは、シグニチャ・インタフェース上で呼び出すことができます。 IDLで表現されるインタフェース継承は、Javaシグニチャ・インタフェース階層とオペレーション・インタフェース階層の両方で反映されます。
非オブジェクト指向言語のマッピングでは、インタフェース型ごとにスタブに対するプログラミング・インタフェースがあります。 一般にスタブは、OMG IDLに慣れているプログラマであれば簡単に予測できるような方法でオブジェクトのOMG IDLで定義されたオペレーションにアクセスする方法を表現したり、特定プログラミング言語の言語マッピングを表したりします。 スタブは、特定のORBコアに対して非公開であり最適化されているインタフェースを使用して、ORBの残りで呼び出します。 複数のORBが使用可能な場合、ORBごとに対応するスタブが異なることがあります。 この場合、正しいスタブと特定のオブジェクト参照を関連付けるために、ORBおよび言語マッピングが協調する必要があります。
Java、C ++、Smalltalkなどのオブジェクト指向プログラミング言語では、スタブ・インタフェースは必要ありません。
バグを報告する、または機能強化を提案する
さらにAPIリファレンスと開発者ドキュメントについては、概念的な概要、用語の定義、回避策、および作業コードの例など、より詳細な開発者向けの説明が含まれている「Java SEドキュメンテーション」を参照してください。
Javaは、米国およびその他の国におけるOracleおよび/またはその関連会社の商標または登録商標です。
Copyright © 1993, 2018, Oracle and/or its affiliates, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
All rights reserved. 使用は「ライセンス条項」と「ドキュメンテーション再配布ポリシー」に従います。