/**
*如果有时候返回值太多，也可将@Log注解中的result属性去掉（默认为false）
*也可以使用@NoNeedLogParam注解作用于参数上，让其不记录该参数值,可以用来去除一些系统参数，如HttpServletResponse等
*/
@Log(value = "获取权限列表", time = true)
@GetMapping("/v1/permissions")
public Result list(PermissionQuery condition){}


/**
*也可以用于类上,如下，只有在DEBUG级别下才会打印返回值【在返回值为列表时可用，防止记录过多日志】
*/
@Log(resLevel = Log.Level.DEBUG)
public class PermissionServiceImpl{}

@Log(value = "'测试使用: ' + #res?.fieldName", el = true) // 使用spel表达式，res表示返回值
@Log(value = "'测试使用: ' + #tc?.fieldName", el = true)  // 使用spel表达式，tc表示请求参数名
@GetMapping("/v1/test")
public TestClass list(@RequestBody TestClass tc){}

/**
* 可对实体字段加该注解，用于字段变更时更精细化描述，如 type(类型): 1[类型1] -> 2[类型2]
*/
@LogChange(name = "类型", enumValue = "TypeEnum.class")
private Integer type;

@Data
public class PermissionForm {
    private Integer groupId;
    /**
     * 字符串非空检验
     */
    @NotBlank
    private String uriPattern; 

    @NotBlank
    private String code;

    /**
     * method不能为空且只能是MethodEnum中对应的枚举值value
     */
    @EnumValue(MethodEnum.class)
    @NotNull
    private Integer method;

    @NotBlank
    private String description;

    /**
     * status只能是StatusEnum中(声明如下)对应的枚举值value
     */
    @EnumValue(StatusEnum.class)
    private Integer status;   
}

/**
 * 状态枚举类
 *
 * @author meilin.huang
 * @version 1.0
 * @date 2019-12-25 10:28 上午
 */
public enum StatusEnum implements NameValueEnum<Integer> {
    /**
     * 启用状态
     */
    ENABLE(1, "启用"),

    /**
     * 禁用状态
     */
    DISABLE(0, "禁用");

    private Integer value;
    private String name;
    EnableDisableEnum(Integer value, String name) {
        this.value = value;
        this.name = name;
    }


    @Override
    public String getName() {
        return this.name;
    }

    @Override
    public Integer getValue() {
        return this.value;
    }
}

/**
*每个方法都有丢应的权限code(用来进行权限校验以及前端页面按钮控制)  
*如果该注解只作用于类上，则类中所有方法对应的权限code为类权限code
*/
@mayfly.core.permission.Permission(code = "permission:")
@RestController
@RequestMapping("/sys")
public class PermissionController 

    // 可全局设置系统不满足断言条件时的默认错误码
    BizAssert.setDefaultError(xxxxxx)

    public void update(ResourceDO resource) {
        ResourceDO old = getById(resource.getId());
        BizAssert.notNull(old, "资源不存在");
        BizAssert.equals(resource.getType(), old.getType(), "资源类型不可变更");
        // 禁止误传修改其父节点
        resource.setPid(null);

        // 如果是权限，还需校验权限码
        if (Objects.equals(old.getType(), ResourceTypeEnum.PERMISSION.getValue())) {
            // 权限类型需要校验code不能为空
            String code = resource.getCode();
            // 如果修改了权限code，则需要校验
            if (!Objects.equals(old.getCode(), code)) {
                checkPermissionCode(code);
            }
        }
        updateByIdSelective(resource);
    }
    
    /**
     *  检验权限code
     */
    private void checkPermissionCode(String code) {
        BizAssert.notEmpty(code, "权限code不能为空");
        BizAssert.state(!code.contains(","), "权限code不能包含','");
        BizAssert.equals(countByCondition(new ResourceDO().setCode(code)), 0L, "该权限code已存在");
    }