InteractionSpec 出力プロパティーのデータとしての公開

IMSInteractionSpec プロパティーを出力データとして公開することができます。現在、公開可能な出力プロパティーは、asyncOutputAvailable、convEnded、および mapName のみです。これらの IMSInteractionSpec のプロパティーを出力データとして公開するには、新規出力クラスを作成し、J2C Java Bean をアプリケーションで使用する前に、そのインターフェース・ファイルおよび実装ファイルを変更する必要があります。

通常は、Java アプリケーションで出力データとして必要なプロパティーだけを公開します。このトピックのステップでは、J2C Java Bean の作成および IMS への接続プロパティーの追加で作成したプロジェクト PhoneBookJ2CBean の J2C Java Bean を使用して、IMSInteractionSpec のすべてのプロパティーを公開する方法について説明します。

IMSInteractionSpec のすべてのプロパティーを出力データとして公開するには、次のステップを実行します。

  1. プロジェクト「PhoneBookJ2CBean」を展開し、Java エディターでインターフェース・ファイル「PB.java」を開く。
  2. PB.java ファイルで、「runPB()」のシグニチャーを更新する。 IMSInteractionSpec の出力プロパティーの引数を追加します。これらの引数は、公開されたプロパティーの出力値を指定するために使用します。その使用法は、IMS トランザクションの出力メッセージの値を指定するために、引数 OUTPUTMSGarg を使用する方法と同じです。メソッド runPB() に引数を追加すると、コードは次のようになります。
    package sample.ims;
    
    
    /**
     * @generated
     */
    public interface PB {
    
    	/**
    	 * @generated
    	 */
    	public sample.ims.WrapperBean runPB(sample.ims.INPUTMSG arg,
                int myCommitMode,
                int myExecutionTimeout,
                int myImsRequestType,
                int myInteractionVerb,
                String myLtermName,
                String myMapName,
                boolean myPurgeAsyncOutput,
                boolean myReRoute,
                String myReRouteName,
                int mySocketTimeout,
                String myUserName,
                String myPassword,
                String myGroupName,
                String myClientID
    			) throws javax.resource.ResourceException;
    }
  3. 次のステップを実行して、新規クラス WrapperBean を作成する。
    1. プロジェクト「PhoneBookBindings」を展開し、「sample.ims」パッケージを右クリックして、「新規」>「クラス」を選択する。
    2. クラスの名前として、「WrapperBean.」を入力する。
    3. 作成するメソッドについて、「継承された抽象メソッド」および「スーパークラスのコンストラクター (Constructors from super class)」を選択する。
    4. 完了」をクリックする。
    5. エディターで「WrapperBean」クラスを開き、「java.io.Serializable」の import 文を追加する。
    6. Serializable を実装するように WrapperBean クラスを変更する。 例:
      public class WrapperBean implements Serializable {
    7. WrapperBean クラスで、IMS トランザクションの出力メッセージの IMS Java データ・バインディング用のプライベート変数を追加する。 例:
      private OUTPUTMSG output;
    8. WrapperBean クラスで、公開したい IMSInteractionSpec のプロパティー用のプライベート変数を追加する。 例:
      private boolean convEnded;
      private boolean asyncOutputAvailable;
      private String mapName;
    9. 次に、出力メッセージの get メソッドと set メソッド、および公開されたそれぞれのプロパティーを追加する。 例:
      public OUTPUTMSG getOutput(){
              return output;
          }   
         
          public boolean getConvEnded(){
              return convEnded;
          }
         
          public boolean getAsyncOutputAvailable(){
              return asyncOutputAvailable;
          } 
          
          public String getMapName(){
              return mapName;
          }
         
          public void setOutput(OUTPUTMSG output){
              this.output = output;
          }
         
          public void setAsyncOutputAvailable(boolean asyncOutputAvailable){
              this.asyncOutputAvailable = asyncOutputAvailable;
          }   
      
          public void setConvEnded(boolean convEnded){
              this.convEnded = convEnded;
          }    
          
          public void setMapName(String mapName){
              this.mapName = mapName;
          }
    10. WrapperBean クラスを保管して閉じる。
  4. PhoneBookJ2CBean」>「sample.ims」を展開して、新規出力クラス「WrapperBean」を使用するようにインターフェース・ファイルを変更し、Java エディターでインターフェース・ファイル「PB.java」を開く。
  5. OUTPUTMSG ではなく WrapperBean を戻すように、メソッド runPB() (IMS トランザクションを実行するメソッド) の出力を変更する。 例:
    public sample.ims.WrapperBean runBP(INPUTMSG arg) throws javax.resource.ResourceException;
  6. PhoneBookJ2CBean」>「sample.ims」を展開して、新規出力クラス「WrapperBean」を使用するように実装ファイルを変更し、Java エディターで実装ファイル「PBImpl.java」を開く。
  7. OUTPUTMSG ではなく WrapperBean を戻すように、メソッド runPB() (IMS トランザクションを実行するメソッド) の出力を変更する。 例:
    public sample.ims.WrapperBean runBP(INPUTMSG arg) throws javax.resource.ResourceException {
    
  8. 公開したい出力プロパティーのドックレット・タグを追加して、runPB() メソッドの javadoc を更新する。 例えば、以下の runPB() の javadoc には、入力プロパティーと出力プロパティーの両方のタグが表示されています。
    /**
         * @j2c.interactionSpec class="com.ibm.connector2.ims.ico.IMSInteractionSpec"
         * @j2c.interactionSpec-property name="commitMode" argumentBinding="myCommitMode"
         * @j2c.interactionSpec-property name="executionTimeout" argumentBinding="myExecutionTimeout"
         * @j2c.interactionSpec-property name="imsRequestType" argumentBinding="myImsRequestType"
         * @j2c.interactionSpec-property name="interactionVerb" argumentBinding="myInteractionVerb"
         * @j2c.interactionSpec-property name="ltermName" argumentBinding="myLtermName"
         * @j2c.interactionSpec-property name="mapName" argumentBinding="myMapName"
         * @j2c.interactionSpec-property name="purgeAsyncOutput" argumentBinding="myPurgeAsyncOutput"
         * @j2c.interactionSpec-property name="reRoute" argumentBinding="myReRoute"
         * @j2c.interactionSpec-property name="reRouteName" argumentBinding="myReRouteName"
         * @j2c.interactionSpec-property name="socketTimeout" argumentBinding="mySocketTimeout"
         * @j2c.interactionSpec-returnProperty
         *   name="convEnded"
         *   outputBinding="convEnded"
         * @j2c.interactionSpec-returnProperty
         *   name="asyncOutputAvailable"
         *   outputBinding="asyncOutputAvailable"
         * @j2c.interactionSpec-returnProperty
         *   name="mapName"
         *   outputBinding="mapName"
         *
         * @j2c.connectionSpec class="com.ibm.connector2.ims.ico.IMSConnectionSpec"
         * @j2c.connectionSpec-property name="userName" argumentBinding="myUserName"
         * @j2c.connectionSpec-property name="password" argumentBinding="myPassword"
         * @j2c.connectionSpec-property name="groupName" argumentBinding="myGroupName"
         * @j2c.connectionSpec-property name="clientID" argumentBinding="myClientID"
         *
         * @generated
         */  
    
  9. ファイルを保管して閉じる。 新しい実装コードが、メソッド runPB() 用に生成されました。
IMSInteractionSpec プロパティーが出力データとして公開されました。
関連タスク
IMS Java データ・バインディングの作成
J2C Java Bean の作成および IMS への接続プロパティーの追加
データとして入力するための InteractionSpec および ConnectionSpec プロパティーの公開
J2C Java Bean からの Web ページ、Web サービス、または EJB の作成
CCI アプリケーションでの IMS データ・バインディングの使用
ご利用条件 | フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.
(C) Copyright IBM Japan 2005.