第十六章 综合实例——《跟我学shiro》 -凯发k8国际

目录贴：

简单的实体关系图

简单数据字典

用户(sys_user)

组织机构(sys_organization)

资源(sys_resource)

角色(sys_role)

资源：表示菜单元素、页面按钮元素等；菜单元素用来显示界面菜单的，页面按钮是每个页面可进行的操作，如新增、修改、删除按钮；使用type来区分元素类型（如menu表示菜单，button代表按钮），priority是元素的排序，如菜单显示顺序；permission表示权限；如用户菜单使用user:*；也就是把菜单授权给用户后，用户就拥有了user:*权限；如用户新增按钮使用user:create，也就是把用户新增按钮授权给用户后，用户就拥有了user:create权限了；available表示资源是否可用，如菜单显示/不显示。

角色：role表示角色标识符，如admin，用于后台判断使用；description表示角色描述，如超级管理员，用于前端显示给用户使用；resource_ids表示该角色拥有的资源列表，即该角色拥有的权限列表（显示角色），即角色是权限字符串集合；available表示角色是否可用。

组织机构：name表示组织机构名称，priority是组织机构的排序，即显示顺序；available表示组织机构是否可用。

用户：username表示用户名；password表示密码；salt表示加密密码的盐；role_ids表示用户拥有的角色列表，可以通过角色再获取其权限字符串列表；locked表示用户是否锁定。

此处如资源、组织机构都是树型结构：

parent_id表示父编号，parent_ids表示所有祖先编号；如0/1/2/表示其祖先是2、1、0；其中根节点父编号为0。

为了简单性，如用户-角色，角色-资源关系直接在实体（用户表中的role_ids，角色表中的resource_ids）里完成的，没有建立多余的关系表，如要查询拥有admin角色的用户时，建议建立关联表，否则就没必要建立了。在存储关系时如role_ids=1,2,3,；多个之间使用逗号分隔。

用户组、组织机构组本实例没有实现，即可以把一组权限授权给这些组，组中的用户/组织机构就自动拥有这些角色/权限了；另外对于用户组可以实现一个默认用户组，如论坛，不管匿名/登录用户都有查看帖子的权限。

更复杂的权限请参考我的《javaee项目开发脚手架》：。

表/数据sql

具体请参考

sql/ shiro-schema.sql （表结构）

sql/ shiro-data.sql  （初始数据）

默认用户名/密码是admin/123456。

实体

具体请参考com.github.zhangkaitao.shiro.chapter16.entity包下的实体，此处就不列举了。

dao

具体请参考com.github.zhangkaitao.shiro.chapter16.dao包下的dao接口及实现。

service

具体请参考com.github.zhangkaitao.shiro.chapter16.service包下的service接口及实现。以下是出了基本crud之外的关键接口：

public interface resourceservice {
    set findpermissions(set resourceids); //得到资源对应的权限字符串
    list findmenus(set permissions); //根据用户权限得到菜单
}

public interface roleservice {
    set findroles(long... roleids); //根据角色编号得到角色标识符列表
    set findpermissions(long[] roleids); //根据角色编号得到权限字符串列表
}

public interface userservice {
    public void changepassword(long userid, string newpassword); //修改密码
    public user findbyusername(string username); //根据用户名查找用户
    public set findroles(string username);// 根据用户名查找其角色
    public set findpermissions(string username);// 根据用户名查找其权限
} 

service实现请参考源代码，此处就不列举了。

userrealm实现     

public class userrealm extends authorizingrealm {
    @autowired private userservice userservice;
    protected authorizationinfo dogetauthorizationinfo(principalcollection principals) {
        string username = (string)principals.getprimaryprincipal();
        simpleauthorizationinfo authorizationinfo = new simpleauthorizationinfo();
        authorizationinfo.setroles(userservice.findroles(username));
        authorizationinfo.setstringpermissions(userservice.findpermissions(username));
        system.out.println(userservice.findpermissions(username));
        return authorizationinfo;
    }
    protected authenticationinfo dogetauthenticationinfo(authenticationtoken token) throws authenticationexception {
        string username = (string)token.getprincipal();
        user user = userservice.findbyusername(username);
        if(user == null) {
            throw new unknownaccountexception();//没找到帐号
        }
        if(boolean.true.equals(user.getlocked())) {
            throw new lockedaccountexception(); //帐号锁定
        }
        return new simpleauthenticationinfo(
                user.getusername(), //用户名
                user.getpassword(), //密码
                bytesource.util.bytes(user.getcredentialssalt()),//salt=username salt
                getname()  //realm name
        );
    }
}

此处的userrealm和《第六章realm及相关对象》中的userrealm类似，通过userservice获取帐号及角色/权限信息。

