Maven(三)

2020-06-19

1. maven 私服

1.1 需求

正式开发，不同的项目组开发不同的工程。

ssm_dao 工程开发完毕，发布到私服。

ssm_service 从私服下载 dao

1.2 分析

公司在自己的局域网内搭建自己的远程仓库服务器，称为私服，私服服务器即是公司内部的 maven 远程仓库，每个员工的电脑上安装 maven 软件并且连接私服服务器，员工将自己开发的项目打成 jar 并发布到私服服务器，其它项目组从私服服务器下载所依赖的构件（jar）。

私服还充当一个代理服务器，当私服上没有 jar 包会从互联网中央仓库自动下载，如下图：

1.3 搭建私服环境

1.3.1 下载 nexus

Nexus 是 Maven 仓库管理器，通过 nexus 可以搭建 maven 仓库，同时 nexus 还提供强大的仓库管理功能，构件搜索功能等。

下载 Nexus，下载地址：https://www.sonatype.com/download-oss-sonatype

1.3.2 安装 nexus

解压 nexus-2.12.0-01-bundle.zip，本教程将它解压在 F 盘，进入 bin 目录：

cmd进入 bin目录，执行 nexus.bat install

安装成功在服务中查看有 nexus 服务：

1.3.3 卸载 nexus

cmd 进入 nexus 的 bin 目录，执行：nexus.bat uninstall

查看 window 服务列表 nexus 已被删除。

1.3.4 启动 nexus

方法 1：cmd 进入 bin 目录，执行 nexus.bat start

方法 2：直接启动 nexus 服务

1.3.4.1 查看 nexus 的配置文件

conf/nexus.properties

# Jetty section
application-port=8081	# nexus 的访问端口配置 
application-host=0.0.0.0	# nexus 主机监听配置(不用修改) 
nexus-webapp=${bundleBasedir}/nexus		# nexus 工程目录 
nexus-webapp-context-path=/nexus	# nexus 的 web 访问路径
# Nexus section
nexus-work=${bundleBasedir}/../sonatype-work/nexus	# nexus 仓库目录
runtime=${bundleBasedir}/nexus/WEB-INF	# nexus 运行程序目录

1.3.4.2 访问

http://localhost:8081/nexus/

1.3.4.3 使用 Nexus 内置账户登陆

点击右上角的 Log in，输入账号和密码登陆 admin/admin123

登陆成功：

1.3.5 仓库类型

1.3.5.1 查看 nexus 的仓库

1.3.5.2 nexus 的仓库有 4 种类型

1、hosted，宿主仓库，部署自己的 jar 到这个类型的仓库，包括 releases 和 snapshot 两部分，Releases 公司内部发布版本仓库、 Snapshots 公司内部测试版本仓库

2、proxy，代理仓库，用于代理远程的公共仓库，如 maven 中央仓库，用户连接私服，私服自动去中央仓库下载 jar 包或者插件。

3、group，仓库组，用来合并多个 hosted/proxy 仓库，通常我们配置自己的 maven 连接仓库组。

4、virtual(虚拟)：兼容 Maven1 版本的 jar 或者插件

1.3.5.3 nexus 仓库目录

默认在 sonatype-work 目录中：

central：代理仓库，代理中央仓库
apache-snapshots：代理仓库，存储 snapshots 构件，代理地址 https://repository.apache.org/snapshots/
central-m1：virtual 类型仓库，兼容 Maven1 版本的 jar 或者插件
releases：本地仓库，存储 releases 构件。
snapshots：本地仓库，存储snapshots 构件。
thirdparty：第三方仓库
public：仓库组

1.4 将项目发布到私服

1.4.1 需求

企业中多个团队协作开发通常会将一些公用的组件、开发模块等发布到私服供其它团队或模块开发人员使用。

本例子假设多团队分别开发 ssm_dao、ssm_service、ssm_web，某个团队开发完在 ssm_dao 会将 ssm_dao 发布到私服供 ssm_service 团队使用，本例子会将 ssm_dao 工程打成 jar 包发布到私服。

1.4.2 配置

1.4.2.1 修改 settings.xml文件

需要在客户端即部署 ssm_dao 工程的电脑上配置 maven 环境，并修改 settings.xml文件，配置连接私服的用户和密码。此用户名和密码用于私服校验，因为私服需要知道上传的账号和密码是否和私服中的账号和密码一致。

<server>
    <id>releases</id>
    <username>admin</username>
    <password>admin123</password>
</server>

<server>
    <id>snapshots</id>
    <username>admin</username>
    <password>admin123</password>
</server>

<!--
    releases   连接发布版本项目仓库
    snapshots 连接测试版本项目仓库
-->

1.4.2.2 配置项目 pom.xml

配置私服仓库的地址，本公司的自己的 jar 包会上传到私服的宿主仓库，根据工程的版本号决定上传到哪个宿主仓库，如果版本为 release 则上传到私服的 release 仓库，如果版本为 snapshot 则上传到私服的 snapshot 仓库

