[Java] IDEA 2021.1 創建 Java Web （Servlet）項目

最近一段時間在學習 Java Web，沒有想到我第一步就沒有辦法進行下去了，笑~

這就先賣個關子，先說說如何使用 IDEA 創建 Java Web （Servlet）項目。

因為我現在使用的是 IDEA 2021.1 以后的版本，所以創建 Java Web 非常簡單。簡單到什么地步呢，可以看看下面的內容。

極速創建版

1. 打開你的 IDEA 進入歡迎頁面，選擇新建項目。

2. 選擇 Java Enterprise（Java EE）。

3. 填寫好右邊的參數，我這里使用了中文語言包，英文的也沒有多大區別，根據自己的喜好配置就好。

應用程序及服務器設置如果沒有的話，可以選擇右邊的新建 -> 選擇 Tomcat 服務器，在彈出來的界面選擇你的 Tomcat 安裝的路徑。

4. 到了依賴項選擇時，留意 Servlet 是否有勾選，如果有勾選，點擊完成。如果沒有勾選，請勾上依賴項再點擊完成。

5. 完成后，就可以看到 IDEA 正在創建項目。創建好項目后可以使用右上角的啟動項目按鈕，IDEA 會默認打開瀏覽器，顯示默認的 Servlet 頁面。

到這里，Java Web 就算是創建成功並正確運行了。但是，有一個問題，就是我正在看的教程和現在用編輯器創建出來的項目目錄大部分不一樣，這樣就讓我沒法跟着教程繼續學習Java Web，於是就有了后面的方法。

手動搭建 Java Web

1. 打開你的 IDEA 進入歡迎頁面，選擇新建項目。

2. 這里選擇空項目進行創建，主要是方便以后以多模塊的方式進行學習和開發。如果是單模塊，可以直接跳到 4 步。

點擊下一步，輸入項目的名稱和項目的存儲路徑，這里就按照自身實際情況修改。

3. 等待項目創建完成。因為項目是空項目，所以 IDEA 會在創建完成的時候自動彈出項目結構，讓你不會因為一個空項目而傻傻的發呆。

在這里選擇 模塊 -> 選擇 + 添加新模塊。

4. 在 新建模塊 選擇 Java 模塊。

修改 模塊的名稱和模塊的存儲路徑。

5. 模塊創建好后，可以在模塊列表中看到剛剛新建的模塊名稱，右鍵對應的模塊名稱，添加 Web 框架。

添加好框架后，會自動顯示框架的相關配置。例如這里可以通過部署描述符下的編輯按鈕，對 Web 模塊部署描述符（web.xml）進行修改

這里可以看到 下面有個警告提示： 'Web' 任何工件都不包含 Facet 資源。這是因為我們沒有在工件選項中創建對應的內容導致的，可以直接點擊創建工件以達到快速創建，不然需要繼續按照下面的步驟進行操作。

6. 選擇 項目設置下的 工件，同樣類似模塊添加一樣，選擇 Web 應用程序：展開型。這里會有兩個選項，一個是 基於模塊 自動創建，和上一步類似；另一個是 空 的工件，需要自己設置目錄以及對應內容的輸出位置。對應的目錄結構可以參考下圖：

7. 點擊右下角 應用 后，我們之前所做的工作會在項目中生成對應的目錄和文件，主要目錄就是 web 和 web 目錄下的 WEB-INF。

在 web 目錄下就可以開始我們的 Java Web 項目的開發了，這里直接創建了一個 Demo 文件 index.jsp，主要就是在頁面上顯示一句話。

8. 接下來就是搭建調試/運行環境了，這樣我們才能知道我們寫的代碼是什么效果。這個前置要求是電腦用已經安裝好了 Web 服務器，因為我自己使用的是 Apache Tomcat，所以這里就以 Tomcat 為例。

點擊右上角的 編輯配置，因為我已經配置好了，所以這里直接顯示 Tomcat 8.5.75，只要點擊彈出更多的選項就能看到編輯配置了。

9. 一樣的和前面創建項目、創建模塊類似，這里 點擊 + 后，在彈出來的菜單里面選擇 Tomcat 服務器 本地，如果是其他的，請根據實際情況選擇。

10. 選擇好后，可以在右邊進行服務器的配置，例如名稱、應用程序服務器、端口等等。如果 應用程序服務器 沒有下拉選項，點擊旁邊的配置，然后選擇安裝在本地的 Tomcat 的跟目錄路徑，IDEA 會自動識別出 Tomcat 的版本信息。如果沒有識別，可能是路徑錯誤或者速度慢，可以檢查路徑或者重試幾次。

11. 服務器配置好之后，還不行，還需要進行部署的配置。切換到部署標簽，點擊 + 添加工件，因為現在只有一個工件，所以 IDEA 會直接添加工件，接着只需要配置一下 應用程序上下文，也就是瀏覽器訪問時的虛擬目錄。設置好后記得點擊 應用 確認。
    
    

12. 運行服務器。點擊右上角的 綠色三角 按鈕，或者使用快捷鍵 Shift + F10 運行。

啟動的過程可以在下面的控制台輸出中看到，看起來是不是很有逼格？啊哈哈。

看到 部署完成，就可以使用瀏覽器打開我們的 Demo 了。訪問的路徑一般是 協議 + 本地主機名 + 端口號 + 虛擬目錄 + 文件名, 我這里的就是：http://localhost:8080/test_Web_exploded/index.jsp。其中端口號在第 10 步服務器配置中設置，虛擬目錄是在第 11 步工件的應用程序上下文中配置，文件名就是我們項目中的 web 目錄下的對應文件。

WEB-INF 目錄下的文件無法直接訪問。

支持 Servlet

到了這里，你以為你的 Java Web 項目就算是真正的搞定了么？答案是：否。

不信，你可以試着創建一個 Servlet，你會很神奇的發現你沒有辦法在繼承中找到 Servlet，就算是你將代碼復制過來，IDEA 也會顯示紅色提示， 無法使用。就像下面這樣：

不過，不要慌，解決辦法也很簡單。

第一種

1. 在 WEB-INF 目錄下新建 lib 文件夾。
2. 找到你的 Tomcat 安裝目錄。
3. 復制 Tomcal 安裝目錄下的 lib/servlet-api.jar 到剛才新建的 lib 目錄中。
4. 右鍵 lib，選擇添加到庫，在彈出來的創建庫中根據實際情況選擇添加到項目，或者添加到模塊庫。到這里就可以繼承到 Servlet 進行開發了。

5. 設置 Servlet 的訪問路徑，因為創建 web 的時候選擇的是 3.0 以上的版本，所以有兩種方式設置。
   1. 在 web.xml 中設置
      
   2. 使用注解的方式設置
      
6. 設置完成后，重啟 Tomcat 服務器，使用瀏覽器訪問。
   
   這里通過瀏覽器訪問后，在控制台中打印了一段文字，這段文字正是我們在代碼中輸出的內容，說明我們前面的步驟操作下來沒有問題。

第二種

還記得我們在前面不是配置了 Tomcat 的服務器么，IDEA 會將這些文件作為庫添加到外部庫中，而我們只需要在項目或者模塊中添加這個依賴就可以使用 Servlet 了。

1. 點擊 文件 -> 項目結構，進入到模塊設置項。
   

2. 選擇對應的模塊，切換到依賴標簽。
   

3. 點擊 + 圖標，選擇添加 庫。
   

4. 然后選擇 Tomcat 作為依賴項添加，記得點擊應用保存當前操作。
   

后續的步驟跟第一種方式的第 5 步開始一樣了，驗證沒有問題就證明配置沒有問題。