CORBA の互換性情報 - J2SE 5.0

J2SE 1.4.x と J2SE 5.0.x の間での CORBA API の変更
J2SE 5.0.x での CORBA サポートの公式仕様
その他の互換性情報

J2SE 1.3 と J2SE 5.0 の間での CORBA API の変更

このドキュメントでは、CORBA の機能に関連して JDK 1.3 と 5.0 の間で変更されたすべての API について情報を提供します。この変更は、JDK 5.0 に組み込まれる CORBA 技術用の API を、次に示す OMG ドキュメントに規定されている CORBA 2.3 マッピングに準拠させるために行われたものです。

CORBA 2.3.1 (formal/99-10-07)
IDL から Java 言語へのマッピング (ptc/00-01-08)
Java から IDL 言語へのマッピング (ptc/00-01-06)
Interoperable Naming Service (/ptc/00-08-07)
ポータブルインセプタ (ptc/2001-03-04)

`org.omg.COSNaming` クラスでの API の変更

CORBA バージョン 2.3 仕様で規定されている IDL から Java へのマッピングに準拠するため、次に示す org.omg.COSNaming クラスを、JDK に同梱されている idlj コンパイラで再生成しました。この変更 (CCC 4284015) には、次のような API の変更が含まれます。互換性への影響: なし。

CORBA V (2.3) のセクション 1.5.2 にあるすべての Helper に関する仕様 (ptc/00-01-08.pdf) に準拠するため、Helper はすべて abstract public クラスになりました。次に、org.omg.CosNaming に属するクラスで abstract public クラスに変更されたすべての Helper クラスを示します。
- BindingHelper.java
- BindingIteratorHelper.java
- BindingListHelper.java
- BindingTypeHelper.java
- IStringHelper.java
- NameComponentHelper.java
- NameHelper.java
- NamingContextHelper.java
- AlreadyBoundHelper.java
- CannotProceedHelper.java
- InvalidNameHelper.java
- NotEmptyHelper.java
- NotFoundHelper.java
- NotFoundReasonHelper.java
セクション 1.7 にある OMG 仕様 (ptc/00-01-08.pdf) の「Mapping for Enum」に準拠するため、次に示す Enum コンストラクタのマッピングが protected に変更されました。

CLASS BEFORE 変更後

BindingType.java private BindingType(int) protected BindingType(int)

NotFoundReason.java private NotFoundReason(int) protected NotFoundReason(int)

CLASS	BEFORE	変更後
`BindingType.java`	private BindingType(int)	protected BindingType(int)
`NotFoundReason.java`	private NotFoundReason(int)	protected NotFoundReason(int)

CORBA 2.3 仕様 (ptc/00-01-08.pdf) の「Deletion of constructors in Stub classes」に準拠するため、次に示すコンストラクタが削除されました。

CLASS	BEFORE	変更後
`_BindingIteratorStub.java`	public _BindingIteratorStub(org.omg.CORBA.portable.Delegate d)	このコンストラクタは削除。
`_NamingContextStub.java`	public _NamingContextStub(org.omg.CORBA.portable.Delegate d)	このコンストラクタは削除。

CORBA 2.3 仕様 (ptc/00-01-08.pdf) に準拠するため、次に示す例外が変更されました。

