JAVA 快速实现webService （同步逻辑）

最新推荐文章于 2022-06-26 14:06:10 发布

转载最新推荐文章于 2022-06-26 14:06:10 发布 · 873 阅读

本文介绍如何快速搭建一个基于SOAP协议的WebService，并通过示例代码展示了服务端与客户端的具体实现过程。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

今天因为需要调用第三方的接口些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"));  

    }  

}