public class Service extends Object
Serviceãªããžã§ã¯ãã¯ãWebãµãŒãã¹ã®ã¯ã©ã€ã¢ã³ãã»ãã¥ãŒãæäŸããŸãã
Serviceã¯ã次ã®ãã¡ã¯ããªãšããŠåäœããŸãã
Dispatchã®ã€ã³ã¹ã¿ã³ã¹ã
ãµãŒãã¹ã§å©çšå¯èœãªããŒãã¯ãgetPortsã¡ãœããã䜿çšããŠåæã§ããŸãã ãããã¯ããµãŒãã¹ç«¯ç¹ã€ã³ã¿ãã§ãŒã¹ãåé
getPortã¡ãœããã«æž¡ããé©åããããŒããå®è¡æã«éžæãããããšãã§ããŸãã
Serviceã«ãã£ãŠäœæããããã¹ãŠã®ãªããžã§ã¯ãã®ãã³ãã©ã»ãã§ãŒã³ãHandlerResolverã䜿çšããŠèšå®ããããšãã§ããŸãã
éåæçã³ãŒã«ããã¯ããã£ã¹ãããããããã«äœ¿çšãããã¹ã¬ããããã匷åã«å¶åŸ¡ãããããExecutorããµãŒãã¹ã«èšå®ããããšãã§ããŸãã ããšãã°ãThreadPoolExecutorãäœæãããµãŒãã¹ã«ãããç»é²ããããšã«ãã£ãŠãç¹å®ã®ãã©ã¡ãŒã¿ã䌎ãã¹ã¬ããã»ããŒã«ãæå¹ã«ã§ããŸãã
Provider, HandlerResolver, Executor| 修食åãšå | ã¯ã©ã¹ | 説æ |
|---|---|---|
static class |
Service.Mode |
åçã¯ã©ã€ã¢ã³ããŸãã¯ãµãŒãã¹ã®æ¹åã§ãã
|
| 修食å | ã³ã³ã¹ãã©ã¯ã¿ | 説æ |
|---|---|---|
protected |
Service(URL wsdlDocumentLocation, QName serviceName) |
|
protected |
Service(URL wsdlDocumentLocation, QName serviceName, WebServiceFeature... features) |
| 修食åãšå | ã¡ãœãã | 説æ |
|---|---|---|
void |
addPort(QName portName, String bindingId, String endpointAddress) |
ãµãŒãã¹ã®æ°ããããŒããäœæããŸãã
|
static Service |
create(QName serviceName) |
Serviceã€ã³ã¹ã¿ã³ã¹ãäœæããŸãã |
static Service |
create(QName serviceName, WebServiceFeature... features) |
Serviceã€ã³ã¹ã¿ã³ã¹ãäœæããŸãã |
static Service |
create(URL wsdlDocumentLocation, QName serviceName) |
Serviceã€ã³ã¹ã¿ã³ã¹ãäœæããŸãã |
static Service |
create(URL wsdlDocumentLocation, QName serviceName, WebServiceFeature... features) |
Serviceã€ã³ã¹ã¿ã³ã¹ãäœæããŸãã |
<T> Dispatch<T> |
createDispatch(EndpointReference endpointReference, Class<T> type, Service.Mode mode, WebServiceFeature... features) |
ã¯ã©ã€ã¢ã³ããéžæãããªããžã§ã¯ãã§äœ¿çšãã
Dispatchã€ã³ã¹ã¿ã³ã¹ãäœæããŸãã |
Dispatch<Object> |
createDispatch(EndpointReference endpointReference, JAXBContext context, Service.Mode mode, WebServiceFeature... features) |
JAXBçæãªããžã§ã¯ãã§äœ¿çšãã
Dispatchã€ã³ã¹ã¿ã³ã¹ãäœæããŸãã |
<T> Dispatch<T> |
createDispatch(QName portName, Class<T> type, Service.Mode mode) |
ã¯ã©ã€ã¢ã³ããéžæãããªããžã§ã¯ãã§äœ¿çšãã
Dispatchã€ã³ã¹ã¿ã³ã¹ãäœæããŸãã |
<T> Dispatch<T> |
createDispatch(QName portName, Class<T> type, Service.Mode mode, WebServiceFeature... features) |
ã¯ã©ã€ã¢ã³ããéžæãããªããžã§ã¯ãã§äœ¿çšãã
Dispatchã€ã³ã¹ã¿ã³ã¹ãäœæããŸãã |
Dispatch<Object> |
createDispatch(QName portName, JAXBContext context, Service.Mode mode) |
JAXBçæãªããžã§ã¯ãã§äœ¿çšãã
Dispatchã€ã³ã¹ã¿ã³ã¹ãäœæããŸãã |
Dispatch<Object> |
createDispatch(QName portName, JAXBContext context, Service.Mode mode, WebServiceFeature... features) |
JAXBçæãªããžã§ã¯ãã§äœ¿çšãã
Dispatchã€ã³ã¹ã¿ã³ã¹ãäœæããŸãã |
Executor |
getExecutor() |
ãã®
Serviceã€ã³ã¹ã¿ã³ã¹ã®executorãè¿ããŸãã |
HandlerResolver |
getHandlerResolver() |
æ§ææžã¿ã®ãã³ãã©ã»ãªãŸã«ããè¿ããŸãã
|
<T> T |
getPort(Class<T> serviceEndpointInterface) |
getPortã¡ãœããã¯ãããã·ãè¿ããŸãã |
<T> T |
getPort(Class<T> serviceEndpointInterface, WebServiceFeature... features) |
getPortã¡ãœããã¯ãããã·ãè¿ããŸãã |
<T> T |
getPort(EndpointReference endpointReference, Class<T> serviceEndpointInterface, WebServiceFeature... features) |
getPortã¡ãœããã¯ãããã·ãè¿ããŸãã |
<T> T |
getPort(QName portName, Class<T> serviceEndpointInterface) |
getPortã¡ãœããã¯ãããã·ãè¿ããŸãã |
<T> T |
getPort(QName portName, Class<T> serviceEndpointInterface, WebServiceFeature... features) |
getPortã¡ãœããã¯ãããã·ãè¿ããŸãã |
Iterator<QName> |
getPorts() |
ãã®ãµãŒãã¹ã«ãã£ãŠã°ã«ãŒãåããããµãŒãã¹ã»ãšã³ããã€ã³ãã®
QNameãªã¹ãã®Iteratorãè¿ããŸã |
QName |
getServiceName() |
ãã®ãµãŒãã¹ã®ååãååŸããŸãã
|
URL |
getWSDLDocumentLocation() |
ãã®ãµãŒãã¹ã®WSDLææžã®äœçœ®ãååŸããŸãã
|
void |
setExecutor(Executor executor) |
ãã®
Serviceã€ã³ã¹ã¿ã³ã¹ã®executorãèšå®ããŸãã |
void |
setHandlerResolver(HandlerResolver handlerResolver) |
ãã®
Serviceã€ã³ã¹ã¿ã³ã¹ã®HandlerResolverãèšå®ããŸãã |
protected Service(URL wsdlDocumentLocation, QName serviceName, WebServiceFeature... features)
public <T> T getPort(QName portName, Class<T> serviceEndpointInterface)
getPortã¡ãœããã¯ãããã·ãè¿ããŸãã ãµãŒãã¹ã»ã¯ã©ã€ã¢ã³ãã¯ããã®ãããã·ã䜿çšããŠã¿ãŒã²ããã»ãµãŒãã¹ç«¯ç¹ã®æäœãåŒã³åºããŸãã serviceEndpointInterfaceã¯ãäœæãããåçãããã·ã»ã€ã³ã¹ã¿ã³ã¹ã«ãã£ãŠãµããŒãããããµãŒãã¹ç«¯ç¹ã€ã³ã¿ãã§ãŒã¹ãæå®ããŸãã portName - WSDLãµãŒãã¹èšè¿°å
ã®ãµãŒãã¹ç«¯ç¹ã®ä¿®é£ŸåãserviceEndpointInterface - åçãããã·ã»ã€ã³ã¹ã¿ã³ã¹ã«ãã£ãŠãµããŒããããŠãããµãŒãã¹ç«¯ç¹ã€ã³ã¿ãã§ãŒã¹ãWebServiceException - ãã®äŸå€ã¯ã次ã®å Žåã«ã¹ããŒãããã
serviceEndpointInterfaceãŸãã¯portNameãæå®ãããå Žåã
Proxy, InvocationHandlerpublic <T> T getPort(QName portName, Class<T> serviceEndpointInterface, WebServiceFeature... features)
getPortã¡ãœããã¯ãããã·ãè¿ããŸãã ãµãŒãã¹ã»ã¯ã©ã€ã¢ã³ãã¯ããã®ãããã·ã䜿çšããŠã¿ãŒã²ããã»ãµãŒãã¹ç«¯ç¹ã®æäœãåŒã³åºããŸãã serviceEndpointInterfaceã¯ãäœæãããåçãããã·ã»ã€ã³ã¹ã¿ã³ã¹ã«ãã£ãŠãµããŒãããããµãŒãã¹ç«¯ç¹ã€ã³ã¿ãã§ãŒã¹ãæå®ããŸãã portName - WSDLãµãŒãã¹èšè¿°å
ã®ãµãŒãã¹ç«¯ç¹ã®ä¿®é£ŸåãserviceEndpointInterface - åçãããã·ã»ã€ã³ã¹ã¿ã³ã¹ã«ãã£ãŠãµããŒããããŠãããµãŒãã¹ç«¯ç¹ã€ã³ã¿ãã§ãŒã¹ãfeatures - ãããã·ã«æ§æããWebServiceFeaturesã®ãªã¹ãã features ãã©ã¡ãŒã¿ã«å«ãŸããŠããªããµããŒããããæ©èœã«ã¯ãããã©ã«ãå€ãèšå®ãããã WebServiceException - ãã®äŸå€ã¯ã次ã®å Žåã«ã¹ããŒãããã
serviceEndpointInterfaceãŸãã¯portNameãæå®ãããå Žåã
Proxy, InvocationHandler, WebServiceFeaturepublic <T> T getPort(Class<T> serviceEndpointInterface)
getPortã¡ãœããã¯ãããã·ãè¿ããŸãã ãã©ã¡ãŒã¿serviceEndpointInterfaceã¯ãæ»ãå€ã®ãããã·ã«ãã£ãŠãµããŒãããããµãŒãã¹ç«¯ç¹ã€ã³ã¿ãã§ãŒã¹ãæå®ããŸãã ãã®ã¡ãœããã®å®è£
ã§ã¯ãJAX-WSå®è¡æã·ã¹ãã ããããã³ã«ã»ãã€ã³ãã£ã³ã°(ããã³ããŒã)ãéžæããããã«åŸã£ãŠãããã·ã®æ§æãè¡ããŸãã æ»ãå€ã®ãããã·ããã¯ã©ã€ã¢ã³ããæ§æãçŽããªãããã«ããŠãã ããã serviceEndpointInterface - ãµãŒãã¹ç«¯ç¹ã€ã³ã¿ãã§ãŒã¹ãWebServiceException - serviceEndpointInterfaceãæå®ãããå Žåã
public <T> T getPort(Class<T> serviceEndpointInterface, WebServiceFeature... features)
getPortã¡ãœããã¯ãããã·ãè¿ããŸãã ãã©ã¡ãŒã¿serviceEndpointInterfaceã¯ãæ»ãå€ã®ãããã·ã«ãã£ãŠãµããŒãããããµãŒãã¹ç«¯ç¹ã€ã³ã¿ãã§ãŒã¹ãæå®ããŸãã ãã®ã¡ãœããã®å®è£
ã§ã¯ãJAX-WSå®è¡æã·ã¹ãã ããããã³ã«ã»ãã€ã³ãã£ã³ã°(ããã³ããŒã)ãéžæããããã«åŸã£ãŠãããã·ã®æ§æãè¡ããŸãã æ»ãå€ã®ãããã·ããã¯ã©ã€ã¢ã³ããæ§æãçŽããªãããã«ããŠãã ããã serviceEndpointInterface - ãµãŒãã¹ç«¯ç¹ã€ã³ã¿ãã§ãŒã¹ãfeatures - ãããã·ã«æ§æããWebServiceFeaturesã®ãªã¹ãã features ãã©ã¡ãŒã¿ã«å«ãŸããŠããªããµããŒããããæ©èœã«ã¯ãããã©ã«ãå€ãèšå®ãããã WebServiceException - serviceEndpointInterfaceãæå®ãããå Žåã
WebServiceFeaturepublic <T> T getPort(EndpointReference endpointReference, Class<T> serviceEndpointInterface, WebServiceFeature... features)
getPortã¡ãœããã¯ãããã·ãè¿ããŸãã ãã©ã¡ãŒã¿endpointReferenceã¯ãæ»ãå€ã®ãããã·ã«ãã£ãŠåŒã³åºããã端ç¹ãæå®ããŸãã endpointReferenceã«åç
§ãã©ã¡ãŒã¿ãããå Žåã¯ã端ç¹ã«éä¿¡ããããã¹ãŠã®ã¡ãã»ãŒãžã«ãããã®åç
§ãã©ã¡ãŒã¿ãSOAPããããŒãšããŠå«ããããããåç
§ãã©ã¡ãŒã¿ã§ããããšã瀺ãå¿
èŠããããŸãã 端ç¹ã®åŒåºãã«ã¯endpointReference'sã®ã¢ãã¬ã¹ã䜿çšããå¿
èŠããããŸãã ãã©ã¡ãŒã¿serviceEndpointInterfaceã¯ãæ»ãå€ã®ãããã·ã«ãã£ãŠãµããŒãããããµãŒãã¹ç«¯ç¹ã€ã³ã¿ãã§ãŒã¹ãæå®ããŸãã ãã®ã¡ãœããã®å®è£
ã§ã¯ããã®Serviceã€ã³ã¹ã¿ã³ã¹ã«é¢é£ä»ããããWSDLãŸãã¯endpointReferenceã®ã¡ã¿ããŒã¿ã«åŸã£ãŠãJAX-WSã©ã³ã¿ã€ã ã»ã·ã¹ãã ããããã³ã«ã»ãã€ã³ãã£ã³ã°(ããã³ããŒã)ã®éžæãšãããã·ã®æ§æãè¡ããŸãã ãã®Serviceã€ã³ã¹ã¿ã³ã¹ã«WSDLããããendpointReferenceã®ã¡ã¿ããŒã¿ã«ãWSDLãããå Žåã¯ããã®ã€ã³ã¹ã¿ã³ã¹ã®WSDLã䜿çšããå¿
èŠããããŸãã ãã®Serviceã€ã³ã¹ã¿ã³ã¹ã«WSDLããªããendpointReferenceã«WSDLãããå Žåã¯ãendpointReferenceã®WSDLã䜿çšããããšãã§ããŸãã æ»ãå€ã®ãããã·ããã¯ã©ã€ã¢ã³ããæ§æãçŽããªãããã«ããŠãã ããã ãã®Serviceã€ã³ã¹ã¿ã³ã¹ã«ãWSDLã«å«ãŸããŠããæ
å ±ãšäžèŽããæ¢ç¥ã®ãããã·ã»ããŒããããå Žåã¯ããã®ãããã·ãè¿ãããŸãããã以å€ã®å Žåã¯WebServiceExceptionãã¹ããŒãããŸãã
ãã®ã¡ãœãããåŒã³åºãããšãã®åäœã¯ã次ã®å Žåãšåãã«ãªããŸã
port = service.getPort(portName, serviceEndpointInterface);
ãã®portNameã¯ãendpointReferenceã®ã¡ã¿ããŒã¿ããååŸãããããserviceEndpointInterfaceãšãã®Serviceã€ã³ã¹ã¿ã³ã¹ã«é¢é£ä»ããããWSDLããååŸãããŸããendpointReference - æ»ãå€ã®ãããã·ã«ãã£ãŠåŒã³åºãããã¿ãŒã²ããã»ãµãŒãã¹ç«¯ç¹ã®EndpointReferenceãserviceEndpointInterface - ãµãŒãã¹ç«¯ç¹ã€ã³ã¿ãã§ãŒã¹ãfeatures - ãããã·ã«æ§æããWebServiceFeaturesã®ãªã¹ãã features ãã©ã¡ãŒã¿ã«å«ãŸããŠããªããµããŒããããæ©èœã«ã¯ãããã©ã«ãå€ãèšå®ãããã WebServiceException - endpointReferenceã®ã¡ã¿ããŒã¿ãããã®Serviceã€ã³ã¹ã¿ã³ã¹ã®serviceNameãšäžèŽããªãå Žåã
endpointReferenceã®ã¡ã¿ããŒã¿ããportNameãæœåºã§ããªãå Žåã
endpointReferenceãæå®ãããå Žåã
serviceEndpointInterfaceãæå®ãããå Žåã
public void addPort(QName portName, String bindingId, String endpointAddress)
Dispatchã€ã³ã¹ã¿ã³ã¹ãäœæããããã«ã®ã¿äœ¿çšã§ããŸãã portName - ã¿ãŒã²ããã»ãµãŒãã¹ç«¯ç¹ã®ä¿®é£ŸåãbindingId - ãã€ã³ãã£ã³ã°ã®æååèå¥åãendpointAddress - ã¿ãŒã²ããã»ãµãŒãã¹ç«¯ç¹ã®URI圢åŒã®ã¢ãã¬ã¹ãWebServiceException - ããŒãã®äœæã§ãšã©ãŒãçºçããå ŽåãSOAPBinding.SOAP11HTTP_BINDING, SOAPBinding.SOAP12HTTP_BINDING, HTTPBinding.HTTP_BINDINGpublic <T> Dispatch<T> createDispatch(QName portName, Class<T> type, Service.Mode mode)
Dispatchã€ã³ã¹ã¿ã³ã¹ãäœæããŸããportName - ã¿ãŒã²ããã»ãµãŒãã¹ç«¯ç¹ã®ä¿®é£Ÿåtype - ã¡ãã»ãŒãžãŸãã¯ã¡ãã»ãŒãžã»ãã€ããŒãã«äœ¿çšããããªããžã§ã¯ãã®ã¯ã©ã¹ã 䜿çšããŠãããã€ã³ãã£ã³ã°ã«å¿ããŠãå®è£
ã¯javax.xml.transform.Sourceãjavax.xml.soap.SOAPMessageãããã³javax.activation.DataSourceããµããŒãããå¿
èŠããããŸãã mode - äœæããããã£ã¹ãããã»ã€ã³ã¹ã¿ã³ã¹ãã¡ãã»ãŒãžæåã§ããããã€ããŒãæåã§ããããå¶åŸ¡ãããã€ãŸããã¯ã©ã€ã¢ã³ããå®å
šãªãããã³ã«ã»ã¡ãã»ãŒãžãæ±ãããã¡ãã»ãŒãžã»ãã€ããŒããæ±ãããå¶åŸ¡ããã ããšãã°ãSOAPãããã³ã«ã䜿çšããå Žåããã®ãã©ã¡ãŒã¿ã¯ãã¯ã©ã€ã¢ã³ããSOAPã¡ãã»ãŒãžãæ±ãããSOAPæ¬äœã®ã³ã³ãã³ããæ±ããã©ãããå¶åŸ¡ããã typeãSOAPMessageã®å Žåãmodeã¯MESSAGEã§ãªããã°ãªããªãã WebServiceException - Dispatchãªããžã§ã¯ãã®äœæã§ãšã©ãŒãçºçããå ŽåãSource, SOAPMessagepublic <T> Dispatch<T> createDispatch(QName portName, Class<T> type, Service.Mode mode, WebServiceFeature... features)
Dispatchã€ã³ã¹ã¿ã³ã¹ãäœæããŸããportName - ã¿ãŒã²ããã»ãµãŒãã¹ç«¯ç¹ã®ä¿®é£Ÿåtype - ã¡ãã»ãŒãžãŸãã¯ã¡ãã»ãŒãžã»ãã€ããŒãã«äœ¿çšããããªããžã§ã¯ãã®ã¯ã©ã¹ã å®è£
ã¯javax.xml.transform.Sourceããã³javax.xml.soap.SOAPMessageããµããŒãããå¿
èŠããããŸãã mode - äœæããããã£ã¹ãããã»ã€ã³ã¹ã¿ã³ã¹ãã¡ãã»ãŒãžæåã§ããããã€ããŒãæåã§ããããå¶åŸ¡ãããã€ãŸããã¯ã©ã€ã¢ã³ããå®å
šãªãããã³ã«ã»ã¡ãã»ãŒãžãæ±ãããã¡ãã»ãŒãžã»ãã€ããŒããæ±ãããå¶åŸ¡ããã ããšãã°ãSOAPãããã³ã«ã䜿çšããå Žåããã®ãã©ã¡ãŒã¿ã¯ãã¯ã©ã€ã¢ã³ããSOAPã¡ãã»ãŒãžãæ±ãããSOAPæ¬äœã®ã³ã³ãã³ããæ±ããã©ãããå¶åŸ¡ããã typeãSOAPMessageã®å Žåãmodeã¯MESSAGEã§ãªããã°ãªããªãã features - ãããã·ã«æ§æããWebServiceFeaturesã®ãªã¹ãã features ãã©ã¡ãŒã¿ã«å«ãŸããŠããªããµããŒããããæ©èœã«ã¯ãããã©ã«ãå€ãèšå®ãããã WebServiceException - Dispatchãªããžã§ã¯ãã®äœæã§ãšã©ãŒãçºçããå Žåããããã¯ãã®ããŒããšäºææ§ã®ãªãæ©èœãŸãã¯ãµããŒããããŠããªãæ©èœãæå¹ã«ããå ŽåãSource, SOAPMessage, WebServiceFeaturepublic <T> Dispatch<T> createDispatch(EndpointReference endpointReference, Class<T> type, Service.Mode mode, WebServiceFeature... features)
Dispatchã€ã³ã¹ã¿ã³ã¹ãäœæããŸãã endpointReferenceã«åç
§ãã©ã¡ãŒã¿ãããå Žåã¯ã端ç¹ã«éä¿¡ããããã¹ãŠã®ã¡ãã»ãŒãžã«ãããã®åç
§ãã©ã¡ãŒã¿ãSOAPããããŒãšããŠå«ããããããåç
§ãã©ã¡ãŒã¿ã§ããããšã瀺ãå¿
èŠããããŸãã 端ç¹ã®åŒåºãã«ã¯endpointReference'sã®ã¢ãã¬ã¹ã䜿çšããå¿
èŠããããŸãã ãã®ã¡ãœããã®å®è£
ã§ã¯ããã®Serviceã€ã³ã¹ã¿ã³ã¹ã«é¢é£ä»ããããWSDLãŸãã¯endpointReferenceã®ã¡ã¿ããŒã¿ã«åŸã£ãŠãJAX-WSã©ã³ã¿ã€ã ã»ã·ã¹ãã ããããã³ã«ã»ãã€ã³ãã£ã³ã°(ããã³ããŒã)ã®éžæãšãã£ã¹ãããã®æ§æãè¡ããŸãã ãã®Serviceã€ã³ã¹ã¿ã³ã¹ã«WSDLããããendpointReferenceã®ã¡ã¿ããŒã¿ã«ãWSDLãããå Žåã¯ããã®ã€ã³ã¹ã¿ã³ã¹ã®WSDLã䜿çšããå¿
èŠããããŸãã ãã®Serviceã€ã³ã¹ã¿ã³ã¹ã«WSDLããªããendpointReferenceã«WSDLãããå Žåã¯ãendpointReferenceã®WSDLã䜿çšããããšãã§ããŸãã å®è£
ã¯ãendpointReferenceã®ã¡ã¿ããŒã¿ããportNameãååŸã§ããå¿
èŠããããŸãã
ãã®ã¡ãœããã®åäœã¯ã次ã®åŒã³åºããšåãã«ãªããŸã
dispatch = service.createDispatch(portName, type, mode, features);
ãã®portNameã¯ãWSDLãŸãã¯EndpointReferenceã®ã¡ã¿ããŒã¿ããååŸãããŸããendpointReference - æ»ãå€ã®Dispatchãªããžã§ã¯ãã«ãã£ãŠåŒã³åºãããã¿ãŒã²ããã»ãµãŒãã¹ç«¯ç¹ã®EndpointReferenceãtype - ã¡ãã»ãŒãžãŸãã¯ã¡ãã»ãŒãžã»ãã€ããŒãã«äœ¿çšããããªããžã§ã¯ãã®ã¯ã©ã¹ã å®è£
ã¯javax.xml.transform.Sourceããã³javax.xml.soap.SOAPMessageããµããŒãããå¿
èŠããããŸãã mode - äœæããããã£ã¹ãããã»ã€ã³ã¹ã¿ã³ã¹ãã¡ãã»ãŒãžæåã§ããããã€ããŒãæåã§ããããå¶åŸ¡ãããã€ãŸããã¯ã©ã€ã¢ã³ããå®å
šãªãããã³ã«ã»ã¡ãã»ãŒãžãæ±ãããã¡ãã»ãŒãžã»ãã€ããŒããæ±ãããå¶åŸ¡ããã ããšãã°ãSOAPãããã³ã«ã䜿çšããå Žåããã®ãã©ã¡ãŒã¿ã¯ãã¯ã©ã€ã¢ã³ããSOAPã¡ãã»ãŒãžãæ±ãããSOAPæ¬äœã®ã³ã³ãã³ããæ±ããã©ãããå¶åŸ¡ããã typeãSOAPMessageã®å Žåãmodeã¯MESSAGEã§ãªããã°ãªããªãã features - ãããã·ã«æ§æããWebServiceFeaturesã®é
åã features ãã©ã¡ãŒã¿ã«å«ãŸããŠããªããµããŒããããæ©èœã«ã¯ãããã©ã«ãå€ãèšå®ãããã WebServiceException - endpointReferenceã®ã¡ã¿ããŒã¿ãããã®Serviceã€ã³ã¹ã¿ã³ã¹ã«é¢é£ä»ããããWSDLã®serviceNameãŸãã¯portNameãšäžèŽããªãå Žåã
EndpointReferenceã®ã¡ã¿ããŒã¿ããportNameãå€å®ã§ããªãå Žåã
Dispatchãªããžã§ã¯ãã®äœæã§ãšã©ãŒãçºçããå Žåã
Source, SOAPMessage, WebServiceFeaturepublic Dispatch<Object> createDispatch(QName portName, JAXBContext context, Service.Mode mode)
Dispatchã€ã³ã¹ã¿ã³ã¹ãäœæããŸããportName - ã¿ãŒã²ããã»ãµãŒãã¹ç«¯ç¹ã®ä¿®é£Ÿåcontext - ã¡ãã»ãŒãžãŸãã¯ã¡ãã»ãŒãžã»ãã€ããŒãã®æŽååãšéæŽååã«äœ¿çšãããJAXBã³ã³ããã¹ããmode - äœæããããã£ã¹ãããã»ã€ã³ã¹ã¿ã³ã¹ãã¡ãã»ãŒãžæåã§ããããã€ããŒãæåã§ããããå¶åŸ¡ãããã€ãŸããã¯ã©ã€ã¢ã³ããå®å
šãªãããã³ã«ã»ã¡ãã»ãŒãžãæ±ãããã¡ãã»ãŒãžã»ãã€ããŒããæ±ãããå¶åŸ¡ããã ããšãã°ãSOAPãããã³ã«ã䜿çšããå Žåããã®ãã©ã¡ãŒã¿ã¯ãã¯ã©ã€ã¢ã³ããSOAPã¡ãã»ãŒãžãæ±ãããSOAPæ¬äœã®ã³ã³ãã³ããæ±ããã©ãããå¶åŸ¡ããã WebServiceException - Dispatchãªããžã§ã¯ãã®äœæã§ãšã©ãŒãçºçããå ŽåãJAXBContextpublic Dispatch<Object> createDispatch(QName portName, JAXBContext context, Service.Mode mode, WebServiceFeature... features)
Dispatchã€ã³ã¹ã¿ã³ã¹ãäœæããŸããportName - ã¿ãŒã²ããã»ãµãŒãã¹ç«¯ç¹ã®ä¿®é£Ÿåcontext - ã¡ãã»ãŒãžãŸãã¯ã¡ãã»ãŒãžã»ãã€ããŒãã®æŽååãšéæŽååã«äœ¿çšãããJAXBã³ã³ããã¹ããmode - äœæããããã£ã¹ãããã»ã€ã³ã¹ã¿ã³ã¹ãã¡ãã»ãŒãžæåã§ããããã€ããŒãæåã§ããããå¶åŸ¡ãããã€ãŸããã¯ã©ã€ã¢ã³ããå®å
šãªãããã³ã«ã»ã¡ãã»ãŒãžãæ±ãããã¡ãã»ãŒãžã»ãã€ããŒããæ±ãããå¶åŸ¡ããã ããšãã°ãSOAPãããã³ã«ã䜿çšããå Žåããã®ãã©ã¡ãŒã¿ã¯ãã¯ã©ã€ã¢ã³ããSOAPã¡ãã»ãŒãžãæ±ãããSOAPæ¬äœã®ã³ã³ãã³ããæ±ããã©ãããå¶åŸ¡ããã features - ãããã·ã«æ§æããWebServiceFeaturesã®ãªã¹ãã features ãã©ã¡ãŒã¿ã«å«ãŸããŠããªããµããŒããããæ©èœã«ã¯ãããã©ã«ãå€ãèšå®ãããã WebServiceException - Dispatchãªããžã§ã¯ãã®äœæã§ãšã©ãŒãçºçããå Žåããããã¯ãã®ããŒããšäºææ§ã®ãªãæ©èœãŸãã¯ãµããŒããããŠããªãæ©èœãæå¹ã«ããå ŽåãJAXBContextãWebServiceFeaturepublic Dispatch<Object> createDispatch(EndpointReference endpointReference, JAXBContext context, Service.Mode mode, WebServiceFeature... features)
Dispatchã€ã³ã¹ã¿ã³ã¹ãäœæããŸãã endpointReferenceã«åç
§ãã©ã¡ãŒã¿ãããå Žåã¯ã端ç¹ã«éä¿¡ããããã¹ãŠã®ã¡ãã»ãŒãžã«ãããã®åç
§ãã©ã¡ãŒã¿ãSOAPããããŒãšããŠå«ããããããåç
§ãã©ã¡ãŒã¿ã§ããããšã瀺ãå¿
èŠããããŸãã 端ç¹ã®åŒåºãã«ã¯endpointReference'sã®ã¢ãã¬ã¹ã䜿çšããå¿
èŠããããŸãã ãã®ã¡ãœããã®å®è£
ã§ã¯ããã®Serviceã€ã³ã¹ã¿ã³ã¹ã«é¢é£ä»ããããWSDLãŸãã¯endpointReferenceã®ã¡ã¿ããŒã¿ã«åŸã£ãŠãJAX-WSã©ã³ã¿ã€ã ã»ã·ã¹ãã ããããã³ã«ã»ãã€ã³ãã£ã³ã°(ããã³ããŒã)ã®éžæãšãã£ã¹ãããã®æ§æãè¡ããŸãã ãã®Serviceã€ã³ã¹ã¿ã³ã¹ã«WSDLããããendpointReferenceã®ã¡ã¿ããŒã¿ã«ãWSDLãããå Žåã¯ããã®ã€ã³ã¹ã¿ã³ã¹ã®WSDLã䜿çšããå¿
èŠããããŸãã ãã®Serviceã€ã³ã¹ã¿ã³ã¹ã«WSDLããªããendpointReferenceã«WSDLãããå Žåã¯ãendpointReferenceã®WSDLã䜿çšããããšãã§ããŸãã å®è£
ã¯ãendpointReferenceã®ã¡ã¿ããŒã¿ããportNameãååŸã§ããå¿
èŠããããŸãã
ãã®ã¡ãœããã®åäœã¯ã次ã®åŒã³åºããšåãã«ãªããŸã
dispatch = service.createDispatch(portName, context, mode, features);
ãã®portNameã¯ãWSDLãŸãã¯endpointReferenceã®ã¡ã¿ããŒã¿ããååŸãããŸããendpointReference - æ»ãå€ã®Dispatchãªããžã§ã¯ãã«ãã£ãŠåŒã³åºãããã¿ãŒã²ããã»ãµãŒãã¹ç«¯ç¹ã®EndpointReferenceãcontext - ã¡ãã»ãŒãžãŸãã¯ã¡ãã»ãŒãžã»ãã€ããŒãã®æŽååãšéæŽååã«äœ¿çšãããJAXBã³ã³ããã¹ããmode - äœæããããã£ã¹ãããã»ã€ã³ã¹ã¿ã³ã¹ãã¡ãã»ãŒãžæåã§ããããã€ããŒãæåã§ããããå¶åŸ¡ãããã€ãŸããã¯ã©ã€ã¢ã³ããå®å
šãªãããã³ã«ã»ã¡ãã»ãŒãžãæ±ãããã¡ãã»ãŒãžã»ãã€ããŒããæ±ãããå¶åŸ¡ããã ããšãã°ãSOAPãããã³ã«ã䜿çšããå Žåããã®ãã©ã¡ãŒã¿ã¯ãã¯ã©ã€ã¢ã³ããSOAPã¡ãã»ãŒãžãæ±ãããSOAPæ¬äœã®ã³ã³ãã³ããæ±ããã©ãããå¶åŸ¡ããã features - ãããã·ã«æ§æããWebServiceFeaturesã®é
åã features ãã©ã¡ãŒã¿ã«å«ãŸããŠããªããµããŒããããæ©èœã«ã¯ãããã©ã«ãå€ãèšå®ãããã WebServiceException - endpointReferenceã®ã¡ã¿ããŒã¿ãããã®Serviceã€ã³ã¹ã¿ã³ã¹ã«é¢é£ä»ããããWSDLã®serviceNameãŸãã¯portNameãšäžèŽããªãå Žåã
EndpointReferenceã®ã¡ã¿ããŒã¿ããportNameãå€å®ã§ããªãå Žåã
Dispatchãªããžã§ã¯ãã®äœæã§ãšã©ãŒãçºçããå Žåã
JAXBContextãWebServiceFeaturepublic QName getServiceName()
public Iterator<QName> getPorts()
QNameãªã¹ãã®Iteratorãè¿ããŸãjavax.xml.namespace.QNameåã®èŠçŽ ãå«ãjava.util.Iteratorãè¿ããWebServiceException - ãã®ãµãŒãã¹ã»ã¯ã©ã¹ãå¿
èŠãªWSDLã¡ã¿ããŒã¿ã«ã¢ã¯ã»ã¹ã§ããªãå Žåãpublic URL getWSDLDocumentLocation()
public HandlerResolver getHandlerResolver()
Serviceã€ã³ã¹ã¿ã³ã¹ã«ãã£ãŠäœ¿çšãããŠããHandlerResolverãååšããªãå Žåã¯nullãpublic void setHandlerResolver(HandlerResolver handlerResolver)
Serviceã€ã³ã¹ã¿ã³ã¹ã®HandlerResolverãèšå®ããŸãã
ãã³ãã©ã»ãªãŸã«ããååšããå Žåãäœæãããåãããã·ãŸãã¯ãã£ã¹ãããã»ã€ã³ã¹ã¿ã³ã¹ã«å¯ŸãäžåºŠãã³ãã©ã»ãªãŸã«ããåŒã³åºããããªãŸã«ãã«ãã£ãŠè¿ããããã³ãã©ã»ãã§ãŒã³ãã€ã³ã¹ã¿ã³ã¹ã«èšå®ãããŸãã
handlerResolver - åŸã«äœæããããã¹ãŠã®ãããã·ãŸãã¯ãã£ã¹ãããã»ãªããžã§ã¯ãã«å¯ŸããŠäœ¿çšãããHandlerResolverãHandlerResolverpublic Executor getExecutor()
Serviceã€ã³ã¹ã¿ã³ã¹ã®executorãè¿ããŸãã executorã¯ãã³ãŒã«ããã¯ãå¿
èŠãšãããã¹ãŠã®éåæåŒåºãã«äœ¿çšãããŸãã java.util.concurrent.ExecutorãExecutorpublic void setExecutor(Executor executor)
Serviceã€ã³ã¹ã¿ã³ã¹ã®executorãèšå®ããŸãã executorã¯ãã³ãŒã«ããã¯ãå¿
èŠãšãããã¹ãŠã®éåæåŒåºãã«äœ¿çšãããŸãã executor - ã³ãŒã«ããã¯ãåŒã³åºãããã«äœ¿çšãããjava.util.concurrent.ExecutorãSecurityException - ã»ãã¥ãªãã£äžã®çç±ã«ãããã€ã³ã¹ã¿ã³ã¹ãexecutorãèšå®ããããšããµããŒãããŠããªãå Žå(ããšãã°ãå¿
èŠãªã¢ã¯ã»ã¹æš©ãäžè¶³ããŠããå Žå)ãExecutorpublic static Service create(URL wsdlDocumentLocation, QName serviceName)
Serviceã€ã³ã¹ã¿ã³ã¹ãäœæããŸãã æå®ãããWSDLããã¥ã¡ã³ãã®äœçœ®ãšãµãŒãã¹ä¿®é£Ÿåã¯ãwsdl:serviceèŠçŽ ãäžæã«èå¥ããå¿
èŠããããŸãã wsdlDocumentLocation - ãµãŒãã¹ã®WSDLããã¥ã¡ã³ãã®äœçœ®ã瀺ãURLserviceName - ãµãŒãã¹ã®QNameWebServiceException - æå®ãããµãŒãã¹ã®äœæã§ãšã©ãŒãçºçããå Žåãpublic static Service create(URL wsdlDocumentLocation, QName serviceName, WebServiceFeature... features)
Serviceã€ã³ã¹ã¿ã³ã¹ãäœæããŸãã äœæãããã€ã³ã¹ã¿ã³ã¹ã¯WebãµãŒãã¹æ©èœã§æ§æãããŸãã æå®ãããWSDLããã¥ã¡ã³ãã®äœçœ®ãšãµãŒãã¹ä¿®é£Ÿåã¯ãwsdl:serviceèŠçŽ ãäžæã«èå¥ããå¿
èŠããããŸãã wsdlDocumentLocation - ãµãŒãã¹ã®WSDLããã¥ã¡ã³ãã®äœçœ®ã瀺ãURLserviceName - ãµãŒãã¹ã®QNamefeatures - ãµãŒãã¹ã«æ§æãããå¿
èŠãããWebãµãŒãã¹æ©èœã ãããã€ããæ©èœãçè§£ããªãå ŽåãWebServiceExceptionãã¹ããŒããå¿
èŠããããŸãã WebServiceException - æå®ãããµãŒãã¹ã®äœæã§ãšã©ãŒãçºçããå Žåãpublic static Service create(QName serviceName)
Serviceã€ã³ã¹ã¿ã³ã¹ãäœæããŸããserviceName - ãµãŒãã¹ã®QNameWebServiceException - æå®ãããµãŒãã¹ã®äœæã§ãšã©ãŒãçºçããå Žåpublic static Service create(QName serviceName, WebServiceFeature... features)
Serviceã€ã³ã¹ã¿ã³ã¹ãäœæããŸãã äœæãããã€ã³ã¹ã¿ã³ã¹ã¯WebãµãŒãã¹æ©èœã§æ§æãããŸãã serviceName - ãµãŒãã¹ã®QNamefeatures - ãµãŒãã¹ã«æ§æãããå¿
èŠãããWebãµãŒãã¹æ©èœã ãããã€ããæ©èœãçè§£ããªãå ŽåãWebServiceExceptionãã¹ããŒããå¿
èŠããããŸãã WebServiceException - æå®ãããµãŒãã¹ã®äœæã§ãšã©ãŒãçºçããå Žå ãã°ãŸãã¯æ©èœãéä¿¡
詳现ãªAPIãªãã¡ã¬ã³ã¹ããã³éçºè
ããã¥ã¡ã³ãã«ã€ããŠã¯ãJava SEã®ããã¥ã¡ã³ããåç
§ããŠãã ããã ãã®ããã¥ã¡ã³ãã«ã¯ãæŠå¿µçãªæŠèŠãçšèªã®å®çŸ©ãåé¿æ¹æ³ãæå¹ãªã³ãŒãäŸãªã©ã®ãéçºè
ã察象ã«ãããã詳现ãªèª¬æãå«ãŸããŠããŸãã
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyãåç
§ããŠãã ããã