public abstract class EndpointReference extends ObjectSE
通常の Web サービス開発者はその内容を気にする必要がないため、このクラスは不変です。Web サービス開発者は、リモート Web サービスエンドポイントを参照するメカニズムとしてこのクラスを厳密に使用する必要があります。クライアントが EndpointReference
を利用するために使用できる Service
API を参照してください。公開されたエンドポイント用に EndpointReferences
を作成する方法については、Endpoint
および BindingProvider
API を参照してください。
このクラスの具体的な実装は、特定のバージョンのアドレッシングの EndpointReference
を表します。たとえば、W3CEndpointReference
は、1.0 に対応する W3C Web サービスで使用するためのものです - コア推奨事項。Jakarta XML Web Services 実装者が異なるバージョンのアドレス指定をサポートする必要がある場合は、そのバージョン用に独自の EndpointReference
サブクラスを作成する必要があります。これにより、Jakarta XML Web Services 実装は、ベンダーが異なるバージョンのアドレス指定にフラグを立てるために使用できるベンダー固有の EndpointReferences
を作成できるようになります。
SEI の Java メソッドで EndpointReference
を渡したり返したりしたい Web サービス開発者は、W3CEndpointReference
などの EndpointReference
の具象インスタンスを使用する必要があります。このようにして、SEI からマップされたスキーマは、渡されるエンドポイント参照の型をより説明します。
Jakarta XML Web Services 実装者は、writeTo(javax.xml.transform.Result)
メソッドを使用して EndpointReferece
から XML 情報セットを抽出することが期待されています。
Jakarta XML Binding は、このクラスを xs:anyType にバインドします。より適切なバインディングが必要な場合、Web サービス開発者は W3CEndpointReference
などの具象サブクラスを使用する必要があります。
W3CEndpointReference
, Service
修飾子 | コンストラクターと説明 |
---|---|
protected | EndpointReference() デフォルトコンストラクター。 |
修飾子と型 | メソッドと説明 |
---|---|
<T> T | getPort(ClassSE<T> serviceEndpointInterface, WebServiceFeature... features) getPort メソッドはプロキシを返します。 |
static EndpointReference | readFrom(SourceSE eprInfoset) eprInfoset に含まれる情報セットから EndpointReference を読み取るファクトリメソッド。 |
StringSE | toString() デバッグに便利な EPR 情報セットを表示します。 |
abstract void | writeTo(ResultSE result) この EndpointReference を指定された情報セット形式に書き込みます |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, waitSE, waitSE, waitSE
public static EndpointReference readFrom(SourceSE eprInfoset)
eprInfoset
に含まれる情報セットから EndpointReference を読み取るファクトリメソッド。このメソッドは、Provider.readEndpointReference(javax.xml.transform.Source)
メソッドのベンダー固有の実装に委譲します。eprInfoset
- マーシャリングされない EndpointReference
情報セット eprInfoset
からマーシャリングされていない EndpointReference は決して null
ではありません WebServiceException
- eprInfoset
から EndpointReference
を作成中にエラーが発生した場合 IllegalArgumentExceptionSE
- null
eprInfoset
値が指定されている場合。public abstract void writeTo(ResultSE result)
EndpointReference
を指定された情報セット形式に書き込みます result
- 情報セットを書くため WebServiceException
- 指定された result
への EndpointReference
の書き込み中にエラーが発生した場合。IllegalArgumentExceptionSE
- null
の場合 result
値が指定されています。public <T> T getPort(ClassSE<T> serviceEndpointInterface, WebServiceFeature... features)
getPort
メソッドはプロキシを返します。EndpointReference
インスタンスに参照パラメーターがある場合、それらの参照パラメーターは、エンドポイントに送信されるすべてのメッセージで、参照パラメーターであることを示す SOAP ヘッダーとして表示される必要があります。パラメーター serviceEndpointInterface
は、返されたプロキシによってサポートされるサービスエンドポイントインターフェースを指定します。EndpointReference
インスタンスは、返されたプロキシによって呼び出されるエンドポイントを指定します。このメソッドの実装では、Jakarta XML Web Services ランタイムシステムがプロトコルバインディング(およびポート)を選択し、それに応じてこの EndpointReference
の WSDL メタデータまたは serviceEndpointInterface
のアノテーションからプロキシを構成する責任を負います。このメソッドがプロキシを正常に返すには、WSDL メタデータが使用可能である必要があり、EndpointReference
インスタンスには実装で理解される serviceName
メタデータが含まれている必要があります。 このポートは Service
オブジェクトから作成されていないため、ハンドラーは自動的に構成されず、HandlerResolver
および Executor
をこのポートに取得または設定することはできません。BindingProvider().getBinding().setHandlerChain()
メソッドを使用して、このポートのハンドラーを手動で構成できます。
T
- サービスエンドポイントインターフェース serviceEndpointInterface
- サービスエンドポイントインターフェース features
- プロキシで構成する WebServiceFeatures
の配列。features
パラメーターに含まれていないサポートされている機能には、デフォルト値があります。WebServiceException
-endpointReference
が無効な場合serviceEndpointInterface
が指定された場合Proxy
SE, WebServiceFeature
public StringSE toString()
ObjectSE
の toStringSE
Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.