shiro之INI配置详解

发布时间 - 2026-01-11 03:21:11    点击率:

如果大家使用过如Spring之类的IoC/DI容器的话,Shiro提供的INI配置也是非常类似的,即可以理解为是一个IoC/DI容器,但是区别在于它从一个根对象securityManager开始。 

根对象SecurityManager

从之前的Shiro架构图可以看出,Shiro是从根对象SecurityManager进行身份验证和授权的;也就是所有操作都是自它开始的,这个对象是线程安全且真个应用只需要一个即可,因此Shiro提供了SecurityUtils让我们绑定它为全局的,方便后续操作。

因为Shiro的类都是POJO的,因此都很容易放到任何IoC容器管理。但是和一般的IoC容器的区别在于,Shiro从根对象securityManager开始导航;Shiro支持的依赖注入:public空参构造器对象的创建、setter依赖注入。 

1、纯Java代码写法(com.github.zhangkaitao.shiro.chapter4.NonConfigurationCreateTest): 

DefaultSecurityManager securityManager = new DefaultSecurityManager(); 
//设置authenticator 
ModularRealmAuthenticator authenticator = new ModularRealmAuthenticator(); 
authenticator.setAuthenticationStrategy(new AtLeastOneSuccessfulStrategy()); 
securityManager.setAuthenticator(authenticator); 
 
//设置authorizer 
ModularRealmAuthorizer authorizer = new ModularRealmAuthorizer(); 
authorizer.setPermissionResolver(new WildcardPermissionResolver()); 
securityManager.setAuthorizer(authorizer); 




//设置Realm 
DruidDataSource ds = new DruidDataSource(); 
ds.setDriverClassName("com.mysql.jdbc.Driver"); 
ds.setUrl("jdbc:mysql://localhost:3306/shiro"); 
ds.setUsername("root"); 
ds.setPassword(""); 
 
JdbcRealm jdbcRealm = new JdbcRealm(); 
jdbcRealm.setDataSource(ds); 
jdbcRealm.setPermissionsLookupEnabled(true); 
securityManager.setRealms(Arrays.asList((Realm) jdbcRealm)); 
 
//将SecurityManager设置到SecurityUtils 方便全局使用 
SecurityUtils.setSecurityManager(securityManager); 

Subject subject = SecurityUtils.getSubject(); 
UsernamePasswordToken token = new UsernamePasswordToken("zhang", "123"); 
subject.login(token); 
Assert.assertTrue(subject.isAuthenticated());   


2.1、等价的INI配置(shiro-config.ini) 

[main] 
#authenticator 
authenticator=org.apache.shiro.authc.pam.ModularRealmAuthenticator 
authenticationStrategy=org.apache.shiro.authc.pam.AtLeastOneSuccessfulStrategy 
authenticator.authenticationStrategy=$authenticationStrategy 
securityManager.authenticator=$authenticator 
 
#authorizer 
authorizer=org.apache.shiro.authz.ModularRealmAuthorizer 
permissionResolver=org.apache.shiro.authz.permission.WildcardPermissionResolver 
authorizer.permissionResolver=$permissionResolver 
securityManager.authorizer=$authorizer 
 
#realm 
dataSource=com.alibaba.druid.pool.DruidDataSource 
dataSource.driverClassName=com.mysql.jdbc.Driver 
dataSource.url=jdbc:mysql://localhost:3306/shiro 
dataSource.username=root 
#dataSource.password= 
dbcRealm=org.apache.shiro.realm.jdbc.JdbcRealm 
jdbcRealm.dataSource=$dataSource 
jdbcRealm.permissionsLookupEnabled=true 
securityManager.realms=$jdbcRealm  

即使没接触过IoC容器的知识,如上配置也是很容易理解的:

1、对象名=全限定类名  相对于调用public无参构造器创建对象
2、对象名.属性名=值    相当于调用setter方法设置常量值
3、对象名.属性名=$对象引用    相当于调用setter方法设置对象引用 

2.2、Java代码(com.github.zhangkaitao.shiro.chapter4.ConfigurationCreateTest) 

Factory<org.apache.shiro.mgt.SecurityManager> factory = 
     new IniSecurityManagerFactory("classpath:shiro-config.ini"); 
 
org.apache.shiro.mgt.SecurityManager securityManager = factory.getInstance(); 


//将SecurityManager设置到SecurityUtils 方便全局使用 
SecurityUtils.setSecurityManager(securityManager); 
Subject subject = SecurityUtils.getSubject(); 
UsernamePasswordToken token = new UsernamePasswordToken("zhang", "123"); 
subject.login(token); 
 
