Maven還停留在導jar包？快來探索Nexus私服的新世界

2021 年 10 月 29 日
筆記
分散式

寫在前面

Maven,學習框架之前我們都會接觸到的一個工具,感覺他的定位,似乎就跟git一樣,只是方便我們開發?於是自然而然的,很多小猿對於Maven都只是停留在會用的階段,利用他來構建,打包,引入jar包。
而實際上呢，Maven還有很多強大的地方，多模組開發，私服等等也是需要我們掌握的，在實際的開發中，往往是多模組共同開發，特別是我們之前提及的Dubbo分散式開發中，多模組開發是重中之重!

傳統項目開發

導jar包

既然是導jar包，我們是在本地windows開發，而實際項目是要放到linux伺服器上，如果我們單純把項目打成jar包丟上去，依賴文件也是jar包，但兩個系統因為環境不一樣，直接丟jar包(他不會重新編譯運行的)，得出來的結果可能就不一樣

比如String的getByte方法，在兩個系統上得到的結果是不一樣的，如果沒有重新編譯運行，那最終也會有偏差

Maven概念

POM

Project Object Model

把每個項目看成一個對象來進行管理

Maven作用

項目構建和管理

提供一套自動化構建項目的方法.並且通用，兼容性好，跨平台

包括打包，編譯，測試，運行等一套操作下來，讓你在開發環境也可以方便進行測試等功能

構建是面向過程的，就是一些步驟，完成項目程式碼的編譯，測試，運行，打包，部署等等。
maven支援的構建包括有：
1.清理，把之前項目編譯的東西刪除掉，我新的編譯程式碼做準備。
2.編譯，把程式源程式碼編譯為執行程式碼， java-class文件

批量的，maven可以同時把成千上百的文件編譯為class。
javac 不一樣，javac一次編譯一個文件。

3.測試， maven可以執行測試程式程式碼，驗證你的功能是否正確。
4.報告，生成測試結果的文件，測試通過沒有。
5.打包，把你的項目中所有的class文件，配置文件等所有資源放到一個壓縮文件中。

這個壓縮文件就是項目的結果文件，通常java程式，壓縮文件是jar擴展名的。
對於web應用，壓縮文件擴展名是.war

6.安裝，把5中生成的文件jar，war安裝到本地倉庫供別的文件使用
7.部署，把程式安裝好可以執行。

這些在下邊的生命周期其實剛剛好體現出來

依賴管理

處理jar包衝突問題

統一開發結構–約定大於配置

即能進行配置的不要去編碼指定，能事先約定規則的不要去進行配置。這樣既減輕了勞動力，也能防止出錯。

實際上maven並沒有強行要求約束我們項目的文件結構，而是因為他做得好，自然而然就變成一種通用的結構了

坐標

倉庫

私服(下文中會有具體實例)

下載順序??

先在本地倉庫找，找不到就去私服找，如果私服沒有，則會到中央倉庫下載到私服並且發送到本地倉庫

無論如何都還是最終會下到本地，區別只是從哪發送到本地而已?

此處有點疑問，私服沒有會去中央倉庫下到私服嗎？我下邊配置了阿里雲和私服，似乎私服沒有的話是直接從阿里雲直達下載到本地倉庫，並不會通過私服？希望大佬可以指正一下！

圖源 //m.yisu.com/zixun/309916.html

鏡像倉庫配置

mirrorOf

對哪種倉庫進行鏡像

手工maven

Maven工程目錄結構

構建命令

Maven構建命令使用mvn開頭，後面加功能參數，可以一次執行多個命令，使用空格分隔

clean

把編譯的去掉，target文件目錄刪除掉

install

把你的當前項目安裝到本地倉庫，成為一個jar包供別的項目引用裡邊的類等

package

會先compile，然後再clean

依賴管理

依賴傳遞

依賴具有傳遞性，包括直接傳遞和間接傳遞。
直接傳遞：在當前項目中通過依賴配置建立的依賴關係（A使用B，A和B就是直接傳遞）
間接傳遞：如果A依賴B，而B依賴C，那麼A和C之間就是間接傳遞

