將外部 JAR 檔案新增至 IntelliJ 項目
1. 簡介
IntelliJ IDEA 是個廣泛使用的 Java 開發 IDE，有免費版和付費版。在 Java 專案中，JAR 檔案包含可重複使用的程式碼和資源，使得使用外部程式庫變得更加容易。
我們需要將 JAR 檔案新增至 IntelliJ IDEA 中的類別路徑中，以便使用 Apache POI 或 JDBC 驅動程式等工具。這使得我們的專案能夠在編碼和執行期間識別它們。
在本教學中，我們將探討在 IntelliJ IDEA 專案中新增外部 JAR 檔案的步驟。
2.為什麼要在 IntelliJ IDEA 中新增外部 JAR 檔案？
在我們的 IntelliJ IDEA 專案中新增外部 JAR 檔案使我們能夠使用第三方程式庫。這些函式庫提供了 Java 預設不包含的額外功能。例如，Apache Commons Collections 提供進階資料結構，Jackson 有助於 JSON 處理，MySQL Connector 支援資料庫連線。
透過新增 JAR 文件，我們可以在專案中使用這些功能，而無需手動編寫程式碼。這對於整合外部 API、框架和工具非常重要。 IntelliJ IDEA 確保我們的專案識別這些文件，以便我們的程式碼能夠無錯誤運作。
3.在 IntelliJ IDEA 專案中新增外部 JAR 文件
要將外部 JAR 檔案新增至 IntelliJ 項目，首先我們需要下載它。為此，我們可以訪問可靠來源，如Maven Repository或該庫的官方網站。然後，我們可以搜尋所需的庫並下載我們專案的 JAR 檔案。
下載 JAR 檔案後，我們建立一個名為baeldung的新 IntelliJ IDEA 專案：
我們導航到文件部分，然後點擊項目結構將其打開：
在左側面板中，我們轉到“模組” ，選擇我們的模組，單擊“依賴項”選項卡，然後按+按鈕選擇外部 JAR 檔案：
我們從可用選項中選擇JAR 或目錄，找到下載的 JAR 文件，然後選擇它將其添加到我們的專案中：
最後，我們點擊「確定」按鈕將commons-collections4-4.5.0-M3.jar檔案新增至我們的 IntelliJ IDEA 專案：
為了驗證外部 JAR 檔案包含情況，我們可以展開專案視圖中的外部庫部分。如果 JAR 檔案出現在那裡，則表示已成功新增：
一旦 JAR 檔案成功添加到我們的 IntelliJ IDEA 項目，我們就可以在程式碼中使用它提供的任何類別和方法。
3.1.使用外部 JAR 檔案建立簡單的 Java 程序
讓我們建立一個簡單的 Java 程序，該程式使用外部 JAR 檔案commons-collections4來示範MultiValuedMap在單一鍵下儲存多個值的功能。
首先，我們從 Apache Commons Collections 匯入MultiValuedMap和ArrayListValuedHashMap來處理每個鍵的多個值：
import org.apache.commons.collections4.MultiValuedMap;
import org.apache.commons.collections4.multimap.ArrayListValuedHashMap;
另外，讓我們定義一個測試來檢查 Apache Commons Collections 中的MultiValuedMap如何處理單一鍵的多個值：
@Test
void givenMultiValuedMap_whenAddingEntries_thenCanRetrieveThem() {
MultiValuedMap<Integer, String> authorMap = new ArrayListValuedHashMap<>();
// Adding multiple names for a single author ID
authorMap.put(101, "Anees Asghar");
authorMap.put(101, "AA");
authorMap.put(102, "John Smith");
authorMap.put(102, "JS");
// Verify values for author ID 101
Collection<String> names101 = authorMap.get(101);
assertEquals(2, names101.size());
assertTrue(names101.contains("Anees Asghar"));
assertTrue(names101.contains("AA"));
// Verify values for author ID 102
Collection<String> names102 = authorMap.get(102);
assertEquals(2, names102.size());
assertTrue(names102.contains("John Smith"));
assertTrue(names102.contains("JS"));
// Verify that an unknown author ID returns an empty collection
assertTrue(authorMap.get(103).isEmpty());
}
首先，我們初始化一個ArrayListValuedHashMap並為兩個作者 ID（ 101和102 ）新增多個名稱。
然後，我們驗證每個 ID 是否正確地對應到預期的名稱數量並包含特定的值。最後，我們檢查查詢不存在的 ID（ 103 ）是否會傳回一個空集合，以確保地圖的行為符合預期。
如果未正確新增 JAR，IntelliJ 會拋出類似「 Cannot resolve symbol commons 」的錯誤：
但是，如果 IntelliJ IDEA 識別commons-collections4 JAR，則程式可以成功編譯並執行。
4. 結論
在本文中，我們探討了在 IntelliJ IDEA 專案中新增外部 JAR 檔案的步驟。
我們可以透過Project Structure > Modules > Dependencies部分將 JAR 檔案新增至專案的類別路徑。然後，我們可以展開專案視圖中的External Libraries部分來驗證 IntelliJ 專案中的 JAR 檔案包含情況。
在 IntelliJ IDEA 專案中新增外部 JAR 檔案讓我們能夠使用 Java 預設不包含的第三方程式庫的額外功能。此外，它還幫助我們添加資料庫連接器、日誌系統或實用功能等工具，從而使我們的專案更加強大。