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

12.3.2 Contextインタフェース

(1)C言語

　ContextインタフェースはC言語では、以下のIDLを元にAPIが提供されています。

  module CORBA {
         typedef string                  Identifier;
         enum ORBStatus { OK, FAILED };
         enum Flags{
                 ARG_IN,
                 ARG_OUT,
                 ARG_INOUT,
                 OUT_LIST_MEMORY,
                 IN_COPY_VALUE,
                 INV_NO_RESPONSE,
                 INV_TERM_ON_ERR,
                 RESP_NO_WAIT,
                 DEPENDENT_LIST,
                 CTX_RESTRICT_SCOPE,
                 CTX_DELETE_DESCENDENTS
         };

         interface ORB {
                 ...
                 ORBStatus get_default_context( out Context );
                 ...
         };
         interface Context {
                 ORBStatus set_one_value(
                                 in Identifier           prop_name,
                                 in string               value );
                 ORBStatus set_values(
                                 in NVList               values );
                 ORBStatus get_values(
                                 in Identifier           start_scope,
                                 in Flags                op_flags,
                                 in Identifier           prop_name,
                                 out NVList              values );
                 ORBStatus delete_values(
                                 in Identifier           prop_name );
                 ORBStatus create_child(
                                 in Identifier           ctx_name,
                                 out Context             child_ctx );
                 ORBStatus delete(
                                 in Flags                del_flags );
         };
  };

　NVListについては、“NVListオブジェクト”を参照してください。
　Contextインタフェースで提供しているAPI(C言語)の機能説明について、以下に示します。

インタフェース名	メソッド名	機能説明
ORB	get_default_context	デフォルトのコンテキストオブジェクトを取得します。
Context	set_one_value	プロパティ名とそのデータ値(ともに文字列)を指定されたコンテキストに関連づけます。
	set_values	NVListで指定された複数のプロパティ名とそのデータ値(ともに文字列）の組み合せをコンテキストに関連付けます。
	get_values	コンテキストに関連付けられた指定されたパラメタに関連した情報のリストを取得します。
	delete_values	プロパティ名、およびそれに関連づけられているデータ値のリストを削除します。
	create_child	childコンテキストを作成します。
	delete	コンテキストオブジェクトを削除します。

(2)C++言語・Java言語

　ContextインタフェースはC++言語、Java言語では、以下のIDLを元にAPIが提供されています。

  module CORBA {
         typedef string                  Identifier;
         enum ORBStatus { OK, FAILED };
         enum Flags{
                 ARG_IN,
                 ARG_OUT,
                 ARG_INOUT,
                 OUT_LIST_MEMORY,
                 IN_COPY_VALUE,
                 INV_NO_RESPONSE,
                 INV_TERM_ON_ERR,
                 RESP_NO_WAIT,
                 DEPENDENT_LIST,
                 CTX_RESTRICT_SCOPE,
                 CTX_DELETE_DESCENDENTS
         };

        interface ORB {
                ... 
                Status get_default_context( out Context );
                ... 
        };
        interface Context {
                readonly attribute Identifier     context_name;
                readonly attribute context        parent;
                
        ORBStatus set_one_value(
                in Identifier prop_name,
                in any propvalue );
        ORBStatus set_values( in NVList values );
        ORBStatus get_values(
                in Identifier start_scope,
                in Flags op_flags,
                in Identifier pattern,
                out NVList values );
        ORBStatus delete_values(
                in Identifier start_scope,
                in Flags op_name,
                in Identifier pattern,
                out NVList values );
        ORBStatus create_child(

                in Identifier child_ctx_name,
                out Context child_ctx );
        };
  };

　Contextインタフェースで提供しているAPI(C++言語)の機能について、以下に示します。

インタフェース名	メソッド名	機能説明
ORB	get_default_context	デフォルトのコンテキストオブジェクトを取得します。
Context	context_name	コンテキスト名を取得します。
	parent	親のコンテキストオブジェクトを取得します。
	set_one_value	プロパティ名とそのデータ値(ともに文字列)を指定されたコンテキストに関連づけます。
	set_values	NVListで指定された複数のプロパティ名とそのデータ値（ともに文字列）の組み合せをコンテキストに関連づけます。
	get_values	コンテキストに関連づけられた指定されたパラメタに関連した情報のリストを取得します。
	delete_values	プロパティ名、およびそれに関連づけられているデータ値のリストを削除します。
	create_child	childコンテキストを作成します。