モジュール java.corba

パッケージ javax.rmi.CORBA

インタフェースValueHandlerMultiFormat

すべてのスーパー・インタフェース:

ValueHandler

public interface ValueHandlerMultiFormat
extends ValueHandler

Java - IDL間のptc/02-01-12の節1.5.1.5です。

導入されたバージョン:

1.5

メソッドのサマリー

修飾子と型	メソッド	説明
byte	getMaximumStreamFormatVersion()	このValueHandlerオブジェクトでサポートされているRMI/IDLカスタム値型の最大のストリーム・フォーマット・バージョンを返します。
void	writeValue(OutputStream out, Serializable value, byte streamFormatVersion)	ORBがRMI/IDLカスタム値型のストリーム・フォーマット・バージョンを渡せるようにします。

インタフェース javax.rmi.CORBA.ValueHandlerから継承されたメソッド

getRMIRepositoryID, getRunTimeCodeBase, isCustomMarshaled, readValue, writeReplace, writeValue

メソッドの詳細

getMaximumStreamFormatVersion

byte getMaximumStreamFormatVersion()

このValueHandlerオブジェクトでサポートされているRMI/IDLカスタム値型の最大のストリーム・フォーマット・バージョンを返します。 ValueHandlerでは、返されたストリーム・フォーマット・バージョンとそれ以前のすべてのバージョンをサポートしている必要があります。 ORBは、この値を標準のIORタグ付きコンポーネントやサービス・コンテキストに組込み、それがサポートする最大のRMI-IIOPストリーム・フォーマットをほかのORBに通知できます。 値が組み込まれない場合、GIOP 1.2のデフォルトはストリーム・フォーマット・バージョン1となり、GIOP 1.3以降のデフォルトはストリーム・フォーマット・バージョン2となります。

writeValue

void writeValue(OutputStream out,
                Serializable value,
                byte streamFormatVersion)

ORBがRMI/IDLカスタム値型のストリーム・フォーマット・バージョンを渡せるようにします。 ORBがこのメソッドを呼び出す場合は、ORBが渡すストリーム・フォーマット・バージョンの範囲を1からgetMaximumStreamFormatVersionメソッドが返す値までにする必要があります。そうしない場合は、標準マイナー・コードを含むBAD_PARAM例外がスローされます。 ORBが古いメソッドのValueHandler.writeValue(OutputStream, Serializable)を呼び出した場合、ストリーム・フォーマット・バージョン1が指定されたものとみなされます。 ValueHandlerMultiFormat.writeValueメソッドに渡されるORB出力ストリームはValueOutputStreamインタフェースを、ValueHandler.readValueメソッドに渡されるORB入力ストリームはValueInputStreamインタフェースを、それぞれ実装している必要があります。