今天因为需要调用第三方的接口些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();
- }
- }
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
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>
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);
- }
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"));
- }
- }
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及以上,其他版本未知。