<distributionManagement>
    <repository>
        <id>releases</id>
        <url>http://localhost:8081/nexus/content/repositories/releases/</url>
    </repository>
    <snapshotRepository>
        <id>snapshots</id>
        <url>http://localhost:8081/nexus/content/repositories/snapshots/</url>
    </snapshotRepository>
</distributionManagement>

注意：pom.xml 这里<id> 和 settings.xml 配置 <id> 对应！

1.4.3 测试

将项目 dao 工程打成 jar 包发布到私服：

1、首先启动 nexus

2、对 ssm_dao 工程执行 deploy 命令

根据本项目pom.xml中version定义决定发布到哪个仓库，如果 version定义为 snapshot，执行 deploy 后查看 nexus 的 snapshot 仓库，如果 version 定义为 release 则项目将发布到 nexus 的 release 仓库。

1.5 从私服下载 jar 包

1.5.1 需求

没有配置 nexus 之前，如果本地仓库没有，去中央仓库下载，通常在企业中会在局域网内部署一台私服服务器，有了私服本地项目首先去本地仓库找 jar，如果没有找到则连接私服从私服下载 jar 包，如果私服没有 jar 包私服同时作为代理服务器从中央仓库下载 jar 包，这样做的好处是一方面由私服对公司项目的依赖 jar 包统一管理，一方面提高下载速度，项目连接私服下载 jar 包的速度要比项目连接中央仓库的速度快的多。

本例子测试从私服下载 ssm_dao 工程 jar 包。

1.5.2 管理仓库组

nexus中包括很多仓库，hosted 中存放的是企业自己发布的jar包及第三方公司的 jar包， proxy 中存放的是中央仓库的 jar，为了方便从私服下载 jar 包可以将多个仓库组成一个仓库组，每个工程需要连接私服的仓库组下载 jar 包。

打开 nexus 配置仓库组，如下图：

上图中仓库组包括了本地仓库、代理仓库等。

1.5.3 在 settings.xml 中配置仓库

在客户端的 settings.xml 中配置私服的仓库，由于 settings.xml 中没有 repositories 的配置标签需要使用 profile 定义仓库。

<profile>
    <!--profile 的 id-->
    <id>dev</id>
    <repositories>
        <repository>
            <!--仓库 id，repositories 可以配置多个仓库，保证 id 不重复-->
            <id>nexus</id>
            <!--仓库地址，即 nexus 仓库组的地址-->
            <url>http://localhost:8081/nexus/content/groups/public/</url>
            <!--是否下载 releases 构件-->
            <releases>
            	<enabled>true</enabled>
            </releases>
            <!--是否下载 snapshots 构件-->
            <snapshots>
            	<enabled>true</enabled>
            </snapshots>
        </repository>
    </repositories>
    <pluginRepositories>
        <!-- 插件仓库，maven 的运行依赖插件，也需要从私服下载插件 -->
        <pluginRepository>
            <!-- 插件仓库的 id 不允许重复，如果重复后边配置会覆盖前边 -->
            <id>public</id>
            <name>Public Repositories</name>
            <url>http://localhost:8081/nexus/content/groups/public/</url>
        </pluginRepository>
    </pluginRepositories>
</profile>

使用 profile 定义仓库需要激活才可生效。

1
2
3

<activeProfiles>
    <activeProfile>dev</activeProfile>
</activeProfiles>

2. 把第三方 jar 包放入本地仓库或私服

2.1 导入本地库

随便找一个 jar 包测试，可以先 CMD 进入到 jar 包所在位置，运行

1	mvn install:install-file -DgroupId=com.alibaba -DartifactId=fastjson -Dversion=1.1.37 -Dfile=fastjson-1.1.37.jar -Dpackaging=jar

2.2 导入私服

需要在 maven 软件的核心配置文件 settings.xml 中配置第三方仓库的 server 信息

<server>
    <id>thirdparty</id>
    <username>admin</username>
    <password>admin123</password>
</server>

CMD执行命令

mvn deploy:deploy-file -DgroupId=com.alibaba -DartifactId=fastjson -Dversion=1.1.37 -Dpackaging=jar -Dfile=fastjson-1.1.37.jar -Durl=http://localhost:8081/nexus/content/repositories/thirdparty/ -DrepositoryId=thirdparty

2.3 参数说明

DgroupId 和 DartifactId 构成了该 jar 包在 pom.xml 的坐标，项目就是依靠这两个属性定位。自己起名字也行。
Dfile 表示需要上传的 jar 包的绝对路径。
Durl 私服上仓库的位置，打开 nexus——>repositories 菜单，可以看到该路径。
DrepositoryId 服务器的表示 id，在 nexus 的 configuration 可以看到。
Dversion 表示版本信息。

关于 jar 包准确的版本：包的名字上一般会带版本号，如果没有那可以解压该包，会发现一个叫 MANIFEST.MF 的文件，这个文件就有描述该包的版本信息。

-------------本文结束感谢您的阅读-------------

本文作者： Wgy
本文标题： Maven(三)
本文链接： https://wgy1993.gitee.io/archives/898b4292.html
版权声明： 本作品采用 CC BY-NC-SA 4.0 进行许可。转载请注明出处！