之前开源了一款项目骨架mall-tiny,完整继承了mall项目的整个技术栈。总感觉mall-tiny集成了太多中间件,过于复杂了。这次对其进行了简化和升级,使它成为了一款拥有完整权限管理功能的快速开发脚手架,希望对大家有所帮助!
mall-tiny是一款基于SpringBoot+MyBatis-Plus的快速开发脚手架,拥有完整的权限管理功能,可对接Vue前端,开箱即用。
mall-tiny项目可无缝对接mall-admin-web前端项目,秒变权限管理系统。
简化依赖服务,只需安装最常用的MySql和Redis服务即可,数据库中需要导入mall_tiny.sql脚本。
src
├── common -- 用于存放通用代码| ├── api -- 通用结果集封装类
| ├── config -- 通用配置类
| ├── domain -- 通用封装对象
| ├── exception -- 全局异常处理相关类
| └── service -- 通用业务类
├── config -- SpringBoot中的Java配置
├── domain -- 共用封装对象
├── generator -- MyBatis-Plus代码生成器
├── modules -- 存放业务代码的基础包
| └── ums -- 权限管理模块业务代码
| ├── controller -- 该模块相关接口
| ├── dto -- 该模块数据传输封装对象
| ├── mapper -- 该模块相关Mapper接口
| ├── model -- 该模块相关实体类
| └── service -- 该模块相关业务处理类
└── security -- SpringSecurity认证授权相关代码├── annotation -- 相关注解├── aspect -- 相关切面├── component -- 认证授权相关组件├── config -- 相关配置└── util -- 相关工具类
resources
├── mapper -- MyBatis中mapper.xml存放位置
├── application.yml -- SpringBoot通用配置文件
├── application-dev.yml -- SpringBoot开发环境配置文件
├── application-prod.yml -- SpringBoot生产环境配置文件
└── generator.properties -- MyBatis-Plus代码生成器配置
直接运行启动类MallTinyApplication的main函数即可。
创建好pms模块的所有表,需要注意的是一定要写好表字段的注释,这样实体类和接口文档中就会自动生成字段说明了。
运行MyBatisPlusGenerator类的main方法来生成代码,可直接生成controller、service、mapper、model、mapper.xml的代码,无需手动创建。
由于MyBatis-Plus提供的增强功能相当强大,单表查询几乎不用手写SQL,直接使用ServiceImpl和BaseMapper中提供的方法即可。
比如我们的菜单管理业务实现类UmsMenuServiceImpl中的方法都直接使用了这些方法。
/*** 后台菜单管理Service实现类* Created by macro on 2020/2/2.*/
@Service
public class UmsMenuServiceImpl extends ServiceImpl<UmsMenuMapper,UmsMenu>implements UmsMenuService {@Overridepublic boolean create(UmsMenu umsMenu) {umsMenu.setCreateTime(new Date());updateLevel(umsMenu); return save(umsMenu);} @Overridepublic boolean update(Long id, UmsMenu umsMenu) {umsMenu.setId(id); updateLevel(umsMenu); return updateById(umsMenu);} @Overridepublic Page<UmsMenu> list(Long parentId, Integer pageSize, Integer pageNum) {Page<UmsMenu> page = new Page<>(pageNum,pageSize);QueryWrapper<UmsMenu> wrapper = new QueryWrapper<>();wrapper.lambda().eq(UmsMenu::getParentId,parentId) .orderByDesc(UmsMenu::getSort); return page(page,wrapper);} @Overridepublic List<UmsMenuNode> treeList() {List<UmsMenu> menuList = list(); List<UmsMenuNode> result = menuList.stream() .filter(menu -> menu.getParentId().equals(0L)).map(menu -> covertMenuNode(menu, menuList)).collect(Collectors.toList()); return result;} @Overridepublic boolean updateHidden(Long id, Integer hidden) {UmsMenu umsMenu = new UmsMenu();umsMenu.setId(id); umsMenu.setHidden(hidden); return updateById(umsMenu);}}
对于分页查询MyBatis-Plus原生支持,不需要再整合其他插件,直接构造Page对象,然后调用ServiceImpl中的page方法即可。
/*** 后台菜单管理Service实现类* Created by macro on 2020/2/2.*/
@Servicepublic class UmsMenuServiceImpl extends ServiceImpl<UmsMenuMapper,UmsMenu>implements UmsMenuService {@Override public Page<UmsMenu> list(Long parentId, Integer pageSize, Integer pageNum) {Page<UmsMenu> page = new Page<>(pageNum,pageSize);QueryWrapper<UmsMenu> wrapper = new QueryWrapper<>();wrapper.lambda().eq(UmsMenu::getParentId,parentId) .orderByDesc(UmsMenu::getSort); return page(page,wrapper);}}
对于多表查询,我们需要手写mapper.xml中的SQL实现,由于之前我们已经生成了mapper.xml文件,所以我们直接在Mapper接口中定义好方法,然后在mapper.xml写好SQL实现即可。
/*** <p>* 后台菜单表 Mapper 接口* </p>** @author macro* @since 2020-08-21*/
public interface UmsMenuMapper extends BaseMapper<UmsMenu> {/*** 根据后台用户ID获取菜单*/List<UmsMenu> getMenuList(@Param("adminId") Long adminId);
}
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.macro.mall.tiny.modules.ums.mapper.UmsMenuMapper"><select id="getMenuList" resultType="com.macro.mall.tiny.modules.ums.model.UmsMenu">SELECT m.id id, m.parent_id parentId, m.create_time createTime, m.title title, m.level level, m.sort sort, m.name name, m.icon icon, m.hidden hidden FROM ums_admin_role_relation arr LEFT JOIN ums_role r ON arr.role_id = r.id LEFT JOIN ums_role_menu_relation rmr ON r.id = rmr.role_id LEFT JOIN ums_menu m ON rmr.menu_id = m.id WHERE arr.admin_id = #{adminId} AND m.id IS NOT NULL GROUP BY m.id </select></mapper>
mall-tiny已经集成了Docker插件,可以打包成Docker镜像来部署
由于使用了SpringSecurity来实现认证和授权,部分接口需要token才可以访问,访问需要认证授权接口流程如下。
点击右上角Authorize按钮输入token,然后访问相关接口即可。
默认集成了Jakarta Bean Validation参数校验框架,只需在参数对象属性中添加javax.validation.constraints包中的注解注解即可实现校验功能,这里以登录参数校验为例。
/*** 用户登录参数* Created by macro on 2018/4/26.*/
@Data
@EqualsAndHashCode(callSuper = false)
public class UmsAdminLoginParam { @NotEmpty@ApiModelProperty(value = "用户名",required = true)private String username; @NotEmpty@ApiModelProperty(value = "密码",required = true)private String password;}
/*** 后台用户管理* Created by macro on 2018/4/26.*/
@Controller
@Api(tags = "UmsAdminController", description = "后台用户管理")
@RequestMapping("/admin")
public class UmsAdminController {@ApiOperation(value = "登录以后返回token")@RequestMapping(value = "/login", method = RequestMethod.POST)@ResponseBodypublic CommonResult login(@Validated @RequestBody UmsAdminLoginParam umsAdminLoginParam) {String token = adminService.login(umsAdminLoginParam.getUsername(), umsAdminLoginParam.getPassword()); if (token == null) {return CommonResult.validateFailed("用户名或密码错误");} Map<String, String> tokenMap = new HashMap<>(); tokenMap.put("token", token);tokenMap.put("tokenHead", tokenHead);return CommonResult.success(tokenMap);}}
原文链接:还在从零开始搭建项目?手撸了款快速开发脚手架! - 掘金
版权声明:本站所有资料均为网友推荐收集整理而来,仅供学习和研究交流使用。
工作时间:8:00-18:00
客服电话
电子邮件
admin@qq.com
扫码二维码
获取最新动态