2023年7月25日发(作者：)

从零开始部署GunsV4.0（SpringBoot开源框架）教程开篇废话：Guns作为⼀个较新且流⾏的SpringBoot框架，对于那些已经接触过各种SSH，SSI，SH等传统的JAVAEE框架的⽼⼿们来说肯定是很快就能够成功部署和掌握的了，但也不免有许多新⼿想学习⼀下。此类框架往往是由多种开源框架堆砌⽽成的，若想⼀个个攻破对于新⼿来说是较为困难的⼀件事。就我个⼈经验⽽⾔，掌握⼀个框架的最快最好的⽅法其实还是项⽬驱动。从学习⼀样新事物的⾓度上来说，多种⽅法中的其中⼀种为：先对事物有个直观且形象地认识，然后根据现象去摸索其⾝后的本质，最后再将脑⼦中零零散散的印象整合起来即可形成⾃⼰对该事物的系统的认识，后续再不断温故⽽知新，从⽽能够熟练掌握它。因此，笔者希望能够通过这篇⽂章，让读者能够先对这个框架有个概念上的认知，其次以详细地部署教程让读者能够顺利部署Guns框架并运⾏起来，使得读者能够⾃⼰真正地直观上了解Guns可以⼲什么，最后读者再⾃⾏慢慢摸索其细节（若笔者有时间，后续可能会继续研究Guns框架并撰写⼀些⼼得体会与⼤家分享）。------------------------------------------------------------正⽂开始------------------------------------------------------------本⽂将按照如下结构为⼤家介绍如何从零开始部署Guns开源框架（⽆基础的⼈亦可按照教程部署成功）。1. Guns的通俗介绍2. 笔者部署Guns的环境3. Guns部署教程3.1 下载安装JDK以及环境变量配置3.2 下载安装MySQL3.3 下载安装Navicat For MySQL3.4 下载Maven和Eclipse以及它们的配置3.5 Eclipse导⼊Guns项⽬3.6 配置Guns项⽬的数据库3.7 修改Guns项⽬的配置⽂件并运⾏4. 结束语1. Guns的通俗介绍Guns是⼀个近⼏年来基于SpringBoot的开源便利且较新的JavaEE项⽬开发框架，它整合了springmvc + shiro + mybatis-plus + beetl+ flowable多项开源技术，致⼒于让Java后台开发更简洁快速，参考介绍。本教程不详细介绍这些开源框架的技术细节和原理，⽹上已有许多教程和介绍，读者可⾃⾏检索。接下来将通俗简单地让读者对Guns有个概念上的认知：通俗简单地说，（1）SpringMVC是后端以MVC模式改进了Spring的⼀项JavaEE框架，主要⽬的是为了使得后端各个层次解耦合，便于后端业务逻辑开发与维护，欲了解更多更细，请参加介绍；（2）Shiro是⼀个简单易⽤的Java安全框架，即可理解为帮你做了很多安全管理机制和保障的Java API，保障⽤户登录安全，会话安全等的框架，详细介绍请参考；（3）mybatis-plus是⼀个半⾃动化的持久化框架，即如何将数据库的表结构与Java中的对象建⽴⼀层映射关系，使得JDBC的相关SQL开发更便捷快速，详细介绍请参考；（4）beetl是⼀个类似于FreeMarker的模板引擎，读者可以将其形象地理解为⼀种代码的模具，通过这个模具可以⼤幅度减少重复代码的复制粘贴修改的⼯作，欲了解更多参考。开发经验丰富的⼈其实能够体会到⽆论是哪个功能模块的开发，其基本的增删改查code其实差不太多，只是变量命名中部分单词不同⽽已，以及某些模块业务逻辑更为复杂；（5）flowable是⼀个轻量级Java业务流程开发引擎，类似于Activiti这样的引擎，读者可以直观地理解为，员⼯请假-组长审批-经理批准这样的业务流程能够通过flowable简单⽽快速地进⾏开发，欲了解更多请参考。2. 笔者部署Guns的环境笔者使⽤的操作系统为Windows 10，具体配置信息可看我之前的博客《》的1.1章节。Guns所需的⼯具有：Guns V4.0源码（）、Maven3.5.4（）、Eclipse-Photon（）、JDK8（）、MySQL（）以及Navicat for MySQL（⾮免费⼯具，⾃⾏搜索下载or从我后⾯提供的度盘链接下载）。为⽅便新⼿，笔者已对这些安装包做了整理，提取码为：icft，如下图所⽰。3. Guns部署教程此教程中的《3.1 下载安装JDK以及环境变量配置》和《3.4 下载Maven和Eclipse以及它们的配置》已经在之前的博客中给出了⾮常详细的介绍了，因此请读者移步《》仔细阅读《2.1 安装配置JDK环境》章节、《2.2 安装配置Maven环境》章节和《2.3 安装配置Eclipse》章节，并按其步骤操作后回到这⾥看后续教程。⽽此教程的核⼼部分为《3.5 Eclipse导⼊Guns项⽬》章节、《3.6 配置Guns项⽬的数据库》章节和《3.7 修改Guns项⽬的配置⽂件并运⾏》章节。3.1 下载安装JDK以及环境变量配置参考《》中的《2.1 安装配置JDK环境》章节。3.2 下载安装MySQL此过程⽐较简单，与安装⼀般常⽤软件⽆异，此处提供⼀个的教程给新⼿们。3.3 下载安装Navicat For MySQL此过程也⽐较简单，与安装⼀般常⽤软件⽆异，⼀直下⼀步下⼀步下⼀步，直⾄完成即可。3.4 下载Maven和Eclipse以及它们的配置参考《》中的《2.2 安装配置Maven环境》章节和《2.3 安装配置Eclipse》章节。3.5 Eclipse导⼊Guns项⽬将所下载的解压⾄本地硬盘中，如下图所⽰。打开Eclipse，点击File---Import导⼊Guns项⽬，如下图所⽰。点击“”后会出现如下图的导⼊对话框，请选择Maven选项中的“Existing Maven Projects”。之后，点击“Next”按钮后，按如下图的①、②和③的操作选中之前解压的Guns-master⽬录。点击“选择⽂件夹”后，在上图的“Projects”栏⽬中会识别出多个配置⽂件，正常识别后，这些都会默认打上“√”，但是由于本⼈已经导⼊过这个项⽬，⽽Eclipse不允许在同⼀个⼯作空间中导⼊多个相同的项⽬，故⽽我的截图中都没打钩。正确情况如下图所⽰，并在下图中点击“Finish”按钮以进⾏项⽬导⼊。导⼊过程中，根据读者⽹速以及读者与该项⽬依赖包所处站点的接⼊速率不同，完成导⼊的速度不同，有⼈会⽐较快有⼈会⽐较慢。导⼊成功后如下图所⽰，可看见guns-admin、guns-core、guns-generator、guns-parent和guns-rest五个项⽬。按照以上步骤，我们已经成功将guns项⽬导⼊eclipse，还剩余两个步骤即可成功运⾏该项⽬。3.6 配置Guns项⽬的数据库在导⼊成功的“guns-admin”项⽬中，我们能够找到“sql”⽬录下的⽂件，如下图所⽰，将打开后的中所有的内容复制⼀下。打开Navicat for MySQL软件，初次打开的读者得先新建⼀个连接，请按如下图操作新建连接，点击“连接”按钮后，在“连接名”处输⼊⼀个名字（随意），⼀般本地的都设置为“localhost”，接着在“密码”处输⼊读者在《3.2 下载安装MySQL》过程中所设置的密码（假设读者所设置密码为abc123，后续还会⽤到这个密码）。填写完毕后，可点击左下⾓的“连接测试”看看是否能成功连接到MySQL数据库，若提⽰成功则点击“确定”按钮，若失败则根据失败提⽰上午检索失败原因（失败原因过多，读者⽆法⼀⼀列举，常见错误有MySQL安装失败或者MySQL服务未启动）。打开新建的“localhost”连接，如下图所⽰：在“localhost”上右键，选择“新建数据库...”，如下图所⽰：在打开的如下图所⽰的界⾯中，配置如下信息：数据库名为guns，字符集为utf8 -- UTF-8 Unicode。点击上图的“确定”按钮后，localhost连接的数据库中会多⼀个名为“guns”的数据库，如下图所⽰：接着，我们按照上图所选，点击guns数据库中的“查询”后可得到如上图的界⾯，我们需点击图中的“新建查询”按钮，得到如下图的对话框：在上图弹出的“查询”对话框中，⾸先，将之前在Eclipse的guns-admin项⽬中的⽂件中所复制的所有内容粘贴⾄此对话框中。接着点击左上⾓的“运⾏”按钮，这些SQL语句则会被全部执⾏⼀遍，执⾏成功后，可在guns数据的“表”栏⽬中看到（没有的话请在右侧空⽩处右键点击⼀下“刷新”按钮）如下图新增的⼏张表：⾄此，距离成功运⾏只差最后⼀步啦！3.7 修改Guns项⽬的配置⽂件并运⾏让我们回到Eclipse，找到guns-admin项⽬中的“”⽂件，它在src/main/resource路径下，并将该⽂件中所有的“username和password”部分的password默认的root值改为读者安装MySQL时所设置的密码（如abc123），该步骤具体如下图所⽰：修改完此配置⽂件后，我们就可以开始运⾏guns项⽬了，请找到guns-admin项⽬中的src/main/java路径下的，⽬录中的⽂件，它是guns项⽬的主程序⽂件，如下图所⽰：请在上图右侧的空⽩处点击右键，选择“Run as”----"Java Application"，如下图所⽰：若成功运⾏，则可在Eclipse的“Console”控制台中看到如下图结果：点击登录后，可进⼊如下图界⾯：⾄此，恭喜⼤家，Guns V4.0已成功部署并运⾏成功。4. 结束语对于新⼿来说，这些过程可能还是⽐较多⽽复杂的，⽽且过程中可能会因各种意想不到的问题⽽卡住，如果读者能够保证所有的步骤均严格按照本教程的写法操作，⼀般情况下不会出现问题。但是若出现了问题，也请不要怕，将错误提⽰输⼊⾄百度，则能够获得⾮常多的解答和解决⽅案，⼀个⼀个问题解决后，会逐渐增加你的成就感。其实本教程中的多数内容，Guns提供的免费视频教程中也都有包含，此篇博客仅做⼀个核⼼步骤提取和记录，让读者们能够不需要耗费太多时间观看视频也能部署Guns项⽬，倘若本⽂对您没有作⽤，可从Guns官⽅提供的中获取视频并观看。对于Guns框架中的技术细节，⽬前笔者尚未有时间进⾏研究和整理，⽇后有时间会考虑撰写相关⼼得体会。在《Guns的通俗介绍》中，倘若⼤⽜们觉得写得有问题，请尽管指出，看到后我会及时修改，谢谢。