JavaTM Platform
Standard Ed. 6

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

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。