从0到1开发测试平台（六）后端对接口response的封装
转载：https://cloud.tencent.com/developer/article/1676824
在进行接口开发时，一般需要一个固定的返回样式，成功和失败的时候，都按照这种格式来进行统一的返回，这样，在与其他人进行接口之间的联调时不会显得很杂乱无章,并且前端方便对返回结果统一处理。而这种固定的格式如果放在Java的每个接口单独处理时，又会在接口开发时很繁琐，所以这个时候可以采用封装一个实体类，统一返回固定模板格式的内容。
现在对我们之前写的登录接口返回进行统一封装处理。
新建common包，并且在common包里新建StatusCode.java，这个类主要是统一定义程序里用到的错误码
package com.test.demo.common;
public class StatusCode {
//请登录
public static final Integer NEED_LOGIN = 401;
/** 操作成功*/
public static final Integer OPERATIONSUCCESS = 200;
/** 用户名/密码错误*/
public static final Integer USER_NAME_OR_PASSWORD_EORROR = 1011;
/** 用户不存在*/
public static final Integer USER_NOT_EXIST = 1012;
/** 用户名不能为空*/
public static final Integer USER_NAME_NULL = 1013;
/** 密码不能为空*/
public static final Integer USER_PASS_NULL = 1014;
}
在common包里新建ResultType.java，这个类是用来定义相应错误码对应的话术
package com.test.demo.common;
public class ResultType {
public static final String NEED_LOGIN = "温馨提示：请使用对应的账号登录";
public static final String LOGIN_SUCCESS = "登录成功";
public static final String USER_NAME_OR_PASSWORD_EORROR = "用户名/密码错误";
public static final String USER_NOT_EXIST = "用户不存在";
public static final String USER_NAME_NULL = "用户名不能为空";
public static final String USER_PASS_NULL = "密码不能为空";
}
在bean包新建Page.java和Result.java，其中page是用来返回分页信息的，Result是统一返回结果
package com.test.demo.bean;
import lombok.Data;
import org.springframework.stereotype.Component;
/*
* 返回分页信息
* */
@Component
@Data
public class Page {
private static final long serialVersionUID = 1L;
private int pageNum;
private int pageSize;
private int startRow;
private int endRow;
private long total;
private int pages;
private boolean count;
private Boolean reasonable;
private Boolean pageSizeZero;
private String countColumn;
private String orderBy;
private boolean orderByOnly;
}
package com.test.demo.bean;
import com.test.demo.common.StatusCode;
import java.io.Serializable;
/*
* 统一返回结果
* */
public class Result implements Serializable {
/** 成功失败 */
private boolean success;
/** 状态码 */
private Integer code;
/** 返回结果集 */
private Object data;
/** 信息 */
private String message;
/**分页信息 */
private Page pageInfo;
/** 前端弹窗模式："warning", "error", "success", "info" */
private String icon;
public Result() {}
public Result(boolean success, String message) {
this.success = success;
this.message = message;
if (success) icon = "success";
else icon = "error";
}
public Result(boolean success, Integer code, String message) {
this(success, message);
this.code = code;
}
public Result(boolean success, Integer code, Object data, String message) {
this(success, code, message);
this.data = data;
}
public static Result result(Object data, boolean success, Integer code, String message) {
Result result = new Result();
result.data = data;
result.success = success;
result.message = message;
result.code = code;
return result;
}
public static Result result(Object data, Page pageInfo, boolean success, Integer code, String message) {
Result result = new Result();
result.pageInfo = pageInfo;
result.data = data;
result.success = success;
result.message = message;
result.code = code;
return result;
}
//返回成功结果
public static Result resultSuccess(Page pageInfo, Object data, String message) {
Result result = new Result();
result.success = true;
result.code = StatusCode.OPERATIONSUCCESS;
result.message = message;
result.pageInfo = pageInfo;
result.data = data;
return result;
}
//返回失败
public static Result resultError(String message, int code) {
Result result = new Result();
result.success = false;
result.message = message;
result.code = code;
return result;
}
public Object getData() {
return data;
}
public void setData(Object data) {
this.data = data;
}
public boolean isSuccess() {
return success;
}
public void setSuccess(boolean success) {
this.success = success;
}
public String getMessage() {
return message;
}
public void setMessage(String message) {
this.message = message;
}
public Integer getCode() {
return code;
}
public void setCode(Integer code) {
this.code = code;
}
public String getIcon() {
return icon;
}
public void setIcon(String icon) {
this.icon = icon;
}
public Page getPageInfo() {
return pageInfo;
}
public void setPageInfo(Page pageInfo) {
this.pageInfo = pageInfo;
}
}
对UserServiceI.java和UserController.java和UserServiceImpl.java中的login方法进行统一返回的修改
UserServiceI.java的login方法的返回值变为 Result类
Result login(String name, String password);
UserController.java方法返回值为Result
@PostMapping("/login")
public Result login(@RequestBody User user){
if(user==null){
return Result.resultError(ResultType.USER_NAME_NULL, StatusCode.USER_NAME_NULL);
}
if(user.getName()==null || "".equals(user.getName())){
return Result.resultError(ResultType.USER_NAME_NULL,StatusCode.USER_NAME_NULL);
}
if(user.getPassword()==null || "".equals(user.getPassword())){
return Result.resultError(ResultType.USER_PASS_NULL,StatusCode.USER_PASS_NULL);
}
return userService.login(user.getName(),user.getPassword());
}
UserServiceImpl.java
package com.test.demo.service.impl;
import com.test.demo.bean.Result;
import com.test.demo.bean.User;
import com.test.demo.common.ResultType;
import com.test.demo.common.StatusCode;
import com.test.demo.mapper.UserMapper;
import com.test.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;
//controller->service->dao
@Service
public class UserServiceImpl implements UserService {
@Autowired
private UserMapper userMapper;
@Override
public List<User> queryUserList() {
return userMapper.queryUserList();
}
@Override
public User queryUserByName(String name) {
return userMapper.queryUserByName(name);
}
@Override
public Result login(String name, String password) {
User user = queryUserByName(name);
if(user == null){
return Result.resultError(ResultType.USER_NOT_EXIST, StatusCode.USER_NOT_EXIST);
}
if(!password.equals(user.getPassword())){
return Result.resultError(ResultType.USER_NAME_OR_PASSWORD_EORROR,StatusCode.USER_NAME_OR_PASSWORD_EORROR);
}
return Result.resultSuccess(null,null,ResultType.LOGIN_SUCCESS);
}
}
浙公网安备 33010602011771号