本地部署

在此章节,我们将介绍如何将Admui导入到本地开发工具,并正常运行。

新建项目

首先,您需要新建一个支持MAVEN的WEB项目,然后将源码中的admui-webadmui-sysadmui-core下的所有文件夹和 pom.xmlREADME.md分别拷贝到我们新建的项目下,然后运行maven update下载 jar 包,项目没有报错,说明项目导入成功。

初始化数据库

以 Navcat 为例,在您的 MySQL 数据库中新建一个数据库(如admui),然后选择数据库右键点击运行 SQL 文件菜单,在弹出的对话框中选择工程项目 database 下的admui.sql脚本文件,然后点击“开始”按钮,当出现[Msg] Finished - *** queries executed successfully的字样,说明导入成功。

Notes:请牢记您数据库的用户名和密码。

修改项目配置文件

打开admui-web下的/src/main/resources/application.properties配置文件,修改以下数据库信息:

spring.datasource.url=jdbc:mysql://localhost:3306/admui-v2?serverTimezone=UTC&useUnicode=true&characterEncoding=utf8&useSSL=false
spring.datasource.username=root
spring.datasource.password=123456

应用服务器部署

因为工程使用的 Spring Boot 内置的 Tomcat,所以启动项目只需直接找到admui-web下的Application.java文件直接右键点击Run as Jave Application菜单即可,服务端口可以修改application.propertiesserver.port属性,默认为9090

将项目部署到WEB应用服务器(如:Tomcat),启动并访问;默认的用户密码为 admin / 123456

Mybatis 代码生成器配置

工程集成了 Mybatis Generator,可以根据库表自动生成 Mybatis 的 Model,Mapper 和 mapping.xml 文件,首先修改generatorConfig.xml中的数据库链接,然后参考下面的表生成配置将要生成配置文件的表配置到配置文件中,然后在 admui-web 工程下src/test/java下找到GenerateCodeMain.java运行Run as Java Application操作,然后在配置的目标目录下寻找是否生成了相应的 Model,Mapper 和 mapping.xml 文件,然后将文件拷贝到对应的目录下修改包名。

定时器配置

找到admui-web下的com.ermei.admui.quartz下的 TaskSchedule 文件,代码提供了两种配置调度器的方式,开发人员可以根据业务需要在调度器下实现自己的业务逻辑。

POI导出

项目提供了公共 POI 导出接口,在 admui-web 工程目录下的 controller 包下找到 ExcelController 文件,开发人员可以将要导出的表头和数据传入,即可导出 Excel 文件,具体逻辑请根据实际需求实现。代码中只提供了导出样例。