CLASS	BEFORE	変更後
`AlreadyBound.java`	public final class AlreadyBound extends org.omg.CORBA.UserException implements org.omg.CORBA.portable.IDLEntity	public final class AlreadyBound extends org.omg.CORBA.UserException
`AlreadyBound.java`	デフォルトコンストラクタのみ	新しいコンストラクタ public AlreadyBound (String reason) を追加
`CannotProceed.java`	public final class CannotProceed extends org.omg.CORBA.UserException implements org.omg.CORBA.portable.IDLEntity	public final class CannotProceed extends org.omg.CORBA.UserException
`CannotProceed.java`	デフォルトコンストラクタのみ	新しいコンストラクタ public CannotProceed (String reason) を追加
`InvalidName.java`	public final class InvalidName extends org.omg.CORBA.UserException implements org.omg.CORBA.portable.IDLEntity	public final class InvalidName extends org.omg.CORBA.UserException
`InvalidName.java`	デフォルトコンストラクタのみ	新しいコンストラクタ public InvalidName (String reason) を追加
`NotEmpty.java`	public final class NotEmpty extends org.omg.CORBA.UserException implements org.omg.CORBA.portable.IDLEntity	public final class NotEmpty extends org.omg.CORBA.UserException
`NotEmpty.java`	デフォルトコンストラクタのみ	新しいコンストラクタ public NotEmpty (String reason) を追加
`NotFound.java`	public final class NotFound extends org.omg.CORBA.UserException implements org.omg.CORBA.portable.IDLEntity	public final class NotFound extends org.omg.CORBA.UserException
`NotFound.java`	デフォルトコンストラクタのみ	新しいコンストラクタ public NotFound (String, org.omg.CosNaming.NamingContextPackage.NotFoundReason, org.omg.CosNaming.NameComponent[]) を追加

CORBA 2.3 仕様に準拠するため、次に示すクラスが追加されました。
- NamingContextPOA.java
- BindingIteratorPOA.java
CORBA 2.3 仕様に準拠するため、次に示すクラスが非推奨になりました。
- _NamingContextImplBase.java
- _BindingIteratorImplBase.java

`org.omg.CORBA` クラスでの API の変更

