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インタフェースを、それぞれ実装している必要があります。