跳到主要內容

Gradle(14)–– Dependency Management

目標
在本章我們會著重在如何管理專案相依、解決相互衝突、解析策略並教你如何發佈artifacts
在不同的元件版本下。

歷史相依管理在建構工具是一個很重要的指標,在傳統的ANT建構工具,他無法幫你處理相依
問題,你必須自己將每一個jar名稱和它的位置寫在build.xml。但是在企業應用,有些軟體
會相依其他函式庫,使用ANT的方式,需要花費很多成本去維護相依的問題。後來,Maven
解決這個缺點,ANT整合Ivy也是解決這個問題。在Gradle有自己的相依管理方式,同時它也
支援Ivy和Maven的套件。Gradle主要定義相依關係

  • 相依環境
當我們開發完成的軟體套件,必須要做版本部署並儲存中央版本庫(central repository),讓所有
團隊可以分享使用這些軟體套件。版本命名參考http://semver.org/

  • Gradle相依管理
gradle相依管理定義在dependencies裡面,需要遵循它的規則和定義方式即可。
宣告相依定義:
dependencies
{
    <configuration name> <dependencies>
}

區塊內定義方式:
1. 個別定義
    compile group: 'log4j', name: 'log4j', version: '1.2.16'
2.陣列定義:
   compile 'log4j:log4j:1.2.16','junit:junit:4.10'
3. Closure定義:
   compile ('log4j:log4j:1.2.16') ) {
            // extra configurations
   }

apply plugin: 'java'repositories {
       
mavenCentral()}
dependencies {
        compile group: 'log4j', name: 'log4j', version: '1.2.16'
}

  • 版本庫(Repositories)
建立版本庫是告訴dependencies要去哪裡下載套件,他會檢查群組、名稱和版本
,符合才下載到gradle版本庫中。

1. 內建版本庫
(1) Maven Central repository :  mavenCentral()
(2) Maven JCenter repository:  jcenter()
(3) Maven local Repository :    mavenLocal()
(4) Ivy repository:    
   ivy {
       url "
http://<ivyrepositorylocation>"
       layout "ivy" // valid values are maven, gradle, ivy
   }

(5) Organization repository: 你可以為你的公司定義私人的程式庫。
repositories {
   maven {
      url "
http://private.repository/path"
      credentials {
        username 'guest'
        password '123123'
     }
   }
   ivy { // For Ivy repositories
   url "
http://private.repository/path"
   }
}

(6) Local directory repository : 有時候開發軟體載入相依性,會用到本地系統檔案目錄,可以定義flatDir方法。
repositories {
   flatDir {
       dirs '/localfile/dir1', '/localfile/dir2'
   }
}

  • 相依深入解析
剛剛介紹相依探討,本節介紹如何解析如何
(1) 遞移相依 :
當套件相依另一個套件時,另一個套件有相依其它套件,一層層的相依關係,可以稱為遞移相依,例如
commons-httpclient –> commons-logging –> 其它套件->…。Gradle會處理這些複雜的相依關係,預設
將這些相依下載到最後一層。

(2)排除相依設定

(2.1) 完全排除(Exclude)
有些情況,你不希望gradle處理相依問題,我們可以使用將transitive為off,
範例一、 只下載commons-httpclient套件apply plugin:'java'
repositories {
          mavenCentral()
}

dependencies {
     compile group:'commons-httpclient', name:'commons-httpclient',
     version:'3.1',
transitive: false}

(2.2) 選擇排除(selective)
如果你不想要全部都不檢查相依,只是部分檢查可以使用exclude定義
dependencies{
    compile('commons-httpclient:commons-httpclient:3.1') {
    exclude group:'commons-codec' // exclude by group
     //exclude group:'commons-codec',module:'commons-codec'
    }
}


(3)動態訂義相依版本

(3.1)版本
Gradle抓取版本超過1.0以上的,如果是用'latest.integration只會捉最新的版本。
compile group:'commons-codec',name:'commons-codec', version: '1.+'
compile group:'commons-codec',name:'commons-codec', version:'latest.integration’

(3.2)副檔名
當我們用ext只會下載所定義的副檔名,範例只會下載 .war的檔案下來。
dependencies {
     runtime group: 'org.mywar', name: 'sampleWeb', version: '1.0',
    
ext: 'war'}

