Maven基礎-預設中央倉庫[settings-xml-配置詳解-]

阿新 • • 發佈：2019-01-03

Maven基礎-預設中央倉庫

當我們建立一個簡單的Maven專案後(只需要在pom.xml配置好依賴)，執行mvn clean install就可以把專案構建好，不需要我們手工下載任何jar，這全靠中央倉庫的存在，它會自動從倉庫下載。這個倉庫的定義是在${M2_HOME}/lib/maven-2.0.10-uber.jar 裡面。你可以在裡面找到\org\apache\maven\project\pom-4.0.0.xml 這個檔案，在這個檔案裡面定義了預設中央倉庫的地址：

<repositories>        
  <repository>        
    <id 
> central</id>        
    <name> Maven Repository Switchboard</name>        
    <layout> default</layout>        
    <url> http://repo1.maven.org/maven2</url>        
    <snapshots>        
      <enabled> false</enabled>        
    </snapshots 
>        
  </repository>        
</repositories>

如果你想覆蓋中央倉庫的預設地址，那麼這裡我們就會使用的映象了，還在setting.xml裡面配置：

<settings>        
…        
  <mirrors>        
    <mirror>        
      <id> maven-net-cn</id>        
      <name> Maven China Mirror</name 
>        
      <url> http://maven.net.cn/content/groups/public/</url>        
      <mirrorOf> central</mirrorOf>        
    </mirror>        
  </mirrors>        
…        
</settings>

,表示只為central倉庫做映象，如果想為所有的倉庫做映象那麼可以改為：
*

Maven配置詳解

maven2 比起maven1 來說，需要配置的檔案少多了，主要集中在pom.xml和settings.xml中。
先來說說settings.xml，settings.xml對於maven來說相當於全域性性的配置，用於所有的專案。在maven2中存在兩個settings.xml，一個位於maven2的安裝目錄conf下面，作為全域性性配置。對於團隊設定，保持一致的定義是關鍵，所以maven2/conf下面的settings.xml就作為團隊共同的配置檔案。保證所有的團隊成員都擁有相同的配置。當然對於每個成員，都需要特殊的自定義設定，如使用者資訊，所以另外一個settings.xml就作為本地配置。預設的位置為：user.dir/.m2/settings.xml目錄中（{user.dir} 指windows 中的使用者目錄）。

settings.xml基本結構如下：

 <settings xmlns="http://maven.apache.org/POM/4.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
                               http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <localRepository/>
  <interactiveMode/>
  <usePluginRegistry/>
  <offline/>
  <pluginGroups/>
  <servers/>
  <mirrors/>
  <proxies/>
  <profiles/>
  <activeProfiles/>
</settings>

簡單介紹一下幾個主要的配置因素：

localRepository

表示本地庫的儲存位置，也就是maven2主要的jar儲存位置，預設在${user.dir}/.m2/repository，如果需要另外設定，就換成其他的路徑。

offline

如果不想每次編譯，都去查詢遠端中心庫，那就設定為true。當然前提是你已經下載了必須的依賴包。

Servers

在POM中的 distributionManagement元素定義了開發庫。然而，特定的username和pwd不能使用於pom.xml，所以通過此配置來儲存server資訊

<servers>
    <server>
      <id>server001</id>
      <username>my_login</username>
      <password>my_password</password>
      <privateKey>${usr.home}/.ssh/id_dsa</privateKey>
      <passphrase>some_passphrase</passphrase>
      <filePermissions>664</filePermissions>
      <directoryPermissions>775</directoryPermissions>
      <configuration></configuration>
    </server>
  </servers>

id:server 的id,用於匹配distributionManagement庫id，比較重要。
username, password:用於登陸此伺服器的使用者名稱和密碼
privateKey, passphrase：設定private key，以及passphrase
filePermissions, directoryPermissions：當庫檔案或者目錄建立後，需要使用許可權進行訪問。參照unix檔案許可，如664和775

Mirrors

表示映象庫，指定庫的映象，用於增加其他庫

