org.omg.IOP

インタフェースCodecOperations

既知のすべてのサブインタフェース:

Codec

public interface CodecOperations

ORBサービスによって使用されるIORのコンポーネントやサービス・コンテキスト・データの形式は、IDLで定義されたデータ型のインスタンスをエンコードするCDRカプセル化としてよく定義されます。Codecは、IDLデータ型とCDRカプセル化表現との間でこれらのコンポーネントを変換するメカニズムを備えています。

CodecはCodecFactoryから取得されます。CodecFactoryは、ORB.resolve_initial_references("CodecFactory")の呼出しを介して取得されます。

メソッドのサマリー

修飾子と型	メソッドと説明
Any	decode_value(byte[] data, TypeCode tc) 指定されたTypeCodeとこのCodecに有効なエンコード形式に基づいて、指定されたバイト配列をAnyにデコードします。
Any	decode(byte[] data) このCodecに有効なエンコード形式に基づいて、指定されたバイト配列をAnyにデコードします。
byte[]	encode_value(Any data) このCodecに有効なエンコード形式に基づいて、指定されたanyをバイト配列に変換します。
byte[]	encode(Any data) このCodecに有効なエンコード形式に基づいて、指定されたanyをバイト配列に変換します。

メソッドの詳細

encode

byte[] encode(Any data)
       throws InvalidTypeForEncoding

このCodecに有効なエンコード形式に基づいて、指定されたanyをバイト配列に変換します。

パラメータ:

data - バイト配列にエンコードされるany形式のデータ。

戻り値:

符号化されたAnyを含むバイト配列。このバイト配列には、TypeCodeとその型のデータの両方が格納される。

例外:

InvalidTypeForEncoding - その型がCodecに有効なエンコード形式に対して無効である場合にスローされる。

decode

Any decode(byte[] data)
    throws FormatMismatch

このCodecに有効なエンコード形式に基づいて、指定されたバイト配列をAnyにデコードします。

パラメータ:

data - Anyにデコードされるバイト配列形式のデータ。

戻り値:

デコードされたバイト配列のデータを含むAny。

例外:

FormatMismatch - バイト配列をAnyにデコードできない場合にスローされる。

encode_value

byte[] encode_value(Any data)
             throws InvalidTypeForEncoding

このCodecに有効なエンコード形式に基づいて、指定されたanyをバイト配列に変換します。Anyのデータだけがエンコードされ、TypeCodeは符号化されません。

パラメータ:

data - バイト配列にエンコードされるany形式のデータ。

戻り値:

エンコードされたanyのデータを含むバイト配列。

例外:

InvalidTypeForEncoding - その型がCodecに有効なエンコード形式に対して無効である場合にスローされる。

decode_value

Any decode_value(byte[] data,
                 TypeCode tc)
          throws FormatMismatch,
                 TypeMismatch

指定されたTypeCodeとこのCodecに有効なエンコード形式に基づいて、指定されたバイト配列をAnyにデコードします。

パラメータ:

data - Anyにデコードされるバイト配列形式のデータ。

tc - データのデコードに使用されるTypeCode。

戻り値:

デコードされたバイト配列のデータを含むAny。

例外:

FormatMismatch - バイト配列をAnyにデコードできない場合にスローされる。

TypeMismatch