Assert.assertTrue(subject.isAuthenticated());  

如上代码是从Shiro INI配置中获取相应的securityManager实例:
1、默认情况先创建一个名字为securityManager,类型为org.apache.shiro.mgt.DefaultSecurityManager的默认的SecurityManager,如果想自定义,只需要在ini配置文件中指定“securityManager=SecurityManager实现类”即可,名字必须为securityManager,它是起始的根;
2、IniSecurityManagerFactory是创建securityManager的工厂,其需要一个ini配置文件路径,其支持“classpath:”(类路径)、“file:”(文件系统)、“url:”(网络)三种路径格式,默认是文件系统;
3、接着获取SecuriyManager实例,后续步骤和之前的一样。 

从如上可以看出Shiro INI配置方式本身提供了一个简单的IoC/DI机制方便在配置文件配置,但是是从securityManager这个根对象开始导航。    

INI配置

ini配置文件类似于Java中的properties(key=value),不过提供了将key/value分类的特性,key是每个部分不重复即可,而不是整个配置文件。如下是INI配置分类: 
Java代码  

[main] 
#提供了对根对象securityManager及其依赖的配置 
securityManager=org.apache.shiro.mgt.DefaultSecurityManager 
.………… 
securityManager.realms=$jdbcRealm 
 
[users] 
#提供了对用户/密码及其角色的配置,用户名=密码,角色1,角色2 
username=password,role1,role2 

[roles] 
#提供了角色及权限之间关系的配置,角色=权限1,权限2 
role1=permission1,permission2 
 
