INI 配置

之前章節我們已經接觸過一些 INI 配置規則了，如果大家使用過如 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、等價的 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=

jdbcRealm=org.apache.shiro.realm.jdbc.JdbcRealm

jdbcRealm.dataSource=$dataSource

jdbcRealm.permissionsLookupEnabled=true

securityManager.realms=$jdbcRealm?

即使沒接觸過 IoC 容器的知識，如上配置也是很容易理解的：

對象名 = 全限定類名 相對于調用 public 無參構造器創建對象

對象名. 屬性名 = 值 相當于調用 setter 方法設置常量值

對象名. 屬性名 =$ 對象引用 相當于調用 setter 方法設置對象引用

3、Java 代碼(com.github.zhangkaitao.shiro.chapter4.ConfigurationCreateTest)

Factory 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 實例：

默認情況先創建一個名字為 securityManager，類型為 org.apache.shiro.mgt.DefaultSecurityManager 的默認的 SecurityManager，如果想自定義，只需要在 ini 配置文件中指定 “securityManager=SecurityManager 實現類” 即可，名字必須為 securityManager，它是起始的根；

IniSecurityManagerFactory 是創建 securityManager 的工廠，其需要一個 ini 配置文件路徑，其支持 “classpath:”(類路徑)、“file:”(文件系統)、“url:”(網絡)三種路徑格式，默認是文件系統；

接著獲取 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"]

[main] 部分

提供了對根對象 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 注入

authenticator.array=1,2,3

authenticator.set=$jdbcRealm,$jdbcRealm?

多個之間通過 “，” 分割。

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?

后邊的覆蓋前邊的注入。

測試用例請參考配置文件 shiro-config-main.ini。

[users] 部分

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

[users]

zhang=123,role1,role2

wang=123?

密碼一般生成其摘要 / 加密存儲，后續章節介紹。

[roles] 部分

配置角色及權限之間的關系，格式：“角色 = 權限 1，權限 2”；如：

[roles]

role1=user:create,user:update

role2=*?

如果只有角色沒有對應的權限，可以不配 roles，具體規則請參考授權章節。

[urls] 部分

配置 url 及相應的攔截器之間的關系，格式：“url = 攔截器 [參數]，攔截器 [參數]，如：

[urls]

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

具體規則參見 web 相關章節。