パッケージ 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,ExecutorSE
ネストされたクラスの要約
ネストされたクラス 修飾子と型 クラス 説明 static classService.Mode動的なクライアントまたはサービスの方向。
メソッドのサマリー
すべてのメソッド 静的メソッド インスタンスメソッド 具象メソッド 修飾子と型 メソッド 説明 voidaddPort(QNameSE portName, StringSE bindingId, StringSE endpointAddress)サービスの新しいポートを作成します。static Servicecreate(URLSE wsdlDocumentLocation, QNameSE serviceName)Serviceインスタンスを作成します。static Servicecreate(URLSE wsdlDocumentLocation, QNameSE serviceName, WebServiceFeature... features)Serviceインスタンスを作成します。static Servicecreate(QNameSE serviceName)Serviceインスタンスを作成します。static Servicecreate(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インスタンスを作成します。ExecutorSEgetExecutor()このServiceインスタンスのエグゼキュータを返します。HandlerResolvergetHandlerResolver()構成されたハンドラーリゾルバーを返します。<T> TgetPort(EndpointReference endpointReference, ClassSE<T> serviceEndpointInterface, WebServiceFeature... features)getPortメソッドはプロキシを返します。<T> TgetPort(ClassSE<T> serviceEndpointInterface)getPortメソッドはプロキシを返します。<T> TgetPort(ClassSE<T> serviceEndpointInterface, WebServiceFeature... features)getPortメソッドはプロキシを返します。<T> TgetPort(QNameSE portName, ClassSE<T> serviceEndpointInterface)getPortメソッドはプロキシを返します。<T> TgetPort(QNameSE portName, ClassSE<T> serviceEndpointInterface, WebServiceFeature... features)getPortメソッドはプロキシを返します。IteratorSE<QNameSE>getPorts()このサービスによってグループ化されたサービスエンドポイントのQNameのリストのIteratorを返しますQNameSEgetServiceName()このサービスの名前を取得します。URLSEgetWSDLDocumentLocation()このサービスの WSDL ドキュメントの場所を取得します。voidsetExecutor(ExecutorSE executor)このServiceインスタンスのエグゼキュータを設定します。voidsetHandlerResolver(HandlerResolver handlerResolver)このServiceインスタンスのHandlerResolverを設定します。
コンストラクターの詳細
Service
protected Service(URLSE wsdlDocumentLocation, QNameSE serviceName)
Serviceを作成します。指定された WSDL ドキュメントの場所とサービス修飾名は、wsdl:service要素を一意に識別しなければなりません(MUST)。- パラメーター:
wsdlDocumentLocation- サービスの WSDL ドキュメントの場所のURLserviceName- サービスのQName
Service
protected Service(URLSE wsdlDocumentLocation, QNameSE serviceName, WebServiceFeature... features)
Serviceを作成します。作成されたインスタンスは、Web サービス機能で構成されます。指定された WSDL ドキュメントの場所とサービス修飾名は、wsdl:service要素を一意に識別しなければなりません(MUST)。- パラメーター:
wsdlDocumentLocation- サービスの WSDL ドキュメントの場所のURLserviceName- サービスのQNamefeatures- サービスで構成する必要がある Web サービス機能。プロバイダーが機能を理解していない場合は、WebServiceException をスローする必要があります。
メソッドの詳細
getPort
public <T> T getPort(QNameSE portName, ClassSE<T> serviceEndpointInterface)
getPortメソッドはプロキシを返します。サービスクライアントは、このプロキシを使用して、ターゲットサービスエンドポイントで操作を呼び出します。serviceEndpointInterfaceは、作成された動的プロキシインスタンスによってサポートされるサービスエンドポイントインターフェースを指定します。- 型パラメーター:
T- サービスエンドポイントインターフェース。- パラメーター:
portName- WSDL サービス記述内のサービスエンドポイントの修飾名。serviceEndpointInterface- 動的プロキシインスタンスでサポートされるサービスエンドポイントインターフェース。- 戻り値:
- 指定されたサービスエンドポイントインターフェースをサポートするオブジェクトプロキシインスタンス。
- 例外:
WebServiceException- この例外は、次の場合にスローされます。- プロキシの作成中にエラーが発生した場合。
- このメソッドで必要とされる WSDL メタデータが欠落している場合。
- 不正な
serviceEndpointInterfaceまたはportNameが指定された場合。
- 関連事項:
ProxySE,InvocationHandlerSE
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
- 関連事項:
ProxySE,InvocationHandlerSE,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オブジェクトの作成でエラーが発生した場合。- 関連事項:
SourceSE,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
- 関連事項:
SourceSE,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
- 関連事項:
SourceSE,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。 - 関連事項:
ExecutorSE
setExecutor
public void setExecutor(ExecutorSE executor)
このServiceインスタンスのエグゼキュータを設定します。エグゼキュータは、コールバックを必要とするすべての非同期呼び出しに使用されます。- パラメーター:
executor- コールバックを呼び出すために使用されるjava.util.concurrent.Executor。- 例外:
SecurityExceptionSE- インスタンスがセキュリティ上の理由でエグゼキュータの設定をサポートしていない場合(たとえば、必要な権限がない場合)。- 関連事項:
ExecutorSE
create
public static Service create(URLSE wsdlDocumentLocation, QNameSE serviceName)
Serviceインスタンスを作成します。指定された WSDL ドキュメントの場所とサービス修飾名は、wsdl:service要素を一意に識別しなければなりません(MUST)。- パラメーター:
wsdlDocumentLocation- サービスの WSDL ドキュメントの場所のURLserviceName- サービスのQName- 戻り値:
- サービスインスタンス
- 例外:
WebServiceException- 指定されたサービスの作成中にエラーが発生した場合。
create
public static Service create(URLSE wsdlDocumentLocation, QNameSE serviceName, WebServiceFeature... features)
Serviceインスタンスを作成します。作成されたインスタンスは、Web サービス機能で構成されます。指定された WSDL ドキュメントの場所とサービス修飾名は、wsdl:service要素を一意に識別しなければなりません(MUST)。- パラメーター:
wsdlDocumentLocation- サービスの WSDL ドキュメントの場所のURLserviceName- サービスのQNamefeatures- サービスで構成する必要がある 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- サービスのQNamefeatures- サービスで構成する必要がある Web サービス機能。プロバイダーが機能を理解していない場合は、WebServiceException をスローする必要があります。- 戻り値:
- リクエストされた Web サービス機能で構成されたサービスインスタンス
- 例外:
WebServiceException- 指定されたサービスの作成中にエラーが発生した場合- 導入:
- 1.7、JAX-WS 2.2