欢迎访问我的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世界...