(3.3)特定檔案名稱
當我們利用classifier來定義特定下載檔案名稱,例如版本庫有兩個jar檔為assys-1.0-test.jar和assys-1.0-publish.jar
兩種。使用classifier只會下載publish的jar檔下來。
dependencies {
    runtime group: 'org.assys, name: ‘assys’, version: '1.0',  classifier: 'publish', ext:'war'
}

  • 報表
我們可以顯示本專案各任務的所有相依關係,例如: compile、testCompile等等

build.gradle
apply plugin: 'java'
version=1.0
repositories {
    mavenCentral()
}
dependencies {
     testCompile 'junit:junit:4+'
    compile group: 'log4j', name: 'log4j', version: '1.2.16'
    compile 'commons-httpclient:commons-httpclient:3.1'
    compile 'dom4j:dom4j:1.6.1'
}
C:\Users\bryan\workspace\ex1>gradle -b build.gradle dependencies
:dependencies
------------------------------------------------------------
Root project
------------------------------------------------------------
archives - Configuration for archive artifacts.
No dependencies
compile - Compile classpath for source set 'main'.
Download https://repo1.maven.org/maven2/commons-httpclient/commons-httpclient/3.
1/commons-httpclient-3.1.pom
Download https://repo1.maven.org/maven2/dom4j/dom4j/1.6.1/dom4j-1.6.1.pom
Download https://repo1.maven.org/maven2/commons-logging/commons-logging/1.0.4/co
mmons-logging-1.0.4.pom
Download https://repo1.maven.org/maven2/commons-codec/commons-codec/1.2/commons-
codec-1.2.pom
Download https://repo1.maven.org/maven2/xml-apis/xml-apis/1.0.b2/xml-apis-1.0.b2
.pom
+--- log4j:log4j:1.2.16
+--- commons-httpclient:commons-httpclient:3.1
|    +--- commons-logging:commons-logging:1.0.4
|    \--- commons-codec:commons-codec:1.2
\--- dom4j:dom4j:1.6.1
     \--- xml-apis:xml-apis:1.0.b2
default - Configuration for default artifacts.
+--- log4j:log4j:1.2.16
+--- commons-httpclient:commons-httpclient:3.1
|    +--- commons-logging:commons-logging:1.0.4
|    \--- commons-codec:commons-codec:1.2
\--- dom4j:dom4j:1.6.1
     \--- xml-apis:xml-apis:1.0.b2
runtime - Runtime classpath for source set 'main'.
+--- log4j:log4j:1.2.16
+--- commons-httpclient:commons-httpclient:3.1
|    +--- commons-logging:commons-logging:1.0.4
|    \--- commons-codec:commons-codec:1.2
\--- dom4j:dom4j:1.6.1
     \--- xml-apis:xml-apis:1.0.b2
testCompile - Compile classpath for source set 'test'.
+--- log4j:log4j:1.2.16
+--- commons-httpclient:commons-httpclient:3.1
|    +--- commons-logging:commons-logging:1.0.4
|    \--- commons-codec:commons-codec:1.2
+--- dom4j:dom4j:1.6.1
|    \--- xml-apis:xml-apis:1.0.b2
\--- junit:junit:4+ -> 4.12
     \--- org.hamcrest:hamcrest-core:1.3
testRuntime - Runtime classpath for source set 'test'.
+--- log4j:log4j:1.2.16
+--- commons-httpclient:commons-httpclient:3.1
|    +--- commons-logging:commons-logging:1.0.4
|    \--- commons-codec:commons-codec:1.2
+--- dom4j:dom4j:1.6.1
|    \--- xml-apis:xml-apis:1.0.b2
\--- junit:junit:4+ -> 4.12
     \--- org.hamcrest:hamcrest-core:1.3
BUILD SUCCESSFUL
Total time: 20.567 secs

留言

這個網誌中的熱門文章

JavaBean 和POJO

