今天因为需要调用第三方的接口些fake service, 用于testcase. 该第三方使用的是soap的webservice模式。
首先是创建service。
package myws; import java.io.IOException; import javax.jws.WebMethod; import javax.jws.WebParam; import javax.jws.WebResult; import javax.jws.WebService; import javax.xml.bind.annotation.XmlAccessType; import javax.xml.bind.annotation.XmlAccessorType; import javax.xml.bind.annotation.XmlRootElement; import javax.xml.ws.Endpoint; /** * * @author 帐前卒 * */ @WebService( name="HELLO", targetNamespace="http://chillyc.info/api", serviceName="API", portName="PortName") public class WebServiceHolder { @WebMethod @WebResult(name="return") public String hello(@WebParam(name="name")String name) { return "hello" + name; } public static void main(String[] args) throws IOException { Endpoint.publish("http://localhost:80/fake/ws", new WebServiceHolder()); System.in.read(); } }
这里写System.in.read();是希望服务在那里卡死。基本上所有的server都是类似死循环的写法。所以我这里就偷懒使用IO.
这里要注意的是@WebService annotation. 其中 name是指这个portType 叫什么。 targetNameSpace这个在所有的后续调用中名字都是一致的。serviceName就是服务的名称。portName 其实就是提供服务的端口名称(这里对服务本身的调用没有什么关系)。如果没有name, 那么java会默认使用WebServiceHolder 也就类名称作为name.
运行后,在浏览器中打开
http://localhost:80/fake/ws?wsdl
然后就可以看到wsdl文件。
This XML file does not appear to have any style information associated with it. The document tree is shown below. <!-- Published by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.6 in JDK 6. --> <!-- Generated by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.6 in JDK 6. --> <definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://chillyc.info/api" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.xmlsoap.org/wsdl/" targetNamespace="http://chillyc.info/api" name="API"> <types> <xsd:schema> <xsd:import namespace="http://chillyc.info/api" schemaLocation="http://localhost/fake/ws?xsd=1"/> </xsd:schema> </types> <message name="hello"> <part name="parameters" element="tns:hello"/> </message> <message name="helloResponse"> <part name="parameters" element="tns:helloResponse"/> </message> <message name="getReturnInfo"> <part name="parameters" element="tns:getReturnInfo"/> </message> <message name="getReturnInfoResponse"> <part name="parameters" element="tns:getReturnInfoResponse"/> </message> <portType name="HELLO"> <operation name="hello"> <input message="tns:hello"/> <output message="tns:helloResponse"/> </operation> <operation name="getReturnInfo"> <input message="tns:getReturnInfo"/> <output message="tns:getReturnInfoResponse"/> </operation> </portType> <binding name="PortNameBinding" type="tns:HELLO"> <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/> <operation name="hello"> <soap:operation soapAction=""/> <input> <soap:body use="literal"/> </input> <output> <soap:body use="literal"/> </output> </operation> <operation name="getReturnInfo"> <soap:operation soapAction=""/> <input> <soap:body use="literal"/> </input> <output> <soap:body use="literal"/> </output> </operation> </binding> <service name="API"> <port name="PortName" binding="tns:PortNameBinding"> <soap:address location="http://localhost/fake/ws"/> </port> </service> </definitions>
大家自己对照刚才的那些name, serviceName等,在wsdl文件中的什么地方。
然后是写一个stub作为调用的接口。
package myws; import javax.jws.WebParam; import javax.jws.WebService; /** * * @author 帐前卒 * */ @WebService(targetNamespace = "http://chillyc.info/api", name="HELLO") public interface WebServiceAPI { String hello(@WebParam(name="name")String name); }
这里要注意的是 那个hello函数,必须与webService发布的函数名相一致(要看wdsl文件中的名字。) 另外WebParam中的name也需要和发布函数中的参数名字一致。 这里WebService中传入了两个值。其中name就是刚才WebService中的name. 其实就是wsdl中的portType. 如果这里写错了。就会有Undefined port type:{http://chillyc.info/api}Name. 这个错误。所以要小心。
另外写个可执行的类。
package myws; import java.net.MalformedURLException; import java.net.URL; import javax.xml.namespace.QName; import javax.xml.ws.Service; /** * * @author 帐前卒 * */ public class Client { public static void main(String[] args) throws MalformedURLException { WebServiceAPI api = Service.create( new URL("http://localhost:80/fake/ws?wsdl"), new QName("http://chillyc.info/api", "API")) .getPort(WebServiceAPI.class); System.out.println(api.hello("sss")); } }
这里URL中的就是wsdl文件的地址。 QName传入的就是targetNamespace 和 serviceName. 另外getPort就填入刚才的stub. 然后直接调用stub中的接口就能得到结果。
done.
简单快速,搭建和写client 也就是10分钟搞定。当然这只是起步
这个方法适用于JDK6及以上,其他版本未知。