1. 程式人生 > >Maven基礎-默認中央倉庫[settings.xml 配置詳解 ]

Maven基礎-默認中央倉庫[settings.xml 配置詳解 ]

XML 搜索 sys sep xsd 默認 本地 phrase clas

首先:Maven中央倉庫的搜索全部公共jar包的地址是,http://search.maven.org/

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>    

<mirrorOf>,表示只為central倉庫做鏡像,如果想為所有的倉庫做鏡像那麽可以改為:
<mirrorOf>*</mirrorOf>

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後,並不會生效,需要通過滿足條件來激活。
repositoriespluginRepositories
定義其他開發庫和插件開發庫。對於團隊來說,肯定有自己的開發庫。可以通過此配置來定義。
如下的配置,定義了本地開發庫,用於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>


作者:低至一折起
鏈接:https://www.jianshu.com/p/5702f89e2c79
來源:簡書
簡書著作權歸作者所有,任何形式的轉載都請聯系作者獲得授權並註明出處。

Maven基礎-默認中央倉庫[settings.xml 配置詳解 ]