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

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

• CORBA 2.3.1 (formal/99-10-07)
• IDL から Java 言語へのマッピング (ptc/00-01-08)
• Java から IDL 言語へのマッピング (ptc/00-01-06)
• 相互運用可能なネームサービス (/ptc/00-08-07)
• ポータブルインタセプタ (ptc/2001-03-04)

org.omg.COSNaming クラスでの 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 に変更されました。
 

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

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

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

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

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

3. 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 の変更

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

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 は、J2SE 1.4 で導入された CORBA の新機能です。idlj ツールの引数に対する変更には、次のようなものがあります。
  • ドキュメント化されていない -poa フラグが削除されました。
  • 標準の POA ベーススケルトンの生成がデフォルトで有効にされるようになりました。
  • 新しいフラグとして -oldImplBase が追加されました。これにより、下位互換性のあるスケルトン (JDK 1.2 および 1.3 と互換性がある) を生成できます。

  互換性への影響: あり。このコンパイラを使用する既存のプログラムに対して idlj を呼び出すときに互換性を維持するには、 -oldImplBase フラグを追加する必要があります。(CCC 4407835)

新規 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 サポートの公式仕様

仕様の参照

• 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)
• 相互運用可能なネームサービス (ptc/00-08-07)
• ポータブルインタセプタ (ptc/2001-08-31)

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

• CORBA 2.3.1 の第 1〜3 章および第 6〜9 章
• 改訂された IDL から Java 言語へのマッピングのセクション 1.21.8.2「orb.properties file」
• 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 5.0 の ORB では、すべてのバージョンの GIOP が完全にサポートされますが、セクション 15.8 および 15.9 で定義されている双方向 GIOP 機能は例外的にサポートされません。
• 相互運用可能なネームサービスの仕様はすべてサポートされています。
• ポータブルインタセプタ仕様のセクション 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 をスローします。ストリームの位置は変わりません。

Copyright © 2001-2004 Sun Microsystems, Inc. All Rights Reserved.

Java ソフトウェア