Webservice详解

深碍√TFBOYSˉ_ 2022-12-29 09:16 186阅读 0赞

## 什么是Webservice ##

WebService是一个SOA（面向服务的编程）的架构，它是不依赖于语言，不依赖于平台，可以实现不同的语言间的相互调用，通过Internet进行基于Http协议的网络应用间的交互。 其实WebService并不是什么神秘的东西，它就是一个可以远程调用的类，或者说是组件，把你本地的功能开放出去共别人调用。

# HttpClient和WebService的区别 #

二者都是调用对方服务接口，区别在于：

1.  **HttpClient用来调用服务，它是模拟一个浏览器，发送Http的请求，服务器会返回请求的一个响应结果，Httpclient然后把响应的结果取出来。HttpClinet相当于一个客户端，使用Http协议调用系统中的方法或者接口。**
2.  **webService是使用soap协议而不是Http协议。**

### 什么是**soap协议** ###

SOAP 是基于 XML 的简易协议，可使应用程序在 HTTP 之上进行信息交换。或者更简单地说：SOAP 是用于访问网络服务的协议。

SOAP 消息实列：

<?xml version="1.0"?>
    <soap:Envelope
    xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
    soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">
    
    <soap:Header>
      ...
      ...
    </soap:Header>
    
    <soap:Body>
      ...
      ...
      <soap:Fault>
        ...
        ...
      </soap:Fault>
    </soap:Body>
    
    </soap:Envelope>

xml元素详解：[https://www.runoob.com/soap/soap-intro.html][https_www.runoob.com_soap_soap-intro.html]

## SpringBoot使用CXF集成WebService ##

### 添加依赖 ###

<dependency>
                <groupId>org.apache.cxf</groupId>
                <artifactId>cxf-rt-frontend-jaxws</artifactId>
                <version>3.1.6</version>
            </dependency>
            <dependency>
                <groupId>org.apache.cxf</groupId>
                <artifactId>cxf-rt-transports-http</artifactId>
                <version>3.1.6</version>
            </dependency>
    
            
            <dependency>
                <groupId>org.apache.axis</groupId>
                <artifactId>axis</artifactId>
                <version>1.4</version>
            </dependency>
            <dependency>
                <groupId>org.apache.axis</groupId>
                <artifactId>axis-jaxrpc</artifactId>
                <version>1.4</version>
            </dependency>
            <dependency>
                <groupId>commons-discovery</groupId>
                <artifactId>commons-discovery</artifactId>
                <version>0.2</version>
            </dependency>

### 创建服务端接口 ###

@WebService(name = "DemoWebService", // 暴露服务名称
            targetNamespace = "http://service.webservicedemo.example.com"// 命名空间,一般是接口的包名倒序
    )
    public interface  DemoWebService {
    
        String sayHello(String message);
    
    }

### 服务端接口实现 ###

@WebService(
            serviceName = "DemoService", // 与接口中指定的name一致
            targetNamespace = "http://service.webservicedemo.example.com", // 与接口中的命名空间一致,一般是接口的包名倒
            endpointInterface = "com.example.webservicedemo.service.DemoWebService" // 接口地址
    )
    public class DemoWebServiceImpl implements DemoWebService {
        @Override
        public String sayHello(String message) {
            return message+"，现在时间："+"("+new Date()+")";
        }
    }

### CXF配置 ###

@Configuration
    public class CxfConfig {
    
        @Bean
        public ServletRegistrationBean createServletRegistrationBean() {
            return new ServletRegistrationBean(new CXFServlet(),"/demo/*");
        }
    
        @Bean(name = Bus.DEFAULT_BUS_ID)
        public SpringBus springBus() {
            return new SpringBus();
        }
    
        @Bean
        public DemoWebService demoService() {
            return new DemoWebServiceImpl();
        }
    
        @Bean
        public Endpoint endpoint() {
            EndpointImpl endpoint = new EndpointImpl(springBus(), demoService());
            endpoint.publish("/api");
            return endpoint;
        }
    
    }

## 启动SpringBoot服务 ##

输入[http://localhost:8090/demo/api?wsdl][http_localhost_8090_demo_api_wsdl]即可

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2MzU3MjQy_size_16_color_FFFFFF_t_70][]

### 使用单元测试模拟客户端 ###

**方式一 使用cxf模拟请求**

@SpringBootTest
    class WebServiceDemoApplicationTests {
    
        @Test
        void contextLoads1() {
    
            //创建动态客户端
            JaxWsDynamicClientFactory factory = JaxWsDynamicClientFactory.newInstance();
            Client client = factory.createClient("http://localhost:8090/demo/api?wsdl");
            // 需要密码的情况需要加上用户名和密码
            //client.getOutInterceptors().add(new ClientLoginInterceptor(USER_NAME,PASS_WORD));
            HTTPConduit conduit = (HTTPConduit) client.getConduit();
            HTTPClientPolicy httpClientPolicy = new HTTPClientPolicy();
            httpClientPolicy.setConnectionTimeout(2000);  //连接超时
            httpClientPolicy.setAllowChunking(false);    //取消块编码
            httpClientPolicy.setReceiveTimeout(120000);     //响应超时
            conduit.setClient(httpClientPolicy);
            //client.getOutInterceptors().addAll(interceptors);//设置拦截器
            try{
                Object[] objects = new Object[0];
                // invoke("方法名",参数1,参数2,参数3....);
                objects = client.invoke("sayHello", "xxx");
                System.out.println("返回数据:" + objects[0]);
            }catch (Exception e){
                e.printStackTrace();
            }
        }
    }

运行结果

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2MzU3MjQy_size_16_color_FFFFFF_t_70 1][]

