tyboot 无sql编码简单功能演示

tyboot 无sql编码简单功能演示

tybootdemo源码

https://gitee.com/magintursh/tybootdemo

tyboot源码：

https://gitee.com/magintursh/tyboot

https://github.com/magintursh/tyboot

示例项目接口截图

如下为这次演示的接口功能，用以演示基于tyboot的简单编码

postman 接口文档： https://documenter.getpostman.com/view/29857/SzmY8gBk?version=latest

无sql编码体验

主要是service层的简单代码演示，orm层的mapper只是个空接口，非必要是不须要定义方法的，因此说，几乎全部时候的代码都只须要写service层的类就能够了。

示例项目中的service类没有接口，只有个实现类，这个后续在进行讨论。

controller

@RestController
@TycloudResource(module = "demo", value = "demo")
@RequestMapping(value = "/v1/demo")
@Api(tags ="demo-示例")
public class TybootDemoResource {

    @Autowired
    private PublicUserInfoService publicUserInfoService;

    @TycloudOperation(ApiLevel = UserType.PUBLIC,needAuth = false)
    @ApiOperation(value = "建立数据")
    @RequestMapping(value = "", method = RequestMethod.POST)
    public ResponseModel<PublicUserInfoModel> createUser(@RequestBody PublicUserInfoModel model) throws Exception {
        if(ValidationUtil.isEmpty(model) || ValidationUtil.isEmpty(model.getMobile()))
            throw new BadRequest("数据校验失败.");
        RequestContext.setExeUserId("system");//未作用户认证，拿不到当前用户信息，手动填充。
        return ResponseHelper.buildResponse(publicUserInfoService.createUser(model));
    }

    @TycloudOperation(ApiLevel = UserType.PUBLIC,needAuth = false)
    @ApiOperation(value = "更新数据")
    @RequestMapping(value = "/{userId}", method = RequestMethod.PUT)
    public ResponseModel<PublicUserInfoModel> updateUser(@PathVariable("userId") String  userId,@RequestBody PublicUserInfoModel model) throws Exception {
        RequestContext.setExeUserId("system");//未作用户认证，拿不到当前用户信息，手动填充。
        model.setUserId(userId);
        return ResponseHelper.buildResponse(publicUserInfoService.updateUser(model));
    }

    @TycloudOperation(ApiLevel = UserType.PUBLIC,needAuth = false)
    @ApiOperation(value = "查询单个数据对象")
    @RequestMapping(value = "/{userId}", method = RequestMethod.GET)
    public ResponseModel<PublicUserInfoModel> queryByUserId(@PathVariable("userId") String  userId) throws Exception {
        return ResponseHelper.buildResponse(publicUserInfoService.queryByUserId(userId));
    }

    @TycloudOperation(ApiLevel = UserType.PUBLIC,needAuth = false)
    @ApiOperation(value = "查询数据列表")
    @RequestMapping(value = "/list", method = RequestMethod.GET)
    public ResponseModel<List<PublicUserInfoModel>> queryByAgencyCode(@RequestParam("agencyCode") String  agencyCode) throws Exception {
        return ResponseHelper.buildResponse(publicUserInfoService.queryByAgencyCode(agencyCode));
    }

    @TycloudOperation(ApiLevel = UserType.PUBLIC,needAuth = false)
    @ApiOperation(value = "分页查询数据列表")
    @RequestMapping(value = "/page", method = RequestMethod.GET)
    public ResponseModel<Page<PublicUserInfoModel>> queryUserPage(
            @RequestParam(value = "agencyCode",required = false) String  agencyCode,
            @RequestParam(value = "nickName",required = false) String  nickName,
            @RequestParam(value = "current") int current,
            @RequestParam(value = "size") int size) throws Exception {
        Page<PublicUserInfoModel> page = new Page(current,size);
        return ResponseHelper.buildResponse(publicUserInfoService.queryUserPage(page,agencyCode,nickName));
    }
}

方法 ResponseHelper.buildResponse() 会返回统一的数据格式 以下：

{
    "status": 200,  //状态码，同http返回码
    "result": null,//结果对象
    "traceId": "1255684406704324610",//请求编号
    "devMessage": "SUCCESS",//错误信息，给开发人员看的，可能会有错误栈输出到这里
    "message": "", //给用户提示用的信息，正常都为空，不为空的时候就是有错误信息
    "path": "/v1/demo"   //这次请求的 路径
}

service

演示service中的编码，简单的无sql编码体验，BaseService 中已经封装不少泛型方法，能够选择使用，

关于缓存：

建立数据 更新数据 查询数据 都有带缓存的方法能够使用，完成缓存更新，保持缓存与mysql之间的同步。此处只作简单数据缓存，复杂的业务功能相关缓存仍是手动处理比较合适。

关于mapper：

此处没有引用mapper接口 ，也没有定义xml，也没有写sql。只须要写完以下方法，一个模块的基础功能便可完成。（其实代码生成部分已经能够生成以下方法）.mapper只是个空的接口，非必要，是不用在其中定义方法。除非在复杂报表查询 必须得写sql的时候才会考虑在其中定义方法。

