# Guns V3.1
## 介绍
Guns基于SpringBoot,致力于做更简洁的后台管理系统,完美整合springmvc + shiro + mybatis-plus + beetl + flowable!Guns项目代码简洁,注释丰富,上手容易,同时Guns包含许多基础模块(用户管理,角色管理,部门管理,字典管理等10个模块),可以直接作为一个后台管理系统的脚手架!
Guns v3.0新增rest api服务,提供对接服务端接口的支持,并利用jwt token鉴权机制给予客户端的访问权限,传输数据进行md5签名保证传输过程数据的安全性!
Guns v3.1新增集成工作流引擎flowable6.2.0!
## 最新Guns视频教程
Guns框架有作者在业余时间录制的视频教程,详情点击[教程介绍](https://gitee.com/naan1993/guns/wikis/pages?title=guns%E8%A7%86%E9%A2%91%E6%95%99%E7%A8%8B%20&parent=)
## 技术讨论 & [wiki地址](https://gitee.com/naan1993/guns/wikis/Home)
如果对项目有任何疑问或者建议,欢迎加入Guns技术交流群:254550081 (加之前先看下wiki)
## 管理系统功能
1.用户管理 2.角色管理 3.部门管理 4.菜单管理 5.字典管理 6.业务日志 7.登录日志 8.监控管理 9.通知管理 10.代码生成
## 项目特点
1. 基于SpringBoot,简化了大量项目配置和maven依赖,让您更专注于业务开发,独特的分包方式,代码多而不乱。
2. 完善的日志记录体系，可记录登录日志，业务操作日志(可记录操作前和操作后的数据)，异常日志到数据库，通过@BussinessLog注解和LogObjectHolder.me().set()方法，业务操作日志可具体记录哪个用户，执行了哪些业务，修改了哪些数据，并且日志记录为异步执行，详情请见@BussinessLog注解和LogObjectHolder,LogManager,LogAop类。
3. 利用beetl模板引擎对前台页面进行封装和拆分，使臃肿的html代码变得简洁，更加易维护。
4. 对常用js插件进行二次封装，使js代码变得简洁，更加易维护，具体请见webapp/static/js/common文件夹内js代码。
5. 利用ehcache框架对经常调用的查询进行缓存，提升运行速度，具体请见ConstantFactory类中@Cacheable标记的方法。
6. controller层采用map + warpper方式的返回结果，返回给前端更为灵活的数据，具体参见com.stylefeng.guns.modular.system.warpper包中具体类。
7. 防止XSS攻击,通过XssFilter类对所有的输入的非法字符串进行过滤以及替换。
8. 简单可用的代码生成体系，通过SimpleTemplateEngine可生成带有主页跳转和增删改查的通用控制器、html页面以及相关的js，还可以生成Service和Dao，并且这些生成项都为可选的，通过ContextConfig下的一些列xxxSwitch开关,可灵活控制生成模板代码，让您把时间放在真正的业务上。
9. 控制器层统一的异常拦截机制,利用@ControllerAdvice统一对异常拦截,具体见com.stylefeng.guns.core.aop.GlobalExceptionHandler类。
10. 页面统一的js key-value单例模式写法，每个页面生成一个唯一的全局变量，提高js的利用效率，并且有效防止多个人员开发引起的函数名/类名冲突，并且可以更好地去维护代码。
## 基于javabean方式的spring配置
Guns以简洁为核心,抛弃了传统的易错,臃肿xml配置,采用javabean的方式配置spring,简化了项目的配置,如下示例为配置mybatis-plus和数据源:
```
@Configuration
@MapperScan(basePackages = {"com.stylefeng.guns.modular.*.dao", "com.stylefeng.guns.common.persistence.dao"})
public class MybatisPlusConfig {
@Autowired
DruidProperties druidProperties;
/**
* mybatis-plus分页插件
*/
@Bean
public PaginationInterceptor paginationInterceptor() {
PaginationInterceptor paginationInterceptor = new PaginationInterceptor();
paginationInterceptor.setDialectType(DBType.MYSQL.getDb());
return paginationInterceptor;
}
}
```
## 业务日志记录
日志记录采用aop(LogAop类)方式对所有包含@BussinessLog注解的方法进行aop切入，会记录下当前用户执行了哪些操作（即@BussinessLog value属性的内容），如果涉及到数据修改，会取当前http请求的所有requestParameters与LogObjectHolder类中缓存的Object对象的所有字段作比较（所以在编辑之前的获取详情接口中需要缓存被修改对象之前的字段信息），日志内容会异步存入数据库中（通过ScheduledThreadPoolExecutor类）。
## beetl对前台页面的拆分与包装
例如，把主页拆分成三部分，每个部分单独一个页面，更加便于维护
```
<!--左侧导航开始-->
@include("/common/_tab.html"){}
<!--左侧导航结束-->
<!--右侧部分开始-->
@include("/common/_right.html"){}
<!--右侧部分结束-->
<!--右侧边栏开始-->
@include("/common/_theme.html"){}
<!--右侧边栏结束-->
```
以及对重复的html进行包装，使前端页面更加专注于业务实现，例如,把所有页面引用包进行提取
```
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="renderer" content="webkit" /><!-- 让360浏览器默认选择webkit内核 -->
<!-- 全局css -->
<link rel="shortcut icon" href="${ctxPath}/static/favicon.ico">
<!-- 全局js -->
<script src="${ctxPath}/static/js/jquery.min.js?v=2.1.4"></script>
<body class="gray-bg">
<div class="wrapper wrapper-content animated fadeInRight">
${layoutContent}
</div>
<script src="${ctxPath}/static/js/content.js?v=1.0.0"></script>
</body>
</html>
```
开发页面时，只需编写如下代码即可
```
@layout("/common/_container.html"){
<div class="row">
<div class="col-sm-12">
<div class="ibox float-e-margins">
<div class="ibox-title">
<h5>部门管理</h5>
</div>
<div class="ibox-content">
//自定义内容
</div>
</div>
</div>
</div>
<script src="${ctxPath}/static/modular/system/dept/dept.js"></script>
@}
```
以上beetl的用法请参考beetl说明文档。
## 对js常用代码的封装
在webapp/static/js/common目录中，有对常用js代码的封装，例如Feng.js,其中Feng.info(),Feng.success(),Feng.error()三个方法，分别封装了普通提示，成功提示，错误提示的代码，简化了layer提示层插件的使用。
## 极简的图片上传方法
guns对web-upload进行二次封装,让图片的上传功能呢只用2行代码即可实现,如下
```
var avatarUp = new $WebUpload("avatar");
avatarUp.init();
```
具体实现请参考static/js/common/web-upload-object.js
## 独创controller层，map+warpper返回方式
map+warpper方式即为把controller层的返回结果使用BeanKit工具类把原有bean转化为Map的的形式(或者原有bean直接是map的形式)，再用单独写的一个包装类再包装一次这个map，使里面的参数更加具体，更加有含义，下面举一个例子，例如，在返回给前台一个性别时，数据库查出来1是男2是女，假如直接返回给前台，那么前台显示的时候还需要增加一次判断，并且前后端分离开发时又增加了一次交流和文档的成本，但是采用warpper包装的形式，可以直接把返回结果包装一下，例如动态增加一个字段sexName直接返回给前台性别的中文名称即可。
## 独创mybatis数据范围拦截器,实现对数据权限的过滤
Guns的数据范围控制是指,对拥有相同角色的用户,根据部门的不同进行相应的数据筛选,如果部门不相同,那么有可能展示出的具体数据是不一致的.所以说Guns对数据范围控制是以部门id为单位来标识的,如何增加数据范围拦截呢?只需在相关的mapper接口的参数中增加一个DataScope对象即可,DataScope中有两个字段,scopeN
SpringBoot整合SSM（含数据库），含有代码生成 （881个子文件） 
page.js.btl 3KB Controller.java.btl 3KB page_info.js.btl 2KB page_edit.html.btl 2KB page_add.html.btl 2KB page.html.btl 2KB menu_sql.sql.btl 391B summernote-bs3.css 143KB style.css 133KB bootstrap.min.css 118KB animate.css 64KB datepicker3.css 33KB font-awesome.css 32KB bootstrap-rtl.css 31KB font-awesome.min.css 26KB ambiance.css 25KB style.min.css 25KB sweetalert.css 18KB simditor.css 17KB ui.jqgrid.css 16KB layer.css 14KB jasny-bootstrap.min.css 14KB jquery-ui-1.10.4.custom.min.css 14KB chosen.css 12KB dropzone.css 11KB layer.css 11KB layim.css 11KB fullcalendar.css 11KB summernote.css 10KB plyr.css 10KB codemirror.css 7KB blueimp-gallery.min.css 7KB awesome-bootstrap-checkbox.css 7KB toastr.min.css 7KB zTreeStyle.css 6KB laydate.css 6KB blueimp-gallery.css 6KB bootstrap-table.min.css 6KB jquery.steps.css 6KB footable.core.css 5KB layer.css 5KB jquery.fancybox.css 5KB dataTables.bootstrap.css 5KB clockpicker.css 4KB basic.css 4KB style.css 4KB bootstrap-colorpicker.min.css 3KB laydate.css 3KB cropper.min.css 3KB ion.rangeSlider.css 3KB jquery.nouislider.css 3KB layer.ext.css 3KB bootstrap-markdown.min.css 3KB jquery.gritter.css 3KB demo.css 2KB blueimp-gallery-video.css 2KB login.css 2KB ion.rangeSlider.skinFlat.css 2KB bootstrap-duallistbox.css 2KB blueimp-gallery-indicator.css 2KB custom.css 1KB bootstrap-multiselect.css 1KB bootstrap-treeview.css 1KB jquery.treegrid.css 1KB _fstyle.css 924B demo.css 867B bootstrapValidator.min.css 694B fullcalendar.print.css 660B switchery.css 611B webuploader.css 554B webuploader.css 515B morris-0.4.3.min.css 443B tiki.css 441B tiddlywiki.css 220B fontawesome-webfont.eot 67KB glyphicons-halflings-regular.eot 20KB footable.eot 5KB
fancybox_loading@2x.gif 14KB boy.gif 13KB girl.gif 9KB fancybox_loading.gif 6KB xubox_loading0.gif 6KB loading-0.gif 6KB loading-0.gif 6KB zTreeStandard.gif 5KB loading.gif 4KB xubox_loading3.gif 2KB loading-2.gif 2KB xubox_loading2.gif 2KB loading-2.gif 2KB throbber.gif 2KB loading-upload.gif 2KB xubox_loading1.gif 701B loading-1.gif 701B loading-1.gif 701B loading.gif 381B loading.gif 166B line_conn.gif 45B ie-spacer.gif 43B blank.gif 43B共 881 条
- 1
- 2
- 3
- 4
- 5
- 6
- 9
资源评论
weixin_458577442020-01-02网上的开源项目，还要分！码云就能搜到
高级工程狮2019-03-07admin 的密码是什么？
程序猿转行炒股了2019-03-07111111 6个1
如果没有_明天2018-04-25MyEclipse倒不进去，差评 程序猿转行炒股了2018-05-06技术菜不要怪文件，别人都能导入就你导入不了，怪谁咯
weixin_399129532018-02-27这个项目怎么启动的？ 程序猿转行炒股了2018-02-27导入项目，配好环境，跑起来就可以了
