JAX-RPC

JAX-RPC Web サービスは、JavaBeans またはエンタープライズ Bean 実装から作成することができます。 Java インターフェイスでリモート メソッドを定義することにより、リモート プロシージャを指定できます。 そのメソッドを実装する 1 つまたは複数のクラスをコードすることのみが 必要です。 残りのクラスとその他の成果物は、Web サービス・ベンダーのツールによって生成されます。 以下は、Web サービス・インターフェースの例です。

package com.ibm.mybank.ejb;
import java.rmi.RemoteException;
import com.ibm.mybank.exception.InsufficientFundsException;
/**
	* Remote interface for Enterprise Bean: Transfer
	*/
public interface Transfer_SEI extends java.rmi.Remote {
			public void transferFunds(int fromAcctId, int toAcctId, float amount)
						throws java.rmi.RemoteException;

}

JAX-RPC のインターフェース定義は、特定の規則に従う必要があります。

• インターフェースは、RMI のように java.rmi.Remote を拡張する必要があります。
• メソッドは java.rmi.RemoteException を作成する必要があります。
• メソッド・パラメーターは、リモート参照になることはできません。
• メソッド・パラメーターは、 JAX-RPC 仕様でサポートされているパラメーターの 1 つでなければなりません。 以下に、サポートされているメソッド・パラメーターの例をリストします。 メソッド・パラメーターの完全なリストについては、 JAX-RPC 仕様を参照してください。
  • プリミティブ型:boolean, byte, double, float, short, intそしてlong
  • プリミティブ型のオブジェクト ラッパー:java.lang.Boolean, java.lang.Byte, java.lang.Double, java.lang.Float, java.lang.Integer, java.lang.Long, java.lang.Short
  • java.lang.String
  • java.lang.BigDecimal
  • java.lang.BigInteger
  • java.lang.Calendar
  • java.lang.Date
• メソッドは、集約値オブジェクトに加え、前にリストした型のコンポジットから構成される値オブジェクトを取ることができます。

以下は、Web サービスおよび Web サービス・クライアントを書き込むのに必要なキー・クラスおよびインターフェースです。

• サービス・インターフェース: スタブまたは動的呼び出しおよ びメソッドを呼び出すのに使用されるプロキシー・オブジェクト用ファクトリー
• ServiceFactory クラス: サービス用ファクトリー。
• loadService

  のloadService方法は以下に記載されているWebSphere Application Serverバージョン6.0 JAX-RPC 実装に必要なサービス ロケータを生成します。 再呼び出しすると、旧バージョンでは、生成済みサービス・ロケーターを取得する特定の方法がありませんでした。 管理対象クライアントの場合は、サービスロケータを取得するためにJNDIメソッドを使用し、管理対象外クライアントの場合は、インスタンス化する必要がありました。 IBMの特定のサービスロケータServiceLocator service=new ServiceLocator(...);移植性はありません。 loadService パラメーターには、以下が含まれます。

  • wsdlDocumentLocation: サービスの WSDL 文書ロケーションの URL またはヌル。
  • serviceName: サービスの修飾名
  • properties: 生成されたサービス実装 クラスの場所を探索するのに役立つ実装固有の プロパティーのセット。
• isUserInRole
  isUserInRole メソッド は、エンドポイント・インスタンスでの現行のメソッド呼び出し用の認証済 みユーザーが、特定の論理ロールに含まれているかどうかを示すブール値を戻します。

  • role: ロール・パラメーターは、ロールの名前を指定するストリングです。
• サービス
• 呼び出しインターフェース: 動的呼び出しに使用
• スタブ・インターフェース: スタブ用基本インターフェース