フィールドの詳細

• USERNAME_PROPERTY

  static final StringSE USERNAME_PROPERTY

  標準プロパティ: 認証用のユーザー名

  タイプ: java.lang.String

  関連事項:

  定数フィールド値

• PASSWORD_PROPERTY

  static final StringSE PASSWORD_PROPERTY

  標準プロパティ: 認証用のパスワード

  タイプ: java.lang.String

  関連事項:

  定数フィールド値

• OPERATION_STYLE_PROPERTY

  static final StringSE OPERATION_STYLE_PROPERTY

  操作スタイルの標準プロパティ。操作スタイルが rpc の場合、このプロパティは "rpc" に設定されます。操作スタイルがドキュメントの場合は「ドキュメント」。

  タイプ: java.lang.String

  関連事項:

  定数フィールド値

• SOAPACTION_USE_PROPERTY

  static final StringSE SOAPACTION_USE_PROPERTY

  SOAPAction の標準プロパティ。このブールプロパティは、SOAPAction を使用するかどうかを示します。このプロパティのデフォルト値は false であり、SOAPAction が使用されていないことを示します。

  タイプ: java.lang.Boolean

  関連事項:

  定数フィールド値

• SOAPACTION_URI_PROPERTY

  static final StringSE SOAPACTION_URI_PROPERTY

  SOAPAction の標準プロパティ。javax.xml.rpc.soap.http.soapaction.use プロパティが true に設定されている場合、SOAPAction URI を示します。

  タイプ: java.lang.String

  関連事項:

  定数フィールド値

• ENCODINGSTYLE_URI_PROPERTY

  static final StringSE ENCODINGSTYLE_URI_PROPERTY

  エンコーディングスタイルの標準プロパティ: 名前空間 URI として指定されたエンコーディングスタイル。デフォルト値は、http://schemas.xmlsoap.org/soap/encoding/ をエンコードする SOAP 1.1 です。

  タイプ: java.lang.String

  関連事項:

  定数フィールド値

• SESSION_MAINTAIN_PROPERTY

  static final StringSE SESSION_MAINTAIN_PROPERTY

  標準プロパティ: このブールプロパティは、サービスクライアントがサービスエンドポイントとのセッションに参加するかどうかを示すために使用されます。このプロパティが true に設定されている場合、サービスクライアントは、セッションを維持する必要があることを示します。false に設定すると、セッションは維持されません。このプロパティのデフォルト値は false です。

  タイプ: java.lang.Boolean

  関連事項:

  定数フィールド値

メソッドの詳細

• isParameterAndReturnSpecRequired

  boolean isParameterAndReturnSpecRequired(QNameSE operationName)

  addParameter メソッドと setReturnType メソッドを呼び出して、特定の操作のパラメーターと戻り値の型の指定を指定するかどうかを示します。

  パラメーター:

  operationName - 操作の修飾名

  戻り値:

  Call 実装クラスが、指定された操作のためにクライアントコードで addParameter と setReturnType を呼び出すことを必要とする場合は true を返します。それ以外の場合は、このメソッドは false を返します。

  例外:

  IllegalArgumentExceptionSE - 無効な操作名を指定した場合

• addParameter

  void addParameter(StringSE paramName,
                    QNameSE xmlType,
                    ParameterMode parameterMode)

  特定の操作のパラメーター型とモードを追加します。クライアントコードは、invoke メソッドを呼び出す前に addParameter メソッドと setReturnType メソッドを呼び出さない場合があることに注意してください。この場合、Call 実装クラスは、WSDL 記述と構成済み型・マッピングレジストリを使用して、パラメーターのリフレクションを使用してパラメーター・型を判別します。

  パラメーター:

  paramName - パラメーターの名前

  xmlType - パラメーターの XML 型

  parameterMode - パラメーターのモード - ParameterMode.IN、ParameterMode.OUT、ParameterMode.INOUT のいずれか

  例外:

  JAXRPCException - メソッド isParameterAndReturnSpecRequired がこの操作に対して false を返す場合、この例外がスローされる可能性があります。

  IllegalArgumentExceptionSE - 不正なパラメーター名または XML 型が指定されている場合

  関連事項:

  isParameterAndReturnSpecRequired(javax.xml.namespace.QName)