web层控制器 

@controller
public class indexcontroller {
    @autowired
    private resourceservice resourceservice;
    @autowired
    private userservice userservice;
    @requestmapping("/")
    public string index(@currentuser user loginuser, model model) {
        set permissions = userservice.findpermissions(loginuser.getusername());
        list menus = resourceservice.findmenus(permissions);
        model.addattribute("menus", menus);
        return "index";
    }
} 

indexcontroller中查询菜单在前台界面显示，请参考相应的jsp页面；

@controller
public class logincontroller {
    @requestmapping(value = "/login")
    public string showloginform(httpservletrequest req, model model) {
        string exceptionclassname = (string)req.getattribute("shirologinfailure");
        string error = null;
        if(unknownaccountexception.class.getname().equals(exceptionclassname)) {
            error = "用户名/密码错误";
        } else if(incorrectcredentialsexception.class.getname().equals(exceptionclassname)) {
            error = "用户名/密码错误";
        } else if(exceptionclassname != null) {
            error = "其他错误："   exceptionclassname;
        }
        model.addattribute("error", error);
        return "login";
    }
} 

logincontroller用于显示登录表单页面，其中shiro authc拦截器进行登录，登录失败的话会把错误存到shirologinfailure属性中，在该控制器中获取后来显示相应的错误信息。 

@requirespermissions("resource:view")
@requestmapping(method = requestmethod.get)
public string list(model model) {
    model.addattribute("resourcelist", resourceservice.findall());
    return "resource/list";
} 

在控制器方法上使用@requirespermissions指定需要的权限信息，其他的都是类似的，请参考源码。

web层标签库

com.github.zhangkaitao.shiro.chapter16.web.taglib.functions提供了函数标签实现，有根据编号显示资源/角色/组织机构名称，其定义放在src/main/webapp/tld/zhang-functions.tld。

web层异常处理器 

@controlleradvice
public class defaultexceptionhandler {
    @exceptionhandler({unauthorizedexception.class})
    @responsestatus(httpstatus.unauthorized)
    public modelandview processunauthenticatedexception(nativewebrequest request, unauthorizedexception e) {
        modelandview mv = new modelandview();
        mv.addobject("exception", e);
        mv.setviewname("unauthorized");
        return mv;
    }
} 

如果抛出unauthorizedexception，将被该异常处理器截获来显示没有权限信息。

spring配置——spring-config.xml

定义了context:component-scan来扫描除web层的组件、datasource（数据源）、事务管理器及事务切面等；具体请参考配置源码。

spring配置——spring-config-cache.xml

定义了spring通用cache，使用ehcache实现；具体请参考配置源码。

spring配置——spring-config-shiro.xml

定义了shiro相关组件。 

userrealm组件禁用掉了cache，可以参考实现自己的cache切面；否则需要在修改如资源/角色等信息时清理掉缓存。 

sysuserfilter用于根据当前登录用户身份获取user信息放入request；然后就可以通过request获取user。 

  
    /login = authc
    /logout = logout
    /authenticated = authc
    /** = user,sysuser
  
 

如上是shirofilter的filterchaindefinitions定义。 

spring mvc配置——spring-mvc.xml

定义了spring mvc相关组件。 

此处注册了一个@currentuser参数解析器。如之前的indexcontroller，从request获取shiro sysuser拦截器放入的当前登录user对象。

spring mvc配置——spring-mvc-shiro.xml

定义了spring mvc相关组件。 

定义aop切面，用于代理如@requirespermissions注解的控制器，进行权限控制。

web.xml配置文件

定义spring root上下文加载器、shirofilter、及springmvc拦截器。具体请参考源码。

jsp页面       

使用shiro标签进行权限控制。具体请参考源码。

系统截图

访问；

首先进入登录页面，输入用户名/密码（默认admin/123456）登录： 

登录成功后到达整个页面凯发k8国际娱乐官网入口主页，并根据当前用户权限显示相应的菜单，此处菜单比较简单，没有树型结构显示   

然后就可以进行一些操作，如组织机构维护、用户修改、资源维护、角色授权 

相关资料

《跟我学spring3》

     http://www.iteye.com/blogs/subjects/spring3

《跟开涛学springmvc》

     http://www.iteye.com/blogs/subjects/kaitao-springmvc

《简单shiro扩展实现not、and、or权限验证》

《shiro struts2 spring3 加上@requirespermissions 后@autowired失效》

更复杂的权限请参考我的《javaee项目开发脚手架》：，提供了更加复杂的实现。

示例源代码：；可加群 231889722 探讨spring/shiro技术。

请你欣赏春天美景