- java.lang.Object
-
- javax.xml.ws.EndpointReference
-
- 直系の既知のサブクラス:
W3CEndpointReference
public abstract class EndpointReference extends Object
このクラスは、Webサービス端点へのリモート参照であるWS-Addressing EndpointReferenceを表します。 WS-Addressing EndpointReferenceの詳細については、Web Services Addressing 1.0 - Coreを参照してください。一般にWebサービスの開発者はこのクラスの内容を考慮する必要がないため、このクラスは不変です。 Webサービスの開発者は、リモートのWebサービス端点を参照するメカニズムとしてのみこのクラスを使用するようにしてください。 クライアントで
EndpointReference
を利用するために使用できるService
APIを参照してください。 発行された端点にEndpointReferences
を作成する方法については、Endpoint
およびBindingProvider
APIを参照してください。このクラスの固定実装は、特定のバージョンのアドレス指定で使用する
EndpointReference
を表します。 たとえば、W3CEndpointReference
は「W3C Web Services Addressing 1.0 - Core Recommendation」で使用します。 JAX-WSの実装者が複数のバージョンのアドレス指定をサポートする必要がある場合、そのバージョンに対応する独自のEndpointReference
サブクラスを作成する必要があります。 これにより、JAX-WS実装でベンダー固有のEndpointReferences
を作成でき、ベンダーはそれを使用して異なるバージョンのアドレス指定を示すことができます。Webサービスの開発者は、SEIのJavaメソッドで引数や戻り値として
EndpointReference
を使用する場合、W3CEndpointReference
といったEndpointReference
の具象インスタンスを使用するようにしてください。 このようにすると、SEIからマッピングされたスキーマでは、渡される端点の参照の種類がより適切に記述されるようになります。JAX-WS実装者は、
EndpointReferece
からwriteTo(javax.xml.transform.Result)
メソッドを使用してXMLインフォセットを抽出することが期待されています。JAXBはこのクラスをxs:anyTypeにバインドします。 より適切なバインディングが必要な場合、Webサービスの開発者は、
W3CEndpointReference
などの具象サブクラスを使用するようにしてください。- 導入されたバージョン:
- 1.6, JAX-WS 2.1
- 関連項目:
W3CEndpointReference
,Service
-
-
コンストラクタのサマリー
コンストラクタ 修飾子 コンストラクタ 説明 protected
EndpointReference()
デフォルトのコンストラクタです。
-
メソッドのサマリー
すべてのメソッド staticメソッド インスタンス・メソッド 抽象メソッド 具象メソッド 修飾子と型 メソッド 説明 <T> T
getPort(Class<T> serviceEndpointInterface, WebServiceFeature... features)
getPort
メソッドはプロキシを返します。static EndpointReference
readFrom(Source eprInfoset)
eprInfoset
に含まれている情報セットからEndpointReferenceを読み取るためのファクトリ・メソッドです。String
toString()
デバッグに役立つようにEPR情報セットを表示します。abstract void
writeTo(Result result)
このEndpointReference
を指定された情報セット形式に書き出します。
-
-
-
メソッドの詳細
-
readFrom
public static EndpointReference readFrom(Source eprInfoset)
eprInfoset
に含まれている情報セットからEndpointReferenceを読み取るためのファクトリ・メソッドです。 このメソッドは、Provider.readEndpointReference(javax.xml.transform.Source)
メソッドのベンダー固有の実装に処理を委譲します。- パラメータ:
eprInfoset
- 非整列化するEndpointReference
情報セット- 戻り値:
eprInfoset
から非整列化されたEndpointReference。null
になることはない- 例外:
WebServiceException
-eprInfoset
からEndpointReference
の作成中にエラーが発生した場合IllegalArgumentException
- 指定されたeprInfoset
の値がnull
の場合。
-
writeTo
public abstract void writeTo(Result result)
このEndpointReference
を指定された情報セット形式に書き出します。- パラメータ:
result
- 情報セットの書込み用- 例外:
WebServiceException
-EndpointReference
を指定のresult
に書き出すときにエラーが発生した場合。IllegalArgumentException
- 指定されたresult
の値がnull
の場合。
-
getPort
public <T> T getPort(Class<T> serviceEndpointInterface, WebServiceFeature... features)
getPort
メソッドはプロキシを返します。EndpointReference
インスタンスに参照パラメータがある場合は、端点に送信されるすべてのメッセージにそれらの参照パラメータをSOAPヘッダーとして含め、それらが参照パラメータであることを示す必要があります。 パラメータserviceEndpointInterface
は、戻り値のプロキシによってサポートされるサービス端点インタフェースを指定します。EndpointReference
インスタンスは、戻り値のプロキシによって呼び出される端点を指定します。 このメソッドの実装では、このEndpointReference
のWSDLメタデータまたはserviceEndpointInterface
の注釈に従って、JAX-WS実行システムがプロトコル・バインディング(およびポート)の選択とプロキシの構成を行います。 このメソッドで正常にプロキシを取得するには、WSDLメタデータが利用可能であることと、実装で認識されるserviceName
メタデータがEndpointReference
インスタンスに含まれていることが必要です。このポートは
Service
オブジェクトから作成されるのではないため、ハンドラは自動的には構成されず、HandlerResolver
とExecutor
の取得や設定をこのポートから行うことはできません。BindingProvider().getBinding().setHandlerChain()
メソッドを使用すると、このポートのハンドラを手動で構成することができます。- 型パラメータ:
T
- サービス・エンドポイント・インタフェース- パラメータ:
serviceEndpointInterface
- サービス端点インタフェースfeatures
- プロキシに構成するWebServiceFeatures
の配列。features
パラメータに含まれていないサポートされる機能には、デフォルト値が設定される。- 戻り値:
- 指定されたサービス端点インタフェースをサポートするObject Proxyインスタンス
- 例外:
WebServiceException
-- プロキシの作成中にエラーがあった場合
- このメソッドが必要とするWSDLメタデータが不足している場合
- この
endpointReference
が無効である場合 - 不正な
serviceEndpointInterface
が指定された場合 - このポートと互換性のない機能、またはサポートされていない機能を有効にした場合。
- 関連項目:
Proxy
,WebServiceFeature
-
-