项目地址:https://gitee.com/rlaxuc/jboot-admin
项目介绍
jboot-admin是基于强大的微服务框架jboot开发的后台管理框架,采用微服务架构设计思想,分为api层、服务实体层、服务调用层、服务实现层、服务基础层,涵盖了jboot提供的大部分功能,包含代码生成、认证权限、数据字典、日志管理、服务治理、服务监控、链路跟踪等功能,包含很多jboot微服务实战开发技巧,无论是学习jboot微服务开发还是作为鲜项目脚手架开发都是一个不错的选择。
jboot-admin主要的开发理念就是简单快速,所以框架里还包含一些其他特性,比如:统一异常,省去了很多if else去返回提示,抛出的异常可直接转化为前端提示。数据字典缓存、数据字典指令、状态指令,解耦了业务、状态、数据字典,在需要decode的地方直接使用指令即可。还有很多很多期待你去代码里发现.
技术选型
核心框架:jboot 1.2.8
模版引擎:jfinal enjoy
注册中心:consul/zookeeper
RPC:motan/dubbo
RPC治理:motan-manager
安全框架:shiro
缓存框架:ehcache/redis
容错隔离:hystrix
调用监控:hystrix-dashboard
链路跟踪:zipkin
页面ui:layui
模块说明
项目为使用maven构建的多模块项目
jboot-admin-parent:父模块,主要管理依赖
jboot-admin-base:框架相关代码
jboot-admin:客户端模块
jboot-admin-service:服务端模块,包含api、entity、provider三个模块
jboot-admin-service-api:服务api模块,定义服务端与客户端api标准
jboot-admin-service-entity:服务实体模块,定义服务所需model、dto管理服务状态
jboot-admin-service-provider:服务实现模块,针对api的实现
项目使用
请使用jdk8及以上版本,数据库为mysql。 1、建立数据库:doc/jboot-admin-mysql.sql,用户名密码root/root 2、启动consul或zookeeper,目前配置文件默认为motan,可进行更改,根据注释修改即可 3、启动redis,默认密码为 123456,可在配置文件进行修改 4、如需更改redis/consul等配置请更新客户端配置文件:jboot-admin/resources/jboot.properties 5、如需更改redis/consul/数据库配置请更新服务端配置文件:jboot-admin-service/jboot-admin-service-provider/resources/jboot.properties 6、启动客户端:客户端启动入口:io.jboot.admin.Application 7、启动服务端:服务端启动入口:io.jboot.admin.service.provider.app.Application 8、浏览器访问:localhost:8888,默认用户名密码:admin/123123 附加: 监控相关功能需要安装对应服务才可正常使用 注册中心监控需要安装:consul 服务调用监控需要安装:hystrix-dashboard 链路跟踪监控需要安装:zipkin-server 服务治理需要安装:motan-manager 这些都可以在网上下载或者自己编译,当然也可以加群下载
代码生成
对jboot 代码生成进行了配置文件的封装,使用更简单方便 先配置代码生成配置文件,包含数据库配置与代码生成包相关配置 然后执行代码生成入口类 provider实现类生成配置文件示例: #---------------------------------------------------------------------------------# # Generator Config # jboot.admin.serviceimpl.ge.entity.package: the entity package; # jboot.admin.serviceimpl.ge.servicepackage:service 接口 package # jboot.admin.serviceimpl.ge.serviceimplpackage:service 实现类 package # jboot.admin.serviceimpl.ge.localdev.removedtablenameprefixes: 需要移除表名前缀只留下后部分,多个逗号隔开 # jboot.admin.serviceimpl.ge.localdev.excludedtable: 生成时不包含表名列表,多个逗号隔开 # jboot.admin.serviceimpl.ge.excludedtableprefixes: 生成时不包含表前缀,多个逗号隔开 #---------------------------------------------------------------------------------# jboot.admin.serviceimpl.ge.modelpackage=io.jboot.admin.service.entity.model jboot.admin.serviceimpl.ge.servicepackage=io.jboot.admin.service.api jboot.admin.serviceimpl.ge.serviceimplpackage=io.jboot.admin.service.provider jboot.admin.serviceimpl.ge.removedtablenameprefixes=sys_ jboot.admin.serviceimpl.ge.excludedtable= jboot.admin.serviceimpl.ge.excludedtableprefixes=temp_,v_ 配置文件位置: 各模块 resources/jboot.properties 代码生成入口: service interface api生成:io.jboot.admin.service.api.ge.GenCode model 实体生成:io.jboot.admin.service.entity.GenCode service impl 实现层生成:io.jboot.admin.service.provider.ge.GenCode
演示页面
登录界面:
资源管理:分为菜单与功能两种类型,菜单为左侧菜单树,功能为页面具体按钮或超链或其他资源内容,配置在资源管理内的资源只有通过授权后才可进行访问。
用户管理:配置系统的登录用户,并配置改用户角色。
角色管理:配置系统内角色,并配置角色具有哪些资源的权限。
数据管理:配置系统所需的字典参数,存储在缓存内,可灵活使用。
注册中心监控:监控注册中心页面
服务调用监控:hystrix服务调用监控
服务链路跟踪:zipkin链路跟踪
服务治理:motan-manager服务治理