SpringCloud-01

Spring Cloud是一个开源的微服务框架，它基于Spring Boot构建，提供了一系列的工具和组件，用于简化微服务的开发和部署。
Spring Cloud包含了许多常用的微服务模式和解决方案，比如服务发现、负载均衡、断路器、配置中心、网关等。它通过集成各种组件，帮助开发人员快速构建和部署微服务应用。

微服务小口诀：1.建Module
2.改pom
3.写YML
4.主启动
5.业务类

DTO（Data Transfer Object）和 VO（Value Object）都是一种设计模式，用于封装数据和提供服务。它们的主要区别在于：
DTO：用于封装数据传输对象，可以将数据库中的数据转换为前端需要的格式，方便前后端之间的数据交互。
VO：用于封装值对象，可以根据具体的需求来封装不同的数据属性，方便前端页面的显示和交互。

假设我们有一个 User 类，表示用户信息，包含 id、name 和 age 三个属性
1.如果我们需要在前端页面上显示用户信息，但是不需要显示用户的 id 属性。这时候，我们可以使用 VO 来封装用户信息的部分属性，UserVO 只包含了需要在前端页面上显示的属性 name 和 age，而不包含 id 属性。用于在前端页面上显示，这样可以避免将敏感数据传输到前端页面上，增加数据的安全性。
2.如果我们需要在前后端之间传输用户信息的全部属性，可以使用 DTO 来封装数据。UserDTO 包含了用户信息的全部属性，用于在前后端之间传输数据。由于 DTO 只包含数据属性，不包含任何业务逻辑，因此可以避免数据的重复查询和传输，提高程序的性能和效率。

一般而言，调用者不应该获取服务提供者的entity并知道表结构关系，所以服务提供者给出的接口文档都应该成为DTO

一般DTO是前端给后端，VO是后端给前端

@PutMapping("/pay/update")
    public String updatePay(@RequestBody PayDTO payDTO){
        Pay pay=new Pay();
        BeanUtil.copyProperties(payDTO,pay);        //payDTO拷贝到pay
        System.out.println(payDTO.toString());
        int i=payService.update(pay);
        return "成功更新记录，返回值"+i;
    }

BeanUtil.copyProperties(payDTO,pay);        //payDTO拷贝到pay

推荐@Resource 尽量不用@Autowired

测试工具PostMan Swagger3

规范时间格式
第一种： 加注解

@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss",timezone="GMT+8")
private Date createTime;

第二种： yml文件里配置

统一返回格式
3大标配：1.code状态值 2.message描述 3.data数据
拓展：时间戳

//枚举值
@Getter
public enum ReturnCodeEnum {
    /**操作失败**/
    RC999("999","操作XXX失败"),
    /**操作成功**/
    RC200("200","success"),
    /**服务降级**/
    RC201("201","服务开启降级保护,请稍后再试!"),
    /**热点参数限流**/
    RC202("202","热点参数限流,请稍后再试!"),
    /**系统规则不满足**/
    RC203("203","系统规则不满足要求,请稍后再试!"),
    /**授权规则不通过**/
    RC204("204","授权规则不通过,请稍后再试!"),
    /**access_denied**/
    RC403("403","无访问权限,请联系管理员授予权限"),
    /**access_denied**/
    RC401("401","匿名用户访问无权限资源时的异常"),
    RC404("404","404页面找不到的异常"),
    /**服务异常**/
    RC500("500","系统异常，请稍后重试"),
    RC375("375","数学运算异常，请稍后重试"),

    INVALID_TOKEN("2001","访问令牌不合法"),
    ACCESS_DENIED("2003","没有权限访问该资源"),
    CLIENT_AUTHENTICATION_FAILED("1001","客户端认证失败"),
    USERNAME_OR_PASSWORD_ERROR("1002","用户名或密码错误"),
    BUSINESS_ERROR("1004","业务逻辑异常"),
    UNSUPPORTED_GRANT_TYPE("1003", "不支持的认证模式");

    /**自定义状态码**/
    private final String code;
    /**自定义描述**/
    private final String message;

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

    //第一种：遍历枚举V1 传统方法
    public static ReturnCodeEnum getReturnCodeEnum(String code)
    {
        //ReturnCodeEnum.values()相当于上面枚举值数组
        for (ReturnCodeEnum element : ReturnCodeEnum.values()) {
            if(element.getCode().equalsIgnoreCase(code))
            {
                return element;
            }
        }
        return null;
    }
    //第二种：遍历枚举V2
    public static ReturnCodeEnum getReturnCodeEnumV2(String code)
    {
        return Arrays.stream(ReturnCodeEnum.values()).filter(x -> x.getCode().equalsIgnoreCase(code)).findFirst().orElse(null);
    }
}

//统一返回对象
@Data
@Accessors(chain = true)
public class ResultData<T> {
    private String code;/** 结果状态 ,具体状态码参见枚举类ReturnCodeEnum.java*/
    private String message;
    private T data;
    private long timestamp ;


    public ResultData (){
        this.timestamp = System.currentTimeMillis();    //调用接口的时间
    }

    public static <T> ResultData<T> success(T data) {
        ResultData<T> resultData = new ResultData<>();
        resultData.setCode(ReturnCodeEnum.RC200.getCode());
        resultData.setMessage(ReturnCodeEnum.RC200.getMessage());
        resultData.setData(data);
        return resultData;
    }

    public static <T> ResultData<T> fail(String code, String message) {
        ResultData<T> resultData = new ResultData<>();
        resultData.setCode(code);
        resultData.setMessage(message);
        return resultData;
    }

}

//异常统一返回
@Slf4j
@RestControllerAdvice
public class GlobalExceptionHandler {
    /**
     * 默认全局异常处理。
     * @param e the e
     * @return ResultData
     */
    @ExceptionHandler(RuntimeException.class)
    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
    public ResultData<String> exception(Exception e) {
        System.out.println("----come in GlobalExceptionHandler");
        log.error("全局异常信息exception:{}", e.getMessage(), e);
        return ResultData.fail(ReturnCodeEnum.RC500.getCode(),e.getMessage());
    }
}


//controller中调用
if(id==-1)throw new RuntimeException("id不能为负数");

RestTemplate是Spring框架中的一个HTTP客户端工具，用于发送HTTP请求并接收响应。它提供了一种简单、方便的方式来调用RESTful风格的Web服务。