## 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）： ``` java 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） ``` 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 容器的知識，如上配置也是很容易理解的： 1. 對象名 = 全限定類名 相對于調用 public 無參構造器創建對象 2. 對象名. 屬性名 = 值 相當于調用 setter 方法設置常量值 3. 對象名. 屬性名 =$ 對象引用 相當于調用 setter 方法設置對象引用 3、Java 代碼（com.github.zhangkaitao.shiro.chapter4.ConfigurationCreateTest） ``` java 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 配置分類： ``` 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 及其依賴對象的配置。 **創建對象** ``` ini securityManager=org.apache.shiro.mgt.DefaultSecurityManager ``` 其構造器必須是 public 空參構造器，通過反射創建相應的實例。 **常量值 setter 注入** ``` ini dataSource.driverClassName=com.mysql.jdbc.Driver jdbcRealm.permissionsLookupEnabled=true ``` 會自動調用 jdbcRealm.setPermissionsLookupEnabled(true)，對于這種常量值會自動類型轉換。 **對象引用 setter 注入** ``` ini authenticator=org.apache.shiro.authc.pam.ModularRealmAuthenticator authenticationStrategy=org.apache.shiro.authc.pam.AtLeastOneSuccessfulStrategy authenticator.authenticationStrategy=$authenticationStrategy securityManager.authenticator=$authenticator ``` 會自動通過 securityManager.setAuthenticator(authenticator) 注入引用依賴。 **嵌套屬性 setter 注入** ``` ini securityManager.authenticator.authenticationStrategy=$authenticationStrategy ``` 也支持這種嵌套方式的 setter 注入。 **byte 數組 setter 注入** ``` ini #base64 byte[] authenticator.bytes=aGVsbG8= #hex byte[] authenticator.bytes=0x68656c6c6f ``` 默認需要使用 Base64 進行編碼，也可以使用 0x 十六進制。 **Array/Set/List setter 注入** ``` ini authenticator.array=1,2,3 authenticator.set=$jdbcRealm,$jdbcRealm ``` 多個之間通過 “，” 分割。 **Map setter 注入** ``` ini authenticator.map=$jdbcRealm:$jdbcRealm,1:1,key:abc ``` 即格式是：map=key：value，key：value，可以注入常量及引用值，常量的話都看作字符串（即使有泛型也不會自動造型）。 **實例化 / 注入順序** ``` ini realm=Realm1 realm=Realm12 authenticator.bytes=aGVsbG8= authenticator.bytes=0x68656c6c6f ``` 后邊的覆蓋前邊的注入。 測試用例請參考配置文件 shiro-config-main.ini。 **[users] 部分** 配置用戶名 / 密碼及其角色，格式：“用戶名 = 密碼，角色 1，角色 2”，角色部分可省略。如： ``` ini [users] zhang=123,role1,role2 wang=123 ``` 密碼一般生成其摘要 / 加密存儲，后續章節介紹。 **[roles] 部分** 配置角色及權限之間的關系，格式：“角色 = 權限 1，權限 2”；如： ``` ini [roles] role1=user:create,user:update role2=* ``` 如果只有角色沒有對應的權限，可以不配 roles，具體規則請參考授權章節。 **[urls] 部分** 配置 url 及相應的攔截器之間的關系，格式：“url = 攔截器 [參數]，攔截器 [參數]，如： ``` ini [urls] /admin/** = authc, roles[admin], perms["permission1"] ``` 具體規則參見 web 相關章節。