メソッドの詳細

• getPort

  RemoteSE getPort(QNameSE portName,
                 ClassSE serviceEndpointInterface)
          throws ServiceException

  getPort メソッドは、生成されたスタブ実装クラスのインスタンスまたは動的プロキシのいずれかを返します。サービスクライアントはこの動的プロキシを使用して、ターゲットサービスエンドポイントで操作を呼び出します。serviceEndpointInterface は、作成された動的プロキシまたはスタブインスタンスによってサポートされるサービスエンドポイントインターフェースを指定します。

  パラメーター:

  portName - WSDL サービス記述のサービスエンドポイントの修飾名

  serviceEndpointInterface - 動的プロキシまたはスタブインスタンスでサポートされるサービスエンドポイントインターフェース

  戻り値:

  指定されたサービスエンドポイントインターフェースをサポートする java.rmi.Remote スタブインスタンスまたは動的プロキシ

  例外:

  ServiceException - この例外は、次の場合にスローされます。

  • 動的プロキシまたはスタブインスタンスの作成でエラーが発生した場合
  • このメソッドで必要とされる WSDL メタデータが欠落している場合
  • オプションで、不正な serviceEndpointInterface または portName が指定されている場合

  関連事項:

  ProxySE, InvocationHandlerSE

• getPort

  RemoteSE getPort(ClassSE serviceEndpointInterface)
          throws ServiceException

  getPort メソッドは、生成されたスタブ実装クラスのインスタンスまたは動的プロキシのいずれかを返します。パラメーター serviceEndpointInterface は、返されたスタブまたはプロキシでサポートされているサービスエンドポイントインターフェースを指定します。このメソッドの実装では、Jakarta XML RPC ランタイムシステムがプロトコルバインディング (およびポート) を選択し、それに応じてスタブを構成する責任を負います。返された Stub インスタンスは、クライアントによって再構成しないでください。

  パラメーター:

  serviceEndpointInterface - サービスエンドポイントインターフェース

  戻り値:

  指定されたサービスエンドポイントインターフェースをサポートするスタブインスタンスまたは動的プロキシ

  例外:

  ServiceException -

  • スタブインスタンスまたはダイナミックプロキシの作成中にエラーが発生した場合
  • このメソッドで必要とされる WSDL メタデータが欠落している場合
  • オプションで、不正な serviceEndpointInterface が指定されている場合

• getCalls

  Call[] getCalls(QNameSE portName)
           throws ServiceException

  指定されたポートで操作を呼び出すための事前構成された Call オブジェクトの配列を取得します。指定されたポートで呼び出すことができる操作ごとに 1 つの Call オブジェクトがあります。各 Call オブジェクトは事前に構成されており、Call インターフェースで setter メソッドを使用して構成する必要はありません。

  getCalls メソッドを呼び出すたびに、事前構成された Call オブジェクトの新しい配列が返されます。

  このメソッドでは、Service 実装クラスが WSDL 関連のメタデータにアクセスできる必要があります。

  パラメーター:

  portName - ターゲットサービスエンドポイントの修飾名

  戻り値:

  Call[] 事前設定された Call オブジェクトの配列

  例外:

  ServiceException - このサービスクラスが必要な WSDL メタデータにアクセスできない場合、または不正な portName が指定されている場合。

• createCall

  Call createCall(QNameSE portName)
           throws ServiceException

  Call インスタンスを作成します。

  パラメーター:

  portName - ターゲットサービスエンドポイントの修飾名

  戻り値:

  インスタンスを呼び出す

  例外:

  ServiceException - Call オブジェクトの作成でエラーが発生した場合

• createCall

  Call createCall(QNameSE portName,
                  QNameSE operationName)
           throws ServiceException

  Call インスタンスを作成します。

  パラメーター:

  portName - ターゲットサービスエンドポイントの修飾名

  operationName - この Call オブジェクトが作成される操作の修飾名。

  戻り値:

  インスタンスを呼び出す

  例外:

  ServiceException - Call オブジェクトの作成でエラーが発生した場合

• createCall

  Call createCall(QNameSE portName,
                  StringSE operationName)
           throws ServiceException

  Call インスタンスを作成します。

  パラメーター:

  portName - ターゲットサービスエンドポイントの修飾名

  operationName - この Call オブジェクトが作成される操作の名前。

  戻り値:

  インスタンスを呼び出す

  例外:

  ServiceException - Call オブジェクトの作成でエラーが発生した場合

• createCall

  Call createCall()
           throws ServiceException

  特定の操作またはターゲットサービスエンドポイントに関連付けられていない Call オブジェクトを作成します。この Call オブジェクトは、Call インターフェースで setter メソッドを使用して構成する必要があります。

  戻り値:

  オブジェクトを呼び出す

  例外:

  ServiceException - Call オブジェクトの作成でエラーが発生した場合

• getServiceName

  QNameSE getServiceName()

  このサービスの名前を取得します。

  戻り値:

  このサービスの修飾名

• getPorts

  IteratorSE getPorts()
             throws ServiceException

  このサービスによってグループ化されたサービスエンドポイントの QName のリストの Iterator を返します

  戻り値:

  型 javax.xml.namespace.QName の要素を持つ java.util.Iterator を返します

  例外:

  ServiceException - このサービスクラスが必要な WSDL メタデータにアクセスできない場合

• getWSDLDocumentLocation

  URLSE getWSDLDocumentLocation()

  このサービスの WSDL ドキュメントの場所を取得します。

  戻り値:

  このサービスの WSDL ドキュメントの場所の URL

• getTypeMappingRegistry

  TypeMappingRegistry getTypeMappingRegistry()

  この Service オブジェクトの TypeMappingRegistry を取得します。返される TypeMappingRegistry インスタンスは、Jakarta XML RPC 仕様で要求されているように、XML 型と Java 型の間の標準型マッピングをサポートするように事前構成されています。

  戻り値:

  このサービスオブジェクトの TypeMappingRegistry。

  例外:

  UnsupportedOperationExceptionSE - Service クラスが TypeMappingRegistry の構成をサポートしていない場合。

• getHandlerRegistry

  HandlerRegistry getHandlerRegistry()

  この Service インスタンス用に構成された HandlerRegistry インスタンスを返します。

  戻り値:

  HandlerRegistry

  例外:

  UnsupportedOperationExceptionSE - Service クラスが HandlerRegistry の構成をサポートしていない場合