最新 guns v5.1 文档

【实例简介】
本文档基于最新的Guns版本，集Guns使用手册，Guns开发手册，Guns核心思想等于一体，并整理了qq群和gitee上用户经常反馈的问题的答疑！本文档最好的阅读方式是从上到下依次阅读(推荐)，也可根据需要直接从目录查看相关文档！感谢您对Guns的支持！
2018/11/7 Guns技术文档v5.-作业部落( md markdown编辑阅读器 登录码云平台,打开Guns主页,点击下载按钮下载 目641次提交 如1个分支 10个标签 0个发行版 15位贡献者 master+Pu‖ Request+lsse文件·挂件 克降下载 e stylefeng最后提心于4天前修改生成器户法各称 Https Ssh stylefeng修改生成方法名称 git@gitee com:naan 1995 制 guns-a.min guns-core eeng增加多数后源配后两个属性 土下ZP □ guns-generator stydefeng修政生成器方法刍称 Dguns-parent naan1993升级drud版本 渴望全方位安全保障?° 亡guns-rest 5 stylefeng验证 token是否过期加异常拦截 你的团队值得更专业、流畅的 敏捷开发工具 -i-+-1l,x -J.x= 22导入项目 221 eclipse导入 1.导入之前请检查 eclipse的 maven配置是否本机听安装的 maven(一般不用 ecl ipse自带的 maven),如下 Preferences type filter text stellati。ns lect the installation used to launch Naver: Ant Clcud found L」 EMBEDDED 3.3.9/13.220171007-0216 M apache-maven-3.3.9 D: devTools \apache-maven-3.3.9 Remove Install/Update Java JuvE EE s Java Persistence Java script MEven Archetypes ors wa Java EE In Leyi alien UsEr Interface Uscr Sctting Note: Embedded runtime is always used for dependency reso ution )Oomph Restore Defaults ) and Close Cancel 2检查 maven安装目录下的 settings.x是否配置了阿里云镜像 <酒当me>Ne河 <uri>http://maven.aliyur.com/nexus/content/groups/public//ur1> </irror> 3.再次检查 eclipse中 maven的配置是否应用了当前 maven安装目录的 settings.xm配置文件(个人习惯全局和用户配置设置为一个),如 http:/guns.stylefeng.cn/ 3/46 2018/11/7 Guns技术文档v5.-作业部落( md markdown编辑阅读器 ences type filter text User Setting Gerret d Global Settings o Cloud Fuu iury Tuuls\auathieTTaverl-339\url\belLings xr l Bruise Ccde Recommende User Settings (oren file) Data Managenent Is\apeche-maven-339\conf(settings, xrl Browse Install/ lInate y Java EE Local Repository(Frcm merged user and global settings): Reindex JSCI Archetypes Discovery Installations Jave EE Inler liu: r User gettin- Oomph Restore defau aults Apply Plln-in Develoment Apply and Close Cancel 4.以上设置完成,需要重启一下 ecl ipse 5.点击 eclipse菜单Fe-> mport,出现如下界面,选择 Existing maven project mport Import Existing Maven Projects Select an mport wizar b eJB ②Grad 》@ Jaya b W-I Chack out Marven Pro ccts from SCM M L Existing Maven Pmjerts O Install or deploy an artifact to a Maven repository a Materialize Maven Pro, ects from SCM b Oomph Cancel 6.找到下载的项目目录,并点击所有模块,之后点击 Finish,导入成功 222IDEA导入 http:/guns.stylefeng.cn/ 4/46 2018/11/7 Guns技术文档v5.-作业部落( md markdown编辑阅读器 1.同样,导入前检查|DEA的 maven配置是否正确 De ault Preferences Build, Execution, Deployment) Build Tools Maven B For default project b Appearance Behavior 圆 Work offline Keymap Use plugin registry > Editor M Execute goals recursively Plugins Print exception stack traces Version Control Always update snapshots v Build, Execution, Deployment Output level w Build Tools w Maven Checksum pol No Global Policy Importing a Multiproject build fail policy: Default Ignored Fill Plugin update policy Default ignored by Maven 3 Runner p Grade a heads(-Taption Gant Maven上 ome directory /Users/stylefeng/work/apache-maven-350 (Version: 3.5.0 b Debugger User settings file USers/stylefeng/work/apache-maven-350/cant/settings. xml Remote Jar Repositories a Local repository /Users/stylefeng /work/repository Arquillian Containers Application Servers Clouds Coverage Gradle-Android Compiler Instant Run equIred Plug Languages Frameworks P Tools 2检查 maven安装目录下的 settings. xm是否配置了阿里云镜像同2.2.1节第2步 3.进入DEA主界面,点击open,并选择下载好的guns代码的根目录 回 Intell IDEA 2017.2.5 EF Cr L Import Projec a Open Check out frcm Version Control H Configure- Get Hep 23运行项目 运行前的准备 安装mysq数据库,作者所用mys叫版本为57 1执行guns- admin模块下的sq1/gus.sq脚本,初始化guns的数据库环境 2.打开qung- admin/sre/main/ resources/ application,ym配置文件,修改数据连接,账号和密码,改为您所连接数据库的配置,oca为本地开 发环境,deν为开发服务器的环境,test为测试服务器的环境, produce为正式上线的环境 http:/guns.stylefeng.cn/ 5/46 2018/11/7 juns技术文档v5.-作业部落( md markdown编辑阅读器 33444444 e sprin profiLes: local urL: jdbc: mysql: //127.0.0.1: 330G/guns ?=utoRecon username: root i00 rs: wall. mergestat 3.如需修改服务器端口或者 context-path,默认的 context-path为/,可参考下图 port: 8080 servlet context-path: 4.执行 GunsApplication类中的man方法,即可运行Guns系统 5.打开浏览器,输入1oce1hst:8080,即可访问到Guns的登录页面,默认登录账号密码: admin/1111 24打包部署 目前Guns支持两种打包方式,即jar包和wer包 1.打包之前修改quns- admin. pom中的 packaging节点,改为jar或者wax peI- appl cation yml x m guns-admin <?xnl version="1.0 encoding=" 7> projectxmlms=http://maven heorg/pom/4.0.axmlNs:xs1=http://www.w3,org/2001/xmls xsischemalocationhttp://maven.apacheorg/pcm/4.0.0http://naven.apacheorg/xsd. <mode version>4. 0. 0</modelversions 5 ≤ pa rent <groupId>co, stylefeng/groupid> cartifactIdbguns-parentcyartifactId <versions. 0. 0-SNAPSHOTs/versions <re lativePath>. /guns-parent/pom. xml</relativePatn> c/parent rtifactIdsyuns-admir</artifactIds 1234567890 version1. 0.0-SNAPSHOTs/version <packagingpjar</packaging> cnamexguns-admins/nare <description>guns Bgspring boot 4</description> ≤ dependencies 2在项目的gune- parent目录执行 maven命令c1 ean package- Maven,test,skip=true,即可打包,如下 Maven Proje 购虫+品回三÷上 r Profiler im guns admin a Lieyu g plugins ai Dependence 把这个选上跳过测试 点击这个就可以弹出命令输入框 http:/guns.stylefeng.cn/ 6/46 2018/11/7 Guns技术文档v5.-作业部落( md markdown编辑阅读器 Execute Maver Goal Working directory /Users/stylefeng/Downloads/guns/guns-parent Command line clean peckage-Dmeven test skip=true Cancel Execute 3.命令执行成功后,在guns- admin/ target目录下即可看到打包好的文件 guns -/work/ space/guns idea doc p□sre □ target P classes p□ generated= sources generated-test-sources mavcnearchivor meven-status Tast-glassas 目guns-1.0oJar 自. attributes 自 -grigore guns, iml E LICENSE m pam. Kml a README.md Ill External Libraries o Scratches and Consoles 提示:若打的包为jr包,可通过ava- jar guns-admn-1.0,0- SNAPSIIOT. jar来启动Guns系统 3.开发手册 用Guns开发手头常备如下几个工具 ·H+42源代码:群文件里有 ·mybatis-plus文档:htt:!/mnp.baomidou.com beetlxt:http://ibeetl.com/guide/#beetl aydate和ayer组件文档:htt/www.layui.com/alonehtn SpringBootxt:https://docs.spring.io/spring-boot/docs/current/reference/html/ 31了解Guns 3.1.1模块结构 新版的51版本的Guns结构,开发环境由多模变成了单模块,化繁为简,返璞归真, gv Guns -/work/ownspace/guns ■sre □main W□cn. stylefeng guns a contig score □modu|ar s GunsApp icat on c Gunsservletnitializer re sources test target 自. gitattributes H-gitigr README. md nl External Libraries P o Scratches and Consoles http:/guns.stylefeng.cn/ 7146 2018/11/7 juns技术文档v5.-作业部落( md Markdown编辑阅读器 但是pom中还是依赖了作者开发的两个其他模块, ≤!一代码生成器一 dependency> A.groupId>cn, sty lefeng guns</groupId> titactIdsguns-generatorcyartitactios <version1..0</versio dependenc !-核心组件一≥ <dependencys <groupId>cn sty lefeng roses</groupId rtifactIdkernel-core/artifactId cversionp1.1.0</versio </dependency? 这俩模块作者已经上传到maven的中央仓库中(https://search.maven.org/search?g=cn.stylefeng) guns- generatαr为代码生成模块,其中代码生成模块整合了myυatis-pls的代码生成器和guns独有的代码生成器,可以-键生成 entitγ,dao, service,html,js等代码,可减少很多开发新模块的工作量,此模块的 gitee地址为 httpsilgitee.com/stylefeng/guns-generator kernel-core模块为抽象岀的核心(通用)模块,以供其他模块调用,此模块主要封裟了一些通用的工具类,公共枚举,常量,配 置等等,此模块的gitee地址是htts:/lgitee.com/stylefeng=Roses/roses-kernel 312包结构说明 □ Project r guns -/work/ownS pace/guns . idea p■dnc开发手册 t sql src 数据库初始化脚本 main □java a cn. styleter cong项目配置 core核心包 a modular业务包 a GunsApplication顶目启动类 c GunsservletIn tial rEsources □META-|NF application. yml配置文件 ehcache. xm缓存配 想 Ingmar: k-s ring. xml日志配置 ebpp stat静态资源文件 o WEB-INF, view页面文件 v ja o en. stylefeng guns测试包 target a. gitattributes nera LICENSE m pam. xml e README, md Ill External Libraries k Po Scratches and Consoles 32实战开发 Guns开发三部曲→>1建表2代码生成3添加菜单4适配业务代码 下面以一个订单业务为例,实战演练如何用Guns编写简单的增删改查业务 32.1建表 http:/guns.stylefeng.cn/ 2018/11/7 juns技术文档v5.-作业部落( md Markdown编辑阅读器 新建订单表如下 对象 E biz_order@ cuns (localhost) 吕保存机字段插入字段删除字段P主个二移↓下移 宇段实引!外键发磊项注释qL预名 长度 小数点不是nu虚拟键 注释 冂1主键 goods name varchar 萄品名称 0 create time 下单时间 warriar 下兰用户 user_phone 下单用产 2. DROP IABLE IF ExISTS biz orderi 1 id int(1) NOT NUT, AUTO TNCREMENT COMMENT‘主键 goods name varchar(255) DEFAULT NULL COMMEN商品名称 下单地点 6 create time datetime DEFAULT NULL CoMMEN下单时间 user name varchar(255) DEFAULT NULL COMMEN下单用户名称 user phore varchar(255) DEFAULT NULL COMMEN'下单用户电话', PRIMARY KEY id) USING BTREE ENGINE=工 mnoDB DEFAULT CHARSE=utf8 ROW FORMA= DY NAMIC COMMEN='订单表'; 11 12. SET FCREIGN KEY CHECKS l1 322代码生成 登录管理系统,打开代码生成页面,填写如下内容,注意看红线部分内容 代悄生成 项月径 D/ee SPice/gul is/yuIls-dd'Tlill cOIILslyleleiyyulIs 杨心包 作者 stylefeng 业名称 订单管理 模块名称 order 表名称 记0dcr 表的 b记 类名 Ordcr 生成 数据表 biz orde订单表 ontroller控制器模板 sys der部门表 eny实体模板 sys dict-字典表 servce-serce模 sys expanse-报销表 dao-dao模积 sys login log登录 index(Pagc首页模板 sys_mem菜中表 addPage-添加面模板 sys nati道知表 edit Page编辑雨模板 sys_ operation log操作志 indexs-主页j模 sy5rela:ion角色和菜单关联表 nos详情页js模板 ys role角色表 sqsq句板 sys use管理员素 http:/guns.stylefeng.cn/ 9146 2018/11/7 juns技术文档v5.-作业部落( md Markdown编辑阅读器 下面详细讲解代码生成使用: 1.项目路径:代码生成的路径,具体到guns- admin模块的绝对路径,一般不需要修改,因为程序会自动计算岀guns- admin的绝对路径 2项目的包:为guns-admn的同 GunsApplication类同一目录的包,如下图,一般也不需要修改 平□ cn sty lefang guns b modu ar G GunsAppl cation C GunsServletIritializer □META-|NF e apolication yml ehcache xml 3.核心包:gun-core的包,一般也不需要修改 4.作者:填写代码生成出的注释上的作者 5.业务名称:生成业务的中午名称 6.模埉名称:对应代码中 modular包下的模块名称,如下图,若模块名称填 order,则生成出的业务代码回到 order包下 jav □Gn. stylefeng guns P D config b.core 平 b modu|ar o order (o GunsApplicaticn O GunsServletInitializer lE resources b□META-NF 7.父级菜单:此项的选择会影响生成sq悿添加菜单项的切入点,生成岀的sq|文件抉行后可自动增加到syS_men菜单项,省去手动添加菜单的 繁琐 8.表前缀:填写此项会自动移除生成实伾, mapper和 service类的名称中包含的重复前缀,例如生成订单表业务代码时,填写bz,则生成的 实体中不会包含B前缀名称,若不填写,则生成的实体类为 BioRder 9.数据表:选择即为生成该表所对应的实体,dao, service等类 10.模板:选择后生成相应的控制器,实体, service,caρ代码等等 生成代码之后需要重启一下管理系统,生成的代码才可以生效! 333添加菜单与分配权限 生戌代码之后,需要为管理系统添加菜单,才可以让新增加的业务显示到页面上,添加菜单有两种方式 第一种为手动添加菜单,依次点击系统管理->菜单管理->点击添加,打开添加页面,如下 单名 莱单雅号 菜单父编号 求址 排露 层级 管理 加用 订单管理 请求地址 /order 豪改用月 除用日 菜单输号 order manage 排序 4 父级骗号 分配角自是否是菜单 是 配角自 Ri e I 罗取消 列月 这里需要注意如下几点: 请求地址需要和 Controlle中的 RequestMapping的值一致 ·排序为同层级菜单中显示菜单的顺序 http:/guns.stylefeng.cn/ 10/46 【实例截图】
【核心代码】