# 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/`