Apache Shiro 编程方式授权

最简单和最常见的方式来执行授权是直接以编程方式与当前Subject 实例交互。

基于角色授权

Role checks(角色检查)

如果你只是简单的想检查当前的Subject 是否拥有一个角色，你可以在Subject 实例上调用hasRole方法。例如：

Subject currentUser = SecurityUtils.getSubject(); if(currentUser.hasRole("administrator")) { //show the admin button } else { //don't show the button? Grey it out? }

相关的角色检查方法如下：

Subject方法	描述
hasRole(String roleName)	返回true 如果Subject 被分配了指定的角色，否则返回false。
hasRoles(List<String> roleNames)	返回true 如果Subject 被分配了所有指定的角色，否则返回false。
hasAllRoles(Collection<String> roleNames)	返回一个与方法参数中目录一致的hasRole 结果的数组。

Role Assertions(角色断言)

Shiro还支持以断言的方式进行授权验证。断言成功，不返回任何值，程序继续执行；断言失败时，将抛出异常信息AuthorizationException。例如：

Subject currentUser = SecurityUtils.getSubject(); //guarantee that the current user is a bank teller and //therefore allowed to open the account: currentUser.checkRole("bankTeller"); openBankAccount();

相关的断言检查方法如下：

Subject方法	描述
checkRole(String roleName)	安静地返回，如果Subject 被分配了指定的角色，不然的话就抛出。
checkRoles(Collection<String> roleNames)	安静地返回，如果Subject 被分配了所有的指定的角色，不然的话就抛出。
checkRoles(String... roleNames)	与上面的checkRoles 方法的效果相同，但允许Java5 的var-args 类型的参数。

基于权限授权

相比传统角色模式，基于权限的授权模式耦合性要更低些，它不会因角色的改变而对源代码进行修改，因此，基于权限的授权模式是更好的访问控制方式。

如果你想进行检查，看一个Subject 是否被允许做某事，你可以调用各种isPermitted*方法的变种。检查权限主要有两个方式——基于对象的权限实例或代表权限的字符串。

Object-based Permission Checks(基于对象的权限检查)

执行权限检查的一个可行方法是实例化org.apache.shiro.authz.Permission 接口的一个实例，并把它传递给接收权限实例的*isPermitted 方法。比如，在办公室有一台打印机，具有唯一标识符laserjet4400n。我们的软件需要检查当前用户是否被允许在该打印机上打印文档。上述情况的权限检查可以明确地像这样表达：

Permission printPermission = new PrinterPermission("laserjet4400n","print"); Subject currentUser = SecurityUtils.getSubject(); If (currentUser.isPermitted(printPermission)) { //show the Print button } else { //don't show the button? Grey it out? }

相关的验证方法如下：

Subject方法	描述
isPermitted(Permission p)	返回true 如果该Subject 被允许执行某动作或访问被权限实例指定的资源集合，否则返回false。
isPermitted(List<Permission> perms)	返回一个与方法参数中目录一致的isPermitted 结果的数组。
isPermittedAll(Collection<Permission> perms)	返回true 如果该Subject 被允许所有指定的权限，否则返回false。

String-based permission checks(基于字符串的权限检查)

基于对象的权限可以是很有用的（编译时类型安全，保证行为，定制蕴含逻辑等），但它们有时对应用程序来说会感到有点“笨手笨脚”的。另一种方法是使用正常的字符串来表示权限实例。例如上述的例子使用基于字符串的权限检查如下：

Subject currentUser = SecurityUtils.getSubject(); if (currentUser.isPermitted("printer:print:laserjet4400n")) { //show the Print button } else { //don't show the button? Grey it out? }

这个例子显示了一个特殊冒号分隔的格式，它由Shiro 默认的org.apache.shiro.authz.permission.WildcardPermission 实现来定义的。这里分别代表了：资源类型：操作：资源ID 。WildcardPermission token 规定和构造操作的格式在Shiro 的Permission 文档中被深入的涉及到。除了上面的字符串默认的WildcardPermission 格式，你可以创建和使用自己的字符串格式如果你喜欢的话。

相关的验证方法如下：

Subject方法	描述
isPermitted(String perm)	返回true 如果该Subject 被允许执行某动作或访问被字符串权限指定的资源，否则返回false。
isPermitted(String…perms)	返回一个与方法参数中目录一致的isPermitted 结果的数组。
isPermittedAll(String…perms)	返回true 如果该Subject 被允许所有指定的字符串权限，否则返回false。

Permission Assertions(权限断言)

以断言的方式进行授权验证。断言成功，不返回任何值，程序继续执行；断言失败时，将抛出异常信息AuthorizationException。例如：

Subject currentUser = SecurityUtils.getSubject(); //guarantee that the current user is permitted //to open a bank account: Permission p = new AccountPermission("open"); currentUser.checkPermission(p); openBankAccount();

或者使用字符串来检查权限：

Subject currentUser = SecurityUtils.getSubject(); //guarantee that the current user is permitted //to open a bank account: currentUser.checkPermission("open"); openBankAccount();

相关的断言方法如下：

Subject方法	描述
checkPermission(Permission p)	安静地返回，如果Subject 被允许执行某动作或访问被特定的权限实例指定的资源，不然的话就抛出AuthorizationException 异常。
checkPermission(String perm)	安静地返回，如果Subject 被允许执行某动作或访问被特定的字符串权限指定的资源，不然的话就抛出AuthorizationException 异常。
checkPermissions(Collection<Permission> perms)	安静地返回，如果Subject 被允许所有的权限，不然的话就抛出AuthorizationException 异常。
checkPermissions(String… perms)	和上面的checkPermissions 方法效果相同，但是使用的是基于字符串的权限。