这是我参与更文挑战的第 **3** 天，活动详情查看： [更文挑战](https://juejin.cn/post/6967194882926444557) >日积月累，水滴石穿 😄 在工作当中经常需要与第三方对接，某些第三方提供的接口是 `WebService` 类型的，所以需要集成 `WebService` 由于 `SpringBoot`提供了 `WebService`的 `starter` 组件，所以集成 `WebService`相当的简单 # 加入依赖 ```xml org.springframework.boot spring-boot-starter-web-services org.apache.cxf cxf-spring-boot-starter-jaxws 3.3.4 org.projectlombok lombok ``` ## 服务端 ### 创建WebService接口 ```java package com.gongj.webservice_server.service; import com.gongj.webservice_server.DTO.UserDTO; import javax.jws.WebService; public interface IUserServer { UserDTO getUser(Long str); } ``` ### 创建实体类 ```java @Data public class UserDTO { private Long id; private String name; private Integer age; private String address; } ``` ### 创建WebService接口的实现类 ```java package com.gongj.webservice_server.service.impl; import com.gongj.webservice_server.DTO.UserDTO; import com.gongj.webservice_server.service.IUserServer; import org.springframework.stereotype.Service; import javax.jws.WebService; @Service @WebService public class UserServerImpl implements IUserServer { @Override public UserDTO getUser(Long id) { UserDTO user = new UserDTO(); user.setId(id); user.setAddress("上海市浦东新区"); user.setAge(25); user.setName("gongj"); return user; } } ``` 这里用到了一个注解`@WebService`，我这就只在实现类上使用了。这里介绍一下，先来看下它的定义： ```java @Retention(RetentionPolicy.RUNTIME) @Target({ElementType.TYPE}) public @interface WebService { String name() default ""; String targetNamespace() default ""; String serviceName() default ""; String portName() default ""; String wsdlLocation() default ""; String endpointInterface() default ""; } ``` * name：对应 `wsdl:portType` 标签，默认值为 Java 类或接口的名称 * targetNamespace：命名空间，一般写为接口的包名倒序，默认值也是接口的包名倒序。对应 `wsdl:definitions:targetNamespace` 标签， * serviceName：`WebService`的服务名称，对应`wsdl:service`，默认值为`WebService`接口实现类的名称+ “Service”,示例：`UserServerImplService` * portName：对应 `wsdl:port`标签，默认值为：`WebService`接口实现类的名称 + "Port"，示例：`UserServerImplPort` * wsdlLocation：指定用于定义 `WebService` 的 WSDL 文档的地址 * endpointInterface：`WebService` 接口全路径 ### 创建 WebService 配置类 ```java package com.gongj.webservice_server.config; import com.gongj.webservice_server.service.IUserServer; 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.beans.factory.annotation.Autowired; import org.springframework.boot.web.servlet.ServletRegistrationBean; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import javax.xml.ws.Endpoint; @Configuration public class CxfConfig { @Autowired private IUserServer userServer; /** * 注入Servlet 注意beanName不能为dispatcherServlet * @return */ @Bean public ServletRegistrationBean cxfServlet() { return new ServletRegistrationBean(new CXFServlet(),"/webservice/*"); } @Bean(name = Bus.DEFAULT_BUS_ID) public SpringBus springBus() { return new SpringBus(); } @Bean public Endpoint endpoint() { EndpointImpl endpoint = new EndpointImpl(springBus(), userServer); endpoint.publish("/api"); return endpoint; } } ``` 启动服务，进行访问：[http://localhost:8080/webservice](http://localhost:8080/webservice) ![image.png](https://p6-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/cc9fbecc98ba4e3aab99906ea12f8eed~tplv-k3u1fbpfcp-watermark.image) 点击链接跳转，我们会看到一个页面，这是 wsdl 服务描述文档。对于这个文档也需要简单的了解一下，也许某次对接第三方系统直接给你一个 wsdl 文档让你自己看去，**注意：wsdl 文档是从下往上看的**。 ![image.png](https://p9-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/14c57404aeaa43729267c5b0788f80c8~tplv-k3u1fbpfcp-watermark.image) ### wsdl 文档 ```xml ``` # 客户端 ## 加入依赖 ```xml org.apache.cxf cxf-spring-boot-starter-jaxws 3.3.4 ``` ## 调用 ```java public static void main(String[] args) { JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance(); Client client = dcf.createClient("http://localhost:8080/webservice/api?wsdl"); ObjectMapper mapper = new ObjectMapper(); try { // invoke("方法名",参数1,参数2,参数3....); Object[] objects = client.invoke("getUser", 99L); System.out.println(mapper.writeValueAsString(objects[0])); } catch (java.lang.Exception e) { e.printStackTrace(); } } 输出结果： {"address":"上海市浦东新区","age":25,"id":99,"name":"gongj"} ``` * 如你对本文有疑问或本文有错误之处，欢迎评论留言指出。如觉得本文对你有所帮助，欢迎点赞和关注。