Java调用与发布Webservice接口（一）

​

一  准备工作

（一）开发环境

demo以springboot为基础框架，使用到了httpclient、hutool等依赖，详情如下：
        springboot版本：

org.springframework.boot spring-boot-starter-parent 2.7.8

cxf与httpclient 、hutool依赖：

    <dependency>         <groupId>org.apache.httpcomponents</groupId>         <artifactId>httpclient</artifactId>     </dependency> 

    <dependency>         <groupId>cn.hutool</groupId>         <artifactId>hutool-all</artifactId>         <version>5.8.20</version>     </dependency> 

二 发布接口

首先创建一个测试接口，@WebService声明这是一个webservice接口，name为接口名称，targetNamespace 很重要，表明webservice接口的命名空间。@WebMethod()声明这是一个接口下的函数方法，@WebParam声明函数需要的参数。

@WebService(name = "UnifySearchService", targetNamespace = "http://com.test.webservice/service")
public interface UnifySearchService {

@WebMethod() String testService(@WebParam(name = "parameter") String parameter); 

}

创建该接口的实现类就可以在函数种编写业务处理代码：

@Override public String testService(String parameter) {     // code          return "parameter：" + parameter; } 

创建发布webservice接口的配置文件：

@Configuration
public class CxfWebServiceConfig {

@Resource private UnifySearchService unifySearchService;  @Bean(name = Bus.DEFAULT_BUS_ID) public SpringBus springBus() {     return new SpringBus(); }  /**  * 访问地址 http://127.0.0.1:8085/ws/service?wsdl  */ @Bean public Endpoint endpoint() {     EndpointImpl endpoint = new EndpointImpl(springBus(), unifySearchService);     endpoint.publish("/service");     return endpoint; } 

}

在applicaiton.properties中，添加以下配置：

创建完毕后运行项目，访问http://127.0.0.1:8085/ws/service?wsdl，可见以下内容：

到此，webservice接口就发布成功了。

三  接口调用

（一）httpclient调用

webservice接口调用在此展示两种最简单的方式，先说最简单的调用方法，httpclient方法调用，需要使用soapUI工具生成xml请求体：

再创建httpclient请求，将上面的xml请求体作为请求参数soapXml，发送POST请求：

public static String doPostSoap(String postUrl, String soapAction, String soapXml) throws IOException {     String retStr = "";     CloseableHttpClient httpClient = CustomerHttpClient4.getHttpClient();     HttpPost httpPost = new HttpPost(postUrl);     httpPost.setHeader("Content-Type", "text/xml;charset=UTF-8");     httpPost.setHeader("SOAPAction", soapAction);     StringEntity data = new StringEntity(soapXml, Charset.forName("UTF-8"));     httpPost.setEntity(data);     try (CloseableHttpResponse response = httpClient.execute(httpPost)) {         HttpEntity httpEntity = response.getEntity();         String entity = EntityUtils.toString(httpEntity, "UTF-8");         if (response.getStatusLine().getStatusCode() == 200) {             retStr = entity;         }     }     return retStr; }  public static void main(String[] args) {     String result;     String xmlParam = "<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://com.wp.webservice/service"><soapenv:Header/><soapenv:Body><ser:testService><parameter>HTTP client请求</parameter></ser:testService>/soapenv:Body></soapenv:Envelope>";     try {         result = doPostSoap("http://localhost:8085/ws/service?wsdl", "", xmlParam);     } catch (IOException e) {         throw new RuntimeException(e);     }     System.out.println(result); } 

调用结果：

（二）hutool工具调用

基于hutool提供的SoapClient工具创建webservice请求调用：

public static String request(String url, String method, String targetNamespace, Map<String, Object> param) {     SoapClient client = SoapClient.create(url).setMethod(method, targetNamespace).setParams(param, false);     // 打印组装xml请求体     Console.log(client.getMsgStr(true));      String result = client.send();     return result; }  public static void main(String[] args) {     Map<String, Object> param = new HashMap<>();     param.put("parameter", "hutool请求webservice接口");     String result = request("http://localhost:8085/ws/service?wsdl",             "ser:testService",             "http://com.wp.webservice/service",             param     );     System.out.println(result); } 

调用结果：

调用webservice接口除以上两种简便的方式外，还可使用cxf提供的工具类进行调用，具体的调用方法后续有时间再贴出来。

此外我在工作中遇到的是带有head认证的webservice接口，刚开始使用cxf框架，在拦截器中进行头部参数认证，但实际效果并不好，因此查找了以上两种方法，第一种可以适配所有情况，第二种需要进一步完善代码才可以，在后续的文章中会贴出代码，包括如何使用hutool调用带有head认证的webservice接口与cxf动态调用webservice接口，敬请期待。

​