@Service
public class PublicUserInfoService extends BaseService<PublicUserInfoModel, PublicUserInfo, PublicUserInfoMapper> {

    /**
     * 建立数据
     * 使用 BaseService 提供的方法 直接保存到关系数据库   或者同时根据业务主键保存到redis
     */
    public PublicUserInfoModel createUser(PublicUserInfoModel model) throws Exception
    {
        //临时使用的userId初始化
        String userId = Sequence.generatorSmsVerifyCode6();
        model.setUserId(userId);
        model.setCreateTime(new Date());
        model.setAgencyCode(CoreConstans.CODE_SUPER_ADMIN);
        //保存到数据库,并按业务主键 userId  进行缓存,并删除按agencyCode缓存的列表数据.,业务主键不填的话默认按物理主键缓存
        //return this.createWithCache(model,model.getUserId(),genCacheKeyForModelList(model.getAgencyCode()));

        // 直接保存到数据库
        return createWithModel(model);
    }

    /**
     * 根据物理主键更新数据
     * 使用 BaseService 提供的方法 直接保存到关系数据库   或者同时根据业务主键 更新对象到redis
     */
    public PublicUserInfoModel updateUser(PublicUserInfoModel model) throws Exception
    {
        //保存到数据库,并按业务主键 userId  更新 缓存,并删除按agencyCode缓存的列表数据.
        //this.updateWithCache(model,model.getUserId(),genCacheKeyForModelList(model.getAgencyCode()));

        //直接保存到数据库
        return this.updateWithModel(model);
    }

    /**
     * 按条件 查询单个对象
     * 方法参数名须要和 PublicUserInfoModel 中定义的属性名保持一直,
     *  才能使用 queryModelByParamsWithCache 和 queryModelByParams 方法.
     *  而且 调用的方法传参顺序 要和 当前方法参数顺序保持一致.
     */
    public PublicUserInfoModel queryByUserId(String userId) throws Exception
    {
        //查询单个对象 并按参数缓存结果,下一次一样参数就直接从缓存获取.
        //this.queryModelByParamsWithCache(userId);

        return this.queryModelByParams(userId);
    }

    /**
     * 按条件查询列表，按建立时间倒叙排列
       被调用方法的参数顺序须要和当前方法保持i一直 
     */
    public List<PublicUserInfoModel> queryByAgencyCode(String agencyCode) throws Exception
    {
        //按参数 缓存查询结果 下一次一样参数 就直接读取缓存
        //this.queryForListWithCache("CREATE_TIME",false,agencyCode);

        //查询top列表
        //this.queryForTopList(10,"CREATE_TIME",false,agencyCode);

        return this.queryForList("CREATE_TIME",false,agencyCode);
    }

    /**
     * 按条件分页查询,  被调用方法的参数顺序须要和当前方法保持i一直 
     */
    public Page<PublicUserInfoModel> queryUserPage(Page<PublicUserInfoModel> page,String agencyCode,@Condition(Operator.like) String nickName) throws Exception
    {
        return this.queryForPage(page,"CREATE_TIME",false,agencyCode,nickName);
    }

}

关于注解 @Condition ：

​ 用户查询参数的逻辑关系定义，默认是 and ，内部是使用 mybatisplus 条件进行判断的。已经封装的条件 请查看类 org.typroject.tyboot.core.rdbms.annotation.Operator 中的定义

如下是 vo po 和mapper的代码

mapper ：

public interface PublicUserInfoMapper extends BaseMapper<PublicUserInfo> {

}

model：

package org.typroject.tyboot.demo.face.model;

import lombok.Data;
import lombok.EqualsAndHashCode;
import org.typroject.tyboot.core.rdbms.model.BaseModel;

import java.util.Date;

@EqualsAndHashCode(callSuper = true)
@Data
public class PublicUserInfoModel extends BaseModel {

    private static final long serialVersionUID = 1L;

    private String userId;
    private String agencyCode;
    private String nickName;
    private String mobile;
    private String gender;
    private Date createTime;
    private Integer userAge;
    private String email;
}

entity：

package org.typroject.tyboot.demo.face.orm.entity;

import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;
import lombok.EqualsAndHashCode;
import org.typroject.tyboot.core.rdbms.orm.entity.BaseEntity;

import java.util.Date;

@EqualsAndHashCode(callSuper = true)
@Data
@TableName("public_user_info")
public class PublicUserInfo extends BaseEntity {

    private static final long serialVersionUID = 1L;

    @TableField("USER_ID")
    private String userId;
    @TableField("AGENCY_CODE")
    private String agencyCode;
    @TableField("NICK_NAME")
    private String nickName;
    @TableField("MOBILE")
    private String mobile;
    @TableField("GENDER")
    private String gender;
    @TableField("CREATE_TIME")
    private Date createTime;
    @TableField("USER_AGE")
    private Integer userAge;
    @TableField("EMAIL")
    private String email;
}

无sql编码也只是相对的。目前实现的是针对单表操做的处理。能用单表处理的业务就没必要要使用太过于复杂的sql来处理业务问题。单表操做方便缓存，方便后续数据库拆分等等好处。