衝突原則

路徑優先

在越淺層的優先順序越高

聲明優先

在同一層，先聲明的比較高

在同一個pom中配置了相同資源的不同版本

後配置的覆蓋前邊的

可選依賴

排除依賴

①手動排除依賴，，且2可以直接把3整個依賴進來，再排除掉特定的

②藉助idea插件排除依賴 — Maven Helper

打開pom文件，下方就可以選擇切換查看方式

右鍵選中你需要排除的 Exclude即可

③版本鎖定–(待補充實例，拿Dubbo的吧)

Dubbo的GitHub文檔中應用到了這點

<properties>
    <spring-boot.version>2.3.0.RELEASE</spring-boot.version>
    <dubbo.version>2.7.8</dubbo.version>
</properties>
    
<dependencyManagement>
    <dependencies>
        <!-- Spring Boot -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>${spring-boot.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>

        <!-- Apache Dubbo  -->
        <dependency>
            <groupId>org.apache.dubbo</groupId>
            <artifactId>dubbo-dependencies-bom</artifactId>
            <version>${dubbo.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
      
    </dependencies>
</dependencyManagement>

<dependencies>
    <!-- Dubbo Spring Boot Starter -->
    <dependency>
        <groupId>org.apache.dubbo</groupId>
        <artifactId>dubbo-spring-boot-starter</artifactId>
        <version>2.7.8</version>
    </dependency>    
</dependencies>

dependencyManagement

通過它元素來管理jar包的版本，讓子項目中直接引用依賴而不用列出版本號。Maven會沿著父子層次向上走，直到找到一個擁有元素的項目，然後它就會使用在這個dependencyManagement元素中指定的版本號。

管理通用性

我們不需要給每個子項目都去聲明版本了，只需要在最頂層父類中統一進行管理。

可擴展性

如果某個子項目需要另外一個版本號時，只需要在dependencies中聲明一個版本號即可。子類就會使用子類聲明的版本號，不繼承於父類版本號。

依賴範圍

傳遞性(了解)

生命周期與插件

繼承(SpringBoot就是一個很好的例子)

作用

通過繼承可以實現在子工程中沿用父工程中的配置（與Java類似）

製作方式

在子工程中聲明其父工程坐標與對應的位置

<!--定義該工程的父工程-->
<parent>
  <groupId>     </groupId>
  <artifactId>    </artifactId>
  <version>    </version>
  <!--填寫父工程的pom文件-->
  <relativePath>父工程pom文件地址</relativePath>
</parent>

如SpringBoot中

<parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.5.6</version>
        <relativePath/> <!-- lookup parent from repository -->
</parent>

在父工程中定義依賴管理

可以管理版本，解決子工程中依賴衝突問題(上文提及到的版本鎖定)

<!--聲明此處進行依賴管理-->
<dependencyManagement>
  <!--具體的依賴-->
  <dependencies>
    <dependency>
      <groupId>     </groupId>
      <artifactId>     </artifactId>
      <version>   </version>
    </dependency>
  </dependencies>
</dependencyManagement>

繼承依賴使用：在子工程中定義依賴關係，無需聲明依賴版本，版本參照父工程中依賴的版本

<dependencies>
  <dependency>
    <groupId> </groupId>
    <artifactId> </artifactId>
  </dependency>
</dependencies>

聚合

我們實際開發中，很多時候是多模組開發，會把業務單獨抽離出來成為一個模組，比如Dao模組，Service模組
- 那這個時候比如說Dao模組發生了變化，其他所有依賴Dao模組的模組怎麼辦呢，都得去更新嗎?他自己知道嗎?還是得我們自己去重新install重新依賴，有沒有辦法讓他們同時更新而不是單獨更新呢?–這就要用到我們的聚合

建立一個空模組

打包類型設置為pom

<packaging>pom</packaging>

聚合module

效果

私服倉庫分類

宿主倉庫hosted：指的是我們公司或團隊內部的包，並且 hosted 類型的倉庫會分為 releases 和 snapshots 兩個，前者是正式版，後者一般是開發測試版(快照版)；

保存那些無法從中央倉庫直接獲取的資源，比如說我們自己研發的一些項目，或者一些第三方非開源項目比如oracle(要注意版權問題)

代理倉庫proxy：用來代理中央倉庫，例如我們依賴的包在本地倉庫沒有，就會到私服獲取，私服沒有的話，會到中央倉庫先把包下載到私服，然後再下載到本地倉庫；
倉庫組group：把多個倉庫組合起來，然後我們項目中只需要配置上這個類型的倉庫地址，就可以把它裡面組合的幾個倉庫都關聯上.

**快速搭載Nexus私服

私服作用

有時候我們是多台機器開發，而我們要去引用別人機器上的模組jar包時，這個時候對方單純install也只是發布到對方電腦上的本地倉庫而已，我們還是訪問不到.這個時候就需要一個中間商私服，來存放一些需要共享的資源

nexus下載安裝

首先要下載 nexus 搭載我們的私服
下載完成後，修改etc中的啟動埠(默認是8081)

進入bin目錄
vim nexus
進入後直接 /run_as_user 查找到run_as_root 再按 i 進入編輯模式

把這一項改為false ，才可以用root用戶開啟nexus

修改完成後按ESC退出編輯模式進入命令模式輸入 :wq 保存退出即可
最後 ./nexus start 啟動
訪問你設置的埠號

帳號默認是admin

初次登錄會提示你去特定位置找密碼

在該目錄下尋找即可

之後可以修改默認密碼

訪問私服倉庫(手動上傳)–不推薦

上方可以切換視圖，左邊是瀏覽倉庫，右邊的管理設置倉庫，我們在管理這一層添加一個自己的倉庫

這裡我們創建一個宿主倉庫

修改快照版/發行版

找到maven-public ，把我們剛創建的包含進去即可

去瀏覽頁面找到我們的倉庫，手動上傳

idea環境上傳

需要配置兩個地方

一個是本地倉庫如何跟私服打交道 — 對應默認的總setting文件
一個是我們的工程要發布到私服具體哪個倉庫 — 對應當前項目pom文件裡邊的配置

上傳jar認證配置

上傳jar包需要認證，maven的認證是在.m2/settings.xml或自己的的maven里settings.xml中servers標籤下配置的.

這裡特別說明一下，servers配置的ID很關鍵，這個與你項目裡面的distrubtionManagement下配置的倉庫ID一致，否則會報審核未通過的錯誤。

<!--  配置訪問伺服器的許可權-->
    <server>
        <id>nexus-Melo</id>
        <username>admin</username>
        <password>admin</password>
    </server>
    <server>
          <id>Melo-Release</id>
          <username>admin</username>
          <password>admin</password>
    </server>
    <server>
          <id>Melo-Snapshots</id>
          <username>admin</username>
          <password>admin</password>
    </server>

這裡的id對應了setting.xml里配置的server.id資訊，name任取

<!--    私服發布管理-->
    <distributionManagement>
        <repository>
          	 <!--			id要跟setting中配置訪問時的id一致-->
            <id>Melo-Release</id>
             <!--			倉庫地址 去nexus網站找到倉庫複製url即可 -->  
            <url>//ip地址:埠/repository/Melo-Release/</url>
        </repository>
        <snapshotRepository>
            <id>Melo-Snapshots</id>
            <url>//ip地址:埠/repository/Melo-Snapshot/</url>
        </snapshotRepository>
    </distributionManagement>

上傳效果

idea環境從私服獲取(同時使用阿里雲鏡像+私服)

配置全局setting.xml，我們所有項目就都會去私服找了

建議使用自帶的maven-public倉庫組，然後把我們自己創建的倉庫包含進去

注意不要把proxy類的倉庫包含進我們的group!這樣我們配置的阿里雲鏡像就失效了

除非自己去手動改proxy代理的倉庫地址，但個人感覺不太推薦，具體見後文”另外的實現方式”

配置server–訪問伺服器的許可權

包含拉取和上傳的兩部分配置，兩部分都需要許可權

<!--  配置訪問伺服器的許可權-->
    <!--第一個id要和下面的mirror中的id一致，代表拉取時也需要進行身份校驗-->
    <server>
        <id>nexus-Melo</id>
        <username>你的私服帳號</username>
        <password>你的私服密碼</password>
    </server>
<!--    下邊是我們上傳時的訪問配置,id對應你上傳時<distributionManagement>中寫的id-->
    <server>
          <id>Melo-Release</id>
          <username>你的私服帳號</username>
          <password>你的私服密碼</password>
    </server>
    <server>
          <id>Melo-Snapshots</id>
          <username>你的私服帳號</username>
          <password>你的私服密碼</password>
    </server>

配置mirror

<!--    阿里雲私服,拿中央倉庫-->
    <mirror>
      <id>alimaven</id>
      <name>aliyun maven</name>
      <url>//maven.aliyun.com/nexus/content/groups/public/</url>
<!--      訪問中央倉庫才使用阿里雲鏡像-->
      <mirrorOf>central</mirrorOf>
    </mirror>
<!--    自己的maven私服-->
    <mirror>
      <id>nexus-Melo</id>
      <!--鏡像名稱 -->
      <name>nexus-Melo</name>
      
      <!--鏡像除了中央倉庫以外的倉庫(本地有的話還是優先本地,沒有再去私服找,私服沒有的話會先通過阿里雲下載到私服,再發送到本地)-->
      <mirrorOf>!central</mirrorOf>
      <!--該鏡像的URL。構建系統會優先考慮使用該URL，而非使用默認的伺服器URL。
 					選擇你用哪個私服倉庫來作為鏡像,建議選擇自帶的maven-public,具體看上邊	-->
      <url>//ip地址:埠/repository/maven-public/</url>
    </mirror>

擴展–mirrorOf

*表示所有 !表示非

，!repo1 : 在除了repo1的倉庫中尋找
external: : 剛好跟上邊的 !internal.repo，* 相反

擴展–mirror**

默認情況下配置多個mirror的情況下，只有第一個生效。
- 無法連接的時候，才會去找後一個；而我們想要的效果是：當某個jar包在第一個mirror中不存在的時候，maven會去第二個mirror中查詢下載，但是maven不會這樣做！

正確的操作是在profiles節點下配置多個profile，而且配置之後要激活!!!!

配置profile

<!--      阿里雲-->
   <profile>
          <id>aliyun</id>
          <repositories>
              <repository>
                  <id>aliyun</id>
                  <url>//maven.aliyun.com/nexus/content/groups/public/</url>
                  <releases>
                      <enabled>true</enabled>
                  </releases>
                  <snapshots>
                      <enabled>true</enabled>
                      <updatePolicy>always</updatePolicy>
                  </snapshots>
              </repository>
          </repositories>
   </profile>

<!--      自己的私服-->
  <profile>
<!--      注意這個id,下邊激活的時候會用到,要一一對應-->
      <id>nexus-pr</id>
      <!-- 遠程倉庫列表 -->
      <repositories>
        <repository>
                 <!--          上邊要拉取的倉庫id-->
          <id>nexus-Melo</id>
          <name>nexus-Melo</name>
          <!-- 虛擬的URL形式,指向鏡像的URL-->
          <url>//ip地址:埠/repository/maven-public/</url>
          <layout>default</layout>
          <!-- 表示可以從這個倉庫下載releases版本的構件-->
          <releases>
            <enabled>true</enabled>
          </releases>
          <!-- 表示可以從這個倉庫下載snapshot版本的構件 -->
          <snapshots>
            <enabled>true</enabled>
          </snapshots>
        </repository>
      </repositories>
     <!-- 暫時還沒有自定義插件的需求 -->
            <!-- 插件倉庫列表 -->
<!--      <pluginRepositories>-->
<!--        <pluginRepository>-->
<!--          &lt;!&ndash;          上邊要拉取的倉庫id&ndash;&gt;-->
<!--          <id>nexus-Melo</id>-->
<!--          <name>nexus-Melo</name>-->
<!--          <url>//114.132.235.87:9001/repository/maven-public/</url>-->
<!--          <layout>default</layout>-->
<!--          <snapshots>-->
<!--            <enabled>true</enabled>-->
<!--          </snapshots>-->
<!--          <releases>-->
<!--            <enabled>true</enabled>-->
<!--          </releases>-->
<!--        </pluginRepository>-->
<!--      </pluginRepositories>-->
    </profile>

激活profile!!

				<!--對應上邊profile定義的id!!!-->
<!--      激活阿里雲-->
      <activeProfile>aliyun</activeProfile>
<!--      激活nexus-->
      <activeProfile>nexus-pr</activeProfile>
      <activeProfile>jdk-1.8</activeProfile>

實現阿里雲與私服共存的效果

那些中央倉庫有的文件，就會走阿里雲鏡像去下載，如果是我們自定義的jar包(中央倉庫沒有的)，就會走我們的私服去下載!

另外的實現方式

其實我們也可以直接在私服創建一個proxy倉庫，讓他代理阿里雲鏡像就好了，但是這樣其實也有個問題，就是proxy倉庫本身是不允許我們自定義上傳組件的，所以綜合考慮的話還是上邊自行配置的方法好一點

寫在最後

maven這一塊，具體的聚合，繼承實例，等到真正運用上了分散式開發的時候，應該會有所滲透。而私服的運用，在多台機器上是十分重要的！

Tags: 分散式

Maven還停留在導jar包？快來探索Nexus私服的新世界

寫在前面

傳統項目開發

導jar包

Maven概念

POM

Maven作用

項目構建和管理

依賴管理

統一開發結構–約定大於配置

坐標

倉庫

私服(下文中會有具體實例)

下載順序??

鏡像倉庫配置

mirrorOf

手工maven

構建命令

clean

install

package

依賴管理

依賴傳遞

衝突原則

路徑優先

聲明優先

在同一個pom中配置了相同資源的不同版本

可選依賴

排除依賴

①手動排除依賴，，且2可以直接把3整個依賴進來，再排除掉特定的

②藉助idea插件排除依賴 — Maven Helper

打開pom文件，下方就可以選擇切換查看方式

右鍵選中你需要排除的 Exclude即可

③版本鎖定–(待補充實例，拿Dubbo的吧)

Dubbo的GitHub文檔中應用到了這點

管理通用性

可擴展性

依賴範圍

傳遞性(了解)

生命周期與插件

繼承(SpringBoot就是一個很好的例子)

作用

製作方式

在子工程中聲明其父工程坐標與對應的位置

如SpringBoot中

在父工程中定義依賴管理

聚合

建立一個空模組

打包類型設置為pom

聚合module

效果

私服倉庫分類

**快速搭載Nexus私服

私服作用

nexus下載安裝

訪問私服倉庫(手動上傳)–不推薦

這裡我們創建一個宿主倉庫

修改快照版/發行版

找到maven-public ， 把我們剛創建的包含進去即可

去瀏覽頁面找到我們的倉庫，手動上傳

idea環境上傳

上傳jar認證配置

上傳效果

idea環境從私服獲取(同時使用阿里雲鏡像+私服)

注意不要把proxy類的倉庫包含進我們的group!這樣我們配置的阿里雲鏡像就失效了

配置server–訪問伺服器的許可權

配置mirror

擴展–mirrorOf

擴展–mirror**

配置profile

激活profile!!

實現阿里雲與私服共存的效果

另外的實現方式

寫在最後

分享此文：

Related Posts

《HelloGitHub》第 73 期

阿里P7面試官：請你簡單說一下類載入機制的實現原理？

WPF PropertyChanged實現子屬性通知

一文讀懂Android進程及TCP動態心跳保活

找到maven-public ，把我們剛創建的包含進去即可