パッケージ jakarta.xml.ws
クラス Service
- java.lang.ObjectSE
-
- jakarta.xml.ws.Service
public class Service extends ObjectSE
Service
オブジェクトは、Web サービスのクライアントビューを提供します。Service
は、次のファクトリとして機能します。- ターゲットサービスエンドポイントのプロキシ。
- リモート操作の動的メッセージ指向呼び出し用の
Dispatch
のインスタンス。
サービスで使用可能なポートは、
getPorts
メソッドを使用して列挙できます。または、サービスエンドポイントインターフェースを単項getPort
メソッドに渡して、ランタイムに互換性のあるポートを選択させることもできます。Service
によって作成されたすべてのオブジェクトのハンドラーチェーンは、HandlerResolver
を使用して設定できます。非同期コールバックのディスパッチに使用されるスレッドをより適切に制御するために、
Executor
をサービスに設定できます。たとえば、ThreadPoolExecutor
を作成してサービスに登録することで、特定のパラメーターを使用したスレッドプールを有効にできます。- 導入:
- 1.6、JAX-WS 2.0
- 関連事項:
Provider
,HandlerResolver
,Executor
SE
ネストされたクラスのサマリー
ネストされたクラス 修飾子と型 クラス 説明 static class
Service.Mode
動的なクライアントまたはサービスの方向。
メソッドのサマリー
すべてのメソッド 静的メソッド インスタンスメソッド 具象メソッド 修飾子と型 メソッド 説明 void
addPort(QNameSE portName, StringSE bindingId, StringSE endpointAddress)
サービスの新しいポートを作成します。static Service
create(URLSE wsdlDocumentLocation, QNameSE serviceName)
Service
インスタンスを作成します。static Service
create(URLSE wsdlDocumentLocation, QNameSE serviceName, WebServiceFeature... features)
Service
インスタンスを作成します。static Service
create(QNameSE serviceName)
Service
インスタンスを作成します。static Service
create(QNameSE serviceName, WebServiceFeature... features)
Service
インスタンスを作成します。Dispatch<ObjectSE>
createDispatch(EndpointReference endpointReference, JAXBContext context, Service.Mode mode, WebServiceFeature... features)
Jakarta XML Binding で生成されたオブジェクトで使用するDispatch
インスタンスを作成します。<T> Dispatch<T>
createDispatch(EndpointReference endpointReference, ClassSE<T> type, Service.Mode mode, WebServiceFeature... features)
クライアントが選択したオブジェクトで使用するDispatch
インスタンスを作成します。Dispatch<ObjectSE>
createDispatch(QNameSE portName, JAXBContext context, Service.Mode mode)
Jakarta XML Binding で生成されたオブジェクトで使用するDispatch
インスタンスを作成します。Dispatch<ObjectSE>
createDispatch(QNameSE portName, JAXBContext context, Service.Mode mode, WebServiceFeature... features)
Jakarta XML Binding で生成されたオブジェクトで使用するDispatch
インスタンスを作成します。<T> Dispatch<T>
createDispatch(QNameSE portName, ClassSE<T> type, Service.Mode mode)
クライアントが選択したオブジェクトで使用するDispatch
インスタンスを作成します。<T> Dispatch<T>
createDispatch(QNameSE portName, ClassSE<T> type, Service.Mode mode, WebServiceFeature... features)
クライアントが選択したオブジェクトで使用するDispatch
インスタンスを作成します。ExecutorSE
getExecutor()
このService
インスタンスのエグゼキュータを返します。HandlerResolver
getHandlerResolver()
構成されたハンドラーリゾルバーを返します。<T> T
getPort(EndpointReference endpointReference, ClassSE<T> serviceEndpointInterface, WebServiceFeature... features)
getPort
メソッドはプロキシを返します。<T> T
getPort(ClassSE<T> serviceEndpointInterface)
getPort
メソッドはプロキシを返します。<T> T
getPort(ClassSE<T> serviceEndpointInterface, WebServiceFeature... features)
getPort
メソッドはプロキシを返します。<T> T
getPort(QNameSE portName, ClassSE<T> serviceEndpointInterface)
getPort
メソッドはプロキシを返します。<T> T
getPort(QNameSE portName, ClassSE<T> serviceEndpointInterface, WebServiceFeature... features)
getPort
メソッドはプロキシを返します。IteratorSE<QNameSE>
getPorts()
このサービスによってグループ化されたサービスエンドポイントのQName
のリストのIterator
を返しますQNameSE
getServiceName()
このサービスの名前を取得します。URLSE
getWSDLDocumentLocation()
このサービスの WSDL ドキュメントの場所を取得します。void
setExecutor(ExecutorSE executor)
このService
インスタンスのエグゼキュータを設定します。void
setHandlerResolver(HandlerResolver handlerResolver)
このService
インスタンスのHandlerResolver
を設定します。
コンストラクターの詳細
Service
protected Service(URLSE wsdlDocumentLocation, QNameSE serviceName)
Service
を作成します。指定された WSDL ドキュメントの場所とサービス修飾名は、wsdl:service
要素を一意に識別しなければなりません(MUST)。- パラメーター:
wsdlDocumentLocation
- サービスの WSDL ドキュメントの場所のURL
serviceName
- サービスのQName
Service
protected Service(URLSE wsdlDocumentLocation, QNameSE serviceName, WebServiceFeature... features)
Service
を作成します。作成されたインスタンスは、Web サービス機能で構成されます。指定された WSDL ドキュメントの場所とサービス修飾名は、wsdl:service
要素を一意に識別しなければなりません(MUST)。- パラメーター:
wsdlDocumentLocation
- サービスの WSDL ドキュメントの場所のURL
serviceName
- サービスのQName
features
- サービスで構成する必要がある Web サービス機能。プロバイダーが機能を理解していない場合は、WebServiceException をスローする必要があります。
メソッドの詳細
getPort
public <T> T getPort(QNameSE portName, ClassSE<T> serviceEndpointInterface)
getPort
メソッドはプロキシを返します。サービスクライアントは、このプロキシを使用して、ターゲットサービスエンドポイントで操作を呼び出します。serviceEndpointInterface
は、作成された動的プロキシインスタンスによってサポートされるサービスエンドポイントインターフェースを指定します。- 型パラメーター:
T
- サービスエンドポイントインターフェース。- パラメーター:
portName
- WSDL サービス記述内のサービスエンドポイントの修飾名。serviceEndpointInterface
- 動的プロキシインスタンスでサポートされるサービスエンドポイントインターフェース。- 戻り値:
- 指定されたサービスエンドポイントインターフェースをサポートするオブジェクトプロキシインスタンス。
- 例外:
WebServiceException
- この例外は、次の場合にスローされます。- プロキシの作成中にエラーが発生した場合。
- このメソッドで必要とされる WSDL メタデータが欠落している場合。
- 不正な
serviceEndpointInterface
またはportName
が指定された場合。
- 関連事項:
Proxy
SE,InvocationHandler
SE
getPort
public <T> T getPort(QNameSE portName, ClassSE<T> serviceEndpointInterface, WebServiceFeature... features)
getPort
メソッドはプロキシを返します。サービスクライアントは、このプロキシを使用して、ターゲットサービスエンドポイントで操作を呼び出します。serviceEndpointInterface
は、作成された動的プロキシインスタンスによってサポートされるサービスエンドポイントインターフェースを指定します。- 型パラメーター:
T
- サービスエンドポイントインターフェース。- パラメーター:
portName
- WSDL サービス記述内のサービスエンドポイントの修飾名。serviceEndpointInterface
- 動的プロキシインスタンスでサポートされるサービスエンドポイントインターフェース。features
- プロキシで構成する WebServiceFeatures のリスト。features
パラメーターに含まれていないサポートされている機能には、デフォルト値があります。- 戻り値:
- 指定されたサービスエンドポイントインターフェースをサポートするオブジェクトプロキシインスタンス。
- 例外:
WebServiceException
- この例外は、次の場合にスローされます。- プロキシの作成中にエラーが発生した場合。
- このメソッドで必要とされる WSDL メタデータが欠落している場合。
- 不正な
serviceEndpointInterface
またはportName
が指定された場合。 - このポートと互換性がない、またはサポートされていない機能が有効になっている場合。
- 導入:
- 1.6、JAX-WS 2.1
- 関連事項:
Proxy
SE,InvocationHandler
SE,WebServiceFeature
getPort
public <T> T getPort(ClassSE<T> serviceEndpointInterface)
getPort
メソッドはプロキシを返します。パラメーターserviceEndpointInterface
は、返されたプロキシによってサポートされるサービスエンドポイントインターフェースを指定します。このメソッドの実装では、Jakarta XML Web Services ランタイムシステムがプロトコルバインディング(およびポート)を選択し、それに応じてプロキシを構成する責任を負います。返されたプロキシは、クライアントが再構成しないでください。- 型パラメーター:
T
- サービスエンドポイントインターフェース。- パラメーター:
serviceEndpointInterface
- サービスエンドポイントインターフェース。- 戻り値:
- 指定されたサービスエンドポイントインターフェースをサポートするオブジェクトインスタンス。
- 例外:
WebServiceException
-- プロキシの作成中にエラーが発生した場合。
- このメソッドで必要とされる WSDL メタデータが欠落している場合。
- 不正な
serviceEndpointInterface
が指定された場合。
getPort
public <T> T getPort(ClassSE<T> serviceEndpointInterface, WebServiceFeature... features)
getPort
メソッドはプロキシを返します。パラメーターserviceEndpointInterface
は、返されたプロキシによってサポートされるサービスエンドポイントインターフェースを指定します。このメソッドの実装では、Jakarta XML Web Services ランタイムシステムがプロトコルバインディング(およびポート)を選択し、それに応じてプロキシを構成する責任を負います。返されたプロキシは、クライアントが再構成しないでください。- 型パラメーター:
T
- サービスエンドポイントインターフェース。- パラメーター:
serviceEndpointInterface
- サービスエンドポイントインターフェース。features
- プロキシで構成する WebServiceFeatures のリスト。features
パラメーターに含まれていないサポートされている機能には、デフォルト値があります。- 戻り値:
- 指定されたサービスエンドポイントインターフェースをサポートするオブジェクトインスタンス。
- 例外:
WebServiceException
-- プロキシの作成中にエラーが発生した場合。
- このメソッドで必要とされる WSDL メタデータが欠落している場合。
- 不正な
serviceEndpointInterface
が指定された場合。 - このポートと互換性がない、またはサポートされていない機能が有効になっている場合。
- 導入:
- 1.6、JAX-WS 2.1
- 関連事項:
WebServiceFeature
getPort
public <T> T getPort(EndpointReference endpointReference, ClassSE<T> serviceEndpointInterface, WebServiceFeature... features)
getPort
メソッドはプロキシを返します。パラメーターendpointReference
は、返されたプロキシによって呼び出されるエンドポイントを指定します。endpointReference
に参照パラメーターがある場合、それらの参照パラメーターは、エンドポイントに送信されるすべてのメッセージで、参照パラメーターであることを示す SOAP ヘッダーとして表示される必要があります。endpointReference's
アドレスは、エンドポイントでの呼び出しに使用する必要があります。パラメーターserviceEndpointInterface
は、返されたプロキシによってサポートされるサービスエンドポイントインターフェースを指定します。このメソッドの実装では、Jakarta XML Web Services ランタイムシステムは、プロトコルバインディング(およびポート)を選択し、このService
インスタンスに関連付けられた WSDL またはendpointReference
のメタデータからプロキシを構成する責任を負います。このService
インスタンスに WSDL があり、endpointReference
メタデータにも WSDL がある場合は、このインスタンスの WSDL を使用する必要があります。このService
インスタンスに WSDL がなく、endpointReference
に WSDL がある場合は、endpointReference
の WSDL を使用できます。返されたプロキシは、クライアントが再構成しないでください。このService
インスタンスに WSDL に含まれる情報と一致する既知のプロキシポートがある場合、そのプロキシが返されます。それ以外の場合は、WebServiceException がスローされます。このメソッドを呼び出すと、次のように動作します。
port = service.getPort(portName, serviceEndpointInterface);
portName
は、endpointReference
のメタデータから、またはserviceEndpointInterface
とこのService
インスタンスに関連付けられた WSDL から取得されます。- 型パラメーター:
T
- サービスエンドポイントインターフェース。- パラメーター:
endpointReference
- 返されたプロキシによって呼び出されるターゲットサービスエンドポイントのEndpointReference
。serviceEndpointInterface
- サービスエンドポイントインターフェース。features
- プロキシで構成するWebServiceFeatures
のリスト。features
パラメーターに含まれていないサポートされている機能には、デフォルト値があります。- 戻り値:
- 指定されたサービスエンドポイントインターフェースをサポートするオブジェクトプロキシインスタンス。
- 例外:
WebServiceException
-- プロキシの作成中にエラーが発生した場合。
- このメソッドで必要とされる WSDL メタデータが欠落している場合。
endpointReference
メタデータがこのService
インスタンスのserviceName
と一致しない場合。portName
を WSDL またはendpointReference
メタデータから抽出できない場合。- 無効な
endpointReference
が指定された場合。 - 無効な
serviceEndpointInterface
が指定された場合。 - このポートと互換性がない、またはサポートされていない機能が有効になっている場合。
- 導入:
- 1.6、JAX-WS 2.1
addPort
public void addPort(QNameSE portName, StringSE bindingId, StringSE endpointAddress)
サービスの新しいポートを作成します。この方法で作成されたポートには WSDL ポート型情報が含まれておらず、Dispatch
インスタンスの作成にのみ使用できます。- パラメーター:
portName
- ターゲットサービスエンドポイントの修飾名。bindingId
- バインディングの文字列識別子。endpointAddress
- URI としてのターゲットサービスエンドポイントのアドレス。- 例外:
WebServiceException
- ポートの作成でエラーが発生した場合。- 関連事項:
SOAPBinding.SOAP11HTTP_BINDING
,SOAPBinding.SOAP12HTTP_BINDING
,HTTPBinding.HTTP_BINDING
createDispatch
public <T> Dispatch<T> createDispatch(QNameSE portName, ClassSE<T> type, Service.Mode mode)
クライアントが選択したオブジェクトで使用するDispatch
インスタンスを作成します。- 型パラメーター:
T
- メッセージまたはペイロードの型- パラメーター:
portName
- ターゲットサービスエンドポイントの修飾名type
- メッセージまたはメッセージペイロードに使用されるオブジェクトのクラス。使用中のバインディングに応じて、javax.xml.transform.Source
、jakarta.xml.soap.SOAPMessage
、jakarta.activation.DataSource
をサポートするための実装が必要です。mode
- 作成されたディスパッチインスタンスがメッセージ指向かペイロード指向か、つまり、クライアントが完全なプロトコルメッセージまたはメッセージペイロードを処理するかどうかを制御します。例: SOAP プロトコルを使用する場合、このパラメーターは、クライアントが SOAP メッセージを処理するか SOAP 本文のコンテンツを処理するかを制御します。型が SOAPMessage の場合、モードは MESSAGE である必要があります。- 戻り値:
- インスタンスをディスパッチします。
- 例外:
WebServiceException
-Dispatch
オブジェクトの作成でエラーが発生した場合。- 関連事項:
Source
SE,SOAPMessage
createDispatch
public <T> Dispatch<T> createDispatch(QNameSE portName, ClassSE<T> type, Service.Mode mode, WebServiceFeature... features)
クライアントが選択したオブジェクトで使用するDispatch
インスタンスを作成します。- 型パラメーター:
T
- メッセージまたはペイロードの型- パラメーター:
portName
- ターゲットサービスエンドポイントの修飾名type
- メッセージまたはメッセージペイロードに使用されるオブジェクトのクラス。javax.xml.transform.Source
およびjakarta.xml.soap.SOAPMessage
をサポートするには、実装が必要です。mode
- 作成されたディスパッチインスタンスがメッセージ指向かペイロード指向か、つまり、クライアントが完全なプロトコルメッセージまたはメッセージペイロードを処理するかどうかを制御します。例: SOAP プロトコルを使用する場合、このパラメーターは、クライアントが SOAP メッセージを処理するか SOAP 本文のコンテンツを処理するかを制御します。型がSOAPMessage
の場合、モードはMESSAGE
でなければなりません。features
- プロキシで構成するWebServiceFeatures
のリスト。features
パラメーターに含まれていないサポートされている機能には、デフォルト値があります。- 戻り値:
- インスタンスをディスパッチします。
- 例外:
WebServiceException
-Dispatch
オブジェクトの作成でエラーが発生した場合、またはこのポートと互換性がないかサポートされていない機能が有効になっている場合。- 導入:
- 1.6、JAX-WS 2.1
- 関連事項:
Source
SE,SOAPMessage
,WebServiceFeature
createDispatch
public <T> Dispatch<T> createDispatch(EndpointReference endpointReference, ClassSE<T> type, Service.Mode mode, WebServiceFeature... features)
クライアントが選択したオブジェクトで使用するDispatch
インスタンスを作成します。endpointReference
に参照パラメーターがある場合、それらの参照パラメーターは、エンドポイントに送信されるすべてのメッセージで、参照パラメーターであることを示す SOAP ヘッダーとして表示される必要があります。endpointReference's
アドレスは、エンドポイントでの呼び出しに使用する必要があります。このメソッドの実装では、Jakarta XML Web Services ランタイムシステムは、プロトコルバインディング(およびポート)を選択し、それに応じて、このService
インスタンスに関連付けられた WSDL またはendpointReference
のメタデータからディスパッチを構成する責任を負います。このService
インスタンスに WSDL があり、endpointReference
のメタデータにも WSDL がある場合は、このインスタンスの WSDL を使用する必要があります。このService
インスタンスに WSDL がなく、endpointReference
に WSDL がある場合は、endpointReference
の WSDL を使用できます。実装は、endpointReference
メタデータからportName
を取得できなければなりません(MUST)。このメソッドは、呼び出しと同じように動作します
dispatch = service.createDispatch(portName, type, mode, features);
portName
は WSDL またはEndpointReference
メタデータから取得されます。- 型パラメーター:
T
- メッセージまたはペイロードの型- パラメーター:
endpointReference
- 返されたDispatch
オブジェクトによって呼び出されるターゲットサービスエンドポイントのEndpointReference
。type
- メッセージまたはメッセージペイロードに使用されるオブジェクトのクラス。javax.xml.transform.Source
およびjakarta.xml.soap.SOAPMessage
をサポートするには、実装が必要です。mode
- 作成されたディスパッチインスタンスがメッセージ指向かペイロード指向か、つまり、クライアントが完全なプロトコルメッセージまたはメッセージペイロードを処理するかどうかを制御します。例: SOAP プロトコルを使用する場合、このパラメーターは、クライアントが SOAP メッセージを処理するか SOAP 本文のコンテンツを処理するかを制御します。型がSOAPMessage
の場合、モードはMESSAGE
でなければなりません。features
- プロキシで構成するWebServiceFeatures
の配列。features
パラメーターに含まれていないサポートされている機能には、デフォルト値があります。- 戻り値:
- ディスパッチインスタンス
- 例外:
WebServiceException
-- このメソッドで必要とされる WSDL メタデータが欠落している場合。
endpointReference
メタデータが、このService
インスタンスに関連付けられた WSDL のserviceName
またはportName
と一致しない場合。EndpointReference
メタデータからportName
を判別できない場合。Dispatch
オブジェクトの作成でエラーが発生した場合。- このポートと互換性がない、またはサポートされていない機能が有効になっている場合。
- 導入:
- 1.6、JAX-WS 2.1
- 関連事項:
Source
SE,SOAPMessage
,WebServiceFeature
createDispatch
public Dispatch<ObjectSE> createDispatch(QNameSE portName, JAXBContext context, Service.Mode mode)
Jakarta XML Binding で生成されたオブジェクトで使用するDispatch
インスタンスを作成します。- パラメーター:
portName
- ターゲットサービスエンドポイントの修飾名context
- メッセージまたはメッセージペイロードをマーシャルおよびアンマーシャルするために使用される JAXBContext。mode
- 作成されたディスパッチインスタンスがメッセージ指向かペイロード指向か、つまり、クライアントが完全なプロトコルメッセージまたはメッセージペイロードを処理するかどうかを制御します。例: SOAP プロトコルを使用する場合、このパラメーターは、クライアントが SOAP メッセージを処理するか SOAP 本文のコンテンツを処理するかを制御します。- 戻り値:
- インスタンスをディスパッチします。
- 例外:
WebServiceException
-Dispatch
オブジェクトの作成でエラーが発生した場合。- 関連事項:
JAXBContext
createDispatch
public Dispatch<ObjectSE> createDispatch(QNameSE portName, JAXBContext context, Service.Mode mode, WebServiceFeature... features)
Jakarta XML Binding で生成されたオブジェクトで使用するDispatch
インスタンスを作成します。- パラメーター:
portName
- ターゲットサービスエンドポイントの修飾名context
- メッセージまたはメッセージペイロードをマーシャルおよびアンマーシャルするために使用される JAXBContext。mode
- 作成されたディスパッチインスタンスがメッセージ指向かペイロード指向か、つまり、クライアントが完全なプロトコルメッセージまたはメッセージペイロードを処理するかどうかを制御します。例: SOAP プロトコルを使用する場合、このパラメーターは、クライアントが SOAP メッセージを処理するか SOAP 本文のコンテンツを処理するかを制御します。features
- プロキシで構成するWebServiceFeatures
のリスト。features
パラメーターに含まれていないサポートされている機能には、デフォルト値があります。- 戻り値:
- インスタンスをディスパッチします。
- 例外:
WebServiceException
-Dispatch
オブジェクトの作成でエラーが発生した場合、またはこのポートと互換性がないかサポートされていない機能が有効になっている場合。- 導入:
- 1.6、JAX-WS 2.1
- 関連事項:
JAXBContext
,WebServiceFeature
createDispatch
public Dispatch<ObjectSE> createDispatch(EndpointReference endpointReference, JAXBContext context, Service.Mode mode, WebServiceFeature... features)
Jakarta XML Binding で生成されたオブジェクトで使用するDispatch
インスタンスを作成します。endpointReference
に参照パラメーターがある場合、それらの参照パラメーターは、エンドポイントに送信されるすべてのメッセージで、参照パラメーターであることを示す SOAP ヘッダーとして表示される必要があります。endpointReference's
アドレスは、エンドポイントでの呼び出しに使用する必要があります。このメソッドの実装では、Jakarta XML Web Services ランタイムシステムは、プロトコルバインディング(およびポート)を選択し、それに応じて、このService
インスタンスに関連付けられた WSDL またはendpointReference
のメタデータからディスパッチを構成する責任を負います。このService
インスタンスに WSDL があり、endpointReference
のメタデータにも WSDL がある場合は、このインスタンスの WSDL を使用する必要があります。このService
インスタンスに WSDL がなく、endpointReference
に WSDL がある場合は、endpointReference
の WSDL を使用できます。実装は、endpointReference
メタデータからportName
を取得できなければなりません(MUST)。このメソッドは、呼び出しと同じように動作します
dispatch = service.createDispatch(portName, context, mode, features);
portName
は WSDL またはendpointReference
メタデータから取得されます。- パラメーター:
endpointReference
- 返されたDispatch
オブジェクトによって呼び出されるターゲットサービスエンドポイントのEndpointReference
。context
- メッセージまたはメッセージペイロードをマーシャルおよびアンマーシャルするために使用される Jakarta XML Binding コンテキスト。mode
- 作成されたディスパッチインスタンスがメッセージ指向かペイロード指向か、つまり、クライアントが完全なプロトコルメッセージまたはメッセージペイロードを処理するかどうかを制御します。例: SOAP プロトコルを使用する場合、このパラメーターは、クライアントが SOAP メッセージを処理するか SOAP 本文のコンテンツを処理するかを制御します。features
- プロキシで構成するWebServiceFeatures
の配列。features
パラメーターに含まれていないサポートされている機能には、デフォルト値があります。- 戻り値:
- ディスパッチインスタンス
- 例外:
WebServiceException
-- このメソッドで必要とされる WSDL メタデータが欠落している場合。
endpointReference
メタデータが、このService
インスタンスに関連付けられた WSDL のserviceName
またはportName
と一致しない場合。EndpointReference
メタデータからportName
を判別できない場合。Dispatch
オブジェクトの作成でエラーが発生した場合。- このポートと互換性がない、またはサポートされていない機能が有効になっている場合。
- 導入:
- 1.6、JAX-WS 2.1
- 関連事項:
JAXBContext
,WebServiceFeature
getServiceName
public QNameSE getServiceName()
このサービスの名前を取得します。- 戻り値:
- このサービスの修飾名
getPorts
public IteratorSE<QNameSE> getPorts()
このサービスによってグループ化されたサービスエンドポイントのQName
のリストのIterator
を返します- 戻り値:
- 型
javax.xml.namespace.QName
の要素を持つjava.util.Iterator
を返します。 - 例外:
WebServiceException
- このサービスクラスが必要な WSDL メタデータにアクセスできない場合。
getWSDLDocumentLocation
public URLSE getWSDLDocumentLocation()
このサービスの WSDL ドキュメントの場所を取得します。- 戻り値:
- このサービスの WSDL ドキュメントの場所の URL。
getHandlerResolver
public HandlerResolver getHandlerResolver()
構成されたハンドラーリゾルバーを返します。- 戻り値:
- HandlerResolver この
Service
インスタンスによって使用されているHandlerResolver
、または存在しない場合はnull
。
setHandlerResolver
public void setHandlerResolver(HandlerResolver handlerResolver)
このService
インスタンスのHandlerResolver
を設定します。ハンドラーリゾルバーが存在する場合は、作成されるプロキシまたはディスパッチインスタンスごとに 1 回呼び出され、リゾルバーによって返されるハンドラーチェーンがインスタンスに設定されます。
- パラメーター:
handlerResolver
- その後に作成されるすべてのプロキシ / ディスパッチオブジェクトに使用するHandlerResolver
。- 関連事項:
HandlerResolver
getExecutor
public ExecutorSE getExecutor()
このService
インスタンスのエグゼキュータを返します。エグゼキュータは、コールバックを必要とするすべての非同期呼び出しに使用されます。- 戻り値:
- コールバックを呼び出すために使用される
java.util.concurrent.Executor
。 - 関連事項:
Executor
SE
setExecutor
public void setExecutor(ExecutorSE executor)
このService
インスタンスのエグゼキュータを設定します。エグゼキュータは、コールバックを必要とするすべての非同期呼び出しに使用されます。- パラメーター:
executor
- コールバックを呼び出すために使用されるjava.util.concurrent.Executor
。- 例外:
SecurityExceptionSE
- インスタンスがセキュリティ上の理由でエグゼキュータの設定をサポートしていない場合(たとえば、必要な権限がない場合)。- 関連事項:
Executor
SE
create
public static Service create(URLSE wsdlDocumentLocation, QNameSE serviceName)
Service
インスタンスを作成します。指定された WSDL ドキュメントの場所とサービス修飾名は、wsdl:service
要素を一意に識別しなければなりません(MUST)。- パラメーター:
wsdlDocumentLocation
- サービスの WSDL ドキュメントの場所のURL
serviceName
- サービスのQName
- 戻り値:
- サービスインスタンス
- 例外:
WebServiceException
- 指定されたサービスの作成中にエラーが発生した場合。
create
public static Service create(URLSE wsdlDocumentLocation, QNameSE serviceName, WebServiceFeature... features)
Service
インスタンスを作成します。作成されたインスタンスは、Web サービス機能で構成されます。指定された WSDL ドキュメントの場所とサービス修飾名は、wsdl:service
要素を一意に識別しなければなりません(MUST)。- パラメーター:
wsdlDocumentLocation
- サービスの WSDL ドキュメントの場所のURL
serviceName
- サービスのQName
features
- サービスで構成する必要がある Web サービス機能。プロバイダーが機能を理解していない場合は、WebServiceException をスローする必要があります。- 戻り値:
- リクエストされた Web サービス機能で構成されたサービスインスタンス
- 例外:
WebServiceException
- 指定されたサービスの作成中にエラーが発生した場合。- 導入:
- 1.7、JAX-WS 2.2
create
public static Service create(QNameSE serviceName)
Service
インスタンスを作成します。- パラメーター:
serviceName
- サービスのQName
- 戻り値:
- サービスインスタンス
- 例外:
WebServiceException
- 指定されたサービスの作成中にエラーが発生した場合
create
public static Service create(QNameSE serviceName, WebServiceFeature... features)
Service
インスタンスを作成します。作成されたインスタンスは、Web サービス機能で構成されます。- パラメーター:
serviceName
- サービスのQName
features
- サービスで構成する必要がある Web サービス機能。プロバイダーが機能を理解していない場合は、WebServiceException をスローする必要があります。- 戻り値:
- リクエストされた Web サービス機能で構成されたサービスインスタンス
- 例外:
WebServiceException
- 指定されたサービスの作成中にエラーが発生した場合- 導入:
- 1.7、JAX-WS 2.2