调用方集成WebService

太过爱你忘了你带给我的痛 2022-09-02 15:50 87阅读 0赞

### 文章目录 ###

*  1.介绍
 *  2.方案一
 *   *  2.1.JAX-WS maven
     *   *  2.1.1.配置maven插件
         *  2.1.2.WSDL 目录配置
         *  2.1.3. WSDL 目录下文件配置
         *  2.1.4. WSDL URL 配置
         *  2.1.5. 配置生成的类目录
         *  2.1.6.样例
 *  3.方案二
 *   *  3.1使用SoapUI解析WSDL地址
     *  3.2样例
 *  4.附

# 1.介绍 #

相关基础概念不过多介绍，如需了解，可自行百度。

在接口对接当中，WebService接口占有着很大份额，本篇文章主要介绍调用如何集成webservice进行方便的调用。

# 2.方案一 #

## 2.1.JAX-WS maven ##

JAX-WS maven 插件从 WSDL（Web 服务描述语言）文件生成 Java 类。 生成的类轻松调用 Web Services。

### 2.1.1.配置maven插件 ###

在 pom.xml 文件的 build plugins 部分配置 JAX-WS Maven 插件和 wsimport ：

<build>
        <plugins>
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>jaxws-maven-plugin</artifactId>
                <version>2.6</version>
                <executions>
                    <execution>
                        <goals>
                            <goal>wsimport</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

总之，wsimport 生成用于 JAX-WS 客户端和服务的 JAX-WS 的代码。 该工具读取 WSDL 文件并生成 Web 服务开发、部署和调用所需的所有代码。

### 2.1.2.WSDL 目录配置 ###

在 Maven 插件部分，wsdlDirectory 配置属性配置WSDL 文件所在的位置。 在这个例子中，告诉插件获取从项目的 src/main/resources 目录中的所有 WSDL 文件：

<plugin>
        ...
        <configuration>
            <wsdlDirectory>${project.basedir}/src/main/resources/</wsdlDirectory>
        </configuration>
    </plugin>

### 2.1.3. WSDL 目录下文件配置 ###

可以使用 wsdlFiles 配置属性来定义生成类时要考虑的 WSDL 文件列表：

<plugin>
        ...
        <configuration>
            <wsdlDirectory>${project.basedir}/src/main/resources/</wsdlDirectory>
            <wsdlFiles>
                <wsdlFile>file1.wsdl</wsdlFile>
                <wsdlFile>file2.wsdl</wsdlFile>
                ...
            </wsdlFiles>
        </configuration>
    </plugin>

当未设置 wsdlFiles 属性时，将 使用wsdlDirectory 属性指定的目录中的所有文件。

### 2.1.4. WSDL URL 配置 ###

可以配置插件的 wsdlUrl 配置属性：

<plugin>
        ...
        <configuration>
            <wsdlUrls>
                <wsdlUrl>http://localhost:8888/ws/country?wsdl</wsdlUrl>
            ...
            </wsdlUrls>
        </configuration>
    </plugin>

要使用此选项，WSDL 文件 URL 的服务器必须启动并运行，以便插件可以读取它。

### 2.1.5. 配置生成的类目录 ###

在 packageName 属性中，可以设置生成的类包名，以及在 sourceDestDir 中，输出目录：

<plugin>
        ...
        <configuration>
            <packageName>com.koal.soap.ws.client</packageName>
            <sourceDestDir>${project.basedir}/src/main/java/</sourceDestDir>
        </configuration>   
    </plugin>

### 2.1.6.样例 ###

样例以wsdl url为例进行演示。

<plugin>
                    <groupId>org.codehaus.mojo</groupId>
                    <artifactId>jaxws-maven-plugin</artifactId>
                    <version>2.6</version>
                    <executions>
                        <execution>
                            <goals>
                                <goal>wsimport</goal>
                            </goals>
                        </execution>
                    </executions>
                    <configuration>
                        <wsdlDirectory>${project.basedir}/src/main/resources/</wsdlDirectory>
                        <packageName>com.niugang.soap.ws.client</packageName>
                        <sourceDestDir>${project.basedir}/src/main/java/</sourceDestDir>
                        <wsdlUrls>
                        <wsdlUrl>http://localhost:8080/ws/countries.wsdl</wsdlUrl>
                        </wsdlUrls>
                    </configuration>
                </plugin>