**方式二 使用axis模拟请求**

@SpringBootTest
    class WebServiceDemoApplicationTests {
    
        @Test
        void contextLoads2() throws ServiceException, RemoteException, MalformedURLException {
            Service service = new Service();
            Call call = (Call) service.createCall();
    
            call.setTargetEndpointAddress(new URL("http://localhost:8090/demo/api?wsdl"));
            call.setOperationName(new QName("http://service.webservicedemo.example.com","sayHello"));
    
    
    //        call.setUseSOAPAction(true);
    //        call.setSOAPActionURI("http://service.webservicedemo.example.com"+"sayHello");
            call.addParameter(new QName("http://service.webservicedemo.example.com", "message"), XMLType.XSD_STRING, ParameterMode.IN);
            call.setReturnType(XMLType.XSD_STRING);
            call.setTimeout(10000);
            call.setEncodingStyle("utf-8");
            //设置命名空间和需要调用的方法名
    
            Object invoke = call.invoke(new Object[]{"xxx"});
            System.out.println(invoke.toString());
    
        }
    }

运行时，会报一个元素错误

意外的元素 (uri:"http://service.webservicedemo.example.com", local:"message")。所需元素为<\{\}message>

![20201222165622926.png][]

需要暴露服务端的接口以及参数。

@WebService(name = "DemoWebService", // 暴露服务名称
            targetNamespace = "http://service.webservicedemo.example.com"// 命名空间,一般是接口的包名倒序
    )
    public interface  DemoWebService {
        //暴露接口 参数
        @WebMethod
        String sayHello(@WebParam(name = "message",targetNamespace = "http://service.webservicedemo.example.com") String message);
    
    }

运行结果

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2MzU3MjQy_size_16_color_FFFFFF_t_70 2][]

[https_www.runoob.com_soap_soap-intro.html]: https://www.runoob.com/soap/soap-intro.html
[http_localhost_8090_demo_api_wsdl]: http://localhost:8090/demo/api?wsdl
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2MzU3MjQy_size_16_color_FFFFFF_t_70]: /images/20221120/d7a45fce07304e6098c3d446c0ac0457.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2MzU3MjQy_size_16_color_FFFFFF_t_70 1]: /images/20221120/72246d7c2ac74c77915b01e356138c56.png
[20201222165622926.png]: /images/20221120/7a284036f0e049e7a2d08031ce09a0ef.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2MzU3MjQy_size_16_color_FFFFFF_t_70 2]: /images/20221120/8c848fe4df6548019598001af6d4d861.png