如何基于mysiteforme进行二次开发：自定义模块扩展实战教程

如何基于mysiteforme进行二次开发自定义模块扩展实战教程【免费下载链接】mysiteformemysiteforme权限管理系统是作者学习springBoot时基于springBoot开发的一套轻量级的系统脚手架可以以此形成一套属于自己的系统后台 自动生成前后台基本代码使用Spring Boot、Shiro、MyBatis、Layui等框架包含用户管理、角色管理、权限管理、资源管理、数据库管理、源码生成、调度管理等项目地址: https://gitcode.com/gh_mirrors/my/mysiteformemysiteforme权限管理系统是一款基于Spring Boot开发的轻量级系统脚手架提供用户管理、角色管理、权限管理等核心功能支持自动生成前后台基本代码非常适合开发者进行二次开发和自定义模块扩展。本文将以实战方式详细介绍如何在mysiteforme基础上快速开发自定义业务模块即使是新手也能轻松掌握。一、开发环境准备与项目结构解析在开始自定义模块开发前需要先完成基础环境配置和项目结构的熟悉这是确保后续开发顺利的关键步骤。1.1 快速搭建开发环境首先通过Git克隆项目仓库到本地git clone https://gitcode.com/gh_mirrors/my/mysiteforme项目采用前后端分离架构主要包含两个核心目录server-admin/后端Spring Boot应用包含控制器、服务层、数据访问层等server-ui/前端Vue应用包含页面组件、API调用和状态管理图1mysiteforme系统架构概览展示了前后端分离的项目结构1.2 核心目录功能说明后端核心目录结构controller/请求处理层如DictController.java处理字典管理请求service/业务逻辑层包含接口和实现类dao/数据访问层与数据库交互entity/实体类定义包含DTO、VO和请求/响应对象util/工具类集合如GenCodeConstants.java定义代码生成常量二、自定义模块开发完整流程以客户管理模块为例我们将按照数据库设计→后端开发→前端实现→权限配置的步骤完整演示自定义模块的开发过程。2.1 数据库表设计首先通过系统提供的数据表管理功能创建模块所需的数据库表。登录系统后进入系统管理→数据表管理点击新增按钮图2mysiteforme数据表管理界面支持可视化创建和编辑数据库表创建customer表包含以下字段id主键name客户名称phone联系电话email电子邮箱address联系地址create_time创建时间update_time更新时间系统会自动处理基础字段如创建时间、更新时间这些在GenCodeConstants.java中定义。2.2 后端接口开发后端开发遵循控制器→服务→数据访问的层次结构我们可以参考DictController.java和TableController.java的实现方式。2.2.1 创建实体类在server-admin/src/main/java/com/mysiteforme/admin/entity/目录下创建Customer.java实体类package com.mysiteforme.admin.entity; import com.baomidou.mybatisplus.annotation.TableName; import com.mysiteforme.admin.base.DataEntity; import lombok.Data; Data TableName(customer) public class Customer extends DataEntityCustomer { private String name; private String phone; private String email; private String address; }2.2.2 编写数据访问层在server-admin/src/main/java/com/mysiteforme/admin/dao/目录下创建CustomerDao.javapackage com.mysiteforme.admin.dao; import com.baomidou.mybatisplus.core.mapper.BaseMapper; import com.mysiteforme.admin.entity.Customer; import org.springframework.stereotype.Repository; Repository public interface CustomerDao extends BaseMapperCustomer { }2.2.3 实现服务层在server-admin/src/main/java/com/mysiteforme/admin/service/目录下创建CustomerService.java接口和impl/CustomerServiceImpl.java实现类// 接口 public interface CustomerService extends BaseServiceCustomer { PageCustomer selectPage(PageListCustomerRequest request); } // 实现类 Service public class CustomerServiceImpl extends BaseServiceImplCustomerDao, Customer implements CustomerService { Override public PageCustomer selectPage(PageListCustomerRequest request) { PageCustomer page new Page(request.getPage(), request.getLimit()); QueryWrapperCustomer queryWrapper new QueryWrapper(); if (StringUtils.isNotBlank(request.getName())) { queryWrapper.like(name, request.getName()); } return baseMapper.selectPage(page, queryWrapper); } }2.2.4 开发控制器在server-admin/src/main/java/com/mysiteforme/admin/controller/system/目录下创建CustomerController.javaRestController RequestMapping(/api/admin/customer) RequiredArgsConstructor public class CustomerController { private final CustomerService customerService; GetMapping(list) public Result list(PageListCustomerRequest request) { return Result.success(customerService.selectPage(request)); } PostMapping(add) SysLog(新增客户) public Result add(RequestBody Valid AddCustomerRequest request) { customerService.saveCustomer(request); return Result.success(); } // 其他接口edit、delete等 }2.3 前端页面实现前端开发主要包括页面组件创建、API调用和路由配置使用Vue框架和Element UI组件库。2.3.1 创建API文件在server-ui/src/api/目录下创建customerApi.tsimport request from /utils/http/index; export const getCustomerList (params) { return request({ url: /api/admin/customer/list, method: get, params }); }; export const addCustomer (data) { return request({ url: /api/admin/customer/add, method: post, data }); };2.3.2 开发页面组件在server-ui/src/views/目录下创建customer/文件夹添加CustomerList.vue和CustomerEdit.vue组件!-- CustomerList.vue -- template PageWrapper title客户管理 ArtSearchBar :searchListsearchList searchhandleSearch / ArtTable reftable :columnscolumns :apiloadData :rowKeyrowKey refreshhandleRefresh template #action{ record } el-button typetext clickhandleEdit(record)编辑/el-button el-button typetext clickhandleDelete(record)删除/el-button /template /ArtTable /PageWrapper /template script setup langts import { ref } from vue; import { getCustomerList, deleteCustomer } from /api/customerApi; const columns [ { label: 客户名称, prop: name }, { label: 联系电话, prop: phone }, { label: 电子邮箱, prop: email }, { label: 联系地址, prop: address }, { label: 创建时间, prop: createTime }, { label: 操作, slot: action } ]; const loadData async (params) { const res await getCustomerList(params); return res.data; }; /script2.3.3 配置路由在server-ui/src/router/modules/asyncRoutes.ts中添加路由配置{ path: /customer, name: customer, component: Layout, meta: { title: 客户管理, icon: system:peoples }, children: [ { path: list, name: customerList, component: () import(/views/customer/CustomerList.vue), meta: { title: 客户列表 } } ] }2.4 权限配置最后需要配置模块权限确保只有授权用户可以访问新开发的功能。进入系统权限管理→菜单管理添加新菜单图3mysiteforme权限分配界面可设置菜单访问权限和操作权限添加菜单后在角色管理中为相应角色分配权限完成整个自定义模块的开发。三、模块扩展高级技巧3.1 利用代码生成工具加速开发mysiteforme提供了强大的代码生成功能可以根据数据库表结构自动生成前后端代码。在系统管理→代码生成中选择创建的customer表配置生成参数生成包名com.mysiteforme.admin模块名称customer生成类型全量生成包含Controller、Service、DAO、Entity、Vue页面生成的代码会自动保持与项目现有风格一致大大减少重复劳动。3.2 自定义权限控制系统支持细粒度的权限控制可以通过注解SysLog记录操作日志通过RateLimit实现接口限流RestController RequestMapping(/api/admin/customer) RateLimit(limit 40, period 1, timeUnit TimeUnit.MINUTES) public class CustomerController { PostMapping(add) SysLog(新增客户) public Result add(RequestBody Valid AddCustomerRequest request) { // 业务逻辑 } }3.3 集成第三方服务系统设计了灵活的扩展机制可以轻松集成第三方服务。例如通过UploadServiceFactory.java配置文件上传服务支持本地存储、七牛云等多种存储方式。四、常见问题与解决方案4.1 数据表创建失败问题创建表时提示表名包含Java关键字解决检查表名是否使用了Java关键字如class、interface等可在GenCodeConstants.java中查看系统禁止使用的关键字列表。4.2 前端页面不显示问题添加路由后菜单不显示解决确保在权限管理中添加了菜单并为当前用户的角色分配了该菜单权限。4.3 接口访问403问题调用接口返回403错误解决检查接口是否添加了正确的权限注解或在SecurityConfig.java中配置了忽略认证的路径。五、总结通过本文的实战教程我们了解了基于mysiteforme进行自定义模块扩展的完整流程从环境准备、数据库设计、前后端开发到权限配置。mysiteforme提供的代码生成工具和灵活的架构设计使二次开发变得简单高效。无论是开发新的业务模块还是扩展现有功能都能快速实现。鼓励开发者深入探索项目源码特别是server-admin/src/main/java/com/mysiteforme/admin/目录下的核心实现结合实际需求进行更多定制化开发。【免费下载链接】mysiteformemysiteforme权限管理系统是作者学习springBoot时基于springBoot开发的一套轻量级的系统脚手架可以以此形成一套属于自己的系统后台 自动生成前后台基本代码使用Spring Boot、Shiro、MyBatis、Layui等框架包含用户管理、角色管理、权限管理、资源管理、数据库管理、源码生成、调度管理等项目地址: https://gitcode.com/gh_mirrors/my/mysiteforme创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考