# jnpf-common

**Repository Path**: jack-net/jnpf-common

## Basic Information

- **Project Name**: jnpf-common
- **Description**: jnpf-common-3.8.0 flowable流程引擎父级依赖
- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-07-20
- **Last Updated**: 2025-07-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

> 特别说明：源码、JDK、MySQL、Redis等安装或存放路径禁止包含中文、空格、特殊字符等

## 一 项目结构

```text
├── jnpf-boot-common - 单体版本涉及依赖 
│   ├── jnpf-common-auth - 认证模块
│   ├── jnpf-common-connector - 单点数据推送模块
│   ├── jnpf-common-core - 基础类及常用工具
│   ├── jnpf-common-database - 数据库配置及多数据库兼容
│   ├── jnpf-common-file - 文件工具类模块
│   ├── jnpf-common-office - office操作模块
│   ├── jnpf-common-redis -  缓存工具Redis组件配置
│   ├── jnpf-common-scheduletask - 调度工具
│   ├── jnpf-common-security - 接口鉴权配置
│   ├── jnpf-common-shardingsphere - shardingsphere配置
│   ├── jnpf-common-sms - 短信模块
│   ├── jnpf-common-swagger - API组件Swagger配置
│   └── pom.xml
├── jnpf-cloud-common - 微服务版本涉及依赖 
│   ├── jnpf-common-cloudshardingsphere - 微服务shardingsphere配置
│   ├── jnpf-common-dubbo - Dubbo拦截器, 自动封装认证信息
│   ├── jnpf-common-feign - 远程调用Feign组件配置
│   ├── jnpf-common-seata - seata依赖
│   └── pom.xml
├── jnpf-dependencies - 所有依赖版本
│   └── pom.xml
├── pom.xml
└── README.md - 项目说明文档
```

## 二 环境要求

| 类目 | 版本或建议 |
| --- | --- |
| 电脑配置 | 建议开发电脑I3及以上CPU，内存32G及以上 |
| 操作系统 | Windows 10/11，MacOS |
| JDK | 建议使用1.8.0_281及以上版本，可使用Eclipse Temurin JDK 8、Alibaba Dragonwell 8、BiSheng JDK 8等 |
| Maven | 3.6.3及以上版本 |
| 开发工具 | IDEA2020及以上版本或 Eclipse、 Spring Tool Suite等IDE工具 |

## 三 关联项目

> 为以下项目提供基础依赖

| 项目 | 分支 | 分支(Coding) | 说明 |
| --- | --- | --- | --- |
| jnpf-file-core-starter | v3.7.x | v3.7.x-stable | 文件基础依赖项目源码 |
| jnpf-scheduletask | v3.7.x | v3.7.x-stable | 任务调度客户端依赖及服务端项目源码 |
| jnpf-sso-starter | v3.7.x | - | 单点登录集成依赖项目源码 |
| jnpf-java-boot | v3.7.x | v3.7.x-stable | java-boot单体后端项目源码 |
| jnpf-java-cloud | v3.7.x | v3.7.x-stable | java-cloud微服务后端项目源码 |

## 四 使用方式

### 4.1 前置条件

#### 4.1.1 本地安装jnpf-core

在IDEA中，双击右侧 `Maven` 中 `jnpf-common` > `jnpf-boot-common` > `jnpf-common-core` > `Lifecycle` > `install`，将 `jnpf-common-core` 包安装至本地

#### 4.1.2 本地安装dependencies

在IDEA中，双击右侧 `Maven` 中 `jnpf-common` > `jnpf-dependencies` > `Lifecycle` > `install`，将 `jnpf-dependencies` 包安装至本地

#### 4.1.3 本地安装file-core-starter

IDEA打开 `jnpf-file-core-starter` 项目, 双击右侧 `Maven`中 `jnpf-file-core-starter` > `Lifecycle` > `install`，将 `jnpf-file-core-starter` 包安装至本地

#### 4.1.4 本地安装scheduletask

IDEA打开 `jnpf-scheduletask` 项目, 双击右侧 `Maven`中`jnpf-scheduletask` > `Lifecycle` > `install`，将 `jnpf-scheduletask` 包安装至本地

### 4.2 本地安装

在IDEA中，双击右侧 `Maven` 中 `jnpf-common` > `Lifecycle` > `install`，将 `jnpf-common` 包安装至本地

### 4.3 私服发布

#### 4.3.1 配置Maven

打开Maven安装目录中的 `conf/setttings.xml`，

在 `<servers></servers>` 节点增加 `<server></server>` ，如下所示:

```xml
  <!-- 发布版 -->
	<server>
    <id>maven-releases</id>
    <username>jnpf-user（账号，结合私服配置设置）</username>
    <password>123456（密码，结合私服配置设置）</password>
  </server>
```

#### 4.3.2 配置项目
> 注意：pom.xml里 `<id>` 和 setting.xml 配置里 `<id>` 对应。

修改 `jnpf-common/jnpf-dependencies/pom.xml` 文件

```xml
<distributionManagement>
    <repository>
        <id>maven-releases</id>
        <name>maven-releases</name>
        <url>http://nexus.jnpfsoft.com/repository/maven-releases/</url>
    </repository>
</distributionManagement>
```

#### 4.3.3 发布到私服

在IDEA中，双击右侧 `Maven` 中 `jnpf-common` > `Lifecycle` > `deploy` 发布至私服。

## 五 更新版本号

打开 `jnpf-common/jnpf-dependencies/` 目录，执行如下命令

```
# mvn versions:set -DnewVersion=3.5.0-RELEASE
mvn versions:set -DnewVersion=版本号
```