SpringBoot集成webservice

前言

之前在工作中，有时候需要去对接第三方的医院，而很多医院的his系统用的都是老技术（WebService）。一直在对接webservice接口，却不知道webservice接口是怎么实现的，这一次，我们来一探究竟。

这里吐槽一句，都什么年代了？还在用webservice?

WebService依赖什么？

跨语言和操作系统的远程调用技术。比如亚马逊，可以将自己的服务以webservice的服务形式暴露出来，我们就可以通过web调用这些，无论我们使用的语言是java还是c，这也是SOA应用一种表现形式。

WSDL(Web Service Description Language)将无论用何种语言书写的web service描述出来，比如其参数或返回值。WSDL是服务端和客户端都能解读的标准格式。客户端通过URL地址访问到WSDL文件，在调用服务端之前先访问WSDL文件。读取到WSDL后通过客户端的API类可以生成代理类，调用这些代理类就可以访问webservice服务。代理类将客户端的方法变为soap（Simple Object Access Protocal，可以理解为http+xml）格式通过http发送，同时接受soap格式的返回值并解析。

依赖

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.apache.cxf</groupId><artifactId>cxf-spring-boot-starter-jaxws</artifactId><version>3.3.4</version></dependency>

创建实体类

/**
 * @author Fang Ruichuan
 * @date 2022-11-14 19:02
 */@Data@BuilderpublicclassUserDto{privateLong id;privateString name;privateInteger age;privateString address;}

创建WebService接口

/**
 * @author Fang Ruichuan
 * @date 2022-11-14 19:03
 */publicinterfaceIUserServer{defaultUserDtogetUser(Long str){thrownewRuntimeException("程序员正在马不停蹄地开发新功能");}}

创建WebService接口的实现类

/**
 * @author Fang Ruichuan
 * @date 2022-11-14 19:08
 */@Service@WebServicepublicclassUserServerImplimplementsIUserServer{@OverridepublicUserDtogetUser(Long id){returnUserDto.builder().id(id).address("上海市浦东新区").age(25).name("laJi").build();}}

这里用到了注解@WebService，我这就只在实现类上使用了。这里介绍一下，先来看下它的定义：

@Retention(RetentionPolicy.RUNTIME)@Target({ElementType.TYPE})public@interfaceWebService{Stringname()default"";StringtargetNamespace()default"";StringserviceName()default"";StringportName()default"";StringwsdlLocation()default"";StringendpointInterface()default"";}

• name: 对应wsdl:portType标签，默认值为Java类或接口的名称；
• targetNamespace: 命名空间，一般写为接口的包名倒序，默认值也是接口的包名倒序。对应wsd:definitions:targetNamespace 标签；
• serviceName: WebService的服务名称，对应wsdl:service，默认值为WebService接口实现类的名称+“Service”，示例：UserServiceImplServicce
• portName: 对应wsdl:port标签，默认值为:WebService接口实现类的名称+“Port”，示例：UserServiceImplPort
• wsdlLocation: 指定用于定义WebService的WSDL文档的地址
• endpoointInterfacce: WebService接口全路径

创建WebService配置类

@Configuration@RequiredArgsConstructorpublicclassCxfConfig{privatefinalIUserServer userServer;/**
     * 注入Servlet，注意beanName不能为dispatcherServlet
     * @author Fang Ruichuan
     * @date 2022/11/14 19:16
     */@BeanpublicServletRegistrationBeancxfServlet(){returnnewServletRegistrationBean(newCXFServlet(),"/webservice/*");}@Bean(name =Bus.DEFAULT_BUS_ID)publicSpringBusspringBus(){returnnewSpringBus();}@BeanpublicEndpointendpoint(){EndpointImpl endpoint =newEndpointImpl(springBus(), userServer);
        endpoint.publish("/api");return endpoint;}}

启动服务：

进行访问：http://localhost:8080/webservice

然后点击url

客户端

publicclassWebserviceClient{publicstaticvoidmain(String[] args){JaxWsDynamicClientFactory dcf =JaxWsDynamicClientFactory.newInstance();Client client = dcf.createClient("http://localhost:8080/webservice/api?wsdl");finalObjectMapper mapper =newObjectMapper();try{Object[] objects = client.invoke("getUser",99L);System.out.println(mapper.writeValueAsString(objects[0]));}catch(Exception e){
            e.printStackTrace();;}}}

显示：

{"address":"上海市浦东新区","age":25,"id":99,"name":"laJi"}