Guns项目架构深度解析：SpringBoot + Shiro + MyBatis完美整合

Guns项目架构深度解析：SpringBoot + Shiro + MyBatis完美整合

【免费下载链接】gunsGuns基于SpringBoot,致力于做更简洁的后台管理系统,完美整合springmvc + shiro + 分页插件PageHelper + 通用Mapper + beetl!Guns项目代码简洁,注释丰富,上手容易,同时Guns包含许多基础模块(用户管理,角色管理,部门管理,字典管理等10个模块),可以直接作为一个后台管理系统的脚手架.项目地址: https://gitcode.com/gh_mirrors/gun/guns

Guns是一款基于SpringBoot开发的简洁高效后台管理系统，通过完美整合SpringMVC、Shiro、PageHelper、通用Mapper和Beetl等技术栈，提供了丰富的基础模块（用户管理、角色管理、部门管理等），可直接作为后台管理系统的脚手架使用。本文将深入剖析Guns项目的架构设计，揭示其如何实现SpringBoot、Shiro与MyBatis的无缝集成。

一、Guns项目核心架构概览 📊

Guns采用经典的分层架构设计，结合现代开发框架的优势，形成了清晰的模块划分。项目整体结构如下：

src/main/java/com/stylefeng/guns/ ├── common/ # 通用组件 ├── config/ # 配置类 ├── core/ # 核心功能 ├── modular/ # 业务模块 └── GunsApplication.java # 应用入口

其中，config目录集中管理所有框架配置，core目录包含权限控制、数据处理等核心功能，modular目录则按业务功能划分模块，这种结构既保证了代码的清晰性，又便于扩展和维护。

Guns项目后台管理界面展示了其简洁而功能丰富的UI设计

二、SpringBoot配置体系详解 🔧

Guns基于SpringBoot构建，充分利用了SpringBoot的自动配置特性，同时通过自定义配置类实现了灵活的功能扩展。

1. 核心配置类

在src/main/java/com/stylefeng/guns/config/web/目录下，集中了所有Web相关配置：

• ShiroConfig.java：Shiro安全框架的核心配置，包括安全管理器、会话管理、缓存配置等
• WebConfig.java：Web应用配置，包括拦截器、视图解析器等
• BeetlConfig.java：Beetl模板引擎配置

以ShiroConfig为例，其核心代码如下：