• addParameter

  void addParameter(StringSE paramName,
                    QNameSE xmlType,
                    ClassSE javaType,
                    ParameterMode parameterMode)

  特定の操作のパラメーター型とモードを追加します。このメソッドは、OUT または INOUT パラメーターの Java 型を指定するために使用されます。

  パラメーター:

  paramName - パラメーターの名前

  xmlType - パラメーターの XML 型

  javaType - パラメーターの Java クラス

  parameterMode - パラメーターのモード -ParameterMode.IN、OUT、INOUT のいずれか

  例外:

  JAXRPCException -

  • この例外は、メソッド isParameterAndReturnSpecRequired が false を返すときにこのメソッドが呼び出された場合にスローされる可能性があります。
  • 指定された XML 型および Java 型のマッピングが無効な場合。例: TypeMappingRegistry には、このマッピング用のシリアライザーがありません。

  IllegalArgumentExceptionSE - 不正なパラメーター名または XML 型が指定されている場合

  UnsupportedOperationExceptionSE - この方法がサポートされていない場合

  関連事項:

  isParameterAndReturnSpecRequired(javax.xml.namespace.QName)

• getParameterTypeByName

  QNameSE getParameterTypeByName(StringSE paramName)

  パラメーターの XML 型を名前で取得します

  パラメーター:

  paramName - パラメーターの名前

  戻り値:

  指定されたパラメーターの XML 型を返します

• setReturnType

  void setReturnType(QNameSE xmlType)

  特定の操作の戻り値の型を設定します。setReturnType(null) を呼び出すと、この Call オブジェクトの戻り値の型が削除されます。

  パラメーター:

  xmlType - 戻り値の XML データ型

  例外:

  JAXRPCException - この例外は、メソッド isParameterAndReturnSpecRequired が false を返すときにスローされる可能性があります。

  IllegalArgumentExceptionSE - 不正な XML 型が指定されている場合

• setReturnType

  void setReturnType(QNameSE xmlType,
                     ClassSE javaType)

  特定の操作の戻り値の型を設定します。

  パラメーター:

  xmlType - 戻り値の XML データ型

  javaType - 戻り値の Java クラス

  例外:

  JAXRPCException -

  • この例外は、メソッド isParameterAndReturnSpecRequired が false を返すときにこのメソッドが呼び出された場合にスローされる可能性があります。
  • XML 型と Java 型が標準型マッピングまたは TypeMapping レジストリを使用してマッピングできない場合

  UnsupportedOperationExceptionSE - この方法がサポートされていない場合

  IllegalArgumentExceptionSE - 不正な XML 型が指定されている場合

• getReturnType

  QNameSE getReturnType()

  特定の操作の戻り値の型を取得します

  戻り値:

  戻り値の XML 型を返します

• removeAllParameters

  void removeAllParameters()

  指定されたすべてのパラメーターをこの Call インスタンスから削除します。このメソッドはパラメーターのみを削除し、戻り値の型は削除しないことに注意してください。setReturnType(null) は、戻り値の型を削除するために使用されます。

  例外:

  JAXRPCException - メソッド isParameterAndReturnSpecRequired がこの呼び出しの操作に対して false を返すときにこのメソッドが呼び出された場合、この例外がスローされる可能性があります。

• getOperationName

  QNameSE getOperationName()

  この Call インスタンスを使用して呼び出される操作の名前を取得します。

  戻り値:

  操作の修飾名

• setOperationName

  void setOperationName(QNameSE operationName)

  この Call インスタンスを使用して呼び出される操作の名前を設定します。

  パラメーター:

  operationName - Call インスタンスを使用して呼び出される操作の QName

• getPortTypeName

  QNameSE getPortTypeName()

  ポート型の修飾名を取得します。

  戻り値:

  ポート型の修飾名

• setPortTypeName

  void setPortTypeName(QNameSE portType)

  ポート型の修飾名を設定します。

  パラメーター:

  portType - ポート型の修飾名

• setTargetEndpointAddress

  void setTargetEndpointAddress(StringSE address)

  ターゲットサービスエンドポイントのアドレスを設定します。このアドレスは、この Call インスタンスのバインディングで指定されたトランスポートに対応している必要があります。

  パラメーター:

  address - ターゲットサービスエンドポイントのアドレス。URI として指定

• getTargetEndpointAddress

  StringSE getTargetEndpointAddress()

  ターゲットサービスエンドポイントのアドレスを取得します。

  戻り値:

  URI としてのターゲットサービスエンドポイントのアドレス

• setProperty

  void setProperty(StringSE name,
                   ObjectSE value)

  名前付きプロパティの値を設定します。Jakarta XML RPC 仕様は、Call.setProperty メソッドに渡すことができるプロパティの標準セットを指定します。

  パラメーター:

  name - プロパティの名前

  value - プロパティの値

  例外:

  JAXRPCException -

  • ただし、オプションの標準プロパティ名が指定されている場合、この Call 実装クラスはこのプロパティの構成をサポートしません。
  • 無効な（またはサポートされていない）プロパティ名が指定された場合、またはプロパティ型が一致しない値が渡された場合。
  • 有効なプロパティの構成にエラーがある場合。