执行

> mvn clean install

生成代码

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L25pdWdhbmcwOTIw_size_16_color_FFFFFF_t_70_pic_center]

单元测试：

@Test
        public void test1(){ 
            EmployeeServiceService employeeServiceService = new EmployeeServiceService();
            IEmployeeService employeeServicePort = employeeServiceService.getEmployeeServicePort();
            String s = employeeServicePort.oemUserInfo("1", "1", "1", "1", "1", "1", "1", "1", "1", "1");
            System.out.println(s);//{"errmemo":"当前人员所在部门不存在或获取部门信息错误,同步失败!","errcode":"500114"}
        }
    
        @Test
        public void test1_1(){ 
            OrgServiceService orgServiceService = new OrgServiceService();
            IOrgService orgService = orgServiceService.getOrgServicePort();
            String s = orgService.oemOrgOperate("1", "1", "1", "1", "1", "1", "1", "1");
            System.out.println(s);//{"errmemo":"新增OEM组织失败","errcode":"500073"}
        }

# 3.方案二 #

使用[Soap客户端-SoapClient][Soap_-SoapClient]

## 3.1使用SoapUI解析WSDL地址 ##

maven依赖

<dependency>
        <groupId>cn.hutool</groupId>
        <artifactId>hutool-all</artifactId>
        <version>5.7.6</version>
    </dependency>

> Soap Ui 下载地址
> 
> 链接：https://pan.baidu.com/s/1OOb0ScivoUdaFG74x9OJ2A  
> 提取码：kizv

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L25pdWdhbmcwOTIw_size_16_color_FFFFFF_t_70_pic_center 1]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L25pdWdhbmcwOTIw_size_16_color_FFFFFF_t_70]

1.  方法名为：ser:oemUserInfo
2.  参数只有一个，为

*  adaccount
 *  empname
 *  mobile
 *  empemail
 *  emprolecode
 *  emprole
 *  managebrand
 *  orgcode
 *  dlmaccount
 *  empstatus

3.定义了一个命名空间，前缀为ser，URI为http://xxx.xxx.xxx.com/

## 3.2样例 ##

单元测试

@Test
        public void test5(){ 
            SoapClient client = SoapClient.create("http://xxxxx/services/oememployee")
                    // 设置要请求的方法，此接口方法前缀为web，传入对应的命名空间
                    .setMethod("ser:oemUserInfo", "http://xxx.xxx.xxx.com/")
                    // 设置参数，此处自动添加方法的前缀：web
                    .setParam("adaccount", 1)
                    .setParam("empname", 1)
                    .setParam("mobile", 1)
                    .setParam("empemail", 1)
                    .setParam("emprolecode", 1)
                    .setParam("emprole", 1)
                    .setParam("managebrand", 1)
                    .setParam("orgcode", 1)
                    .setParam("dlmaccount", 1)
                    .setParam("empstatus", 1)
                    ;
            // 发送请求，参数true表示返回一个格式化后的XML内容
            // 返回内容为XML字符串，可以配合XmlUtil解析这个响应
            String send = client.send(true);
            System.out.println(send);
        }

返回结果

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
      <S:Body>
        <ns2:oemUserInfoResponse xmlns:ns2="http://xxx.xxx.xxx.com/">
          <return>{"errmemo":"参数员工所属部门编码为空，无法进行同步","errcode":"500092"}</return>
        </ns2:oemUserInfoResponse>
      </S:Body>
    </S:Envelope>

# 4.附 #

[Spring Boot集成WebService][Spring Boot_WebService]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L25pdWdhbmcwOTIw_size_16_color_FFFFFF_t_70_pic_center]: /images/20220829/e6012b16d896421dae19a2a168c5d878.png
[Soap_-SoapClient]: https://hutool.cn/docs/#/http/WebService/Soap%E5%AE%A2%E6%88%B7%E7%AB%AF-SoapClient?id=soap%E5%AE%A2%E6%88%B7%E7%AB%AF-soapclient
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L25pdWdhbmcwOTIw_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20220829/8729979ac1524834a50d116479a40d0f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L25pdWdhbmcwOTIw_size_16_color_FFFFFF_t_70]: /images/20220829/426b6d5f13c54fb7ba3531fc5f2f96f4.png
[Spring Boot_WebService]: https://gitee.com/niugangxy/springboot-webservice