什么是WebService
webService是一种古老的互联网通讯方法。通过http通讯,将数据封装成XML的形式在网络中传输。习惯Java开发的伙伴肯定会对其嗤之以鼻,为什么不用Json传输,为什么不直接通过url拼参数?最大的两个因素是:
1,兼顾老系统,总所周知,在事业单位中几十年的老系统屡见不鲜。他们直接的通讯方式肯定是webService,所以为了而兼容他们沿用旧技术。
2,兼顾不同语言编写的计算机系统。银行柜台机,工厂车床等。很多是.net开发计算机系统。对于他们Java习惯的方式,他们可能不适配,所以通过webService将数据转换成XML的形式。大家都可以接受。
创建服务端
导包
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-frontend-jaxws</artifactId>
<version>3.1.12</version>
</dependency>
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-transports-http</artifactId>
<version>3.1.12</version>
</dependency>
先写接口
package com.zxl.online.api;
import javax.jws.WebMethod;
import javax.jws.WebService;
@WebService
public interface WSAPI {
@WebMethod
String getInfo();
}
再写实现类
package com.zxl.online.api.impl;
import com.zxl.online.api.NumberConstant;
import com.zxl.online.api.ResponseMessage;
import com.zxl.online.api.WSAPI;
import com.zxl.online.api.phoneEntity;
import javax.jws.WebService;
import java.util.ArrayList;
import java.util.List;
@WebService(targetNamespace = "http://api.online.zxl.com/", endpointInterface = "com.zxl.online.api.WSAPI")
public class WSImp implements WSAPI {
public WSImp(){
}
@Override
public String getInfo() {
return "成功调用!";
}
}
注意!
这里一定要填对,不然客户端会调用失败!
最后是配置类
package com.zxl.online.api;
import com.zxl.online.api.impl.WSImp;
import org.apache.cxf.Bus;
import org.apache.cxf.bus.spring.SpringBus;
import org.apache.cxf.jaxws.EndpointImpl;
import org.apache.cxf.transport.servlet.CXFServlet;
import org.springframework.boot.web.servlet.ServletRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class WSConfig {
//默认servlet路径/*,如果覆写则按照自己定义的来
@Bean
public ServletRegistrationBean cxfServlet() {
return new ServletRegistrationBean(new CXFServlet(),
"/webservice/*");
}
@Bean(name = Bus.DEFAULT_BUS_ID)
public SpringBus springBus() {
return new SpringBus();
}
//把实现类交给spring管理
@Bean
public WSAPI webService() {
return new WSImp();
}
//终端路径
@Bean
public EndpointImpl endpoint() {
EndpointImpl endpoint = new EndpointImpl(springBus(),webService());
endpoint.publish("/test");
return endpoint;
}
}
成功启动
创建客户端
SOAPUI进行测试
下载地址
soapui是一款成熟的,受欢迎的网络请求测试工具。用来测试webService非常方便!
填入链接
自动解析
进行测试
代码测试
简单测试
//测试本地服务端
@GetMapping("/testWebService")
public void testSend1() {
// 创建动态客户端
JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
Client client =
dcf.createClient("http://127.0.0.1:1000/webservice/test?wsdl");
// 需要密码的情况需要加上用户名和密码
// client.getOutInterceptors().add(new ClientLoginInterceptor(USER_NAME,PASS_WORD));
Object[] objects = new Object[0];
try {
// invoke("方法名",参数1,参数2,参数3....);
objects = client.invoke("getInfo");
System.out.println("返回数据:" + objects[0]);
} catch (java.lang.Exception e) {
e.printStackTrace();
}
}
这种测试方法是不成熟的,自己玩玩可以。放在工作中是不成熟的行为
生成客户端
这里我们就不测自己的了,测一个通过电话获取位置信息的网络接口,以模拟实战。
生成代码
我们在idea中的控制台,使用jdk自带的方法,进行生成(避免编译器产生的版本问题)
wsimport -encoding utf-8 -s . http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl
将他拉入咱们的工程中,
可能会出现拉不动的情况,我们在idea中右键点击“open in explorer”在windows文件管理器中自由拖动
测试
//测试网上的
@GetMapping("/getWether")
public void getWether() {
MobileCodeWS mobileCodeWS = new MobileCodeWS();//MobileCodeWS 在wsdl中找的
MobileCodeWSSoap port = mobileCodeWS.getPort(MobileCodeWSSoap.class);
String mobileCodeInfo = port.getMobileCodeInfo("18000000654", null);
System.out.println(mobileCodeInfo);
}
好了,现在我们服务端,客户端都已生成并测试成功!
优化代码
将实体类转为xml
在现实工作中,我们通过webService接口肯定是要将数据转为xml形式的
定义一个类
package com.zxl.online.api;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.experimental.Accessors;
@Data
@AllArgsConstructor
@NoArgsConstructor
@Accessors(chain = true)
public class phoneEntity {
private String province;
private String city;
private String regign;
}
转换方法
/**
* @param message
* @return
* @Title: entity2Xml
* @Description: 实体转换为xml
* @return: String
*/
public String entity2Xml(ResponseMessage message) {
StringBuffer xml = new StringBuffer("<?xml version=\"1.0\" encoding=\"UTF-8\"?>");
xml.append("<responseMessage>");
xml.append("<status>" + message.getStatus() + "</status>");
xml.append("<message>" + message.getMessage() + "</message>");
List<phoneEntity> list = message.getInfos();
if (list != null) {
xml.append("<infos>");
for (int i = 0; i < list.size(); i++) {
phoneEntity vo = list.get(i);
xml.append("<info>");
xml.append("<province>" + vo.getProvince() + "</province>");
xml.append("<city>" + vo.getCity() + "</city>");
xml.append("<regign>" + vo.getRegign() + "</regign>");
xml.append("</info>");
}
xml.append("</infos>");
}
xml.append("</responseMessage>");
return xml.toString();
}
改造原方法
@Override
public String getInfo() {
//new一个实体类
phoneEntity phoneEntity = new phoneEntity();
phoneEntity.setProvince("湖北省").setCity("武汉市").setRegign("洪山区");
//new一个返回类
ResponseMessage message = new ResponseMessage();
message.setStatus(NumberConstant.ZERO);
message.setMessage("SUCCESS");
List<phoneEntity> list = new ArrayList<>();
list.add(phoneEntity);
message.setInfos(list);
// 转换成xml
String xml = entity2Xml(message);
return xml;
}
测试
成功!