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