@alanwang-merit/meritdata-platform-skill-package 1.0.0

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/.bak//345/272/224/347/224/250/345/274/200/345/217/221/345/271/263/345/217/260-/345/237/272/347/241/200/345/271/263/345/217/260-/344/275/277/347/224/250/346/224/273/347/225/245/357/274/210/344/271/235/357/274/211/357/274/232/347/273/204/347/273/207/345/222/214/344/272/272/345/221/230/345/220/214/346/255/245.md

@@ -0,0 +1,912 @@
+---
+title: 应用开发平台使用攻略（三）：组织和人员同步
+date: 2025.05.28
+categories:
+  - 开发攻略
+  - 6.13.2
+---
+
+# 应用开发平台使用攻略（九）：组织和人员同步
+
+## 1. 概述
+
+客户或开发人员在使用数据应用开发平台前，需要将其外部系统的组织人员信息整合移植到数据应用开发平台中。为了避免繁琐的数据录入，平台提供了的组织同步、人员同步、资源同步、角色同步、权限同步功能，这些功能大大简化了数据移植的过程。本文档将对以上同步功能的实现方式和步骤做详细讲解。
+
+由于同步数据涉及到关系数据的问题，我们建议同步顺序为：同步组织 =》 同步角色 =》 同步人员 =》 同步资源 =》 同步资源权限。
+
+同步所用到的所有标签来源于 系统管理 -> 基础配置 ->  组织人员同步 页签，可在对应的页签查询对应的标签的意义和用法。
+
+## 2. 组织同步
+
+组织同步有两种实现方式：webservice 同步方式、调用 RESTful API 同步，在该文档中会对这两种实现方式做出详细的介绍。依据文档《应用开发平台使用攻（一）：系统环境搭建》搭建一个简单的后端工程，在 pom 文件的< dependencies></ dependencies>中添加如下依赖
+
+```xml
+<!-- webservice方式实现所需依赖 -->
+<dependency>
+    <groupId>org.apache.cxf</groupId>
+    <artifactId>cxf-spring-boot-starter-jaxws</artifactId>
+    <version>3.2.4</version>
+    <exclusions>
+        <exclusion>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-tomcat</artifactId>
+        </exclusion>
+    </exclusions>
+</dependency>
+<!--导入RSAUTils所需jar包 RESTfulAPI实现所需依赖-->
+<dependency>
+    <groupId>commons-codec</groupId>
+    <artifactId>commons-codec</artifactId>
+    <version>1.11</version>
+</dependency>
+<dependency>
+  <groupId>org.apache.cxf</groupId>
+  <artifactId>cxf-rt-frontend-jaxws</artifactId>
+  <version>3.5.9</version>
+</dependency>
+<dependency>
+  <groupId>org.apache.cxf</groupId>
+  <artifactId>cxf-rt-transports-http</artifactId>
+  <version>3.5.9</version>
+</dependency>
+```
+
+使用6.13.2版本需要使用如下依赖
+
+```xml
+<dependency>
+  <groupId>org.apache.cxf</groupId>
+  <artifactId>cxf-rt-frontend-jaxws</artifactId>
+  <version>4.1.1</version>
+</dependency>
+<dependency>
+  <groupId>org.apache.cxf</groupId>
+  <artifactId>cxf-rt-transports-http</artifactId>
+  <version>4.1.1</version>
+</dependency>
+```
+
+### 2.1 实现方式
+
+#### 2.1.1 webservice 实现 Demo
+
+适用于在第三方系统中实现同步功能时或在外部系统上实现同步功能时调用平台的 webService 服务。
+
+| webService 地址                                    | 方法名  | 参数       | 返回值                               |
+| -------------------------------------------------- | ------- | ---------- | ------------------------------------ |
+| http://网关地址/应用名称/ws/syncOrgWebService?wsdl | syncOrg | xml 字符串 | 全部成功返回“1”有数据无法同步返回“0” |
+
+##### 2.1.1.1 批量同步（推荐）
+
+**应用开发平台支持单独同步组织和批量同步组织，为减少同步组织时出现组织层级出现错乱和内存溢出等问题，平台推荐大家使用批量同步操作，使用批量同步操作时，按照以下代码案例进行组织层级的封装即可，例如：需要同步的第一级组织为同步机构，第二级为同步机构_子机构，在xml中，第一级ORG_CODE为syncCode，父级ORG_PARENT_CODE为merit(根据现场实际填写，必填项，下文组织同步的配置说明中有各个字段的定义和是否必填说明)；第二级机构ORG_CODE为syncCode_sub，父级ORG_PARENT_CODE为syncCode（上级的code），并且注意组装xml时上级机构必须在下级机构前面。**
+
+**将下面代码直接复制到项目的 Java 包中（注意修改父部门编码）**
+
+案例代码：
+
+```java
+public static void main(String[] args) {
+        JaxWsDynamicClientFactory dcf=JaxWsDynamicClientFactory.newInstance();
+        Client client = dcf.createClient("http://localhost:8081/cloud-system-manage/ws/syncOrgWebService?wsdl");
+        String parameterValues="<ROOT>"
+                + "<ORG>"
+                + "<ORG_CODE>syncOrg</ORG_CODE>"
+                + "<ORG_PARENT_CODE>merit</ORG_PARENT_CODE>"
+                + "<ORG_NAME>同步机构</ORG_NAME>"
+                + "<ORG_SIMPLENAME>同步</ORG_SIMPLENAME>"
+                + "<ORG_DLEVEL>1</ORG_DLEVEL>"
+                + "<ORG_IS_ABLE>1</ORG_IS_ABLE>"
+                + "<ORG_SORT>1</ORG_SORT>"
+                + "<ORG_REMARK>备注说明</ORG_REMARK>"
+                + "</ORG>"
+                +"<ORG>"
+                + "<ORG_CODE>syncOrg_sub</ORG_CODE>"
+                + "<ORG_PARENT_CODE>syncOrg</ORG_PARENT_CODE>"
+                + "<ORG_NAME>同步机构_子机构</ORG_NAME>"
+                + "<ORG_SIMPLENAME>同步2</ORG_SIMPLENAME>"
+                + "<ORG_DLEVEL>1</ORG_DLEVEL>"
+                + "<ORG_IS_ABLE>1</ORG_IS_ABLE>"
+                + "<ORG_SORT>1</ORG_SORT>"
+                + "<ORG_REMARK>备注说明</ORG_REMARK>"
+                + "</ORG>"+
+                "</ROOT>";
+        Object[] results = new Object[0];
+        try {
+            results = client.invoke("syncOrg", parameterValues);
+        } catch (Exception e) {
+            throw new RuntimeException(e);
+        }
+        for (Object result : results) {
+            System.out.println(result.toString());
+        }
+
+    }
+```
+
+##### 2.1.1.2单独同步
+
+```java
+public static void main(String[] args) {
+        JaxWsDynamicClientFactory dcf=JaxWsDynamicClientFactory.newInstance();
+        Client client = dcf.createClient("http://localhost:8081/cloud-system-manage/ws/syncOrgWebService?wsdl");
+        String parameterValues="<ROOT>"
+                + "<ORG>"
+                + "<ORG_CODE>syncOrg</ORG_CODE>"
+                + "<ORG_PARENT_CODE>merit</ORG_PARENT_CODE>"
+                + "<ORG_NAME>同步机构</ORG_NAME>"
+                + "<ORG_SIMPLENAME>同步</ORG_SIMPLENAME>"
+                + "<ORG_DLEVEL>1</ORG_DLEVEL>"
+                + "<ORG_IS_ABLE>1</ORG_IS_ABLE>"
+                + "<ORG_SORT>1</ORG_SORT>"
+                + "<ORG_REMARK>备注说明</ORG_REMARK>"
+                + "</ORG>"
+                +"<ORG>"
+                + "<ORG_CODE>syncOrg_sub</ORG_CODE>"
+                + "<ORG_PARENT_CODE>syncOrg</ORG_PARENT_CODE>"
+                + "<ORG_NAME>同步机构_子机构</ORG_NAME>"
+                + "<ORG_SIMPLENAME>同步2</ORG_SIMPLENAME>"
+                + "<ORG_DLEVEL>1</ORG_DLEVEL>"
+                + "<ORG_IS_ABLE>1</ORG_IS_ABLE>"
+                + "<ORG_SORT>1</ORG_SORT>"
+                + "<ORG_REMARK>备注说明</ORG_REMARK>"
+                + "</ORG>"+
+                "</ROOT>";
+        Object[] results = new Object[0];
+        try {
+            results = client.invoke("syncOrg", parameterValues);
+        } catch (Exception e) {
+            throw new RuntimeException(e);
+        }
+        for (Object result : results) {
+            System.out.println(result.toString());
+        }
+
+    }
+```
+
+- 运行后结果如下：
+  ![image](/imgs/组织人员同步/1-1.jpg)
+  ![image](/imgs/组织人员同步/1-2.jpg)
+  
+- 以下是 webservice 实现的一个修改操作演示示例（将同步机构 1 名称替换为“技术研发部”）。
+
+  ```java
+  import org.apache.cxf.endpoint.Client;
+  import org.apache.cxf.jaxws.endpoint.dynamic.JaxWsDynamicClientFactory;
+  
+  public class UpdateSyncOrgTest {
+      public static void main(String[] args) {
+          try {
+              JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
+              Client client = dcf.createClient("http://localhost:8081/cloud-system-manage/ws/syncOrgWebService?wsdl");
+              String parameterValues="<ROOT>"
+                      + "<ORG>"
+                      + "<ORG_CODE>syncOrg</ORG_CODE>"
+                      + "<ORG_NAME>技术研发部</ORG_NAME>"
+                      + "</ORG>"+
+                      "</ROOT>";
+              Object[] results = client.invoke("syncOrg", parameterValues);
+              for (Object result : results) {
+                  System.out.println(result.toString());
+              }
+          }
+          catch (Exception e) {
+              e.printStackTrace();
+          }
+      }
+  }
+  ```
+  
+- 修改只需将编码和所需修改的字段传入即可。运行后"同步机构"修改为"技术研发部"。
+  ![image](/imgs/组织人员同步/1-3.jpg)
+
+#### 2.1.2 RESTful API 实现 Demo
+
+- 在通过 RESTful 接口同步之前，需要先进行环境准备工作：
+
+  - 在通过《系统环境搭建》文档搭建的工程中，粘贴如下代码
+
+    ```java
+    import org.apache.commons.codec.binary.Base64;
+    
+    import javax.crypto.Cipher;
+    import java.io.File;
+    import java.io.FileInputStream;
+    import java.io.ObjectInputStream;
+    import java.security.Key;
+    
+    public class RSAUtils {
+        private static String ALGORITHM = "RSA";
+        public static int KEYSIZE = 1024;
+        public static String ENCODE = "UTF-8";
+        public static String encrypt(String source, String path) throws Exception {
+            ObjectInputStream ois = new ObjectInputStream(new FileInputStream(path + File.separator +"public.pem"));
+            Key key = (Key) ois.readObject();
+            ois.close();
+            Cipher cipher = Cipher.getInstance(ALGORITHM);
+            cipher.init(1, key);
+            byte[] b = source.getBytes();
+            byte[] b1 = cipher.doFinal(b);
+            return new String(Base64.encodeBase64(b1), ENCODE);
+        }
+    }
+    ```
+
+    ```java
+    public class Main {
+    public static void main(String[] args) throws Exception {
+            //修改public.pem的文件存储路径(公钥地址)
+            String cloudHome = "C:\\Users\\merit\\Desktop";
+            /**
+             * 证书Secret:a6267d4217474727829bf591b172b2c7
+             * 分隔符号：-
+            */
+            String token= RSAUtils.encrypt("a6267d4217474727829bf591b172b2c7-" + System.currentTimeMillis(),cloudHome);
+            System.out.println(token);
+        }
+    }
+    ```
+
+这两段代码的作用是生成在调用 RESTful API 需要的 app-token,RSAUtils 类是用来对内容进行加密，Main 类作用是生成 app-token，其中<font color="red">证书 Secret</font>内容是在登录应用开发平台后，在服务管理中的证书管理中获取，如图所示：
+![image](./imgs/组织人员同步/1-10.jpg)
+
+- 使用类似 Postman 接口测试工具，在地址栏中输入http://localhost:8081/cloud-system-manage/webapi/+同步服务接口，接口URL在服务管理中的接口管理中查看
+  ![image](/imgs/组织人员同步/1-11.jpg)
+  
+- 通过接口同步时，请求 Header 中需要携带三个参数，Content-Type、app-key、app-token
+  Content-Type: application/x-www-form-urlencoded
+  app-key: 在证书管理页面中获取
+  app-token: 在工程中手动创建(app-token 生效时间 1 分钟，超时后需要重新生成)
+  ![image](/imgs/组织人员同步/1-12.jpg)
+  
+  ##### 2.1.2.1批量同步（推荐）
+  
+- 组织机构同步 URL:http://localhost:8081/cloud-system-manage/webapi/ou/sync/org
+
+- param 中参数：orgInfo
+
+- xml 示例代码如下：与webService的xml同理：需要注意在xml中先组装父级，后组装子级，且子级机构的父级编码必须为父级的编码
+  ```xml
+  <ROOT><ORG><ORG_CODE>apiSyncOrg</ORG_CODE><ORG_PARENT_CODE>merit</ORG_PARENT_CODE><ORG_NAME>接口同步机构——父级</ORG_NAME><ORG_SIMPLENAME>接口同步</ORG_SIMPLENAME><ORG_DLEVEL>1</ORG_DLEVEL><ORG_IS_ABLE>1</ORG_IS_ABLE><ORG_SORT>1</ORG_SORT><ORG_REMARK>使RESTful API同步的机构-子级</ORG_REMARK></ORG><ORG><ORG_CODE>apiSyncOrg_sub</ORG_CODE><ORG_PARENT_CODE>apiSyncOrg</ORG_PARENT_CODE><ORG_NAME>接口同步机构3</ORG_NAME><ORG_SIMPLENAME>接口同步</ORG_SIMPLENAME><ORG_DLEVEL>1</ORG_DLEVEL><ORG_IS_ABLE>1</ORG_IS_ABLE><ORG_SORT>1</ORG_SORT><ORG_REMARK>使RESTful API同步的机构</ORG_REMARK></ORG></ROOT>
+  ```
+
+- Postman 中填写如下图所示：
+  ![image](/imgs/组织人员同步/1-13.jpg)
+  ![image](/imgs/组织人员同步/1-14.jpg)
+  
+- 运行结果如下：
+  ![image](/imgs/组织人员同步/1-15.jpg)
+  ![image](/imgs/组织人员同步/1-16.jpg)
+
+#### 2.1.3 注意事项
+
+- 无编码的部门不做任何操作，视为同步失败（失败之前的正确的组织数据会成功插入数据库，运行就此终止，之后的数据不会被运行）。
+  如果组织找不到父级部门信息，视为同步失败。
+  同步组织时，先通过组织编码查找组织信息，如果已经存在，则更新，如果不存在则新增。
+
+### 2.2 配置说明
+
+- 所传入的数据需按照组织同步配置中的规则，转化为 xml 字符串；默认规则如下：
+
+  | 字段名称     | 默认 XML 标签名(XPath) | 说明                                                         | 是否必填 |
+  | ------------ | ---------------------- | ------------------------------------------------------------ | -------- |
+  | 组织名称     | <ORG_NAME>             | 所添加组织的名称                                             | 是       |
+  | 组织编码     | <ORG_CODE>             | 所添加组织的编码，有唯一性校验                               | 是       |
+  | 父级组织编码 | <ORG_PARENT_CODE>      | 所添加组织的父级组织编码，为空时，默认为根节点编码           | 是       |
+  | 组织名称简称 | <ORG_SIMPLENAME>       | 所添加组织的简称                                             | 是       |
+  | 组织级别     | <ORG_DLEVEL>           | (0机构、1 部门)机构中无法维护人员信息，部门中无法维护角色信息，所以修改此字段时需特别注意 | 是       |
+  | 是否启用     | <ORG_IS_ABLE>          | 默认 1 为启用 0 为禁用                                       | 是       |
+  | 排序号       | <ORG_SORT>             | 根据排序号排列                                               | 是       |
+  | 备注         | <ORG_REMARK>           | 组织机构信息备注                                             | 否       |
+
+## 3. 人员同步
+
+### 3.1 实现方式
+
+#### 3.1.1 webservice 实现 Demo
+
+- 适用于在第三方系统中实现同步功能时或在外部系统上实现同步功能时调用平台的 webService 服务。
+
+  | webService 地址                                     | 方法名   | 参数       | 返回值                               |
+  | --------------------------------------------------- | -------- | ---------- | ------------------------------------ |
+  | http://网关地址/应用名称/ws/syncUserWebService?wsdl | syncUser | xml 字符串 | 全部成功返回“1”有数据无法同步返回“0” |
+
+- 以下是 webservice 实现的一个新增操作演示实例。
+
+  ```java
+  import org.apache.cxf.endpoint.Client;
+  import org.apache.cxf.jaxws.endpoint.dynamic.JaxWsDynamicClientFactory;
+  
+  public class SyncUserTest {
+      public static void main(String[] args) {
+          try {
+              JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
+              Client client = dcf.createClient("http://localhost:8081/cloud-system-manage/ws/syncUserWebService?wsdl");
+              String parameterValues = "<LIST>"
+                      + "<USER>"
+                      + "<RY_STAFFNAME>同步人员1</RY_STAFFNAME>"
+                      + "<RY_STAFFCODE>sync1</RY_STAFFCODE>"
+                      + "<RY_ISSEAL_V>1</RY_ISSEAL_V>"
+                      + "<RY_SEX>1</RY_SEX>"
+                      + "<RY_DEPARTMENTCODE>merit</RY_DEPARTMENTCODE>"
+                      + "<RY_WORKPHONE>02983145678</RY_WORKPHONE>"
+                      + "<RY_MOVEPHONE>13572943980</RY_MOVEPHONE>"
+                      + "<RY_EDUCATIONBG>本科</RY_EDUCATIONBG>"
+                      + "<ORG_SIMPLENAME>同步</ORG_SIMPLENAME>"
+                      + "<RY_PART_TIME_DEPARTMENTCODE>tempo,dmm,dam</RY_PART_TIME_DEPARTMENTCODE>"
+                  	+ "<RY_EMAIL>merit@merit.com</RY_EMAIL>"
+                      + "<RY_ORDER>1</RY_ORDER>"
+                      + "<RY_BIRTHDAY>2001-11-09</RY_BIRTHDAY>"
+                      + "<RY_SAFE_LEVEL>2</RY_SAFE_LEVEL>"
+                      + "<RY_ROLECODE></RY_ROLECODE>"
+                      + "</USER>"
+                      + "<USER>"
+                      + "<RY_STAFFNAME>同步人员2</RY_STAFFNAME>"
+                      + "<RY_STAFFCODE>sync2</RY_STAFFCODE>"
+                      + "<RY_ISSEAL_V>1</RY_ISSEAL_V>"
+                      + "<RY_SEX>1</RY_SEX>"
+                      + "<RY_DEPARTMENTCODE>merit</RY_DEPARTMENTCODE>"
+                      + "<ORG_SIMPLENAME>同步</ORG_SIMPLENAME>"
+                      + "<RY_PART_TIME_DEPARTMENTCODE>tempo,dmm,dam</RY_PART_TIME_DEPARTMENTCODE>"
+                  	+ "<RY_EMAIL>merit@merit.com</RY_EMAIL>"
+                      + "<RY_WORKPHONE>02988888888</RY_WORKPHONE>"
+                      + "<RY_MOVEPHONE>13389262116</RY_MOVEPHONE>"
+                      + "<RY_EDUCATIONBG>本科</RY_EDUCATIONBG>"
+                      + "<RY_ORDER>1</RY_ORDER>"         
+                      + "<RY_BIRTHDAY>2001-11-09</RY_BIRTHDAY>"
+                      + "<RY_SAFE_LEVEL>1</RY_SAFE_LEVEL>"
+                      + "</USER>"
+                      + "</LIST>";
+              Object[] results = client.invoke("syncUser", parameterValues);
+              for (Object result : results) {
+                  System.out.println(result.toString());
+              }
+          } catch (Exception e) {
+              e.printStackTrace();
+          }
+      }
+  }
+  
+  ```
+  
+- 运行后在“技研中心”部门新增“同步人员 1”，“同步人员 2”的信息。
+  ![image](/imgs/组织人员同步/1-4.jpg)
+
+- 与组织同步一样，如果人员编码在系统中已经存在，则更新人员，如果不存在，则为新增操作，若需要修改某人员信息，把它的编码和需要修改的项写成 xml 字符串传入即可。
+  以下是 webservice 实现的一个修改操作演示实例。
+
+  ```java
+  import org.apache.cxf.endpoint.Client;
+  import org.apache.cxf.jaxws.endpoint.dynamic.JaxWsDynamicClientFactory;
+  
+  public class UpdateSyncUserTest {
+      public static void main(String[] args) {
+          try {
+              JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
+              Client client = dcf.createClient("http://localhost:8081/cloud-system-manage/ws/syncUserWebService?wsdl");
+              String orgInfo = "<LIST>"
+                      + "<USER>"
+                      + "<RY_STAFFNAME>新用户</RY_STAFFNAME>"
+                      + "<RY_STAFFCODE>sync1</RY_STAFFCODE>"
+                      + "<RY_DEPARTMENTCODE>merit</RY_DEPARTMENTCODE>"
+                      + "</USER>" +
+                      "</LIST>";
+              Object[] results = client.invoke("syncUser", orgInfo);
+              for (Object result : results) {
+                  System.out.println(result.toString());
+              }
+          } catch (Exception e) {
+              e.printStackTrace();
+          }
+      }
+  }
+  ```
+
+- 运行后,将“同步人员 1”姓名修改为“新用户”
+  ![image](/imgs/组织人员同步/1-5.jpg)
+
+#### 3.1.2 RESTful API 实现 Demo
+
+- 注意事项：
+  - app-token 的生效时间只有一分钟，超时后需要重新生成，在同步人员时重新生成 app-token，再将参数值粘贴进去;
+  - header 中的参数配置，参考 2.1.2 中组织机构 RESTful API 同步中的配置
+- 人员同步 URL：http://localhost:8081/cloud-system-manage/webapi/ou/sync/user
+- param 参数：userInfo
+- 参数 xml 代码如下：
+  ```xml
+  <LIST><USER><RY_STAFFNAME>同步人员1</RY_STAFFNAME><RY_STAFFCODE>sync1</RY_STAFFCODE><ORG_SIMPLENAME>同步</ORG_SIMPLENAME><RY_PART_TIME_DEPARTMENTCODE>nengyuan,zhizao,chanpin</RY_PART_TIME_DEPARTMENTCODE><RY_EMAIL>merit@merit.com</RY_EMAIL><RY_ISSEAL_V>1</RY_ISSEAL_V><RY_SEX>1</RY_SEX><RY_DEPARTMENTCODE>merit</RY_DEPARTMENTCODE><RY_WORKPHONE>02988888888</RY_WORKPHONE><RY_MOVEPHONE>13389262116</RY_MOVEPHONE><RY_EDUCATIONBG>本科</RY_EDUCATIONBG><RY_ORDER>1</RY_ORDER><RY_BIRTHDAY>2001-11-09</RY_BIRTHDAY><RY_SAFE_LEVEL>1</RY_SAFE_LEVEL></USER></LIST>
+  ```
+- 执行结果如下
+  ![image](/imgs/组织人员同步/1-17.jpg)
+  ![image](/imgs/组织人员同步/1-18.jpg)
+
+#### 3.1.3 注意事项
+
+- 如果人员没有编码，不做任何操作，视为同步失败（失败之前的正确的组织数据会成功插入数据库，运行就此终止，之后的数据不会被运行）。
+  如果人员所属部门不存在，视为同步失败。
+  人员有禁用的标识为：
+
+- 如上图所示：user_status_flag 对应的 XPath 值为 1，这个值可以配置为任意值，当传递过来的启用禁用状态值与配置的该值相等时，则把该人员设置为禁用状态，比如，现在“人员禁用标志”是 1，外部传入值也是 1，人员即被设置为禁用状态。
+
+### 3.2 配置说明
+
+- 所传入的数据需按照组织同步配置中的规则，转化为 xml 字符串；默认规则如下：
+
+  | 字段名称      | 默认 XML 标签名               | 说明                                                         | 是否必填 |
+  | ------------- | ----------------------------- | ------------------------------------------------------------ | -------- |
+  | 名称          | <RY_STAFFNAME>                | 人员名称                                                     | 是       |
+  | 编码          | <RY_STAFFCODE>                | 人员编码，有唯一性校验                                       | 是       |
+  | 启用禁用状态  | <RY_ISSEAL_V>                 | 默认 0 为禁用、1 为启用                                      | 是       |
+  | 所在部门 code | <RY_DEPARTMENTCODE>           | 所在部门编码，如部门不存在则操作失败                         | 是       |
+  | 工作电话      | <RY_WORKPHONE>                | 电话                                                         | 否       |
+  | 性别          | <RY_SEX>                      | 默认 1 为男性 0 为女性                                       | 否       |
+  | 出生日期      | <RY_BIRTHDAY>                 | 此字段为字符串类型                                           | 否       |
+  | 移动电话      | <RY_MOVEPHONE>                | 移动电话                                                     | 否       |
+  | 学历          | <RY_EDUCATIONBG>              | 默认为小学、初中、高中、大学、中专、高职、本科、专科、博士、研究生、硕士研究生 | 否       |
+  | 兼职部门      | <RY_PART_TIME_DEPARTMENTCODE> | 兼职部门编码                                                 |          |
+  | 邮箱          | <RY_EMAIL>                    | 邮箱                                                         |          |
+  | 职务编码      | <RY_DUTYCODE>                 | 职务编码                                                     |          |
+  | 密码          | <RY_PASSWORD>                 | 此项为空的话则默认为 123456                                  | 否       |
+  | 排序号        | <RY_ORDER>                    | 以此排序                                                     | 是       |
+  | 角色编码      | <RY_ROLECODE>                 | 角色编码，可以在同步人员时赋予角色，此项为空时默认设置为“系统普通人员” | 否       |
+  | 人员密级      | <RY_SAFE_LEVEL>               | 人员密级分类，4（核心涉密人员）、3（重要涉密人员）、2（一般涉密人员）、1（非密人员） | 否       |
+
+## 4. 资源菜单同步
+
+### 4.1 实现方式
+
+#### 4.1.1 webservice 实现方式
+
+- 适用于在第三方系统中实现同步功能时或在外部系统上实现同步功能时调用平台的 webService 服务。
+
+  | webService 地址                                         | 方法名       | 参数       | 返回值                               |
+  | ------------------------------------------------------- | ------------ | ---------- | ------------------------------------ |
+  | http://网关地址/应用名称/ws/syncResourceWebService?wsdl | syncResource | xml 字符串 | 全部成功返回“1”有数据无法同步返回“0” |
+
+- 以下是 webservice 实现的一个新增操作演示实例。
+
+  ```java
+  import org.apache.cxf.endpoint.Client;
+  import org.apache.cxf.jaxws.endpoint.dynamic.JaxWsDynamicClientFactory;
+  
+  public class SyncResourceTest {
+      public static void main(String[] args) {
+          try {
+              JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
+              Client client = dcf.createClient("http://localhost:8081/cloud-system-manage/ws/syncResourceWebService?wsdl");
+              String parameterValues = "<ROOT>"
+                      + "<RESOURCE>"
+                      + "<RESOURCE_URL>/system-manage/test</RESOURCE_URL>"
+                      + "<RESOURCE_EMBED_URL>/system-manage/test.html</RESOURCE_EMBED_URL>"
+                      + "<RESOURCE_CODE>test</RESOURCE_CODE>"
+                      + "<RESOURCE_PARENT_CODE>-1</RESOURCE_PARENT_CODE>"
+                      + "<RESOURCE_NAME>测试资源菜单</RESOURCE_NAME>"
+                      + "<RESOURCE_SIMPLENAME>测试菜单</RESOURCE_SIMPLENAME>"
+                      + "<RESOURCE_TYPE>1</RESOURCE_TYPE>"
+                      + "<RESOURCE_SORT>1</RESOURCE_SORT>"
+                      + "<RESOURCE_APPLICATION_NAME>cloud-system-test</RESOURCE_APPLICATION_NAME>"
+                      + "<RESOURCE_REMARK>备注说明</RESOURCE_REMARK>"
+                      + "</RESOURCE>"
+                      + "</ROOT>";
+              Object[] results = client.invoke("syncResource", parameterValues);
+              for (Object result : results) {
+                  System.out.println(result.toString());
+              }
+          }
+          catch (Exception e) {
+              e.printStackTrace();
+          }
+      }
+  }
+  ```
+  
+- 运行后结果如下：
+  ![image](/imgs/组织人员同步/1-6.jpg)
+
+#### 4.1.2 RESTful API 实现 Demo
+
+- 注意事项：
+  - app-token 的生效时间只有一分钟，超时后需要重新生成，在同步人员时重新生成 app-token，再将参数值粘贴进去;
+  - header 中的参数配置，参考 2.1.2 中组织机构 RESTful API 同步中的配置
+  
+- 资源菜单同步 URL：http://localhost:8081/cloud-system-manage/webapi/ou/sync/resource
+
+- param 参数： resourceInfo
+
+- 菜单同步示例 xml 代码如下：
+  ```xml
+  <ROOT><RESOURCE><RESOURCE_URL>/system-manage/resource/test</RESOURCE_URL><RESOURCE_CODE>resourceTest</RESOURCE_CODE><RESOURCE_PARENT_CODE>-1</RESOURCE_PARENT_CODE><RESOURCE_NAME>
+  api同步资源菜单</RESOURCE_NAME><RESOURCE_SIMPLENAME>同步菜单</RESOURCE_SIMPLENAME><RESOURCE_IS_ABLE>1</RESOURCE_IS_ABLE><RESOURCE_TYPE>1</RESOURCE_TYPE>
+  <RESOURCE_APPLICATION_NAME>cloud-system-test</RESOURCE_APPLICATION_NAME><RESOURCE_REMARK>RESTful API方式同步的资源菜单</RESOURCE_REMARK></RESOURCE></ROOT>
+  ```
+  
+- 组件同步示例xml代码如下：
+  
+  ```xml
+  <ROOT><RESOURCE>
+  <RESOURCE_PARENT_CODE>1108ba7727cd4aed9c56607974ca1935</RESOURCE_PARENT_CODE>
+  <RESOURCE_NAME>234</RESOURCE_NAME>
+  <RESOURCE_CODE>sf</RESOURCE_CODE>
+  <RESOURCE_TYPE>2</RESOURCE_TYPE><RESOURCE_REMARK>测试</RESOURCE_REMARK>
+  </RESOURCE></ROOT>
+  ```
+  
+- 分组同步示例xml代码如下：
+  
+  ```xml
+  <ROOT><RESOURCE>
+  <RESOURCE_NAME>556</RESOURCE_NAME><GROUP_SORT>12</GROUP_SORT><RESOURCE_TYPE>4</RESOURCE_TYPE>
+  </RESOURCE></ROOT>
+  ```
+  
+- 模块同步示例xml代码如下：
+  
+  ```xml
+  <ROOT><RESOURCE>
+  <RESOURCE_NAME>104</RESOURCE_NAME><RESOURCE_PARENT_CODE>3f28830696aedfaa0196aee08e1d0000</RESOURCE_PARENT_CODE><RESOURCE_TYPE>0</RESOURCE_TYPE>
+  </RESOURCE></ROOT>
+  ```
+  
+- 运行结果如下图：
+  ![image](/imgs/组织人员同步/2-1.jpg)
+  ![image](/imgs/组织人员同步/2-2.jpg)
+
+### 4.2 配置说明
+
+| 字段名称     | 默认 XML 标签名             | 说明                                       | 是否必填 |
+| ------------ | --------------------------- | ------------------------------------------ | -------- |
+| 名称         | <RESOURCE_NAME>             | 资源名称                                   | 是       |
+| 编码         | <RESOURCE_CODE>             | 资源编码，有唯一性校验                     | 是       |
+| 资源父级编码 | <RESOURCE_PARENT_CODE>      | 添加的资源菜单父级菜单，必填项，置空时报错 | 是       |
+| 类型         | <RESOURCE_TYPE >            | 资源类型，0 模块 1 菜单                    | 是       |
+| 资源路由地址 | <RESOURCE_URL>              | 通过资源路由访问资源                       | 是       |
+| 备注         | <RESOURCE_REMARK>           | 资源描述                                   | 否       |
+| 实际菜单地址 | <RESOURCE_EMBED_URL>        | 资源实际菜单地址(前后端分离适用)           | 是       |
+| 所属应用名   | <RESOURCE_APPLICATION_NAME> | 不能为空，否则菜单不显示                   | 是       |
+| 所属产品名   | <RESOURCE_PRODUCT_NAME>     |                                            | 是       |
+| 排序号       | <RESOURCE_SORT>             | 用于菜单顺序排列                           | 是       |
+| 分组排序号   | <GROUP_SORT>                | 分组排序号                                 | 是       |
+
+## 角色同步
+
+### 5.1 实现方式
+
+#### 5.1.1 webservice 实现 Demo
+
+- 适用于在第三方系统中实现同步功能时或在外部系统上实现同步功能时调用平台的 webService 服务。
+
+  | webService 地址                                     | 方法名   | 参数       | 返回值                               |
+  | --------------------------------------------------- | -------- | ---------- | ------------------------------------ |
+  | http://网关地址/应用名称/ws/syncRoleWebService?wsdl | syncRole | xml 字符串 | 全部成功返回“1”有数据无法同步返回“0” |
+
+- 以下是 webservice 实现的一个新增操作演示实例。
+
+  ```java
+  import org.apache.cxf.endpoint.Client;
+  import org.apache.cxf.jaxws.endpoint.dynamic.JaxWsDynamicClientFactory;
+
+  public class SyncRoleTest {
+      public static void main(String[] args) {
+          try {
+              JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
+              Client client = dcf.createClient("http://localhost:8081/cloud-system-manage/ws/syncRoleWebService?wsdl");
+              String parameterValues = "<ROOT>"
+                      + "<ROLE>"
+                      + "<ORG_CODE>syncOrg1</ORG_CODE>"
+                      + "<RY_ROLENAME>同步角色1</RY_ROLENAME>"
+                      + "<RY_ROLECODE>syncRole1</RY_ROLECODE>"
+                      + "</ROLE>"
+                      + "</ROOT>";
+              Object[] results = client.invoke("syncRole", parameterValues);
+              for (Object result : results) {
+                  System.out.println(result.toString());
+              }
+          } catch (Exception e) {
+              e.printStackTrace();
+          }
+      }
+  }
+  ```
+
+- 运行结果如下：
+  ![image](/imgs/组织人员同步/1-9.jpg)
+- 角色编码作为角色唯一性校验，如果编码存在则修改，不存在则新增
+
+#### 5.1.2 RESTful API 实现 Demo
+
+- 注意事项：
+  - app-token 的生效时间只有一分钟，超时后需要重新生成，在同步人员时重新生成 app-token，再将参数值粘贴进去;
+  - header 中的参数配置，参考 2.1.2 中组织机构 RESTful API 同步中的配置
+- 角色同步 URL：http://localhost:8081/cloud-system-manage/webapi/ou/sync/role
+- param 参数： roleInfo
+- 角色同步样例 xml：
+
+```xml
+<ROOT><ROLE><ORG_CODE>apiSyncOrg1</ORG_CODE><RY_ROLENAME>api同步角色1</RY_ROLENAME><RY_ROLECODE>apiSyncRole1</RY_ROLECODE></ROLE></ROOT>
+```
+
+- 执行结果如下：
+  ![image](./imgs/组织人员同步/1-19.jpg)
+  ![image](./imgs/组织人员同步/1-20.jpg)
+
+### 5.2 配置说明
+
+| 字段名称 | 默认 XML 标签名  | 说明                           | 是否必填 |
+| -------- | ---------------- | ------------------------------ | -------- |
+| 资源路径 | <ORG_CODE>       | 决定角色同步的机构，不能为部门 | 是       |
+| 角色名称 | <RY_ROLENAME>    | 角色名称                       | 是       |
+| 角色编码 | <RY_ROLECODE>    | 角色编码(做唯一性校验)         | 是       |
+| 租户ID   | <ROLE_TENANT_ID> | 角色同步租户ID                 | 是       |
+
+## 6. 资源权限同步
+
+### 6.1 实现方式
+
+#### 6.1.1 wenservice 实现 Demo
+
+- 适用于在第三方系统中实现同步功能时或在外部系统上实现同步功能时调用平台的 webService 服务。
+
+  | webService 地址                                        | 方法名     | 参数       | 返回值                               |
+  | ------------------------------------------------------ | ---------- | ---------- | ------------------------------------ |
+  | http://网关地址/应用名称/ws/syncAssignWebService ?wsdl | syncAssign | xml 字符串 | 全部成功返回“1”有数据无法同步返回“0” |
+
+- 以下是 webservice 实现的一个新增操作演示实例
+
+- <font color="red"> RY_ROLECODE 输入角色/组织/人员维护列表中已有角色/组织/人员编码</font>
+
+- <font color="red"> RESOURCE_URL 输入资源维护列表中已有模块名称/菜单路由地址/组件编码/资源分组名称</font>   
+
+- <font color="red"> RESOURCE_TYPE 资源类型 输入0（模块），1（菜单），2（组件），4（资源分组）中的任意一个，非必填默认为1（菜单）</font>   
+
+- <font color="red"> ASSIGN_TYPE 授权类型  输入org（组织授权），role（角色授权），user（人员授权）中的任意一个，非必填默认为role（角色授权）</font>
+
+- <font color="red"> HAS_PROGENY 是否包含下级 按组织授权时生效，输入0（不包含下级），1（包含下级）中的任意一个，非必填默认为0（不包含下级）</font>
+
+  ```java
+  import org.apache.cxf.endpoint.Client;
+  import org.apache.cxf.jaxws.endpoint.dynamic.JaxWsDynamicClientFactory;
+  
+  public class SyncAssignTest {
+      public static void main(String[] args) {
+          try {
+              JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
+              Client client = dcf.createClient("http://localhost:8081/cloud-system-manage/ws/syncAssignWebService?wsdl");
+              String parameterValues = "<ROOT>"
+                      + "<Assign>"
+                      + "<RESOURCE_URL>/system-manage/test</RESOURCE_URL>"
+                      + "<RY_ROLECODE>syncRole1</RY_ROLECODE>"
+                   	+ "<RESOURCE_TYPE>1</RESOURCE_URL>"
+                      + "<ASSIGN_TYPE>role</ASSIGN_TYPE>"
+                      + "</Assign>"
+                      + "</ROOT>";
+              Object[] results = client.invoke("syncAssign", parameterValues);
+              for (Object result : results) {
+                  System.out.println(result.toString());
+              }
+          } catch (Exception e) {
+              e.printStackTrace();
+          }
+      }
+  }
+  ```
+
+- 同步资源菜单中的 RESOURCE_URL 为 resource 的 url，运行后会直接在给角色获取对应的资源权限。
+
+- 运行后结果如下：
+  ![image](./imgs/组织人员同步/1-8.jpg)
+
+#### 6.1.1 RESTful API 实现 Demo
+
+- 注意事项：
+  - app-token 的生效时间只有一分钟，超时后需要重新生成，在同步人员时重新生成 app-token，再将参数值粘贴进去;
+  - header 中的参数配置，参考 2.1.2 中组织机构 RESTful API 同步中的配置
+- 资源菜单权限同步 URL：http://localhost:8081/cloud-system-manage/webapi/ou/sync/assign
+- param 参数： assignInfo
+- 示例 xml 代码：
+  ```xml
+  <ROOT>
+  <ASSIGN>
+  <RESOURCE_TYPE>4</RESOURCE_TYPE>
+  <RESOURCE_URL>资源分组1,资源分组2</RESOURCE_URL>
+  <RY_ROLECODE>test001,dev001</RY_ROLECODE>
+  <ASSIGN_TYPE>user</ASSIGN_TYPE>
+  </ASSIGN>
+  <ASSIGN>
+  <RESOURCE_TYPE>0</RESOURCE_TYPE>
+  <RESOURCE_URL>模块1,模块2</RESOURCE_URL>
+  <RY_ROLECODE>test,dev</RY_ROLECODE>
+  <ASSIGN_TYPE>role</ASSIGN_TYPE>
+  </ASSIGN>
+  <ASSIGN>
+  <RESOURCE_TYPE>1</RESOURCE_TYPE>
+  <RESOURCE_URL>/test1,/test2</RESOURCE_URL>
+  <RY_ROLECODE>merit,bigData</RY_ROLECODE>
+  <ASSIGN_TYPE>org</ASSIGN_TYPE>
+  <HAS_PROGENY>1</HAS_PROGENY>
+  </ASSIGN>
+  <ASSIGN>
+  <RESOURCE_TYPE>2</RESOURCE_TYPE>
+  <RESOURCE_URL>cloud_zj1,cloud_zj2</RESOURCE_URL>
+  <RY_ROLECODE>test001,dev001</RY_ROLECODE>
+  <ASSIGN_TYPE>user</ASSIGN_TYPE>
+  </ASSIGN>
+  </ROOT>
+  ```
+- 执行结果如下图：
+  ![image](./imgs/组织人员同步/2-3.jpg)
+  ![image](./imgs/组织人员同步/2-4.jpg)
+
+### 6.2 配置说明
+
+| 字段名称      | 默认 XML 标签名 | 说明                                                         | 是否必填 |
+| ------------- | --------------- | ------------------------------------------------------------ | -------- |
+| 资源名称/路径 | <RESOURCE_URL>  | 资源名称/路径，通过设置名称/路径给组织/人员/角色赋予资源权限;模块：名称；菜单：路由地址；组件：组件编码；资源分组：分组名称 | 是       |
+| 编码          | <RY_ROLRCODE>   | 组织/人员/角色编码                                           | 是       |
+| 资源类型      | <RESOURCE_TYPE> | 0模块，1菜单，2组件，4资源分组，默认为1                      | 否       |
+| 授权类型      | <ASSIGN_TYPE>   | org组织授权，role角色授权，user人员授权，默认为role          | 否       |
+| 是否包含下级  | <HAS_PROGENY>   | 组织授权生效，0不包含，1包含，默认为0不包含下级              | 否       |
+
+## 7. 组织同步配置
+
+- 组织同步、人员同步、资源同步、权限同步都需要一定的规则，根据这些定义的配置规则，将数据转换成 xml 字符串。
+- 组织同步配置说明：
+  - “固定编码值”字段是最终存入数据库中的值，修改时注意与系统中相对应数据字典的字典值的编码保持一致。
+  - 若“固定编码值”字段为空则“XPath 或值”字段内为 XPath，不为空则“XPath 或值”字段为值。如下图：
+
+* “XPath 或值”为 XPath 时，如人员性别 XPath 为 RY_SEX，人员的性别信息标签为<RY_SEX></RY_SEX>，如传入的字符串“性别”标签为<SEX>与 RY_SEX 不对应，可以修改 XPath 与之对应，将“性别”的 XPath 改为 SEX 即可(注意区分大小写，可支持中文)。如下图：
+
+  <XPath 或值>为值时
+
+  ```xml
+  <ROOT>
+    <ORG>
+      <ORG_CODE>jy2</ORG_CODE>
+      <ORG_PARENT_CODE>merit</ORG_PARENT_CODE>
+      <ORG_NAME>技研成2</ORG_NAME>
+      <ORG_SIMPLENAME>技研2</ORG_SIMPLENAME>
+      <ORG_SYNC_STATUS>1</ORG_SYNC_STATUS>
+      <ORG_DLEVEL>2</ORG_DLEVEL>
+      <ORG_IS_ABLE>1</ORG_IS_ABLE>
+      <ORG_SORT>1</ORG_SORT>
+      <ORG_REMARK>备注说明</ORG_REMARK>
+    </ORG>
+  </ROOT>
+  ```
+
+* 如机构中<XPath 或值>的值为”机构、部门、班组、小班”。那么传过来的 xml 中的值也应该为“机构、部门、班组、小班”如"<ORG_DLEVEL>部门</ORG_DLEVEL>":，如果<XPath 或值>中的值为“1、2、3、4”则 xml 中的值为“1、2、3、4”。
+
+* 根据 XPath 字段值，<ORG_DLEVEL>标签内可填的值有 1、2、3、4
+
+# 附录 A：常见问题
+
+- 1.  同一个 main 方法中同时调用多个 webservice 方法，执行时抛出异常：
+
+  - 错误调用方法代码示例：
+
+  ```java
+  public static void main(String[] args){
+    try {
+      JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
+      Client clientA = dcf.createClient("http://192.168.1.66:8080/groupClass/ws/getSayHelloService?wsdl");
+      Object[] resultA = clientA.invoke("sayHello", "Joker");
+      System.out.println("resultA===>" + resultA[0]);
+    dcf = JaxWsDynamicClientFactory.newInstance();
+      Client clientB = dcf.createClient("http://192.168.1.66:8080/groupClass/ws/getSayGoodByeService?wsdl");
+      Object[] resultB = clientB.invoke("sayGoodBye", "Joker");
+      System.out.println("resultB===>" + resultB[0]);
+    } catch (Exception e) {
+      e.printStackTrace();
+    }
+  }
+  ```
+  
+- 异常信息：
+  
+```
+  [INFO ] [08:43:33] org.apache.cxf.endpoint.dynamic.DynamicClientFactory - Created classes: gc.web.ws.ObjectFactory, gc.web.ws.SayHello, gc.web.ws.SayHelloResponse
+    resultA===>Hello:Joker
+  [INFO ] [08:43:35] org.apache.cxf.endpoint.dynamic.DynamicClientFactory - Created classes: gc.web.ws.ObjectFactory, gc.web.ws.SayGoodBye, gc.web.ws.SayGoodByeResponse
+    [WARN ] [08:43:35] org.apache.cxf.phase.PhaseInterceptorChain - Interceptor for {http://ws.web.gc/}SayGoodByeImplService#{http://ws.web.gc/}sayGoodBye has thrown exception, unwinding now
+    org.apache.cxf.interceptor.Fault: Marshalling Error: gc.web.ws.SayGoodBye is not known to this context
+    at org.apache.cxf.jaxb.JAXBEncoderDecoder.marshall(JAXBEncoderDecoder.java:266)
+    at org.apache.cxf.jaxb.io.DataWriterImpl.write(DataWriterImpl.java:237)
+    at org.apache.cxf.interceptor.AbstractOutDatabindingInterceptor.writeParts(AbstractOutDatabindingInterceptor.java:117)
+    at org.apache.cxf.wsdl.interceptors.BareOutInterceptor.handleMessage(BareOutInterceptor.java:68)
+    at org.apache.cxf.phase.PhaseInterceptorChain.doIntercept(PhaseInterceptorChain.java:308)
+    at org.apache.cxf.endpoint.ClientImpl.doInvoke(ClientImpl.java:514)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:423)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:324)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:277)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:297)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:283)
+    at cms.web.util.ConnectWebService.main(ConnectWebService.java:129)
+  Caused by: javax.xml.bind.MarshalException
+  - with linked exception:
+  [com.sun.istack.SAXException2: gc.web.ws.SayGoodBye is not known to this context
+  javax.xml.bind.JAXBException: gc.web.ws.SayGoodBye is not known to this context]
+    at com.sun.xml.bind.v2.runtime.MarshallerImpl.write(MarshallerImpl.java:326)
+    at com.sun.xml.bind.v2.runtime.MarshallerImpl.marshal(MarshallerImpl.java:251)
+    at javax.xml.bind.helpers.AbstractMarshallerImpl.marshal(AbstractMarshallerImpl.java:95)
+    at org.apache.cxf.jaxb.JAXBEncoderDecoder.writeObject(JAXBEncoderDecoder.java:617)
+    at org.apache.cxf.jaxb.JAXBEncoderDecoder.marshall(JAXBEncoderDecoder.java:241)
+    ... 11 more
+  Caused by: com.sun.istack.SAXException2: gc.web.ws.SayGoodBye is not known to this context
+  javax.xml.bind.JAXBException: gc.web.ws.SayGoodBye is not known to this context
+    at com.sun.xml.bind.v2.runtime.XMLSerializer.reportError(XMLSerializer.java:247)
+    at com.sun.xml.bind.v2.runtime.XMLSerializer.reportError(XMLSerializer.java:262)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl$1.serializeBody(ElementBeanInfoImpl.java:147)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl$1.serializeBody(ElementBeanInfoImpl.java:130)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl.serializeBody(ElementBeanInfoImpl.java:332)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl.serializeRoot(ElementBeanInfoImpl.java:339)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl.serializeRoot(ElementBeanInfoImpl.java:75)
+    at com.sun.xml.bind.v2.runtime.XMLSerializer.childAsRoot(XMLSerializer.java:494)
+    at com.sun.xml.bind.v2.runtime.MarshallerImpl.write(MarshallerImpl.java:323)
+    ... 15 more
+  Caused by: javax.xml.bind.JAXBException: gc.web.ws.SayGoodBye is not known to this context
+    at com.sun.xml.bind.v2.runtime.JAXBContextImpl.getBeanInfo(JAXBContextImpl.java:613)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl$1.serializeBody(ElementBeanInfoImpl.java:144)
+    ... 21 more
+  org.apache.cxf.interceptor.Fault: Marshalling Error: gc.web.ws.SayGoodBye is not known to this context
+    at org.apache.cxf.jaxb.JAXBEncoderDecoder.marshall(JAXBEncoderDecoder.java:266)
+    at org.apache.cxf.jaxb.io.DataWriterImpl.write(DataWriterImpl.java:237)
+    at org.apache.cxf.interceptor.AbstractOutDatabindingInterceptor.writeParts(AbstractOutDatabindingInterceptor.java:117)
+    at org.apache.cxf.wsdl.interceptors.BareOutInterceptor.handleMessage(BareOutInterceptor.java:68)
+    at org.apache.cxf.phase.PhaseInterceptorChain.doIntercept(PhaseInterceptorChain.java:308)
+    at org.apache.cxf.endpoint.ClientImpl.doInvoke(ClientImpl.java:514)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:423)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:324)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:277)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:297)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:283)
+    at cms.web.util.ConnectWebService.main(ConnectWebService.java:129)
+  Caused by: javax.xml.bind.MarshalException
+  - with linked exception:
+  [com.sun.istack.SAXException2: gc.web.ws.SayGoodBye is not known to this context
+  javax.xml.bind.JAXBException: gc.web.ws.SayGoodBye is not known to this context]
+    at com.sun.xml.bind.v2.runtime.MarshallerImpl.write(MarshallerImpl.java:326)
+    at com.sun.xml.bind.v2.runtime.MarshallerImpl.marshal(MarshallerImpl.java:251)
+    at javax.xml.bind.helpers.AbstractMarshallerImpl.marshal(AbstractMarshallerImpl.java:95)
+    at org.apache.cxf.jaxb.JAXBEncoderDecoder.writeObject(JAXBEncoderDecoder.java:617)
+    at org.apache.cxf.jaxb.JAXBEncoderDecoder.marshall(JAXBEncoderDecoder.java:241)
+    ... 11 more
+  Caused by: com.sun.istack.SAXException2: gc.web.ws.SayGoodBye is not known to this context
+  javax.xml.bind.JAXBException: gc.web.ws.SayGoodBye is not known to this context
+    at com.sun.xml.bind.v2.runtime.XMLSerializer.reportError(XMLSerializer.java:247)
+    at com.sun.xml.bind.v2.runtime.XMLSerializer.reportError(XMLSerializer.java:262)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl$1.serializeBody(ElementBeanInfoImpl.java:147)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl$1.serializeBody(ElementBeanInfoImpl.java:130)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl.serializeBody(ElementBeanInfoImpl.java:332)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl.serializeRoot(ElementBeanInfoImpl.java:339)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl.serializeRoot(ElementBeanInfoImpl.java:75)
+    at com.sun.xml.bind.v2.runtime.XMLSerializer.childAsRoot(XMLSerializer.java:494)
+    at com.sun.xml.bind.v2.runtime.MarshallerImpl.write(MarshallerImpl.java:323)
+    ... 15 more
+  Caused by: javax.xml.bind.JAXBException: gc.web.ws.SayGoodBye is not known to this context
+    at com.sun.xml.bind.v2.runtime.JAXBContextImpl.getBeanInfo(JAXBContextImpl.java:613)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl$1.serializeBody(ElementBeanInfoImpl.java:144)
+    ... 21 more
+```
+
+- 此类问题的解决方式有两种：
+    （1）直接在方法中一次只调用一个 webservice 同步接口；
+    （2）改造 main 方法，使每次调用前重置上下文
+  
+  ```java
+    public static void main(String[] args){
+      try {
+        //在一个方法中连续调用多次WebService接口,每次调用前需要重置上下文
+        ClassLoader cl = Thread.currentThread().getContextClassLoader();
+      JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
+      Client clientA = dcf.createClient("http://192.168.1.66:8080/groupClass/ws/getSayHelloService?wsdl");
+        Object[] resultA = clientA.invoke("sayHello", "Joker");
+        System.out.println("resultA===>" + resultA[0]);
+        Thread.currentThread().setContextClassLoader(cl);
+      dcf = JaxWsDynamicClientFactory.newInstance();
+      Client clientB = dcf.createClient("http://192.168.1.66:8080/groupClass/ws/getSayGoodByeService?wsdl");
+      Object[] resultB = clientB.invoke("sayGoodBye", "Joker");
+      System.out.println("resultB===>" + resultB[0]);
+      } catch (Exception e) {
+        e.printStackTrace();
+      }
+    }
+  ```