@Configuration public class ShiroConfig { @Bean public DefaultWebSecurityManager securityManager(...) { DefaultWebSecurityManager securityManager = new DefaultWebSecurityManager(); securityManager.setRealm(this.shiroDbRealm()); securityManager.setCacheManager(cacheShiroManager); // 其他配置... return securityManager; } // 其他Bean定义... }

2. 多环境配置支持

Guns通过src/main/java/com/stylefeng/guns/config/properties/目录下的配置类，实现了灵活的属性配置：

• DruidProperties.java：Druid数据源配置
• GunsProperties.java：项目核心配置
• MutiDataSourceProperties.java：多数据源配置

这些配置类通过@ConfigurationProperties注解与配置文件无缝对接，支持多环境配置切换。

三、Shiro安全框架整合 🔒

Guns使用Shiro实现身份认证和权限控制，其整合方式体现了良好的设计思想。

1. 安全管理器配置

在ShiroConfig中，通过securityManager方法配置了核心安全管理器：

@Bean public DefaultWebSecurityManager securityManager(CookieRememberMeManager rememberMeManager, CacheManager cacheShiroManager, SessionManager sessionManager) { DefaultWebSecurityManager securityManager = new DefaultWebSecurityManager(); securityManager.setRealm(this.shiroDbRealm()); // 设置自定义Realm securityManager.setCacheManager(cacheShiroManager); // 设置缓存管理器 securityManager.setRememberMeManager(rememberMeManager); // 记住我功能 securityManager.setSessionManager(sessionManager); // 会话管理 return securityManager; }

2. 自定义Realm实现

Guns通过ShiroDbRealm实现了自定义的身份认证和授权逻辑：

@Bean public ShiroDbRealm shiroDbRealm() { return new ShiroDbRealm(); }

ShiroDbRealm继承自AuthorizingRealm，重写了doGetAuthenticationInfo（认证）和doGetAuthorizationInfo（授权）方法，实现了基于数据库的权限管理。

3. 过滤器链配置

Shiro的过滤器链配置决定了URL的访问控制策略：

@Bean public ShiroFilterFactoryBean shiroFilter(DefaultWebSecurityManager securityManager) { ShiroFilterFactoryBean shiroFilter = new ShiroFilterFactoryBean(); shiroFilter.setSecurityManager(securityManager); shiroFilter.setLoginUrl("/login"); // 登录页 shiroFilter.setSuccessUrl("/"); // 登录成功页 shiroFilter.setUnauthorizedUrl("/global/error"); // 未授权页 // 过滤器链配置 Map<String, String> hashMap = new LinkedHashMap<>(); hashMap.put("/static/**", "anon"); // 静态资源无需认证 hashMap.put("/login", "anon"); // 登录页无需认证 hashMap.put("/**", "user"); // 其他路径需要认证 shiroFilter.setFilterChainDefinitionMap(hashMap); return shiroFilter; }

Guns项目登录界面，集成了Shiro身份认证功能

四、MyBatis-Plus数据访问层设计 🛢️

Guns使用MyBatis-Plus作为ORM框架，结合通用Mapper和PageHelper插件，极大简化了数据访问层的开发。

1. 数据源配置

在MybatisPlusConfig.java中，Guns支持单数据源和多数据源两种模式：

@Configuration @MapperScan(basePackages = {"com.stylefeng.guns.modular.*.dao", "com.stylefeng.guns.common.persistence.dao"}) public class MybatisPlusConfig { // 单数据源配置 @Bean @ConditionalOnProperty(prefix = "guns", name = "muti-datasource-open", havingValue = "false") public DruidDataSource singleDatasource() { return dataSourceGuns(); } // 多数据源配置 @Bean @ConditionalOnProperty(prefix = "guns", name = "muti-datasource-open", havingValue = "true") public DynamicDataSource mutiDataSource() { // 多数据源实现... } }

2. 数据范围拦截器

Guns通过自定义拦截器实现了数据权限控制：

@Bean public DataScopeInterceptor dataScopeInterceptor() { return new DataScopeInterceptor(); }

这个拦截器会根据当前用户的角色，自动为SQL语句添加数据范围条件，实现了行级别的数据权限控制。

3. 通用Mapper设计

在com.stylefeng.guns.common.persistence.dao包下，定义了通用的Mapper接口，所有业务Dao接口都继承自这些通用接口，从而获得了CRUD等基础操作方法，避免了重复代码。

五、模块化设计与业务集成 📦

Guns采用模块化设计思想，将业务功能划分为多个独立模块，每个模块包含控制器、服务、数据访问和视图等组件。

以系统管理模块为例，其结构如下：

src/main/java/com/stylefeng/guns/modular/system/ ├── controller/ # 控制器 ├── service/ # 服务层 ├── dao/ # 数据访问层 ├── model/ # 模型类 └── warpper/ # 结果包装器

这种模块化设计使得代码组织清晰，便于维护和扩展。同时，Guns提供了10个基础模块，包括用户管理、角色管理、部门管理、字典管理等，可以直接复用。

六、快速开始使用Guns项目 🚀

要开始使用Guns项目，只需按照以下步骤操作：

1. 克隆仓库：

   git clone https://gitcode.com/gh_mirrors/gun/guns

2. 导入数据库脚本：

   • 主数据库脚本：sql/guns.sql
   • 业务数据库脚本：sql/biz.sql

3. 配置数据库连接： 修改application.yml中的数据库连接信息

4. 启动项目： 运行GunsApplication.java的main方法

5. 访问系统： 打开浏览器访问http://localhost:8080

七、总结与展望 🌟

Guns项目通过巧妙整合SpringBoot、Shiro和MyBatis-Plus等主流框架，构建了一个功能完善、结构清晰的后台管理系统脚手架。其主要优势体现在：

• 架构清晰：采用分层设计和模块化思想，代码组织合理
• 安全可靠：基于Shiro的身份认证和权限控制
• 开发高效：集成通用Mapper和PageHelper，简化数据访问层开发
• 扩展性强：支持多数据源、多租户等高级特性
• 易于上手：代码简洁，注释丰富，文档完善

Guns项目架构设计如同城市规划，各个组件协同工作，构建出高效稳定的系统

无论是作为学习SpringBoot、Shiro、MyBatis整合的案例，还是直接作为项目开发的基础框架，Guns都具有很高的参考价值。通过深入理解Guns的架构设计，开发者可以提升自己的系统设计能力，构建出更优秀的Java后台系统。

【免费下载链接】gunsGuns基于SpringBoot,致力于做更简洁的后台管理系统,完美整合springmvc + shiro + 分页插件PageHelper + 通用Mapper + beetl!Guns项目代码简洁,注释丰富,上手容易,同时Guns包含许多基础模块(用户管理,角色管理,部门管理,字典管理等10个模块),可以直接作为一个后台管理系统的脚手架.项目地址: https://gitcode.com/gh_mirrors/gun/guns