# 目录


# 关于分支和版本的说明

当前最新版本为:

分支说明

  • 开发分支(dev):最新代码,不保证稳定,实时发布 SNAPSHOT ,同时提交 PR 也是在这个分支。
  • 主分支(master):保护分支,稳定版代码,用于发布稳定版版本,不接受任何 PR

版本号说明

  • 稳定版(release):格式为 x.x.x,为官方推荐使用的版本,可以用于生产环境。
  • 快照版(snapshots):格式为 x.x.x-SNAPSHOT。快照版会实时更新(dev 分支 push 后),想尝试新功能的开发者可以在开发环境使用 SNAPSHOT 版。

WARNING

快照版不可用于生产环境!!!
快照版不可用于生产环境!!!
快照版不可用于生产环境!!!

# 使用 jap-bom

mica-bom,可以简化依赖和依赖版本统一处理,避免jar冲突。

注意:maven 是按先后顺序进行依赖的,所以 mica-bom 顺序按 mica、spring boot、spring cloud依次添加。

# Maven

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.fujieid</groupId>
            <artifactId>jap-bom</artifactId>
            <version>${jap.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
1
2
3
4
5
6
7
8
9
10
11

# Gradle

Spring boot 环境中可以开启 apply plugin: "io.spring.dependency-management" 插件。

dependencyManagement {
    imports {
        mavenBom "com.fujieid:jap-bom:${japVersion}"
    }
}
1
2
3
4
5

# 使用 snapshots

注意:snapshots 版本会及时响应,修复最新的 bug 或者必要的需求。

# Maven

<repositories>
    <repository>
        <id>sonatype-nexus-snapshots</id>
        <name>Sonatype Nexus Snapshots</name>
        <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
        <releases>
            <enabled>false</enabled>
        </releases>
    </repository>
</repositories>
1
2
3
4
5
6
7
8
9
10
11
12
13

# Gradle

repositories {
    mavenLocal()
    maven { url "https://maven.aliyun.com/repository/public" }
    maven { url "https://maven.aliyun.com/repository/spring" }
    maven { url "https://maven.aliyun.com/repository/spring-plugin" }
    maven { url "https://repo.spring.io/libs-release" }
    maven { url "https://repo.spring.io/milestone" }
    // 添加 snapshots 库地址
    maven { url "https://oss.sonatype.org/content/repositories/snapshots" }
    mavenCentral()
}
1
2
3
4
5
6
7
8
9
10
11

# 推荐阅读

本章节介绍 JAP 的具体使用方法。

须知 名词解释 使用 jap-simple 使用 jap-social 使用 jap-oauth2 使用 jap-oidc 使用 jap-sso 使用 jap-mfa 前后端分离架构下使用 JAP 错误代码