ページの先頭行へ戻る
Interstage Application Server リファレンスマニュアル(API編)

5.18.4 Container共通インタフェース

  この節で説明するメソッドは、他のインタフェースリポジトリオブジェクトを包含する各インタフェースリポジトリオブジェクト(Containerと呼びます)に継承されて、その継承先のインタフェースリポジトリオブジェクトのメソッドとして使用されます。

5.18.4.1 CORBA-CONTAINER-LOOKUP

名前

  CORBA-CONTAINER-LOOKUP

形式

REPOSITORY.
    CLASS      CORBA-CONTAINED
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID. LOOKUP.
DATA DIVISION.
LINKAGE SECTION.
01 0--RESULT OBJECT REFERENCE CORBA-CONTAINED.
01 SEARCH_NAME PIC X ANY LENGTH.
PROCEDURE DIVISION
  USING      SEARCH_NAME
  RETURNING 0—RESULT
  RAISING   CORBA-SYSTEMEXCEPTION
  .
END METHOD LOOKUP.

機能説明

  インタフェースリポジトリオブジェクトが包含するインタフェースリポジトリオブジェクトの中から、指定された名前を持つオブジェクトを見つけだし、そのオブジェクトリファレンスを返します。search_nameには、検索する名前(PIC X)を指定します。返却対象のオブジェクトが見つからない場合は、NIL(空の)オブジェクトリファレンスを返して正常終了します。

復帰値

  正常終了した場合は、指定された名前を持つオブジェクトのオブジェクトリファレンスが返されます。
  異常終了した場合は、NIL(空の)オブジェクトリファレンスが返され、SystemExceptionが発生します。

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

5.18.4.2 CORBA-CONTAINER-CONTENTS

名前

  CORBA-CONTAINER-CONTENTS

形式

REPOSITORY.
    CLASS      SEQUENCE-CORBA-CONTAINED
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID. CONTENTS.
DATA DIVISION.
LINKAGE SECTION.
01 0--RESULT TYPE CORBA-CONTAINEDSEQ.
01 LIMIT_TYPE TYPE CORBA-DEFINITIONKIND.
01 EXCLUDE_INHERITED TYPE CORBA-BOOLEAN.
PROCEDURE DIVISION
  USING      LIMIT_TYPE
             EXCLUDE_INHERITED
  RETURNING 0—RESULT
  RAISING   CORBA-SYSTEMEXCEPTION
  .
END METHOD CONTENTS.

機能説明

  インタフェースリポジトリオブジェクトに直接包含される、または、継承によって包含されるインタフェースリポジトリオブジェクトのオブジェクトリファレンスをリスト形式で返します。

復帰値

  正常終了した場合は、検索されたオブジェクトのオブジェクトリファレンスのリストが返されます。
  異常終了した場合は、NIL(空の)オブジェクトリファレンスのリストが返され、SystemExceptionが発生します。

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

5.18.4.3 CORBA-CONTAINER-LOOKUP_NAME

名前

  CORBA-CONTAINER-LOOKUP_NAME

形式

REPOSITORY.
     CLASS      SEQUENCE-CORBA-CONTAINED
     CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID. LOOKUP_NAME.
DATA DIVISION.
LINKAGE SECTION.
01 0--RESULT TYPE CORBA-CONTAINEDSEQ.
01 SEARCH_NAME PIC X ANY LENGTH.
01 LEVELS_TO_SEARCH TYPE CORBA-LONG.
01 LIMIT_TYPE TYPE CORBA-DEFINITIONKIND.
01 EXCLUDE_INHERITED TYPE CORBA-BOOLEAN.
PROCEDURE DIVISION
  USING      SEARCH_NAME
             LEVELS_TO_SEARCH
             LIMIT_TYPE
             EXCLUDE_INHERITED
  RETURNING 0—RESULT
  RAISING   CORBA-SYSTEMEXCEPTION
  .
END METHOD LOOKUP_NAME.

機能説明

  インタフェースリポジトリオブジェクトに直接包含される、または、継承によって包含されるオブジェクトの中から、指定された名前を持つオブジェクトを見つけだし、そのオブジェクトリファレンスとともに、さらにそのオブジェクトが包含/継承するオブジェクトのオブジェクトリファレンスをリスト形式で返します。

復帰値

  正常終了した場合は、検索されたオブジェクトのオブジェクトリファレンスのリストが返されます。
  異常終了した場合は、NIL(空の)オブジェクトリファレンスのリストが返され、SystemExceptionが発生します。

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

5.18.4.4 CORBA-CONTAINER-DESCRIBE_CONTENTS

名前

  CORBA-CONTAINER-DESCRIBE_CONTENTS

形式

REPOSITORY.
    CLASS      SEQUENCE-DESCRIPTION-001
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID. DESCRIBE_CONTENTS.
DATA DIVISION.
LINKAGE SECTION.
01 0--RESULT TYPE CORBA-CONTAINER-DESCRIPTIONSEQ.
01 LIMIT_TYPE TYPE CORBA-DEFINITIONKIND.
01 EXCLUDE_INHERITED TYPE CORBA-BOOLEAN.
01 MAX_RETURNED_OBJS TYPE CORBA-LONG.
PROCEDURE DIVISION
  USING      LIMIT_TYPE
             EXCLUDE_INHERITED
             MAX_RETURNED_OBJS
  RETURNING 0—RESULT
  RAISING   CORBA-SYSTEMEXCEPTION
  .
END METHOD DESCRIBE_CONTENTS.

機能説明

  インタフェースリポジトリオブジェクトに直接包含される、または、継承によって包含されるオブジェクトの定義情報を、CORBA-DEFINITIONKIND構造体のリスト形式(“5.18.1 型の定義”参照)で返します。
  LIMIT_TYPEで指定されたインタフェースタイプの包含オブジェクトが返却対象となります。

復帰値

  正常終了した場合は、オブジェクトの定義情報リストが返されます。
  異常終了した場合は、NIL(空の)定義情報リストが返され、SystemExceptionが発生します。

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

5.18.4.5 継承されて使用できるメソッド

(1) CORBA-CONTAINER-DEF_KIND

  (1)については、“IRObject共通インタフェース”を継承します。
  “CORBA-IROBJECT”の部分を“CORBA-CONTAINER”に置き換えて使用することができます。
  関数の仕様については、“5.18.2 IRObject共通インタフェース”を参照してください。