1. 程式人生 > >Maven魔法堂:安裝Oracle JDBC Driver依賴的那些坑

Maven魔法堂:安裝Oracle JDBC Driver依賴的那些坑

## 前言 由於Oracle並沒有向公開Maven倉庫提供任何Oracle JDBC Driver的Jar包,因此我們無法像MySQL、SQLite等那麼輕鬆直接通過Maven載入依賴。 而手動下載Oracle JDBC Driver Jar包,然後安裝到本地倉庫(.m2目錄),再通過Maven載入依賴則是常用手段。但此外我們還能通過`system`的方式引入,但其中的坑下面將細細道來。 ## 手動安裝到本地倉庫 1. 將ojdbc7-12.1.0.2.jar放置到專案根目錄的lib目錄下,隨專案進行版本管理; 2. 在POM.xml檔案中加入依賴定義; ``` com.oracle ojdbc7 12.1.0.2 ``` 3. 安裝JAR包到本地倉庫。 ``` # 在專案根目錄下執行 mvn install:install-file -Dfile=./lib/ojdbc7-12.1.0.2.jar -DgroupId=com.oracle -DartifactId=ojdbc7 -Dversion=12.1.0.2 -Dpackaging=jar ``` ## scope為system在SpringBoot中的坑 除上述方式外,我們可以在POM.xml將依賴定義為 ``` com.oracle
ojdbc7 12.1.0.2 system ${project.basedir}/lib/ojdbc7-12.1.0.2.jar
``` 那麼即使本地倉庫(.m2目錄)下沒有Oracle JDBC Driver依賴,執行`mvn compile`和`mvn spring-boot:run`依然成功執行。 但**請注意**,執行`mvn package`打包出來的SpringBoot UberJar包中沒有包含Oracle JDBC Driver依賴,那麼直接部署到伺服器上則報如下錯誤: > ############ > application failed to start >
> Description: > .................................. > Reason: Failed to load driver class oracle.jdbc.driver.OracleDriver in either of HikariConfig class loader or Thread context classloader. > > Action: > Update your application's configuration > ############ 解決方法: 1. 對於外接Web容器的SpringBoot應用,則將Oracle JDBC Driver Jar包放置在容器的lib目錄下; 2. 對於內建Web容器的SpringBoot應用,則修改spring-boot-maven-plugin外掛配置即可,具體請見下文。 ## 說說Maven依賴定義中的scope屬性 作用:用於限制依賴在Maven專案各生命週期的作用範圍。 - `compile`,預設值,依賴將參與編譯階段,並會被打包到最終釋出包(如Jar、War、UberJar)內的Lib目錄下。具有傳遞性,即該依賴項對於依賴當前專案的其它專案同樣生效; - `provided`,依賴將參與編譯階段但不會被打包到最終的釋出包,執行階段由容器或JDK提供。不具備傳遞性。(如Servlet API,JSP API,Lombok等); - `runtime`,依賴不參與編譯階段(即不加入到classpath),但會打包到最終釋出包,從而參與執行和測試階段。通常用於根據配置檔案動態載入或介面反射載入的依賴(如JDBC驅動); - `test`,依賴參加編譯階段,但不打包到最終釋出包,依賴僅參與測試階段; - `system`,表示該依賴項的路徑為基於檔案系統的Jar包路徑,並且必須通過`systemPath`指定本地檔案路徑。依賴參與編譯階段,預設不會被打包到最終釋出包。 - 對於Spring Boot專案,若要將scope為system的Jar包打包到釋出包,則需要配置spring-boot-maven-plugin ``` org.springframework.boot
spring-boot-maven-plugin true
``` - `import`,Maven2.0.9新增的scope值。僅能在``中使用,用於引用其它專案的依賴項。 - 示例 ``` io.fsjohnhuang deps pom import ``` - 關於type pom 若專案擁有大量依賴項,那麼會導致當前專案的POM.xml檔案臃腫,即使採用父POM依然無法很好地解決該問題。而通過type為pom的專案則可以將依賴項分打包為獨立專案,然後其它業務系統專案則可以通過引入這些專案匯入相關依賴項,從而精簡POM檔案。 - 關於type屬性 預設的type屬性值為jar,即Maven將專案編譯打包為Jar包,當設定為pom時則表示該專案為一堆相關依賴項的打包定義而已,當設定為apk或ejb等時則表示Maven在編譯打包時採用andriod或ejb相關的外掛執行任務。 ## 總結 好記性不如爛筆頭,Maven功能強大的背後自然也蘊藏著大量的知識點,記下來以便日後查閱! 轉載請註明來自:https://www.cnblogs.com/fsjohnhuang/p/13937146.html —— \^\_\^肥