使用 Maven 建構 J2EE 專案：從建立 Web 專案到解決目錄結構問題

使用 Maven 建構 J2EE 專案：從建立 Web 專案到解決目錄結構問題

Maven 是 Java 專案管理與建構的利器，尤其在 J2EE（現 Jakarta EE）專案開發中，能有效標準化專案結構、依賴管理與建構流程。本文將帶您從零開始，使用 Maven 建立一個標準的 Web 專案，並針對常見的「缺少原始碼目錄」問題提供解決方案。

第一步：使用 Maven 建立 Web 專案

在 IDE（如 IntelliJ IDEA、Eclipse）中選擇建立 Maven 專案，並勾選「webapp」原型，或直接執行以下指令：

mvn archetype:generate -DgroupId=com.example -DartifactId=my-webapp -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false

專案建立完成後，預設會產生標準的 Maven 目錄結構。但許多開發者發現，專案中缺少 src/main/java、src/main/resources、src/test/java、src/test/resources 等關鍵目錄。

這是否很簡單？其實只要補上這些目錄，專案即可正常運作。

第二步：解決缺少原始碼目錄的問題

針對缺少 src/main/java 等目錄的情況，有兩種常見解決方式：

方法一：手動新增資源目錄

在 IDE 中以滑鼠右鍵點選專案根目錄，選擇 New → Folder，依序建立以下四個標準目錄：

• src/main/java — 存放 Java 程式碼
• src/main/resources — 存放配置檔、屬性檔等資源（如 application.xml）
• src/test/java — 存放測試程式碼
• src/test/resources — 存放測試資源檔

建立完成後，記得在 IDE 中將 src/main/java 標記為 Sources Root，src/test/java 標記為 Test Sources Root，以便編譯器正確識別。

方法二：修改 .classpath 檔案

若使用 Eclipse，可直接編輯專案根目錄下的 .classpath 檔案，加入以下條目：

<classpathentry kind="src" path="src/main/java"/>
<classpathentry kind="src" path="src/main/resources"/>
<classpathentry kind="src" path="src/test/java"/>
<classpathentry kind="src" path="src/test/resources"/>

儲存後重新整理專案，目錄即會出現在專案瀏覽器中。

Maven Web 專案目錄慣例速查

遵循這些慣例，Maven 就能自動識別並正確編譯、打包、執行測試，讓專案維護更輕鬆。