浅谈 Java 多版本发布

灰太狼 2023-02-12 05:40 11阅读 0赞

### 文章目录 ###

*  1. 契约精神
 *  2. 版本号
 *  3. 一方库版本设计
 *  4. 二方库版本设计
 *   *  4.1. 理解“高版本向下兼容”
 *  5. 三方库版本设计
 *  6. Web API 版本设计

# 1. 契约精神 #

什么是契约？

百度百科：[https://baike.baidu.com/item/%E5%A5%91%E7%BA%A6/2874688][https_baike.baidu.com_item_E5_A5_91_E7_BA_A6_2874688]  
维基百科：[https://zh.wikipedia.org/zh/%E5%A5%91%E7%BA%A6][https_zh.wikipedia.org_zh_E5_A5_91_E7_BA_A6]

相关概念：

*  Design by Contract （契约式设计）
 *  Contract-First (契约先行)

# 2. 版本号 #

[软件的版本号是如何定义的？- 知乎][-]

# 3. 一方库版本设计 #

一方库：本工程中的各模块的相互依赖

推荐方案：

*  版本统一
 *  顶层 pom 定义版本
 *  子随父：child module 沿用 parent module 版本

版本管理：

Maven 项目，建议采用 Maven Version Plugin 统一管理升级。

发布：

无需发布，项目内引用。

# 4. 二方库版本设计 #

二方库：公司内部的依赖库，一般指公司内部的其他项目发布的 jar 包

推荐方案：

*  基于版本号，多版本发布
 *  高版本向下兼容

发布：

Maven 私服发布，多版本代码发布。

## 4.1. 理解“高版本向下兼容” ##

*  对“修改、删除”关闭，对“新增”开放

旧版本：

{
        
    	"name":"Bob",
    	"age":20
    }

向下兼容新版本 - `新增`

{
        
    	"name":"Alice",
    	"age":18,
    	"address":"Beijing"
    }

非向下兼容新版本 - `修改`

{
        
    	"newName":"Alice",
    	"age":18
    }

非向下兼容新版本 - `删除`

{
        
    	"age":18
    }

**极端情况**

如果整个契约变动很大，并不满足 “向下兼容”，建议新建 API，`path` 采用 `v1`, `v2` 等字样区分。

# 5. 三方库版本设计 #

三方库：公司之外的开源库， 比如 apache、ibm、google 等发布的依赖

推荐方案：

同二方库版本设计，需要更加注重版本，严格落实 “基于版本研发”。

发布：

Maven 私服 / 中央仓库 / Jar 包 多版本代码发布。

# 6. Web API 版本设计 #

背景：调用方多样性（H5 无版本、移动终端有版本），但通信协议一致。

推荐方案：

参考三方库版本设计

发布：

自建服务器发布，“伪多版本发布” （发行版为最新版本，向下兼容多版本）

[https_baike.baidu.com_item_E5_A5_91_E7_BA_A6_2874688]: https://baike.baidu.com/item/%E5%A5%91%E7%BA%A6/2874688
[https_zh.wikipedia.org_zh_E5_A5_91_E7_BA_A6]: https://zh.wikipedia.org/zh/%E5%A5%91%E7%BA%A6
[-]: https://www.zhihu.com/question/20289602

发表评论取消回复

表情：

评论列表（有 0 条评论，11人围观）

还没有评论，来说两句吧...

相关阅读

相关浅谈 Java 多版本发布

文章目录 1. 契约精神 2. 版本号 3. 一方库版本设计 4. 二方库版本设计 4.1. 理解“高版本向下兼容” 5. 三方

灰太狼/ 2023年02月12日 05:40/ 0 赞/ 12 阅读

相关浅谈”多态”

文章目录前言一、多态概述二、多态实现的条件三、多态的作用四、多态的转型（重要！！！） 1.向上转型小结

不念不忘少年蓝@/ 2023年01月08日 08:27/ 0 赞/ 165 阅读

相关浅谈java

java与c语言 java是一门面向对象编程的强类型语言，一切东西都要抽象为对象，具有封装、继承、多态三个特性。这门语言常用于开发网站，与c语言不同，c语言是面向

短命女/ 2022年09月30日 15:42/ 0 赞/ 322 阅读

相关浅谈java

Java是面向对象的程序设计语言，同普通的面向对象一样，java也同样具有三大特征：封装，继承和多态。此处就不对其做过多赘述了。只提一点：Java不支持多重继承。

「爱情、让人受尽委屈。」/ 2022年08月07日 09:55/ 0 赞/ 282 阅读

相关浅谈C++多态

C++编程语言是一款应用广泛，支持多种程序设计的计算机编程语言。我们今天就会为大家详细介绍其中C++多态性的一些基本知识，以方便大家在学习过程中对此能够有一个充分的掌握。

淩亂°似流年/ 2022年08月04日 15:43/ 0 赞/ 200 阅读

相关浅谈C++多态

多态意思是一个事物有多种形态，运算符的重载，函数的重载都是多态现象。从系统实现的角度看，多态性分为两类：静态多态和动态的多态，之前函数的重载和运算符的重载都属于静态的多态，在程

柔光的暖阳◎/ 2022年07月10日 05:27/ 0 赞/ 246 阅读

相关浅谈jQuery 2.0版本

1、jQuery 2.0 版本的一些特性： 1) 不兼容 IE6/7/8 需要注意 IE9、IE10 的兼容模式仍然会使 jQuery 2.0 运行不正常，需要在 HTTP

傷城~/ 2022年06月17日 02:27/ 0 赞/ 301 阅读

相关【版本工具】Git-浅谈git命令

一、代码上传（1）git init : 初始化git仓库（2）git add --all / git add . 添加本地文件到暂存区（3）git comm

傷城~/ 2022年06月12日 03:26/ 0 赞/ 225 阅读

相关浅谈C++多态

最近复习到了C++的多态性，我想把多态性的一些知识点进行下梳理总结。本文所有代码均在windows10的VS2013平台上测试 [https://blog.csdn.net/

旧城等待，/ 2022年05月12日 02:24/ 0 赞/ 227 阅读

相关浅谈Java 多线程同步

最近在研究多线程同步的一些问题，整理了网上很多文档，在这里给大家分享下 Java并发机制的底层实现原理 Java代码在编译后会变成Java字节码，字节码被类加载器加载到

r囧r小猫/ 2021年09月22日 21:30/ 0 赞/ 375 阅读