CORBA 互換性情報 - J2SE v.1.4.0

J2SE 1.3 と J2SE 1.4 間での CORBA API の変更点
J2SE 1.4 での CORBA サポートに関する正式仕様
その他の互換性に関する情報

J2SE 1.3 と J2SE 1.4 間での CORBA API の変更点

このドキュメントには、J2SDK v1.3 と v1.4 間での CORBA 機能に関する API 変更情報がすべて含まれています。これらの変更は、J2SDK 1.4 に含まれる CORBA テクノロジ用 API を、次の OMG ドキュメントで指定された CORBA 2.3 マッピングに準拠させるために行われました。

「CORBA 2.3.1」 (formal/99-10-07)
「IDL to Java Language Mapping」 (ptc/00-01-08)
「Java to IDL Language Mapping」 (ptc/00-01-06)
「Interoperable Naming Service」 (ptc/00-08-07)
「Portable Interceptors」 (ptc/2001-03-04)

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

CORBA Version 2.3 仕様で指定された IDL から Java へのマッピングに準拠して、SDK に同梱される idlj コンパイラにより、次の org.omg.COSNaming クラスが再生成されました。この変更 (CCC 4284015) には、次の API の変更が含まれます。互換性への影響はありません。

org.omg.CosNaming

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

OMG 仕様 1.7 節「Mapping for Enum」(ptc/00-01-08.pdf) に準拠して、次の Enum コンストラクタが protected に変更されました。

クラス変更前変更後

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

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

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

クラス	変更前	変更後
`BindingType.java`	private BindingType( int )	protected BindingType( int )
`NotFoundReason.java`	private NotFoundReason( int )	protected NotFoundReason( int )

クラス変更前変更後

_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) に準拠して、次の例外が変更されました。

クラス	変更前	変更後
`_BindingIteratorStub.java`	public _BindingIteratorStub(org.omg.CORBA.portable.Delegate d)	このコンストラクタは削除されました。
`_NamingContextStub.java`	public _NamingContextStub(org.omg.CORBA.portable.Delegate d)	このコンストラクタは削除されました。

クラス変更前変更後

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 仕様に準拠して、次のクラスが追加されました。