OMG 仕様 99-07-57「IDL to Java mapping」に準拠するため、次に示すメソッドが変更されました。
- メソッド org.omg.CORBA.Any.insert_fixed(java.math.BigDecimal、org.omg.CORBA.TypeCode) のシグニチャーが、例外 org.omg.CORBA.Bad_INV_ORDER をスローするように変更されました。ユーザーのコードでシステム例外を宣言する必要はありません。(CCC 4340915)
- メソッド TypeCode.equivalent が abstract として定義されています。変更前: NO_IMPLEMENT 例外をスローしました。互換性への影響: ライセンシーには最小限の影響がありますが、エンドユーザーには影響がありません。ライセンシーは、このメソッドのダミー実装を提供する必要があります。(CCC 4340932)
- メソッド TypeCode.get_compact_typecode が abstract として定義されています。変更前: NO_IMPLEMENT 例外をスローしました。互換性への影響: ライセンシーには最小限の影響がありますが、エンドユーザーには影響がありません。ライセンシーは、このメソッドのダミー実装を提供する必要があります。(CCC 4340932)
- org.omg.CORBA.portable.Delegate.java のメソッド get_interface_def(org.omg.CORBA.Object) のマッピングが abstract として定義されています。互換性への影響: はい。非 abstract メソッドが abstract に変換されます。(CCC 4366071)
- org.omg.CORBA.portable.OutputStream.java のメソッド write_Principal() のマッピングが abstract ではなくなりました。互換性への影響: なし。abstract メソッドが非 abstract に変換されます。(CCC 4366072)
- org.omg.CORBA.portable.InputStream.java のメソッド read_Principal() のマッピングが abstract ではなくなりました。互換性への影響: なし。abstract と宣言されていたメソッドが abstract でなくなっても、既存のバイナリとの互換性は影響を受けません。(CCC 4366074)
CORBA 2.3 仕様に準拠するため、org.omg.DomainManagerOperations インタフェースは org.omg.CORBA.Object を拡張したものではなくなりました。互換性への影響: なし。DomainManagerOperations インタフェースを直接に使用する CORBA プログラムはありません。プログラムは DomainManagerOperations インタフェースを DomainManager インタフェースを介して使用する必要があり、そのインタフェースはすでに org.omg.CORBA.Object を拡張したものとなっています。(CCC 4340907)
次に示すクラスは、abstract として宣言されており、private コンストラクタはなくなりました。(CCC 4372196)
- org.omg.CORBA.ServiceDetailHelper
- org.omg.CORBA.ServiceInformationHelper
セクション 1.15.2 の「IDL to Java」仕様に準拠するため、次に示す org.omg.CORBA ファイルにあるデフォルトコンストラクタの javadoc コメントが COMPLETED_MAYBE から COMPLETED_NO に変更されました。互換性への影響: なし。(CCC 4363355)
- INTERNAL.java
- INVALID_TRANSACTION.java
- INV_OBJREF.java
org.omg.CORBA 内の次の Helper クラスは、public final から public abstract に変更され、Helper クラスのデフォルトコンストラクタが削除されました。この変更は、CORBA 2.3.1 で定義されている ORB コア仕様と、ptc/00-01-08 で定義されている IDL/Java 言語マッピングに準拠するために行われました。互換性への影響: 最小限。OMG IDL/Java 言語マッピング仕様に定義されているとおり Helper クラスが「abstract」になったため、Helper クラスのインスタンスを生成していた以前のアプリケーションでは問題を起こします。しかし、Helper クラスに含まれているのは static メソッドだけなので、アプリケーションで Helper クラスのインスタンスを生成しても意味がありません。(CCC 4364208)
- AnySeqHelper.java
- BooleanSeqHelper.java
- CharSeqHelper.java
- DoubleSeqHelper.java
- FloatSeqHelper.java
- LongLongSeqHelper.java
- LongSeqHelper.java
- OctetSeqHelper.java
- ShortSeqHelper.java
- StringValueHelper.java
- ULongLongSeqHelper.java
- ULongSeqHelper.java
- UShortSeqHelper.java
- WCharSeqHelper.java
- WStringValueHelper.java
最近承認された OMG 問題 3015 (新しいクラス AbstractInterfaceDef をインタフェースリポジトリクラスに追加する) に準拠するため、次のような新しい定数を org.omg.CORBA.DefinitionKind に追加しました。互換性への影響: なし。(CCC 4367601)
- _dk_AbstractInterface=24。インタフェースリポジトリオブジェクトが abstract オブジェクトを表していることを示す定数です。
- public static final DefinitionKind dk_AbstractInterface = new DefinitionKind(_dk_AbstractInterface)。これは、DefinitionKind の static インスタンスで、インタフェースリポジトリオブジェクトが abstract インタフェースを表していることを示します。
次に示すタイプコード用の org.omg.CORBA API が、OMG 仕様に準拠するように変更されました。これらのクラスはすべて、org.omg.CORBA パッケージに含まれています。互換性への影響: はい。詳細は、下記のそれぞれの変更内容を参照してください。(CCC 4368800)
- Typecode のメソッド fixed_digits、fixed_scale、member_visibility、type_modified、および concrete_base_type が concrete から abstract に変更されました。タイプコードは、常に ORB の実装者によって実装されます。また、ORB ユーザーがサブクラス化することはないため、この変更がユーザーに影響することはありません。
- TCKind.from_int は、非チェック例外 BAD_PARAM をスローすることがなくなりました。BAD_PARAM は非チェック例外なので、この例外を削除しても、コンパイル時にユーザーのコードに影響はありません。
- Principal は、メソッドのある concrete クラスに変更され、abstract メソッドのある abstract クラスから NO_IMPLEMENT をスローするようになりました。Principal は非推奨で、ほとんど使用されることはありません。いずれにしても、このクラスをユーザーがサブクラス化することはほとんどなく、通常は ORB の実装者が完全に実装します。
- extract_Streamable メソッドが Any に追加されました。メソッドの追加は互換性に影響を与えません。
- Any.insert_object(object, Typecode) が、BAD_PARAM をスローするように変更されました。BAD_PARAM は非チェック例外なので、この例外を追加しても、コンパイル時にユーザーのコードに影響はないはずです。
- Any のメソッド insert_Streamable、extract_Principal、および insert_Principal が、abstract ではなくなりました。Any は ORB の実装者によって完全に実装され、ORB ユーザーがサブクラス化することはないため、これはユーザーに影響しないはずです。
- Any のメソッド extract_value および insert_value が、abstract に変更されました。Any は ORB の実装者によって完全に実装され、ORB ユーザーがサブクラス化することはないため、これはユーザーに影響しないはずです。
Identifier フィールドが org.omg.CORBA.Initializer に追加されました。互換性への影響: なし。(CCC 4372194)
ptc/00-01-08.pdf に準拠するため、次のクラスが変更されました。
- org.omg.CORBA.ORBPackage.InvalidName.java は final として宣言されています。互換性への影響: はい。InvalidName は final として宣言されているため、このクラスをサブクラス化しているソースコードに影響があります。ただし、これは例外の型なので、そのようなコーディングは想定されていません。(CCC 4366734)
- org.omg.stub.java.rmi._Remote_Stub.java は、_type_ids のコピーを返します。そのため、外部のユーザーは元の type_ids_ 配列を分解できません。(CCC 4366734)
- org.omg.CORBA.SetOverrideType 内の from_int(Int i) メソッドは、例外 BAD_PARAM をスローしないようになりました。互換性への影響: いいえ。非チェック例外の宣言を削除したので、互換性の問題は起きません。(CCC 4369490)
- org.omg.CORBA.DefinitionKind の from_int(Int i) メソッドは、例外 BAD_PARAM をスローしないようになりました。互換性への影響: いいえ。(CCC 4370659)
- org.omg.CORBA.DynamicImplementation は、Portable Object Adapter (POA) のために、OMG によって非推奨になりました。デフォルトの呼び出し本体が提供されます。互換性への影響: いいえ。このクラスの実装者に影響はありません。(CCC 4369490)
エラーを修正するため、次のクラスが変更されました。互換性への影響: いいえ。(CCC 4362556)
- Helper および Holder クラスが UnknownUserException.java に追加されました。互換性への影響はありません。
- Helper および Holder クラスが WrongTransaction.java に追加され、このクラスは final として宣言されるようになりました。互換性への影響はありません。
- CompletionStatus.java は final として宣言されるようになりました。また、IDLEntity を実装しなくなり、private コンストラクタに変更されました。BAD_PARAM RuntimeException が from_int によって明示的にスローされることがなくなりました。互換性への影響: はい。新しい CompletionStatus.java クラスを使用して記述する新規コードでは、BAD_PARAM 実行時例外を明示的にキャッチする必要がありません。そのコードを以前のバージョンの JDK で再コンパイルすると、コンパイル時にエラーが起きます。これらの変更は、JCK リグレッション (4375061) のために元に戻されました。代わりに、OMG 問題が登録されました (http://www.omg.org/issues/java-rtf.html#Issue3946)。
- INV_POLICY.java が final として宣言されるようになりました。互換性への影響はありません。
ポータブルインタセプタが追加されたため、既存の CORBA API に新しいメソッドを追加することと、IDL の typedef から 4 つの新しいクラスを生成することが必要になりました。互換性への影響: なし。これらの変更はすべて追加です。(CCC 4379826)
- register_initial_reference が public class org.omg.CORBA.ORB に追加されました。
- 新しいクラス org.omg.CORBA.StringSeqHelper が 2 つの IDL typedef に追加されました。
- 新しいクラス org.omg.CORBA.StringSeqHolder が 2 つの IDL typedef に追加されました。
- 新しいクラス org.omg.CORBA.WStringSeqHelper が 2 つの IDL typedef に追加されました。
- 新しいクラス org.omg.CORBA.WStringSeqHolder が 2 つの IDL typedef に追加されました。

javax.rmi.CORBA クラスでの API の変更

OMG の API 仕様に準拠するため、javax.rmi.CORBA に次のような変更を加えました。

javax.rmi.CORBA.Stub の protected コンストラクタを削除しました。互換性への影響: なし。(CCC 4366722)
OMG 仕様 00-01-06.pdf に準拠するため、jaxax.rmi.CORBA.ClassDesc コンストラクタを削除しました。(CCC 4366734)

API 以外の変更

JDK 5.0 には、次のような API 以外の変更も実装されています。

リポジトリ ID の計算が修正されました。互換性への影響: はい。ORB のバージョン管理サポートが追加されたため、JDK 1.3 ORB との相互運用が可能で、下位互換性が維持されています。また、ほかのベンダーの ORB との相互運用も可能です。(CCC 4365188)
最近承認された OMG 問題 3015 に準拠するため、インタフェースリポジトリ関連のバージョンプラグマをすべて、org.omg.CORBA.ir.idl の外に取り出しました。さらに、org.omg.CORBA に組み込んだ少数の IR インタフェースのリポジトリ ID 値も変更しました。たとえば、IDLTypeHelper では、
private static String _id = "IDL:omg.org/CORBA/IDLType:2.3";
を、次のように変更しました。
private static String _id = "IDL:omg.org/CORBA/IDLType:1.0";

互換性への影響: はい。この変更は、既存の実装との相互運用性に影響を与えることがあります。COMM_FAILURE 例外 (または類似の例外) を受け取った場合は、アプリケーションおよび IR を再起動してください。(CCC 4372718)
すべての org.omg.* パッケージファイルに @serial exclude タグが追加されました。そのため、JAVADOC は、直列化の仕様についてパッケージ全体を無視することになります。Object Management Group (OMG) からは、異なるバージョン間での直列化の互換性については何も要求が出されていません。実用上は、org.omg クラスを 1 つのバージョンで直列化したあと、別のバージョンで直列化解除するといった処理は行なわれることがありません。互換性への影響: なし。(CCC 4394004)
POA のサポートのため、idlj コンパイラの引数が変更されました。POA は、Merlin で導入された CORBA の新機能です。idlj ツールの引数に対する変更には、次のようなものがあります。
- ドキュメント化されていない -poa フラグが削除されました。
- 標準の POA ベーススケルトンの生成がデフォルトで有効にされるようになりました。
- 新しいフラグとして -oldImplBase が追加されました。これにより、下位互換性のあるスケルトン (JDK 1.2 および 1.3 と互換性がある) を生成できます。
互換性への影響: はい。このコンパイラを使用する既存のプログラムに対して idlj を呼び出すときに互換性を維持するには、-oldImplBase フラグを追加する必要があります。(CCC 4407835)

新規 API

JDK 5.0 には、次のような新しい API が追加されました。

PortableInterceptor API が追加されました。テストプランでは、間違った仕様 ptc/2000-04-05 が参照されていました。機能リストでは、別の間違った仕様 orbos/99-12-02 が参照されていました (ptc/2000-04-05 は、形式が変更されたこと以外は orbos/99-12-02 と同じ)。この新規 API の正しい仕様参照は、http://www.omg.org/cgi-gin/doc?ptc/2001-03-04 です。 CCC 4307834 に、ptc/2000-04-05 に対する変更と追加のリストが含まれています。互換性への影響: なし。これは新機能なので、この API を使用している既存のコードはありません。
ポータブルインタセプタが追加されたため、public インタフェース org.omg.PortableServer.POA に新しいメソッド id が必要になりました。

J2SE 5.0 での CORBA サポートの公式仕様

仕様の参照

Java 2 Platform Standard Edition (J2SE) 5.0 ORB のコンパイル時に適用される仕様は次のとおりです。これらのリンクから正しい仕様を参照できない場合は、OMG が URL を変更した可能性があるので、正しい仕様を検索するために www.omg.org にリンクしてかまいません。

CORBA 2.3.1 (formal/99-10-07)
IDL から Java 言語へのマッピング (ptc/00-01-08)
改訂された IDL から Java 言語へのマッピング (ptc/00-11-03)
Java から IDL 言語へのマッピング (ptc/00-01-06)
Interoperable Naming Service (ptc/00-08-07)
ポータブルインセプタ (ptc/31.08.01)

上記に記載したのは、このドキュメントで参照されている仕様だけです。

サポートされている仕様の詳細

J2SE 5.0 の ORB では、現在のところ、上記の仕様のすべてが実装されているわけではありません。サポートされているセクションは次のとおりです。

CORBA 2.3.1 の第 1 - 3 章および第 6 - 9 章
改訂された IDL から Java 言語へのマッピング、セクション 1.21.8.2、orb.properties ファイル。
CORBA 2.3.1 の第 4 章。ただし、一部の内容が、ポータブルインタセプタ仕様の次のセクションで置き換えられています。
- セクション 4.2.3.5 destroy
- セクション 4.5.2 CodeFactory および PICurrent が必要
- register_initial_reference の更新としてのセクション 4.5.3.4
CORBA 2.3.1 の第 5 章。ただし、ポータブルインタセプタ仕様の次のセクションの更新が優先されます。
- 5.5.2 StringSeq および WStringSeq が必要です。これにより、次のクラスが org.omg.CORBA に追加されます。
- - StringSeqHolder
  - StringSeqHelper
  - WStringSeqHolder
  - WStringSeqHelper
CORBA 2.3.1 のセクション 10.6.1 および 10.6.2 (リポジトリ ID に対してサポートされる)。
CORBA 2.3.1 のセクション 10.7 (TypeCode API に対して)。
CORBA 2.3.1 の第 11 章「Portable Object Adapter (POA)」。ただし、ポータブルインタセプタ仕様の次のセクションの更新が優先されます。
- セクション 11.3.7。POA はすべてのポリシーを保持しなければならない
- セクション 11.3.8.2。POA はすべてのポリシーを保持しなければならない
- セクション 11.3.8.26。 POA::id が必要。
CORBA 2.3.1 の第 13 章および第 15 章 (GIOP 1.0、1.1、および 1.2 の定義)。J2SE 5.0 の ORB では、すべてのバージョンの GIOP が完全にサポートされますが、セクション 15.8 および 15.9 で定義されている双方向 GIOP 機能は例外的にサポートされません。
Interoperable Naming Service の仕様はすべてサポートされています。
ポータブルインタセプタセクション 13.8 (新しい Coder および Decoder インタフェース) と、第 21 章全体 (インタセプタの仕様)。
改訂された IDL から Java 言語へのマッピング仕様 (ptc/00-11-03) のセクション 1.21.8 は、IDL から Java 言語へのマッピング仕様 (ptc/00-01-08) の内容から変更されました。

ツール

IDL から Java へのコンパイラ (idlj) は、次に準拠しています。
- CORBA 2.3.1 の第 3 章 (IDL の定義)
- CORBA 2.3.1 の第 5 章および第 6 章 (Value 型のセマンティクス)
- CORBA 2.3.1 のセクション 10.6.5 (プラグマ)
- IDL から Java へのマッピング仕様
- 改訂された IDL から Java へのマッピング仕様のセクション 1.12.1「local interfaces」
Java から IDL へのコンパイラ (rmic の IIOP バックエンド) は、次の仕様に準拠しています。
- CORBA 2.3.1 の第 5 章および第 6 章 (Value 型)
- Java から IDL 言語へのマッピング仕様。IDL から Java 言語へのマッピング仕様のセクション 1.21 を暗黙的に参照
- -idl フラグを指定して生成される IDL は、CORBA 2.3.1 の第 3 章に準拠しています。

その他の互換性情報

java.util.Calendar クラスは、RMI-IIOP を使用すると、J2SE 1.3.x と J2SE 5.0 の間で相互運用性がありません。この点は OMG 問題 3151 で解決される予定ですが、それが実装されるのは Java プラットフォームの将来のリリースになる見込みです。
J2SE 5.0 バージョンの Calendar の writeObject メソッドでは、ZoneInfo オブジェクトを書き出します。同様に、そのオブジェクトを読み込むには readObject メソッドを呼び出します。古いバージョンと対話している場合は、オブジェクトが存在しないため、ストリームは Java オブジェクト直列化仕様に基づき EOFException をスローします。ストリームの位置は変わりません。

連絡先