<mirrors>
    <mirror>
      <id>planetmirror.com</id>
      <name>PlanetMirror Australia</name>
      <url>http://downloads.planetmirror.com/pub/maven2</url>
      <mirrorOf>central</mirrorOf>
    </mirror>
  </mirrors>

id,name:唯一的標誌，用於區別映象
url:映象的url
mirrorOf：此映象指向的服務id

Proxies

此設定，主要用於無法直接訪問中心的庫使用者配置。

  <proxies>
    <proxy>
      <id>myproxy</id>
      <active>true</active>
      <protocol>http</protocol>
      <host>proxy.somewhere.com</host>
      <port>8080</port>
      <username>proxyuser</username>
      <password>somepassword</password>
      <nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts>
    </proxy>
  </proxies>

id:代理的標誌
active：是否啟用代理
protocol, host, port:protocol://host:port 代理
username, password：使用者名稱和密碼
nonProxyHosts: 不需要代理的host

Profiles

類似於pom.xml中的profile元素，主要包括activation,repositories,pluginRepositories 和properties元素
剛開始接觸的時候，可能會比較迷惑，其實這是maven2中比較強大的功能。從字面上來說，就是個性配置。
單獨定義profile後，並不會生效，需要通過滿足條件來啟用。
repositories 和pluginRepositories
定義其他開發庫和外掛開發庫。對於團隊來說，肯定有自己的開發庫。可以通過此配置來定義。
如下的配置，定義了本地開發庫，用於release 釋出。

<repositories>
        <repository>
          <id>repo-local</id>
       <name>Internal 開發庫</name>
       <url>http://192.168.0.2:8082/repo-local</url>
          <releases>
            <enabled>true</enabled>
            <updatePolicy>never</updatePolicy>
            <checksumPolicy>warn</checksumPolicy>
          </releases>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
          <layout>default</layout>
        </repository>
      </repositories>
      <pluginRepositories>
    <pluginRepository>
    <id>repo-local</id>
    <name>Internal 開發庫</name>
    <url>http://192.168.0.2:8082/repo-local</url>
    <releases>
            <enabled>true</enabled>
            <updatePolicy>never</updatePolicy>
            <checksumPolicy>warn</checksumPolicy>
    </releases>
    <snapshots>
    <enabled>false</enabled>
    </snapshots>
    <layout>default</layout>
    </pluginRepository>
    </pluginRepositories>

releases, snapshots:每個產品的版本的Release或者snapshot(注：release和snapshot的區別，release一般是比較穩定的版本，而snapshot基本上不穩定，只是作為快照）

properties

maven 的properties作為placeholder值，如ant的properties。
包括以下的5種類型值：
1. env.X，返回當前的環境變數
2. project.x:返回pom中定義的元素值，如project.version
3. settings.x：返回settings.xml中定義的元素
4. java 系統屬性：所有經過java.lang.System.getProperties()返回的值
5. x：使用者自己設定的值

Activation

用於啟用此profile

<activation>
        <activeByDefault>false</activeByDefault>
        <jdk>1.5</jdk>
        <os>
          <name>Windows XP</name>
          <family>Windows</family>
          <arch>x86</arch>
          <version>5.1.2600</version>
        </os>
        <property>
          <name>mavenVersion</name>
          <value>2.0.3</value>
        </property>
        <file>
          <exists>${basedir}/file2.properties</exists>
          <missing>${basedir}/file1.properties</missing>
        </file>
      </activation>

jdk:如果匹配指定的jdk版本，將會啟用
os:作業系統
property：如果maven能檢測到相應的屬性
file: 用於判斷檔案是否存在或者不存在

除了使用activation來啟用profile，同樣可以通過activeProfiles來啟用

Active Profiles

表示啟用的profile,通過profile id來指定。

<activeProfiles>
    <activeProfile>env-test</activeProfile> 指定的profile id
  </activeProfiles>

Maven基礎-預設中央倉庫[settings-xml-配置詳解-]