Soap从入门到实战

参考文章：https://howtodoinjava.com/spring-boot/spring-soap-client-webservicetemplate/

使用的技术：springboot + jaxb

一.soap是什么

网上是这样解释的：

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

我的理解是：

1.他是一种网络传输协议
2.他的基础是http
3.他传输内容不再是常用的文本而是xml

二.soap和http的差别

1.soap传输内容的是xml,http传输的内容是文本
2.soap的wsdl文件可以暴露访问对象的接口,调用者可以详细的看到访问对象的结构。http只能传输文本没有描述信息，前端如果需要接口信息需要后端使用第三方插件或者自己书写。

三.Wsdl

wsdl是Web Sercivice Descripe Language 的简称，也就是说他是描述Web服务的语言。描述的内容有服务的路由，方法名，返回值等等。

四.Wsdl基本结构

<?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>

Envelope是强制使用的，我认为是一种引用的约束吧，强调我们的xml内容定义为soap消息

五.soap实列

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://www.definesys.com/xml/employee"

           targetNamespace="http://www.definesys.com/xml/employee" elementFormDefault="qualified">

    <xs:element name="EmployeeDetailRequest">

        <xs:complexType>

            <xs:sequence>

               <xs:element name="Employee" type="tns:Employee"></xs:element>

            </xs:sequence>

        </xs:complexType>

    </xs:element>

    <xs:element name="EmployeeDetailResponse">

        <xs:complexType>

            <xs:sequence>

                <xs:element name="Employee" type="tns:Employee"></xs:element>

            </xs:sequence>

        </xs:complexType>

    </xs:element>

    <xs:complexType name="Employee">

        <xs:sequence>

            <xs:element name="code" type="xs:string"></xs:element>

            <xs:element name="name" type="xs:string"></xs:element>

            <xs:element name="email" type="xs:string"></xs:element>

        </xs:sequence>

    </xs:complexType>

</xs:schema>

namespace:http://www.definesys.com/xml/employee 自己取的

targetNamespace="http://www.definesys.com/xml/employee" 自己定义的

EmployeeDetailRequest:访问的入口，其中的内容是访问时需要的参数

EmployeeDetailResponse:返回的出口，其中的内容是返回时返回的参数

六.使用Springboot实战

1.建立一个Web Service

File-------> New------->Project-------->Spring Initializer ------>web,web service

2.导入jaxb依赖生成pojo等对象

1.向pom中添加如下内容

 <!--插件-->

            <plugin>

                <groupId>org.codehaus.mojo</groupId>

                <artifactId>jaxb2-maven-plugin</artifactId>

                <version>1.6</version>

                <executions>

                    <execution>

                        <id>xjc</id>

                        <goals>

                            <goal>xjc</goal>

                        </goals>

                    </execution>

                </executions>

                <configuration>

                    <schemaDirectory>${project.basedir}/src/main/resources/</schemaDirectory>

                    <!--<schemaFiles>employee.xsd</schemaFiles>-->

                    <outputDirectory>${project.basedir}/src/main/java</outputDirectory>

                    <packageName>com.example.webservice.entity</packageName>

                    <clearOutputDir>false</clearOutputDir>

                </configuration>

            </plugin>

${project.basedir}/src/main/java: 定义输出文件的根目录

com.example.webservice.entity ：生成pojo的包名称

false是否清空包目录

生成的pojo如下：

Employee：真实的普通java对象

EmployeeDetailRequest: 封装了Emploee可以将请求中的soap对象解析成普通的Employee对象

EmployeeDetaiResponse: 将普通的Employee对象封装成Soap对象

package-info.java:绑定输出对象的命名空间

3.相关注释的解释

@XmlAccessorType(XmlAccessType.FIELD)

定义类级别，将类的字段都写到xml中

@XmlType(name = "Employee", propOrder = {    "code",    "name",    "email"})

类定义级别，定义字段写到xml中的顺序

@XmlElement(required = true)

字段定义级别，将字段写入到xml中

@XmlRootElement(name = "EmployeeDetailRequest")

类定义级别，name指的是映射到xml时的名称

4.写一个配置文件来生成wsdl

package com.example.webservice.config;

import org.springframework.beans.factory.parsing.DefaultsDefinition;

import org.springframework.boot.web.servlet.ServletRegistrationBean;

import org.springframework.context.ApplicationContext;

