Java_Maven：4. maven 私服

1 需求

2 分析

3 搭建私服环境

3.1 下载 nexus

3.2 安装 nexus

3.3 卸载 nexus

3.4 启动 nexus

3.5 仓库类型

4 将项目发布到私服

4.1 需求

4.2 配置

4.3 测试

5 从私服下载 jar 包

5.1 需求

5.2 管理仓库组

5.3 在 setting.xml 中配置仓库

5.4 测试从私服下载 jar 包

1 需求
- 正式开发，不同的项目组开发不同的工程。
- ssm_dao 工程开发完毕，发布到私服。
- ssm_service 从私服下载 dao
2 分析
- 公司在自己的局域网内搭建自己的远程仓库服务器，称为私服，私服服务器即是公司内部的 maven 远程仓库，每个员工的电脑上安装 maven 软件并且连接私服服务器，员工将自己开发的项目打成 jar 并发布到私服服务器，其它项目组从私服服务器下载所依赖的构件（jar）。
- 私服还充当一个代理服务器，当私服上没有 jar 包会从互联网中央仓库自动下载，如下图：
3 搭建私服环境
- 3.1 下载 nexus
  - Nexus 是 Maven 仓库管理器，通过 nexus 可以搭建 maven 仓库，同时 nexus 还提供强大的仓库管理功能，构件搜索功能等。
    - 下载 Nexus，下载地址：https://www.sonatype.com/products/repository-oss-download
    - 下载：nexus-3.47.1-01-win64.zip
- 3.2 安装 nexus
  - 解压 nexus-3.47.1-01-win64.zip，本教程将它解压在 F 盘，进入 bin 目录：
  - cmd 进入 bin 目录，执行 nexus.bat install
  - 安装成功在服务中查看有 nexus 服务：
- 3.3 卸载 nexus
  - cmd 进入 nexus 的 bin 目录，执行：nexus.bat uninstall
  - 查看 window 服务列表 nexus 已被删除。
- 3.4 启动 nexus
  - 方法 1：
    - cmd 进入 bin 目录，执行 nexus.bat start
  - 方法 2：
    - 直接启动 nexus 服务
    - 查看 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 运行程序目录
    - 访问：
    - http://localhost:8081/nexus/
    - 使用 Nexus 内置账户 admin/admin123 登陆：
    - 点击右上角的 Log in，输入账号和密码登陆：
    - 登陆成功：
- 3.5 仓库类型
  - nexus
  - 查看 nexus 的仓库：
  - nexus 的仓库有 4 种类型：
    - 1. hosted，宿主仓库，部署自己的 jar 到这个类型的仓库，包括 releases 和 snapshot 两部分，Releases 公司内部发布版本仓库、 Snapshots 公司内部测试版本仓库
    - 2. proxy，代理仓库，用于代理远程的公共仓库，如 maven 中央仓库，用户连接私服，私服自动去中央仓库下载 jar 包或者插件。
    - 3. group，仓库组，用来合并多个 hosted/proxy 仓库，通常我们配置自己的 maven 连接仓库组。
    - 4. virtual(虚拟)：兼容 Maven1 版本的 jar 或者插件
  - nexus 仓库默认在 sonatype-work 目录中：
  - central：代理仓库，代理中央仓库
  - apache-snapshots：代理仓库
    - 存储 snapshots 构件，代理地址 https://repository.apache.org/snapshots/
  - central-m1：virtual 类型仓库，兼容 Maven1 版本的 jar 或者插件
  - releases：本地仓库，存储 releases构件。
  - snapshots：本地仓库，存储 snapshots构件。
  - thirdparty：第三方仓库
  - public：仓库组
4 将项目发布到私服
- 4.1 需求
  - 企业中多个团队协作开发通常会将一些公用的组件、开发模块等发布到私服供其它团队或模块开发人员使用。
  - 本例子假设多团队分别开发 ssm_dao、ssm_service、ssm_web，某个团队开发完在ssm_dao 会将 ssm_dao 发布到私服供 ssm_service 团队使用，本例子会将 ssm_dao 工程打成jar 包发布到私服。
- 4.2 配置
  - 第一步：需要在客户端即部署 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 连接测试版本项目仓库
- 第二步：配置项目 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> 对应！
- 4.3 测试
  - 将项目 dao 工程打成 jar 包发布到私服：
  - 1、首先启动 nexus
  - 2、对 ssm_dao 工程执行 deploy 命令
  - 根据本项目pom.xml中version定义决定发布到哪个仓库，如果version定义为snapshot，执行 deploy后查看 nexus 的 snapshot仓库，如果 version定义为 release则项目将发布到 nexus的 release 仓库，本项目将发布到 snapshot 仓库：
  - 也可以通过 http 方式查看：

