欢迎访问我的GitHub
这里分类和汇总了欣宸的全部原创(含配套源码)：https://github.com/zq2599/blog_demos
常见场景
- 作为java库的开发者，如何让其他项目用上自己的java库？常用方式是上传到内网环境的Nexus3私服，其他java项目用maven或gradle从Nexus私服下载这个java库使用：
- 上述过程是一名java程序员的基本功，今天咱们就来实战演练这套基本功，全文由以下内容组成：
- 准备工作
- Nexus3上创建帐号
- Nexus3上创建两个仓库(release和snapshot)
- java库的项目中添加上传jar的配置，并验证上传
- 使用java库的项目中添加下载jar的配置，并验证使用
- snapshot更新验证
- release验证
前提
开始实战前有些准备工作要先完成，首先是本地开发环境：
- 操作系统：win10
- JDK：1.8.0_281
- Gradle：6.8.3
- IDEA：2021.1 (Ultimate Edition)
还请在局域网部署Nexus3私服，部署和配置方式请请参考：
- 《Ubuntu部署和体验Nexus3》
- 《群晖DS218+做maven私服(nexus3)》
- 《Nexus3常用功能备忘》
- 上述准备工作完成后，可以开始实战操作了；
Nexus3上创建帐号
-
以管理员身份登录Nexus3，按照下图操作新增一个帐号，用来执行上传下载操作：
-
帐号基本信息如下，注意两个红框中的配置，状态是激活，角色您可以视情况而定，我这里为了简单就用了管理员角色：
-
最后点击底部的Create local user按钮完成创建；
Nexus3上创建两个仓库(release和snapshot)
- 一般咱们会用到两种类型的仓库：release和snapshot，先创建release的，操作如下：
- 类型选择maven2(hosted)：
- 需要设置的参数如下图，这里我起的名字是my-release，注意Version policy一定要选择Release：
- 点击底部的Create respository即可创建仓库；
- 接着创建snapshot类型的仓库，名字是my-snapshot，详情如下所示，注意Version policy一定要选择Snapshot，并且允许重复部署：
- 好了，设置完成，接下来进入开发环节，先把二方库部署到刚刚新建的仓库中，再在另一个应用中使用这个二方库；
将二方库部署到Nexus3
- 接下来的操作在您的二方库工程上进行，我这里用的是一个典型父子结构的gradle工程，该工程详情请参考《Gradle构建多模块SpringBoot应用》，下图红框中的democlient就是二方库模块，这里面只有一个Student类，咱们要做的就是将democlient模块构建成jar并部署到Nexus3的仓库中：
- democlient模块的build.gradle如下，与上传操作有关的是maven插件，以及uploadArchives任务的参数，其中仓库的url参数的来源稍后会讲到：
plugins {
id 'java-library'
// 使用maven插件执行上传jar到Nexus3的操作
id 'maven'
}
// 如果要上传库到私服，就在此添加
def uploadGroup = group
def uploadArtifactId = this.name
def uploadVersion = version
// uploadArchives任务的配置
uploadArchives {
// 仓库配置
repositories {
mavenDeployer {
// release仓库的配置
repository(url: 'http://192.168.50.43:8081/repository/my-release/') {
authentication(
// Nexus3上有权限上传jar的帐号及其密码
userName: 'bolingcavalry',
password: '123456'
)
}
// snapshot仓库的配置
snapshotRepository(url: 'http://192.168.50.43:8081/repository/my-snapshot/') {
authentication(
// Nexus3上有权限上传jar的帐号及其密码
userName: 'bolingcavalry',
password: '123456'
)
}
// 二方库的身份参数：group、artifact、version
pom.groupId = uploadGroup
pom.artifactId = uploadArtifactId
pom.version = uploadVersion
}
}
}
// 子模块自己的依赖
dependencies {
// 使用api，将依赖传递给使用democlient的模块
api 'org.projectlombok:lombok'
// annotationProcessor不会传递，使用了lombok生成代码的模块，需要自己声明annotationProcessor
annotationProcessor 'org.projectlombok:lombok'
}
- uploadArchives任务中的仓库url参数，请直接从仓库的详情页复制，如下图红框4就是my-release仓库的url：
- 确认您项目的version，我这里是1.0.0-SNAPSHOT，如下图红框，所以构建出的jar会上传的my-snapshot仓库：
- 设置完毕后双击下图红框中的按钮，即可开始编译和构建：
- 构建完成后控制台输出如下，可见会先做编译打包再上传：
- 去Nexus3看看，点击下图位置查看仓库内容：
- 如下图，jar已经上传成功，这里有多个是因为我这边执行了多次uploadArchives任务：
上传到my-release仓库
- 篇幅所限，就不展示上传到my-release仓库的过程了，因为和前面上传到my-snapshot的操作是一样的，唯一的不同就是项目version中不要有snapshot，如下图，这样就能上传到my-release仓库：
- 需要注意的是，之前创建my-release仓库时，其Deployment policy选项为Disable redeploy，即不允许同一个version重复提交，因此同一个version只能成功上传一次，如果再次上传会报错，如下图：
使用仓库的内容
使用仓库的方法很简单，首先确保使用者的电脑能够访问到仓库，再在项目中配置仓库地址和jar坐标就行了，如下图红框：
- 以上就是Gradle项目的jar发布到私有仓库和使用该jar的完整过程，如果您正在发布二方库，希望本文可以给您一些参考；
你不孤单，欣宸原创一路相伴
- Java系列
- Spring系列
- Docker系列
- kubernetes系列
- 数据库+中间件系列
- DevOps系列
欢迎关注公众号：程序员欣宸
微信搜索「程序员欣宸」，我是欣宸，期待与您一同畅游Java世界…