前言 今天介紹JavaBean和POJO的不同,這兩個名詞在JAVA文章常常被拿來使用以及討論。在JDK1.1時候釋出才有的一個標準架構,很多時候常常被搞混,所以我們特別開闢一章來加以討論。POJO規範在企業級應用已經廣大的被使用的規範。 解釋 POJO : 全名為Plain-old-Java-object,只需要繼承Object就可以,沒有特定規定,只要建立的類別有setter/getter方法都可以稱為POJO JavaBean: JavaBean通常用來封裝多個物件成為單獨物件使用,規範比較嚴格,規則如下 規則 說明 1 需要實作序列(Serializable/Externalizable) 2 不能有參數的建構子( no-arg constructor) 3 需要有公用setter/getter 4 屬性必須要私人(private) 5 屬於特定POJO規則 比較 所有的JavaBean都為POJO,但是所有的POJO不一定為JavaBean 都可以當作重複元件 都必須序列化 特性都為可用性、易用性和持久化使用 - 應用 由圖我們可以知道POJO在應用程式中,主要用來存取資料庫資料達到持久化的目的,並提供給商業邏輯流程處理使用。這種POJO的架構提供程式人員開發時的可以很有規則將資料封裝並加以使用。 範例1. JavaBean(以員工為實例) JavaBean建立員工物件,可以發現Employee物件建構子沒有任何參數,屬性為私有化並setter/getter的命名方式。 //實作序列化 public class Employee implements java.io.Serializable{ private int id; private String name; //無參數建構子 public Employee(){} //以下實作setter/getter public void setId(int id){this.id=id;} public int getId(){return id;} public void setName(String ...

GSON基礎教學

GSON 前言 JSON是很常見的資料交換格式,在JAVA領域常用處理JSON的函式庫:GSON、FastXML和JSON-B,本章節會以GSON為主,學習目標如下 JSON格式說明 GSON 套件函式 GSON: 物件轉換JSON字串 GSON: JSON字串轉換物件 JSON 格式說明 JSON全名為JavaScript Object Notation,它是一種輕量級的資料交換格式,會大為流行的理由,主要是他比傳統用xml更輕巧且容易處理, JSON表達方式物件會用大括弧{},陣列則是用中括號[]。 用JSON字串來表達Employee的物件內容,由JSON字串可以知道物件name、age、sex和salary屬性。 JSON表示員工資料方式: {“name”:”Jack Bryant”, “age”:18, “sex”:”M”,”salary”:3500.00} JSON陣列表示方式: 跟我們使用JAVA的陣列方式類似,內容值可以是數字’、文字、布林、陣列、物件、null等等。 範例: 字串: [“紅”、”橙”、”黃”、”綠”、”青”、”藍”、”紫”} 布林: [true, true, false, false, true, true] GSON 套件函式 Gson為google所發布的函式庫,主要將物件與json字串之間的轉換時方便使用。當我們將JAVA物件轉換成JSON字串稱為 序列化 ,JSON字串轉換至JAVA物件稱為 反序列化 。 GSON: 物件轉換JSON字串 有了JSON基本概念後,我們進入本章重點,首先我們需要建立員工類別(Employee),定義如下 物件 屬性 員工類別 Employee name 名字 age 年紀 sex 性別 salary 薪水 /** * name:員工類別 */ public class Employee implements Serializable { //constructor public Employee(String name, double salary){ this.name = name; this.sala...

H2資料庫(1)-基本安裝與介紹

H2資料庫介紹 H2為嵌入式資料庫,使用java開發,跨平台且內含資料庫管理介面,好處開發階段方便開發人員使用。 比較 詳細比較表: http://www.h2database.com/html/features.html#comparison 由圖比較可以知道,H2比其他資料庫更為優勢,以下會介紹開發時常用的模式: 嵌入式模式Embedded Mode 嵌入式資料庫會與應用程式共用同一JVM底層,在這個模式下persistent或是in-memory資料庫都支援,也沒有連線數的限制。但壞處是只可以給該應用程式使用,其他人無法直接存取資料庫。 伺服器模式 Server Mode 外部應用程式可以藉由JDBC或是OBC的方式連結該資料庫,它也支援persistent或是in-memory資料庫,也沒有連線數的限制。 混合模式 Mixed Mode 同時有嵌入式與伺服器的模式去讓外部應用程式連線或是自己應用程式連線。 安裝H2 database 官方網站: http://www.h2database.com/html/main.html 下載安裝程式 出現安裝連結,本次範例使用 Windows installer 的安裝連結 下載安裝程式後,點擊兩下,進入安裝畫面,按”下一步” 一直按”下一步”後,會出現”完成” 安裝完成後,會出現一個說明網頁,你可以點選Quickstart 它會告訴你,如何進入DBRMS畫面以及開啟資料庫服務 開啟windows的視窗圖示,執行 H2 Console後,會執行H2資料庫 進入DBRMS的登入畫面,使用者預設為”SA”,密碼為空值”“,按下”connect”進入,SQL命令中心 登入後,可以在空白處執行SQL語法 8.大致上安裝H2資料庫滿快速,操作畫面也是很好上手,如果系統在開發階段個人覺的滿推薦給大家使用看看。 參考 H2官方網站