第四章 INI配置

之前章节我们已经接触过一些INI配置规则了，如果大家使用过如Spring之类的IoC/DI容器的话，Shiro 提供的INI配置也是非常类似的，

即可以理解为是一个IoC/DI容器，但是区别在于它从一个根对象securityManager开始。

一、根对象SecurityManager

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

因为 Shiro 的类都是POJO的，因此都很容易放到任何IoC 容器管理。但是和一般的IoC 容器的区别在于：

1）Shiro 从根对象securityManager 开始导航；

2）Shiro 支持的依赖注入：public空参构造器对象的创建、setter依赖注入。

1. 纯Java代码写法

@Test
public void testJava() throws PropertyVetoException, NamingException{
	DefaultSecurityManager securityManager = new DefaultSecurityManager();
	//设置authenticator
	//可处理多Realm的Authenticator
	ModularRealmAuthenticator authenticator = new ModularRealmAuthenticator();
	//Authenticator设置验证规则（策略）
	authenticator.setAuthenticationStrategy(new AtLeastOneSuccessfulStrategy());
	//Authenticator设置进SecurityManager
	securityManager.setAuthenticator(authenticator);
	
	//设置authorizer
	//可处理多Realm的Authorizer
	ModularRealmAuthorizer authorizer = new ModularRealmAuthorizer();
	//设置权限字符串解析器（解析为Permission对象）
	/*调用如isPermitted(“user:view”)，
	首先通过PermissionResolver将权限字符串转换成相应的Permission实例，
	默认使用WildcardPermissionResolver，即转换为通配符的WildcardPermission；*/
	authorizer.setPermissionResolver(new WildcardPermissionResolver());
	//Authorizer设置进SecurityManager
	securityManager.setAuthorizer(authorizer);
	
	//设置Realm
	ComboPooledDataSource ds = new ComboPooledDataSource();
	ds.setDriverClass("com.mysql.jdbc.Driver");
	ds.setJdbcUrl("jdbc:mysql://localhost:3306/shiro");
	ds.setUser("root");
	ds.setPassword("123456");
	//配置JDBC Realm
	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. 等价的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.mchange.v2.c3p0.ComboPooledDataSource
dataSource.dirverClassName=com.mysql.jdbc.Driver
dataSource.jdbcUrl=jdbc:mysql://localhost:3306/shiro
dataSource.user=root
dataSource.password=123456
jdbcRealm=org.apache.shiro.realm.jdbc.JdbcRealm
jdbcRealm.dataSource=$dataSource
jdbcRealm.permissionsLookupEnabled=true
securityManager.realms=$jdbcRealm

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

1）对象名=全限定类名 相对于调用public 无参构造器创建对象

2）对象名.属性名=值 相当于调用setter方法设置常量值

3）对象名.属性名=$对象引用 相当于调用setter方法设置对象引用

3. Java代码

@Test
public void testShiroConfig(){
	Factory<org.apache.shiro.mgt.SecurityManager> factory = new IniSecurityManagerFactory("classpath:chapter4/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配置分类：

[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"]

[mian]部分

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

创建对象

securityManager=org.apache.shiro.mgt.DefaultSecurityManager

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

常量值setter注入

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

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

对象引用setter注入

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

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

嵌套属性setter注入

securityManager.authenticator.authenticationStrategy=$authenticationStrategy

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

byte数组setter注入

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

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

Array/Set/List setter注入

securityManager.realms=$myRealm1,$myRealm2
authenticator.array=1,2,3
authenticator.set=$jdbcReam,$jdbcReam

多个之间通过“，”分隔

Map setter注入

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

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

实例化/注入顺序

realm=Realm1
realm=Realm12

authenticator.bytes=aGVsbG8=
authenticator.bytes=0x68656c6c6f

后边的覆盖前边的注入

[users]部分

配置用户名/密码及其角色，格式：“用户名=密码，角色1，角色2”，角色部分可省略。如

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

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

[roles]部分

配置角色及权限之间的关系，格式：“角色=权限1，权限2”；如：

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

如果只有角色没有对应的权限，可以不配roles，具体参考授权章节（ 即通过hasRole/hasRoles来判断是否拥有角色，而不用isPermitted/isPermittedAll来判断是否拥有权限）

[urls]部分

配置url及相应的拦截器之间的关系，格式：“url=拦截器[参数]，拦截器[参数]”，如：

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

具体规则参见web相关章节。