Interstage Application Server アプリケーション作成ガイド（CORBAサービス編）

3.7.2 文字列型

(1)IDLマッピング

IDL言語で文字列型stringを指定した場合、C言語ではCORBA_stringにマッピングされます。CORBA_stringは以下のように定義されます。

typedef  char  *CORBA_string;    /* stringの定義*/

以降では、以下のIDL定義例をもとに説明します。

IDL言語

module ODsample{
    interface  stringtest{
       string op1(in string str1, out string str2, inout string str3); 
    };
};

C言語

CORBA_string
ODsample_stringtest_op1(
    ODsample_stringtest obj;   /* オブジェクトリファレンス */
    CORBA_string str1,         /* inパラメタ */
    CORBA_string *str2,        /* outパラメタ */
    CORBA_string *str3,        /* inoutパラメタ */
    CORBA_Environment *env )   /* 例外情報 */

(2)クライアントアプリケーションで扱うパラメタ

クライアントアプリケーションのパラメタの扱いについて、以下に示します。

パラメタ	サーバへ渡すパラメタ	サーバから渡されたパラメタ
in	CORBA_string_alloc()で領域を獲得します。	－
inout	(inパラメタと同じ)	領域はスタブで自動的に獲得されます。
out 復帰	－	(inoutパラメタと同じ)

注意

クライアントおよびスタブで獲得した領域は、不要になった時点でCORBA_free()で解放する必要があります。

クライアントアプリケーションでの処理例を以下に示します。

CORBA_string          str1, str2, str3, ret;
CORBA_Environment     env;

/* inパラメタ */
str1 = CORBA_string_alloc(2);   /* 領域獲得 */
strcpy( str1 , "IN" );          /* パラメタ設定 */

/* inoutパラメタ */
str3 = CORBA_string_alloc(7);   /* 領域獲得 */
strcpy( str3 , "INOUT:1" );     /* パラメタ設定 */

/* サーバ呼出し */
ret = ODsample_stringtest_op1(obj, str1, &str2, &str3, &env );

/* 領域解放 */
CORBA_free( str1 );             /* inパラメタ */
CORBA_free( str2 );             /* outパラメタ */
CORBA_free( str3 );             /* inoutパラメタ */
CORBA_free( ret );              /* 復帰パラメタ */

(3)サーバアプリケーションで扱うパラメタ

サーバアプリケーションのパラメタの扱いについて以下に示します。

パラメタ	クライアントから渡されたパラメタ	クライアントへ渡すパラメタ
in	文字列域は、スケルトンで自動的に獲得/解放されます。	－
inout	文字列域は、スケルトンで自動的に獲得されます。	渡されたパラメタより短い文字列を返す場合 渡された文字列域に文字列を設定します。 渡されたパラメタより長い文字列を返す場合 渡された文字列域をCORBA_free()で一度解放し、CORBA_string_alloc()で再獲得します。 文字列域は、スケルトンで自動的に解放されます。
out 復帰	－	文字列域をCORBA_string_alloc()で獲得します。文字列域は、スケルトンで自動的に解放されます。

サーバアプリケーションでの処理例を以下に示します。

CORBA_string
ODsample_stringtest_op1(
    ODsample_stringtest obj;         /* オブジェクトリファレンス */
    CORBA_string str1,               /* inパラメタ */
    CORBA_string *str2,              /* outパラメタ */
    CORBA_string *str3,              /* inoutパラメタ */
    CORBA_Environment *env )         /* 例外情報 */
{
    CORBA_string str; 

/* outパラメタ */
    *str2 = CORBA_string_alloc(3);   /* 領域獲得 */
    strcpy( *str2, "OUT" );          /* パラメタ設定 */

/* inoutパラメタ */
    CORBA_free( *str3 );             /* 領域解放 */
    *str3 = CORBA_string_alloc(7);   /* 領域再獲得 */
    strcpy( *str3, "INOUT:2" );      /* パラメタ設定 */

/* 復帰パラメタ */
    str = CORBA_string_alloc(6);     /* 領域獲得 */
    strcpy( str, "RETURN" );         /* 復帰パラメタ設定 */
    return( str ); 
}