[urls] 
#用于web,提供了对web url拦截相关的配置,url=拦截器[参数],拦截器 
/index.html = anon 
/admin/** = authc, roles[admin], perms["permission1"] 

[main]部分

提供了对根对象securityManager及其依赖对象的配置。

创建对象 

Java代码  

securityManager=org.apache.shiro.mgt.DefaultSecurityManager 

其构造器必须是public空参构造器,通过反射创建相应的实例。 

常量值setter注入 

Java代码  

dataSource.driverClassName=com.mysql.jdbc.Driver 
jdbcRealm.permissionsLookupEnabled=true  

会自动调用jdbcRealm.setPermissionsLookupEnabled(true),对于这种常量值会自动类型转换。 

对象引用setter注入 

Java代码  

authenticator=org.apache.shiro.authc.pam.ModularRealmAuthenticator 
authenticationStrategy=org.apache.shiro.authc.pam.AtLeastOneSuccessfulStrategy 
authenticator.authenticationStrategy=$authenticationStrategy 
securityManager.authenticator=$authenticator  

会自动通过securityManager.setAuthenticator(authenticator)注入引用依赖。 

嵌套属性setter注入 

Java代码  

securityManager.authenticator.authenticationStrategy=$authenticationStrategy   

也支持这种嵌套方式的setter注入。 

byte数组setter注入 
Java代码  

#base64 byte[] 
authenticator.bytes=aGVsbG8= 
#hex byte[] 
authenticator.bytes=0x68656c6c6f  

默认需要使用Base64进行编码,也可以使用0x十六进制。 

Array/Set/List setter注入 

Java代码  

authenticator.array=1,2,3 
authenticator.set=$jdbcRealm,$jdbcRealm  


多个之间通过“,”分割。 

Map setter注入

Java代码  

authenticator.map=$jdbcRealm:$jdbcRealm,1:1,key:abc 

即格式是:map=key:value,key:value,可以注入常量及引用值,常量的话都看作字符串(即使有泛型也不会自动造型)。         

实例化/注入顺序 
Java代码  

realm=Realm1 
realm=Realm12 
 
authenticator.bytes=aGVsbG8= 
authenticator.bytes=0x68656c6c6f  

后边的覆盖前边的注入。 

测试用例请参考配置文件shiro-config-main.ini。 

[users]部分
配置用户名/密码及其角色,格式:“用户名=密码,角色1,角色2”,角色部分可省略。如:

Java代码  

[users] 
zhang=123,role1,role2 
wang=123  

密码一般生成其摘要/加密存储,后续章节介绍。 

[roles]部分
配置角色及权限之间的关系,格式:“角色=权限1,权限2”;如:
Java代码  

[roles] 
role1=user:create,user:update 
role2=*  

如果只有角色没有对应的权限,可以不配roles,具体规则请参考授权章节。 

[urls]部分

配置url及相应的拦截器之间的关系,格式:“url=拦截器[参数],拦截器[参数],如:  
Java代码  

[urls] 
/admin/** = authc, roles[admin], perms["permission1"]  

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。


# shiro  # INI  # 使用Shiro实现登录成功后跳转到之前的页面  # 基于Spring框架的Shiro配置方法  # shiro实现单点登录(一个用户同一时刻只能在一个地方登录)  # java shiro实现退出登陆清空缓存  # Java中SSM+Shiro系统登录验证码的实现方法  # Apache Shiro 使用手册(三) Shiro授权  # 让Apache Shiro保护你的应用  # Apache Shiro 使用手册(四) Realm 实现  # SpringBoot+Shiro学习之密码加密和登录失败次数限制示例  # spring boot 1.5.4 集成shiro+cas  # 实现单点登录和权限控制  # 配置文件  # 是从  # 拦截器  # 都是  # 可以看出  # 文件系统  # 请参考  # 是一个  # 让我们  # 多个  # 只需  # 要在  # 它是  # 很容易  # 都很  # 三种  # 自定义  # 只需要  # 可以使用  # 相对于 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: 香港服务器建站指南:免备案优势与SEO优化技巧全解析  如何快速查询域名建站关键信息?  Laravel如何设置定时任务(Cron Job)_Laravel调度器与任务计划配置  iOS中将个别页面强制横屏其他页面竖屏  教你用AI润色文章,让你的文字表达更专业  如何快速完成中国万网建站详细流程?  logo在线制作免费网站在线制作好吗,DW网页制作时,如何在网页标题前加上logo?  jimdo怎样用html5做选项卡_jimdo选项卡html5实现与切换效果【指南】  如何制作一个表白网站视频,关于勇敢表白的小标题?  佛山网站制作系统,佛山企业变更地址网上办理步骤?  Win11怎么设置默认图片查看器_Windows11照片应用关联设置  Laravel怎么实现模型属性转换Casting_Laravel自动将JSON字段转为数组【技巧】  魔毅自助建站系统:模板定制与SEO优化一键生成指南  如何利用DOS批处理实现定时关机操作详解  Laravel DB事务怎么使用_Laravel数据库事务回滚操作  如何获取PHP WAP自助建站系统源码?  Laravel怎么做数据加密_Laravel内置Crypt门面的加密与解密功能  微信小程序制作网站有哪些,微信小程序需要做网站吗?  微信小程序 scroll-view组件实现列表页实例代码  如何快速选择适合个人网站的云服务器配置?  Win11应用商店下载慢怎么办 Win11更改DNS提速下载【修复】  如何在自有机房高效搭建专业网站?  Laravel观察者模式如何使用_Laravel Model Observer配置  Laravel如何实现邮件验证激活账户_Laravel内置MustVerifyEmail接口配置【步骤】  VIVO手机上del键无效OnKeyListener不响应的原因及解决方法  jQuery中的100个技巧汇总  Laravel怎么生成URL_Laravel路由命名与URL生成函数详解  Laravel如何使用Blade模板引擎?(完整语法和示例)  iOS验证手机号的正则表达式  HTML5空格和margin有啥区别_空格与外边距的使用场景【说明】  个人网站制作流程图片大全,个人网站如何注销?  Firefox Developer Edition开发者版本入口  微信推文制作网站有哪些,怎么做微信推文,急?  JS去除重复并统计数量的实现方法  Laravel Asset编译怎么配置_Laravel Vite前端构建工具使用  ,网页ppt怎么弄成自己的ppt?  Android中AutoCompleteTextView自动提示  打造顶配客厅影院,这份100寸电视推荐名单请查收  Linux系统命令中tree命令详解  LinuxCD持续部署教程_自动发布与回滚机制  西安市网站制作公司,哪个相亲网站比较好?西安比较好的相亲网站?  如何解决hover在ie6中的兼容性问题  香港服务器部署网站为何提示未备案?  谷歌浏览器如何更改浏览器主题 Google Chrome主题设置教程  Laravel Eloquent:优雅地将关联模型字段扁平化到主模型中  Laravel Artisan命令怎么自定义_创建自己的Laravel命令行工具完全指南  音乐网站服务器如何优化API响应速度?  车管所网站制作流程,交警当场开简易程序处罚决定书,在交警网站查询不到怎么办?  Laravel如何处理CORS跨域问题_Laravel项目CORS配置与解决方案  Laravel如何创建自定义Facades?(详细步骤)