|
|
# jnpf-java-boot
|
|
|
|
|
|
> 特别说明：源码、JDK、MySQL、Redis等存放路径禁止包含中文、空格、特殊字符等
|
|
|
|
|
|
## 环境要求
|
|
|
|
|
|
> 官方建议： JDK版本不低于 `1.8.0_281`版本，可使用`OpenJDK 8`、`Alibaba Dragonwell 8`、`BiShengJDK 8`
|
|
|
|
|
|
项目 | 推荐版本 | 说明
|
|
|
-----|-----------------------------------| -------------
|
|
|
JDK | 1.8.0_281 | JAVA环境依赖(需配置环境变量)
|
|
|
Maven | 3.6.3 | 项目构建(需配置环境变量)
|
|
|
Redis | 3.2.100(Windows)/6.0.x(Linux,Mac) |
|
|
|
MySQL | 5.7.x+ | 数据库任选一(默认)
|
|
|
SQLServer | 2012+ | 数据库任选一
|
|
|
Oracle | 11g+ | 数据库任选一
|
|
|
PostgreSQL | 12+ | 数据库任选一
|
|
|
达梦数据库 | DM8 | 数据库任选一
|
|
|
人大金库 | KingbaseES V8 R6 | 数据库任选一
|
|
|
|
|
|
## 工具推荐
|
|
|
> 为防止无法正常下载Maven以来，请使用以下IDE版本
|
|
|
|
|
|
IDEA版本 | Maven版本
|
|
|
-----|-------- |
|
|
|
IDEA2020及以上版本 | Maven 3.6.3及以上版本 |
|
|
|
|
|
|
## IDEA插件
|
|
|
|
|
|
- `Lombok`
|
|
|
- `Alibaba Java Coding Guidelines`
|
|
|
- `MybatisX`
|
|
|
|
|
|
## Maven私服配置
|
|
|
|
|
|
> 通过官方私服下载依赖完成后，由于IDEA的缓存可能会出现部分报红，重启IDEA即可
|
|
|
|
|
|
#### JNPF官方Maven私服与阿里云Maven私服、Maven官方的包区别
|
|
|
|
|
|
- com.sqlserver:sqljdbc4:4.0
|
|
|
- com.oracle:ojdbc6:11.2.0
|
|
|
- com.dm:DmJdbcDriver18:1.8.0
|
|
|
- com.kingbase8:kingbase8-jdbc:1.0
|
|
|
- dingtalk-sdk-java:taobao-sdk-java-source:1.0
|
|
|
- dingtalk-sdk-java:taobao-sdk-java:1.0
|
|
|
- yozo:signclient:3.0.1
|
|
|
|
|
|
1、打开`maven`下`conf/settings.xml`文件
|
|
|
|
|
|
2、在`<servers></servers>`中添加
|
|
|
|
|
|
```xml
|
|
|
<servers>
|
|
|
<server>
|
|
|
<id>maven-releases</id>
|
|
|
<username>jnpf-user</username>
|
|
|
<password>HLrQ0MA%S1nE</password>
|
|
|
</server>
|
|
|
<server>
|
|
|
<id>maven-snapshots</id>
|
|
|
<username>jnpf-user</username>
|
|
|
<password>HLrQ0MA%S1nE</password>
|
|
|
</server>
|
|
|
</servers>
|
|
|
```
|
|
|
3、在`<mirrors></mirrors>`中添加
|
|
|
|
|
|
```xml
|
|
|
<mirror>
|
|
|
<id>maven-snapshots</id>
|
|
|
<mirrorOf>*</mirrorOf>
|
|
|
<name>maven-snapshots</name>
|
|
|
<url>https://repository.jnpfsoft.com/repository/maven-public/</url>
|
|
|
</mirror>
|
|
|
```
|
|
|
|
|
|
## 环境配置
|
|
|
- 打开`jnpf-admin/src/main/resources/application.yml`
|
|
|
|
|
|
> 环境变量
|
|
|
> - dev 开发环境
|
|
|
> - test 测试环境
|
|
|
> - preview 预发布环境
|
|
|
> - pro 生产环境
|
|
|
|
|
|
``` yml
|
|
|
#环境 dev|test|pro|preview
|
|
|
profiles:
|
|
|
active: dev
|
|
|
```
|
|
|
|
|
|
- 打开`application-x.yml`(`x`表示环境变量),需配置以下
|
|
|
- 服务端口(`port`)
|
|
|
- 表空间(`tableSpace`,当数据库为`Oracle`、`达梦`、`金仓`时表空间必须指定，其他数据库为空即可)
|
|
|
- 数据库连接
|
|
|
- Redis
|
|
|
- 静态资源
|
|
|
|
|
|
## 启动项目
|
|
|
- `jnpf-admin/src/main/java/JnpfAdminApplication.java`，右击运行即可。
|
|
|
|
|
|
### 项目发布
|
|
|
|
|
|
- 在`IDEA`右侧`Maven`-`jnpf-java-boot(root)`-`Lifecycle`中双击`clean`清理下项目
|
|
|
- 双击`package`打包项目
|
|
|
- 打开项目目录，依次打开`jnpf-java-boot\jnpf-admin\target`，将`jnpf-admin-{version}-RELEASE.jar`上传至服务器
|
|
|
|
|
|
### swagger接口文档
|
|
|
- `http://localhost:30000/swagger-ui/` |
