Spring Boot接口设计

项目文件结构

编写示例代码

添加lombok的依赖
新建DemoController，用于提供RESTful接口。增加相关注解：@RestController，@RequestMapping(“/demo”)，@Slf4j
新建GetUserParam，接口传入参数实体。
新建DemoErrorEnum，接口返回消息和返回消息码的枚举

public enum DemoErrorEnum {

    SUCCESS("操作成功", "0000"),
    PARAM_NULL("参数为空", "1001"),
    TOKEN_EXPIRED("token已过期", "2007"),
    SERVER_ERROR("服务器异常，请稍后重试", "5001"),


    ;

    private String code;
    private String message;

    public String getCode() {
        return code;
    }

    public String getMessage() {
        return message;
    }

    DemoErrorEnum(String message, String code) {
        this.message = message;
        this.code = code;
    }

    public static String getErrorMsg(String code) {
        for (DemoErrorEnum e : DemoErrorEnum.values()) {
            if (e.getCode().equals(code)) {
                return e.message;
            }
        }
        return null;
    }
}

新建ResultDTO，作为接口返回基类。增加相关注解：@Data，@Accessors(chain = true)。
- success：接口是否调用成功
- resultMessage：调用结果描述
- resultCode：调用结果消息码
- result：调用返回的数据
- 定义一个static的error方法，当接口失败的时候，可以直接返回一个error方法，方法内部构造具体的返回消息码和结果描述。入参为一个DemoErrorEnum的枚举。
- 定义一个static的success方法，当接口成功的时候，可以直接返回一个success方法，方法内部构造具体的返回信息，入参也是一个DemoErrorEnum的枚举。编写一个重载方法，入参为空，方法内部构造默认的响应信息。

import com.naylor.interfacedesign.domain.demo.error.DemoErrorEnum;
import lombok.Data;
import lombok.experimental.Accessors;

import java.io.Serializable;

@Data
@Accessors(chain = true)
public class ResultDTO<T>  implements Serializable {
    private boolean success;

    private String resultMessage;

    private String resultCode;

    private T result;

    public static ResultDTO error(DemoErrorEnum errorEnum) {
        return new ResultDTO().setSuccess(false).setResultMessage(errorEnum.getMessage()).setResultCode(errorEnum.getCode());
    }

    public static ResultDTO success(DemoErrorEnum errorEnum) {
        return new ResultDTO().setSuccess(true).setResultCode(errorEnum.getCode());
    }

    public static ResultDTO success() {
        return new ResultDTO().setSuccess(true).setResultCode(DemoErrorEnum.SUCCESS.getCode()).setResultMessage(DemoErrorEnum.SUCCESS.getMessage());
    }
}

新建UserDTO，接口返回的具体信息
DemoController中新建getUser方法，入参为GetUserParam，返回值为ResultDTO
。此接口内部逻辑大致是三部分
- 检验传入的参数是否合法
- 调用service处理具体的业务逻辑
- 检验和组装service返回的结果，并以此为依据向接口调用者返回信息。

import com.naylor.interfacedesign.domain.demo.controller.param.GetUserParam;import com.naylor.interfacedesign.domain.demo.dto.ResultDTO;import com.naylor.interfacedesign.domain.demo.dto.UserDTO;import com.naylor.interfacedesign.domain.demo.error.DemoErrorEnum;import lombok.extern.slf4j.Slf4j;import org.springframework.web.bind.annotation.*;@RestController@RequestMapping("/demo")@Slf4jpublic class DemoController {    @GetMapping("/user")    public ResultDTO<UserDTO> getUser(GetUserParam param) {        if (null == param) {            return ResultDTO.error(DemoErrorEnum.PARAM_NULL);        }        UserDTO userDTO = null;        // do something        return null != userDTO ? ResultDTO.success().setResult(userDTO) : ResultDTO.error(DemoErrorEnum.SERVER_ERROR);    }}

文章由极客之音整理，本文链接：https://www.bmabk.com/index.php/post/14909.html

Spring Boot接口设计

项目文件结构

编写示例代码

相关推荐