クラス	変更前	変更後
`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[]) を追加

NamingContextPOA.java
BindingIteratorPOA.java

CORBA 2.3 仕様に準拠して、次のクラスが推奨されなくなりました。

_NamingContextImplBase.java
_BindingIteratorImplBase.java

`org.omg.CORBA` の API 変更

OMG 仕様 99-07-57「IDL to Java Language 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 プログラムは存在しません。プログラムは、org.omg.CORBA.Object を継承済みの DomainManager インタフェースを介してのみ、DomainManagerOperations インタフェースを使用します。(CCC 4340907)
次のクラスは、abstract として宣言され、また private コンストラクタを保持することもなくなりました。 (CCC 4372196)
- org.omg.CORBA.ServiceInformationHelper
1.15.2 節の IDL から Java へのマッピング仕様に準拠して、次の org.omg.CORBA ファイル内のデフォルトコンストラクタ javadoc コメントが COMPLETED_MAYBE から COMPLETED_NO に変更されました。互換性への影響はありません。(CCC 4363355)
- INV_OBJREF.java
org.omg.CORBA 内の次のヘルパークラスが、public final から public abstract に変更されました。また、これらのヘルパークラスのデフォルトコンストラクタが削除されました。この変更は、CORBA 2.3.1 で定義されたコア ORB 仕様、および ptc/00-01-08 で定義された IDL/Java 言語マッピングに準拠して行われました。OMG IDL/Java 言語マッピング仕様の定義に従い、ヘルパークラスが「abstract」とされたため、これまでヘルパークラスのインスタンスを生成していたアプリケーションは失敗します。ただし、ヘルパークラスは内部に static メソッドのみを保持すること、およびアプリケーションがヘルパークラスのインスタンスを生成する十分な理由が存在しないため、互換性への影響は最小限に抑えられます。(CCC 4364208)
- WStringValueHelper.java
インタフェースリポジトリクラスに新規クラス AbstractInterfaceDef を追加するという、最近伝えられた OMG の 3015 問題に従って、次の定数が org.omg.CORBA.DefinitionKind に新たに追加されました。互換性への影響はありません。(CCC 4367601)
- _dk_AbstractInterface=24。これは、インタフェースリポジトリオブジェクトが抽象オブジェクトであることを示す定数です。
- public static final DefinitionKind dk_AbstractInterface = new DefinitionKind(_dk_AbstractInterface)。これは、DefinitionKind の static インスタンスで、インタフェースリポジトリオブジェクトが抽象インタフェースであることを表します。
OMG 仕様に準拠して、次のタイプコード用 org.omg.CORBA API が変更されました。次のリスト内のクラスはすべて、org.omg.CORBA パッケージ内に存在します。この変更により、互換性に影響があります。詳細は、以下の各変更点を参照してください。(CCC 4368800)
- Typecode メソッド fixed_digits、fixed_scale、member_visibility、type_modified、および concrete_base_type が具象から abstract に変更されました。タイプコードは、常に ORB 実装者により実装され、ORB ユーザによりサブクラス化されることはありません。このため、ユーザへの影響はありません。
- TCKind.from_int がチェックされない例外 BAD_PARAM をスローすることはなくなりました。BAD_PARAM はチェックされない例外であるため、この例外がスローされなくてもコンパイル時にユーザのコードが影響を受けることはありません。
- Principal は、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 例外をスローすることはなくなりました。チェックされない例外の throw 宣言が削除されただけなので、互換性に問題が生じることはありません。(CCC 4369490)
- org.omg.CORBA.DefinitionKind の from_int(Int i) メソッドが BAD_PARAM 例外をスローすることはなくなりました。互換性への影響はありません。(CCC 4370659)
- org.omg.CORBA.DynamicImplementation は OMG により非推奨とされています。それに代わり、Portable Object Adapter (POA) が優先使用されます。デフォルトの呼び出し本体が提供されます。互換性への影響はありません。このクラスを実装するいかなるユーザも影響を受けません。(CCC 4369490)
エラーを訂正するため、次のクラスに変更が加えられました。互換性への影響はありません。(CCC 4362556)
- ヘルパークラスおよびホルダークラスが UnknownUserException.java に追加されました。互換性への影響はありません。
- ヘルパークラスおよびホルダークラスが WrongTransaction.java に追加されました。このクラスは final として宣言されます。互換性への影響はありません。
- CompletionStatus.java は、final として宣言され、IDLEntity を実装しなくなるとともに、private コンストラクタに変更されました。また、from_int により BAD_PARAM RuntimeException が明示的にスローされることはなくなりました。これらの変更により、互換性に影響があります。新規 CompletionStatus.java クラスを使用して記述された新しいコードは、BAD_PARAM 実行時例外を明示的にキャッチする必要がありません。このコードを以前の SDK を使用して再コンパイルすると、コンパイル時エラーが発生します。これらの変更は、JCK の退行不具合 (バグ ID:4375061) であるため、元に戻されました。この問題に関しては、OMG の問題 (http://cgi.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 に追加されました。
- 2 つの IDL typedef に対し、新規クラス 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 が追加されました。

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 の変更点

J2SDK v1.4 では、次の非 API 変更も実装されました。

リポジトリ ID 計算処理の訂正。この変更により、互換性に影響があります。J2SDK 1.3 ORB との相互運用を可能にするために 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 クラスをあるバージョンで直列化して、次のバージョンで直列化解除することが必要な状況は考えられません。この変更による互換性への影響はありません。(CCC 4394004)
POA (Merlin での CORBA の新機能) をサポートするために、idlj コンパイラ引数が変更されました。idlj ツール引数への変更点には、以下が含まれます。
- ドキュメント化されていない -poa フラグの削除
- 標準 POA ベースのスケルトン生成をデフォルトで有効化
- 下位互換性 (JDK 1.2 および J2SDK 1.3 との互換) を維持するスケルトンを生成するための新規フラグ -oldImplBase の追加
これらの変更により、互換性に影響があります。コンパイラを使用する既存のプログラムでは、互換性を維持するため、idlj に -oldImplBase フラグを追加することが必要になる場合があります。(CCC 4407835)

新規 API

J2SDK v1.4 に次の API が新たに追加されました。

PortableInterceptor API が追加されました。テストプランでは、不正な仕様 ptc/2000-04-05 が参照されていました。また、機能リスト内の不正な仕様 orbos/99-12-02 も参照されていました (ptc/2000-04-05 は、書式の変更を除き、orbos/99-12-02 と同じです)。この新規 API の正確な仕様は、http://cgi.omg.org/cgi-bin/doc?ptc/2001-03-04 で参照できます。CCC 4307834 には、ptc/2000-04-05 からの変更/追加点の一覧が含まれます。これは既存のコードが使用しない新機能であるため、互換性に問題は起こりません。

ポータブルインターセプタを追加することにより、public インタフェース org.omg.PortableServer.POA に新規メソッド、id が必要になりました。

J2SE 1.4 での CORBA サポートに関する正式仕様

仕様参照

Java 2 Platform, Standard Edition (J2SE) v.1.4 の ORB が準拠する仕様を次に示します。これらのリンクをクリックしても参照すべき適切な仕様を表示できない場合、OMG により URL が変更された可能性があります。その場合は、www.omg.org へ移動して、適切な仕様を検索してください。

「CORBA 2.3.1」(formal/99-10-07)
「IDL to Java Language Mapping」 (ptc/00-01-08)
「Revised IDL to Java Language Mapping」 (ptc/00-11-03)
「Java Language to IDL Mapping」 (ptc/00-01-06)
「Interoperable Naming Service」 (ptc/00-08-07)
「Portable Interceptors」 (ptc/2001-03-04)

上記は、このドキュメントが参照している仕様です。

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

現在のところ、J2SE 1.4 の ORB では、上記のすべての仕様が実装されているわけではありません。以下にサポートされているセクションのリストを示します。

「CORBA 2.3.1」第 1 - 3 章および第 6 - 9 章
「Revised IDL to Java Language Mapping」 1.21.8.2 節、orb.properties ファイル
「CORBA 2.3.1」第 4 章の、ポータブルインターセプタ仕様の置き換えに関する次の部分

4.2.3.5 節 destroy
4.5.2 節 CodeFactory および PICurrent の必要性
4.5.3.4 節 register_initial_reference に対する更新

「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 1.4 ORB はすべてのバージョンの GIOP を完全にサポートします (15.8 節および 15.9 節で定義された双方向 GIOP 機能を除く)。
「Interoperable Naming Service」に記載された仕様は、すべてサポートされます。
「Portable Interceptors」の 13.8 節 (新規 Coder/Decoder インタフェース) および第 21 章すべて (インターセプタ仕様)。
「Revised IDL to Java Language Mapping Specification」 (ptc/00-11-03) の 1.21.8 節は、「IDL to Java Language Mapping Specification」(ptc/00-01-08) から変更されています。

ツール

IDL-to-Java コンパイラ (idlj) は、以下の仕様に準拠しています。

「CORBA 2.3.1」第 3 章 (IDL の定義)
「CORBA 2.3.1」第 5 章および第 6 章 (値型のセマンティクス)
「CORBA 2.3.1」 10.6.5 節 (プラグマ)
「IDL to Java Mapping Specification」
「Revised IDL to Java Language Mapping Specification」 1.12.1 節「local interfaces」

Java-to-IDL コンパイラ (rmic 用 IIOP バックエンド) は、以下の仕様に準拠しています。

「CORBA 2.3.1」第 5 章および第 6 章 (値型)
「Java Language to IDL Mapping」これは、「IDL to Java Language Mapping」の 1.21 節を暗黙的に参照していることに留意してください。
-idl フラグ付で生成された IDL は、「CORBA 2.3.1」第 3 章に準拠しています。

その他の互換性に関する情報

java.util.Calendar クラスは、RMI-IIOP を使用している場合 J2SE 1.3.x と J2SE 1.4 との間に相互運用性がありません。OMG の 3151 問題によりこの問題は解決されるはずですが、Java プラットフォームの今後のリリースには相互運用性が実装される予定です。
J2SE v.1.4 の Calendar は、ZoneInfo オブジェクトをその writeObject メソッドに書き込みます。同様に、readObject を呼び出して、ZoneInfo オブジェクトを読み込みます。Java のオブジェクト直列化に基づき、Calendar は、ストリームが EOFException をスローしてストリームの位置をそのまま維持できるように、旧バージョンとやりとりする場合には、ZoneInfo オブジェクトがそこに存在しないものとみなします。

質問またはコメントの送付先: JavaIDL@eng.sun.com.

Java Software