add新增管理员功能、BaseController类的简介--------示例OJ

一、为什么使用BaseController类？

比如add方法：

优化了insert>0这一部分

如何判断新增是否成功,insert方法有返回值，

如果大于0则说明新增成功。

否则新增失败。

类似这种判断会有很多种。难道每次都要写这样的重复代码吗？

因此为了简化代码，我们使用BaseController，封装了返回结果。

根据int正负判断，因此这个部分会写大量代码，是重复的，其他的服务也需要这个判断逻辑
因此在公共中写这个方法，建立一个basecontroller类

优化是为了便于后续维护代码

1.降低代码重复度

示例：实现add方法

最开始

优化后
java 复制代码
return sysUserMapper.insert(sysUser);//再转换为实体
直接return就行了，将返回值改为int。这样在Controller层就直接调用封装方法。

二、完整的实现新增管理员用户功能

2.1BaseController类

toR就是toResult，转换成结果

java 复制代码

package com.qyy.common.core.controller;

import cn.hutool.core.collection.CollectionUtil;
import com.qyy.common.core.domain.R;
import com.qyy.common.core.domain.TableDataInfo;
import java.util.List;
import com.github.pagehelper.PageInfo;



// 封装返回结果，实现一些方法，用来简化代码
public class BaseController {
    //       if (insert > 0) {
//        return R.ok();
//    }
//        return R.fail();

    //toResult,如果rows>0  则插入成功，返回ok，
    // 否则返回fail
    public R<Void> toR(int rows) {
        return rows > 0 ? R.ok() : R.fail();
    }


    //       if (result) {
//        return R.ok();
//    }
//        return R.fail();
    public R<Void> toR(boolean result) {
        return result ? R.ok() : R.fail();
    }


    public TableDataInfo getTableDataInfo(List<?> list) {
        //list == null || list.isEmpty()
        if (CollectionUtil.isEmpty(list)) {
            return TableDataInfo.empty();
        }
//        new PageInfo<>(list).getTotal(); //获取符合查询条件的数据的总数
//        return TableDataInfo.success(list, list.size());
        return TableDataInfo.success(list, new PageInfo<>(list).getTotal());
    }
}

1.封装mapper层返回数据结果为int类型的

java 复制代码

    public R<Void> toR(int rows) {
        return rows > 0 ? R.ok() : R.fail();
    }

2.封装mapper层返回数据结果为boolean类型的

java 复制代码

public R<Void> toR(boolean result) {
        return result ? R.ok() : R.fail();
    }

3. 封装mapper层返回数据结果为List<?>类型的

java 复制代码

    public TableDataInfo getTableDataInfo(List<?> list) {
        //list == null || list.isEmpty()
        if (CollectionUtil.isEmpty(list)) {
            return TableDataInfo.empty();
        }
//        new PageInfo<>(list).getTotal(); //获取符合查询条件的数据的总数
//        return TableDataInfo.success(list, list.size());
        return TableDataInfo.success(list, new PageInfo<>(list).getTotal());
    }

2.2 SysUserController继承BaseController类

下面我以完整的新增管理员用户功能来演示一遍

Controller层调用业务逻辑层实现add方法

java 复制代码

@RestController
@RequestMapping("/sysUser")
@Tag(name = "管理员接口")
public class SysUserController extends BaseController {

    @Autowired
    private ISysUserService sysUserService;//引入业务逻辑层

    @PostMapping("/add")
    @Operation(summary = "新增管理员", description = "根据提供的信息新增管理员")
    @ApiResponse(responseCode = "1000", description = "操作成功")
    @ApiResponse(responseCode = "2000", description = "服务繁忙请稍后重试")
    @ApiResponse(responseCode = "3101", description = "用户已存在")
    public R<Void> add(@RequestBody SysUserSaveDTO sysUserSaveDTO) {
        return toR(sysUserService.add(sysUserSaveDTO));//调用业务逻辑层，toR是封装返回结果
    }
}

ISysUserService接口

java 复制代码

public interface ISysUserService {
    int add(SysUserSaveDTO sysUserSaveDTO);
}

实现ISysUserService接口，实现add方法

java 复制代码

@Service
@RefreshScope //这个注解可以实现动态刷新配置文件，以达到不重启服务器就刷新配置文件的方式，达到动态刷新配置文件的目的。
@Slf4j
public class SysUserServiceImpl implements ISysUserService {
    @Autowired
    private SysUserMapper sysUserMapper;//引入mapper

    @Override
    public int add(SysUserSaveDTO sysUserSaveDTO) {

        //判断用户账号是否已经存在，这是mybatisplus的查询方式
        List<SysUser> sysUserList = sysUserMapper.selectList(new LambdaQueryWrapper<SysUser>()
                .eq(SysUser::getUserAccount, sysUserSaveDTO.getUserAccount()));
        //这段代码的作用是从数据库中查询SysUser表里所有userAccount与sysUserSaveDTO对象中指定的用户账号相匹配的记录，
        //并将查询结果集以List<SysUser>的形式返回并赋值给sysUserList变量。这样做的目的是为了根据特定的用户账号信息筛选出对应的用户信息列表。


        //用hutool工具类判断集合是否为空
        if (CollectionUtil.isNotEmpty(sysUserList)) {
            //用户已经存在
            //自定义的异常   公共的异常类
            throw new ServiceException(ResultCode.AILED_USER_EXISTS);
        }
        SysUser sysUser = new SysUser();//创建一个用户实体类，insert方法要放入实体的
        sysUser.setUserAccount(sysUserSaveDTO.getUserAccount());//用户账号
        sysUser.setPassword(BCryptUtils.encryptPassword(sysUserSaveDTO.getPassword()));//用户密码
        sysUser.setCreateBy(Constants.SYSTEM_USER_ID);//创建人，用户id

        return sysUserMapper.insert(sysUser);//再转换为实体
    }
}