欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

shiro之INI配置详解

程序员文章站 2024-02-29 14:47:10
如果大家使用过如spring之类的ioc/di容器的话,shiro提供的ini配置也是非常类似的,即可以理解为是一个ioc/di容器,但是区别在于它从一个根对象securi...

如果大家使用过如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"]  

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