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, waitSEpublic 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 が指定された場合ProxySE, WebServiceFeaturepublic StringSE toString()
ObjectSE の toStringSE Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.