import org.springframework.context.annotation.Bean;

import org.springframework.context.annotation.Configuration;

import org.springframework.core.io.ClassPathResource;

import org.springframework.ws.config.annotation.EnableWs;

import org.springframework.ws.config.annotation.WsConfigurerAdapter;

import org.springframework.ws.transport.http.MessageDispatcherServlet;

import org.springframework.ws.wsdl.WsdlDefinition;

import org.springframework.ws.wsdl.wsdl11.DefaultWsdl11Definition;

import org.springframework.xml.xsd.SimpleXsdSchema;

import org.springframework.xml.xsd.XsdSchema;

@EnableWs

@Configuration

public class WebServiceConfig extends WsConfigurerAdapter {

    @Bean

    public ServletRegistrationBean messageDispathcherServlet(ApplicationContext applicationContext){

        MessageDispatcherServlet servlet=new MessageDispatcherServlet();

        servlet.setApplicationContext(applicationContext);

        servlet.setTransformWsdlLocations(true);

        return  new ServletRegistrationBean(servlet,"/cms/*");

    }

    @Bean(name="employee")

    public WsdlDefinition defaultWsdl11Defination(XsdSchema employeeSchema){

        DefaultWsdl11Definition wsdl=new DefaultWsdl11Definition();

        wsdl.setPortTypeName("EmployeePort");

        wsdl.setLocationUri("/cms/employee-detail");

        wsdl.setTargetNamespace("http://www.definesys.com/xml/employee");

        wsdl.setSchema(employeeSchema);

        return wsdl;

    }

    @Bean

    public XsdSchema employeeSchema(){

        return new SimpleXsdSchema(new ClassPathResource("employee.xsd"));

    }

}

messageDispathcherServlet:方法中指定我们项目访问的路径的根路径

defaultWsdl11Defination：将我们书写的不完整的xsd文件书写成一个完成的wsdl并返回这个wsdl文件，在其中添加了PortTypeName(似乎没什么用,l类似于端口号），LocationUri(路径），TargetNamespace(没什么大用)

employeeSchema：返回我们自己写的xsd文件

@bean：将我们的wsdl对象注入到spring容器其中name是我们url访问的路径，因此我访问的employee.wsdl的路径是http://localhost:9999/cms/employee.wsdl

5.书写我们的终端

package com.example.webservice.controller;

import com.example.webservice.entity.Employee;

import com.example.webservice.entity.EmployeeDetailRequest;

import com.example.webservice.entity.EmployeeDetailResponse;

import org.springframework.ws.server.endpoint.annotation.Endpoint;

import org.springframework.ws.server.endpoint.annotation.PayloadRoot;

import org.springframework.ws.server.endpoint.annotation.RequestPayload;

import org.springframework.ws.server.endpoint.annotation.ResponsePayload;

@Endpoint

public class EmploySoapController {

    private static final  String NAMESPACE_URI="http://www.definesys.com/xml/employee";

    @PayloadRoot(namespace = NAMESPACE_URI,localPart = "EmployeeDetailRequest")

    @ResponsePayload

    public EmployeeDetailResponse getEmployee1(@RequestPayload EmployeeDetailRequest request){

        EmployeeDetailResponse response=new EmployeeDetailResponse();

        Employee employee=new Employee();

        employee.setCode(2);

        employee.setName(2);

        employee.setEmail(2);

        response.setEmployee(employee);

        return  response;

    }

}

@PayloadRoot:namespace 指定我们的命名空间，客户端和服务端需要保持一致。localPart：在wsdl中访问的接口名，需要和wsdl中接口的名称一致，客户端访问的localPart也必须和wsdl中的接口一致。

@ResponsePayload 说明输出的是一个soap消息，和@ResponseBody有点类似

@RequesPayLoad 说明输入的是一个soap消息和RequestBody类似

6.测试

1.下载soapui并安装

2.新建一个soap项目

3.添加一个wsdl文件

4.输入wsdl的路径，我的是下图路径,如果报错可以去浏览器看看能不能打开，不能就检查路径是否正确

http://localhost:9999/cms/employee.wsdl。没有改端口的朋友默认是8080

5.在request中输入内容,输出就是相应逻辑的输出

输出结果：

6.客户端访问：url填写wsdl的路径即可，localpart填写：相应的访问接口的localPart即可