5 从私服下载 jar 包
- 5.1 需求
  - 没有配置 nexus 之前，如果本地仓库没有，去中央仓库下载
  - 通常在企业中会在局域网内部署一台私服服务器，有了私服本地项目首先去本地仓库找 jar，如果没有找到则连接私服从私服下载 jar 包，如果私服没有 jar 包私服同时作为代理服务器从中央仓库下载 jar 包
  - 这样做的好处是一方面由私服对公司项目的依赖 jar 包统一管理，一方面提高下载速度，项目连接私服下载 jar 包的速度要比项目连接中央仓库的速度快的多。
  - 本例子测试从私服下载 ssm_dao 工程 jar 包。
- 5.2 管理仓库组
  - nexus中包括很多仓库，hosted中存放的是企业自己发布的jar包及第三方公司的jar包，proxy 中存放的是中央仓库的 jar，为了方便从私服下载 jar 包可以将多个仓库组成一个仓库组，每个工程需要连接私服的仓库组下载 jar 包。
  - 打开 nexus 配置仓库组，如下图：
  - 上图中仓库组包括了本地仓库、代理仓库等。
- 5.3 在 setting.xml 中配置仓库
  - 在客户端的 setting.xml 中配置私服的仓库，由于 setting.xml 中没有 repositories 的配置标签需要使用 profile 定义仓库。
  - ```
  <profile> 
      
          <id>dev</id> 
          <repositories> 
       
              <repository> 
                  
                  <id>nexus</id> 
                  
                  
                  <url>http://localhost:8081/nexus/content/groups/public/</url> 
  
                  
                  <releases> 
                      <enabled>true</enabled> 
                  </releases> 
  
                  
                  <snapshots> 
                      <enabled>true</enabled> 
                  </snapshots> 
  
              </repository> 
  
          </repositories> 
  
      <pluginRepositories> 
          
          <pluginRepository> 
      
              
              <id>public</id> 
              <name>Public Repositories</name> 
              <url>http://localhost:8081/nexus/content/groups/public/</url> 
  
          </pluginRepository> 
  
      </pluginRepositories> 
  
  </profile> 
```
- 使用 profile 定义仓库需要激活才可生效。
- ```
<activeProfiles>
    <activeProfile>dev</activeProfile>
</activeProfiles>
```
  - 配置成功后通过 eclipse 查看有效 pom，有效 pom 是 maven 软件最终使用的 pom 内容，程序员不直接编辑有效 pom，打开有效 pom
  - 有效 pom 内容如下：
  - 下边的 pom 内容中有两个仓库地址，maven 会先从前边的仓库的找，如果找不到 jar 包再从下边的找，从而就实现了从私服下载 jar 包。
  - ```
  <repositories>
      <repository>
          <releases>
              <enabled>true</enabled>
          
          </releases>
  
          <snapshots>
              <enabled>true</enabled>
          </snapshots>
          
          <id>public</id>
          <name>Public Repositories</name>
          <url>http://localhost:8081/nexus/content/groups/public/</url>
      
      </repository>
  
      <repository>
          <snapshots>
              <enabled>false</enabled>
          </snapshots>
          
          <id>central</id>
          <name>Central Repository</name>
          <url>https://repo.maven.apache.org/maven2</url>
      
      </repository>
  
  </repositories>
  
  <pluginRepositories>
      <pluginRepository>
          <id>public</id>
          <name>Public Repositories</name>
          <url>http://localhost:8081/nexus/content/groups/public/</url>
      </pluginRepository>
   
      <pluginRepository>
          <releases>
              <updatePolicy>never</updatePolicy>
          </releases>
  
          <snapshots>
              <enabled>false</enabled>
          </snapshots>
          
          <id>central</id>
          <name>Central Repository</name>
          <url>https://repo.maven.apache.org/maven2</url>
  
      </pluginRepository>
  
  </pluginRepositories>
```
- 5.4 测试从私服下载 jar 包
  - 测试 1：局域网环境或本地网络即可
    - 在 ssm_service 工程中添加以上配置后，添加 ssm_dao 工程的依赖，删除本地仓库中 ssm_dao工程，同时在 eclipse 中关闭 ssm_dao 工程。
    - 观察控制台：
    - 项目先从本地仓库找 ssm_dao，找不到从私服找，由于之前执行 deploy 将 ssm_dao 部署到私服中，所以成功从私服下载 ssm_dao 并在本地仓库保存一份。
    - 如果此时删除私服中的 ssm_dao，执行 update project 之后是否正常？
    - 如果将本地仓库的 ssm_dao 和私服的 ssm_dao 全部删除是否正常？
  - 测试 2：需要互联网环境
    - 在项目的 pom.xml 添加一个依赖，此依赖在本地仓库和私服都不存在，maven 会先从本地仓库找，本地仓库没有再从私服找，私服没有再去中央仓库下载，jar 包下载成功在私服、本地仓库分别存储一份。