...

examcloud-exchange-outer-api-provider/src/main/java/cn/com/qmth/examcloud/exchange/outer/api/provider/ExamStudentOuterServiceProvider.java

@@ -38,7 +38,7 @@ public class ExamStudentOuterServiceProvider extends ControllerSupport
 	@Autowired
 	ExamStudentCloudService examStudentCloudService;
 
-	@ApiOperation(value = "保存考生信息", response = String.class)
+	@ApiOperation(value = "保存考生信息", response = OuterSaveExamStudentResp.class)
 	@PostMapping("saveExamStudent")
 	@Override
 	public OuterSaveExamStudentResp saveExamStudent(

examcloud-exchange-outer-api-provider/src/main/java/cn/com/qmth/examcloud/exchange/outer/api/provider/FaceOuterServiceProvider.java

@@ -25,16 +25,17 @@ import cn.com.qmth.examcloud.commons.web.security.bean.User;
 import cn.com.qmth.examcloud.commons.web.support.ControllerSupport;
 import cn.com.qmth.examcloud.exchange.outer.api.FaceOuterService;
 import cn.com.qmth.examcloud.exchange.outer.service.FaceService;
+import io.swagger.annotations.Api;
 import io.swagger.annotations.ApiOperation;
 
 /**
- * 人脸 处理
- * 
- * @author chenken
- * @date 2018年4月3日 下午3:58:31
- * @company QMTH
- * @description FaceppController.java
+ * 人脸服务
+ *
+ * @author WANGWEI
+ * @date 2018年11月14日
+ * @Copyright (c) 2018-? http://qmth.com.cn All Rights Reserved.
  */
+@Api("人脸服务")
 @RestController
 @RequestMapping("${$rmp.cloud.exchange.outer}/face")
 public class FaceOuterServiceProvider extends ControllerSupport implements FaceOuterService {

examcloud-exchange-outer-api/src/main/java/cn/com/qmth/examcloud/exchange/outer/api/bean/OuterExamStudentBean.java

@@ -1,58 +1,79 @@
 package cn.com.qmth.examcloud.exchange.outer.api.bean;
 
 import cn.com.qmth.examcloud.commons.web.cloud.api.JsonSerializable;
-
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+
+/**
+ * 类注释
+ *
+ * @author WANGWEI
+ * @date 2018年11月14日
+ * @Copyright (c) 2018-? http://qmth.com.cn All Rights Reserved.
+ */
+@ApiModel(value = "examStudentBean", description = "考生信息")
 public class OuterExamStudentBean implements JsonSerializable {
 	private static final long serialVersionUID = 2079003980099252759L;
 
 	/**
 	 * 顶级机构ID
 	 */
+	@ApiModelProperty(value = "顶级机构", example = "0", required = true)
 	private Long rootOrgId;
 
 	/**
 	 * 考试ID
 	 */
+	@ApiModelProperty(value = "考试ID", example = "100", required = true)
 	private Long examId;
 
 	/**
 	 * 考试名称
 	 */
+	@ApiModelProperty(value = "考试名称", example = "2018年秋季入学考试", required = true)
 	private String examName;
 
 	/**
 	 * 学生姓名
 	 */
+	@ApiModelProperty(value = "学生姓名", example = "陈圆圆", required = true)
 	private String studentName;
 
 	/**
 	 * 学生学号
 	 */
+	@ApiModelProperty(value = "学生学号", example = "2018001001", required = true)
 	private String studentCode;
 
 	/**
 	 * 学生身份证号
 	 */
+	@ApiModelProperty(value = "学生身份证号", example = "XXXXXXXXXXXXXXXXXX", required = true)
 	private String identityNumber;
 
 	/**
 	 * 考试课程名称
 	 */
+	@ApiModelProperty(value = "考试课程名称", example = "大学英语", required = true)
 	private String courseName;
 
 	/**
 	 * 考试课程code
 	 */
+	@ApiModelProperty(value = "考试课程code", example = "K2", required = true)
 	private String courseCode;
 
 	/**
 	 * 考试课程level
 	 */
+	@ApiModelProperty(value = "考试课程level.  ZSB:专升本;GQZ:高起专;GQB:高起本;ALL:不限", example = "ALL", required = true)
+
 	private String courseLevel;
 
 	/**
 	 * 试卷类型
 	 */
+	@ApiModelProperty(value = "试卷类型,大写字母A-Z", example = "X", required = true)
 	private String paperType;
 
 	public Long getRootOrgId() {

examcloud-exchange-outer-api/src/main/java/cn/com/qmth/examcloud/exchange/outer/api/request/OuterSaveExamStudentReq.java

@@ -1,7 +1,6 @@
 package cn.com.qmth.examcloud.exchange.outer.api.request;
 
 import cn.com.qmth.examcloud.commons.web.cloud.api.BaseRequest;
-import io.swagger.annotations.ApiModel;
 import io.swagger.annotations.ApiModelProperty;
 
 /**
@@ -11,7 +10,6 @@ import io.swagger.annotations.ApiModelProperty;
  * @date 2018年11月14日
  * @Copyright (c) 2018-? http://qmth.com.cn All Rights Reserved.
  */
-@ApiModel(value = "SaveExamStudentReq", description = "请求体")
 public class OuterSaveExamStudentReq extends BaseRequest {
 
 	private static final long serialVersionUID = -8455805881947392754L;

examcloud-exchange-outer-api/src/main/java/cn/com/qmth/examcloud/exchange/outer/api/response/OuterSaveExamStudentResp.java

@@ -2,11 +2,22 @@ package cn.com.qmth.examcloud.exchange.outer.api.response;
 
 import cn.com.qmth.examcloud.commons.web.cloud.api.BaseResponse;
 import cn.com.qmth.examcloud.exchange.outer.api.bean.OuterExamStudentBean;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 
+/**
+ * 响应
+ *
+ * @author WANGWEI
+ * @date 2018年11月14日
+ * @Copyright (c) 2018-? http://qmth.com.cn All Rights Reserved.
+ */
+@ApiModel(value = "json", description = "响应体")
 public class OuterSaveExamStudentResp extends BaseResponse {
 
 	private static final long serialVersionUID = 5003024673163742249L;
 
+	@ApiModelProperty(value = "考生信息", name = "examStudentBean")
 	private OuterExamStudentBean examStudentBean;
 
 	public OuterExamStudentBean getExamStudentBean() {