• getProperty

  ObjectSE getProperty(StringSE name)

  名前付きプロパティの値を取得します。

  パラメーター:

  name - プロパティの名前

  戻り値:

  名前付きプロパティの値

  例外:

  JAXRPCException - 無効またはサポートされていないプロパティ名が渡された場合。

• removeProperty

  void removeProperty(StringSE name)

  名前付きプロパティを削除します。

  パラメーター:

  name - プロパティの名前

  例外:

  JAXRPCException - 無効またはサポートされていないプロパティ名が渡された場合。

• getPropertyNames

  IteratorSE getPropertyNames()

  この Call オブジェクトでサポートされている構成可能なプロパティの名前を取得します。

  戻り値:

  プロパティ名のイテレータ

• invoke

  ObjectSE invoke(ObjectSE[] inputParams)
         throws RemoteExceptionSE

  同期リクエスト / レスポンス対話モードを使用して特定の操作を呼び出します。

  パラメーター:

  inputParams - Object[]- この呼び出しのパラメーター。これには、入力パラメーターのみが含まれます

  戻り値:

  戻り値または null を返します

  例外:

  RemoteExceptionSE - リモートメソッドの呼び出しにエラーがある場合

  SOAPFaultException - SOAP 障害を示します

  JAXRPCException -

  • Call オブジェクトの構成にエラーがある場合
  • inputParams が必要なパラメーターセットと一致しない場合 (addParameter 呼び出しまたは対応する WSDL で指定されたとおり)
  • パラメーターと戻り値の型が正しく指定されていない場合

• invoke

  ObjectSE invoke(QNameSE operationName,
                ObjectSE[] inputParams)
         throws RemoteExceptionSE

  同期リクエスト / レスポンス対話モードを使用して特定の操作を呼び出します。

  パラメーター:

  operationName - 操作の QName

  inputParams - Object[]- この呼び出しのパラメーター。これには、入力パラメーターのみが含まれます。

  戻り値:

  戻り値または null

  例外:

  RemoteExceptionSE - リモートメソッドの呼び出しにエラーがある場合。

  SOAPFaultException - SOAP 障害を示します

  JAXRPCException -

  • Call オブジェクトの構成にエラーがある場合
  • inputParam が必要なパラメーターセットと一致しない場合 (addParameter 呼び出しまたは対応する WSDL で指定されたとおり)
  • パラメーターと戻り値の型が正しく指定されていない場合

• invokeOneWay

  void invokeOneWay(ObjectSE[] inputParams)

  一方向の相互作用モードを使用してリモートメソッドを呼び出します。クライアントスレッドは通常、このリモートメソッド呼び出しのサーバー処理の完了を待機することをブロックしません。使用中のプロトコルが SOAP/HTTP の場合、このメソッドは、HTTP レスポンスコードを受信するか、エラーが発生するまでブロックする必要があります。このメソッドは、リモート例外をスローしてはなりません。このメソッドは、一方向のリモート呼び出しの処理中に JAXRPCException をスローする場合があります。

  パラメーター:

  inputParams - Object[]- この呼び出しのパラメーター。これには、入力パラメーターのみが含まれます。

  例外:

  JAXRPCException - Call オブジェクトの構成にエラーがある場合（例: 一方向呼び出しに対して非 void 戻り値の型が誤って指定されている場合）、または一方向リモート呼び出しの呼び出し中にエラーが発生した場合

• getOutputParams

  MapSE getOutputParams()

  最後に呼び出された操作の出力パラメーターに対して、{name、value} の Map を返します。返されるマップのパラメーター名は、型 java.lang.String です。

  戻り値:

  最後の Call.invoke() の出力パラメーターをマップします。出力パラメーターがない場合は、空の Map が返されます。

  例外:

  JAXRPCException - このメソッドが一方向操作のために呼び出された場合、または invoke メソッドが呼び出される前に呼び出された場合。

• getOutputValues

  ListSE getOutputValues()

  最後に呼び出された操作の出力パラメーターの List 値を返します。

  戻り値:

  java.util.List 出力パラメーターの値。出力値がない場合は、空の List が返されます。

  例外:

  JAXRPCException - このメソッドが一方向操作のために呼び出された場合、または invoke メソッドが呼び出される前に呼び出された場合。