public final class AddressingFeature extends WebServiceFeature
この機能は、SEI プロキシ、クライアント側の Dispatch
インスタンス、サーバー側の Endpoint
インスタンスの作成中に使用できます。この機能は、クライアント側での Service
インスタンスの作成には使用できません。
以下に、有効または無効に関するこの機能の効果について説明します。
この機能が有効になっている場合、required
プロパティは、エンドポイントが WS-Addressing を必要とするかどうかを決定します。true に設定されている場合、WS-Addressing ヘッダーは受信メッセージと発信メッセージに存在する必要があります。デフォルトでは、required
プロパティは false
です。
Web サービス開発者がこの機能を明示的に有効にしていない場合、WSDL の wsam:Addressing ポリシーアサーションを使用して WS-Addressing の使用を検索します。この機能を明示的に使用することにより、アプリケーションは、WSDSAddressing の使用に関する WSDL の指示をオーバーライドします。場合によっては、これは本当に必要です。例: アプリケーションが WS-Addressing 自体を実装している場合、この機能を使用してアドレス指定を無効にすることができます。つまり、Jakarta XML Web Services 実装は、WS-Addressing ヘッダーを消費または生成しません。
アドレッシングが有効になっている場合、対応する wsam:Addressing ポリシーアサーションを 3.1 WS-Policy アサーションに従って WSDL で生成する必要があります
例 1: @Addressing
用に生成された WSDL で可能なポリシーアサーション
<wsam:Addressing wsp:Optional="true">
<wsp:Policy/>
</wsam:Addressing>
例 2: @Addressing(required=true)
用に生成された WSDL で可能なポリシーアサーション
<wsam:Addressing>
<wsp:Policy/>
</wsam:Addressing>
例 3: @Addressing(required=true, responses=Responses.ANONYMOUS)
用に生成された WSDL で可能なポリシーアサーション
<wsam:Addressing>
<wsp:Policy>
<wsam:AnonymousResponses/>
</wsp:Policy>
</wsam:Addressing>
WS-Addressing の詳細については、Web サービスのアドレス指定 - コア、1.0 に対応する Web サービス -SOAP バインディング、1.0 に対応する Web サービス - メタデータを参照してください。
Addressing
修飾子と型 | クラスと説明 |
---|---|
static class | AddressingFeature.Responses アドレス指定が有効になっている場合、このプロパティは、エンドポイントで匿名レスポンスのみを使用するか、非匿名レスポンスのみを使用するか、すべてを使用する必要があるかを決定します。 |
修飾子と型 | フィールドと説明 |
---|---|
static StringSE | ID AddressingFeature を識別する定数値 |
protected boolean | required アドレス指定が有効になっている場合、このプロパティはエンドポイントに WS-Addressing が必要かどうかを決定します。 |
enabled
コンストラクターと説明 |
---|
AddressingFeature() アドレス指定要件を使用して AddressingFeature を作成および構成します。 |
AddressingFeature(boolean enabled) アドレス指定要件を使用して AddressingFeature を作成および構成します。 |
AddressingFeature(boolean enabled, boolean required) アドレス指定要件を使用して AddressingFeature を作成および構成します。 |
AddressingFeature(boolean enabled, boolean required, AddressingFeature.Responses responses) アドレス指定要件を使用して AddressingFeature を作成および構成します。 |
修飾子と型 | メソッドと説明 |
---|---|
StringSE | getID() この WebServiceFeature の一意の識別子を取得します。 |
AddressingFeature.Responses | getResponses() アドレス指定が有効になっている場合、このプロパティは、エンドポイントで匿名レスポンス、非匿名レスポンス、すべてのレスポンスの使用が必要かどうかを決定します。 |
boolean | isRequired() アドレス指定が有効になっている場合、このプロパティはエンドポイントに WS-Addressing が必要かどうかを決定します。 |
isEnabled
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
protected boolean required
public AddressingFeature()
AddressingFeature
を作成および構成します。作成された機能は ws-addressing を有効にします。つまり、ws-addressing をサポートしますが、使用する必要はありません。また、すべてのレスポンス型を受け入れるように構成されています。public AddressingFeature(boolean enabled)
AddressingFeature
を作成および構成します。enabled
が true の場合、ws-addressing を有効にします。つまり、ws-addressing をサポートしますが、使用する必要はありません。また、すべてのレスポンス型を受け入れるように構成します。enabled
- true は、ws-addressing を有効にします。つまり、ws-addressing はサポートされていますが、使用する必要はありません。public AddressingFeature(boolean enabled, boolean required)
AddressingFeature
を作成および構成します。enabled
と required
が true の場合、ws-addressing が有効になり、使用する必要があります。また、すべてのレスポンス型を受け入れるように構成します。enabled
- true は、ws-addressing を有効にします。つまり、ws-addressing はサポートされていますが、使用する必要はありません。required
- true は、ws-addressing を使用する必要があることを意味します。public AddressingFeature(boolean enabled, boolean required, AddressingFeature.Responses responses)
AddressingFeature
を作成および構成します。enabled
と required
が true の場合、ws-addressing が有効になり、使用する必要があります。また、レスポンス型は responses
パラメーターを使用して構成できます。enabled
- true は、ws-addressing を有効にします。つまり、ws-addressing はサポートされていますが、使用する必要はありません。required
- true は、ws-addressing を使用する必要があることを意味します。responses
- 必要なレスポンスの型を指定します public StringSE getID()
WebServiceFeature
の getID
public boolean isRequired()
public AddressingFeature.Responses getResponses()
AddressingFeature.Responses.ALL
、エンドポイントが匿名のレスポンスのみを使用する必要がある場合は AddressingFeature.Responses.ANONYMOUS
、エンドポイントが非匿名のレスポンスのみを使用する必要がある場合は AddressingFeature.Responses.NON_ANONYMOUS
Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.