天天看點

idea建立 Spring Boot 項目

配置開發環境

在使用 Spring Boot 進行開發之前,第一件事就是配置好開發環境。這裡我們以 Windows 作業系統為例,如果您使用的是其他作業系統,請對照其相關設定進行操作。

工欲善其事,必先利其器,IDE(內建開發環境)的選擇相當重要,目前市面上有很多優秀的 IDE 開發工具,例如 IntelliJ IDEA、Spring Tools、Visual Studio Code 和 Eclipse 等等,那麼我們該如何選擇呢?

這裡我們極力推薦大家使用 IntelliJ IDEA,因為相比于與其他 IDE,IntelliJ IDEA 對 Spring Boot 提供了更好的支援。

Spring Boot 版本及其環境配置要求如下表。

Spring Boot 2.x
JDK 8.0 及以上版本
Maven  3.x
IntelliJ IDEA 14.0 以上

建立 Spring Boot 項目

開發環境配置完成後,接下來,我們就可以通過 Intellij IDEA 建立一個 Spring Boot 項目了。

 Intellij IDEA 一般可以通過兩種方式建立 Spring Boot 項目:

  • 使用 Maven 建立
  • 使用 Spring Initializr 建立

使用 Maven 建立

1. 使用 IntelliJ IDEA 建立一個名稱為 helloworld 的 Maven 項目 

2. 在該 Maven 項目的 pom.xml 中添加以下配置,導入 Spring Boot 相關的依賴。

  1. <project>
  2. ...
  3. <parent>
  4. <groupId>org.springframework.boot</groupId>
  5. <artifactId>spring-boot-starter-parent</artifactId>
  6. <version>2.4.5</version>
  7. <relativePath/> <!-- lookup parent from repository -->
  8. </parent>
  9. <dependencies>
  10. <dependency>
  11. <groupId>org.springframework.boot</groupId>
  12. <artifactId>spring-boot-starter-web</artifactId>
  13. </dependency>
  14. <dependency>
  15. <groupId>org.springframework.boot</groupId>
  16. <artifactId>spring-boot-starter-test</artifactId>
  17. <scope>test</scope>
  18. </dependency>
  19. </dependencies>
  20. ...
  21. </project>

3. 在 net.biancheng.www 包下,建立一個名為 helloWorldApplication 主程式,用來啟動 Spring Boot 應用,代碼如下。

  1. package net.biancheng.www;
  2. import org.springframework.boot.SpringApplication;
  3. import org.springframework.boot.autoconfigure.SpringBootApplication;
  4. @SpringBootApplication
  5. public class helloWorldApplication {
  6. public static void main(String[] args) {
  7. SpringApplication.run(helloWorldApplication.class, args);
  8. }
  9. }

Spring Boot 項目目錄結構如下圖。

idea建立 Spring Boot 項目

圖1:Spring Boot 項目結構

使用 Spring Initializr 建立

IntelliJ IDEA 支援使用者使用 Spring 項目建立向導(Spring Initializr )快速地建立一個 Spring Boot 項目,步驟如下。

1. 在 IntelliJ IDEA 歡迎頁面左側選擇 Project ,然後在右側選擇 New Project,如下圖。

idea建立 Spring Boot 項目

圖2:IDEA 歡迎頁面建立項目

或者在 IntelliJ IDEA 工作區上方的菜單欄中選擇 File ,在下拉菜單中選則 New,然後選擇 Project,如下圖。

idea建立 Spring Boot 項目

圖3:IDEA 工作區 建立 Maven 項目

2. 在建立工程界面左側,選擇 Spring Initializr,選擇項目的 SDK 為 1.8,選擇 starter service URL 為 http://start.spring.io(預設),最後點選下方的 Next 按鈕進行下一步。

idea建立 Spring Boot 項目

圖4:Spring Intializr 建立向導

3. IDEA 會連接配接網絡,并根據 starter service URL 查詢 Spring Boot 的目前可用版本群組件清單,如下圖。

idea建立 Spring Boot 項目

圖5:IDEA 聯網查詢 Springboot 可以用版本及元件清單

4. 在 Spring Initializr Project Settings 中,輸入項目的 GroupId、ArtifactId 等内容,注意 Type 為 Maven,packaging 為 jar,Java version 切換為 8(預設為 11),最後點選下方的 Next 按鈕,進行下一步。

idea建立 Spring Boot 項目

圖6:Spring Boot Initializr Settings

5. 在 dependencise 界面中,選擇 Spring Boot 的版本及所依賴的 Spring Boot 元件(例如 Spring Boot 的版本為 2.4.5, Spring Boot 元件為 Web),然後點選下方的 Next 按鈕。

idea建立 Spring Boot 項目

圖7:Spring Boot 元件和版本選擇

6. 根據需要修改項目名稱及項目存儲位置等資訊,最後點選 Finish 按鈕,完成 Spring Boot 項目的建立,如下圖。

idea建立 Spring Boot 項目

圖8:Initializr 完成建立 Spring Boot 項目

7. 傳回 IDEA 工作區,可以看到 Spring Boot 項目 helloworld 已經建立完成。該項目不但具有完整的目錄結構,還有完整的 Maven 配置,并預設生成了一個名為 HelloworldApplication 的主啟動程式。

idea建立 Spring Boot 項目

圖9:Spring Boot 項目結構

此時,幾乎所有的準備工作都已經準備就緒,我們可以在沒有編寫任何代碼的情況下,直接将該 Spring Boot 項目運作起來。

啟動 Spring Boot

預設情況下,Spring  Boot 項目會建立一個名為 ***Application 的主程式啟動類 ,該類中使用了一個組合注解 @SpringBootApplication,用來開啟 Spring Boot 的自動配置,另外該啟動類中包含一個 main() 方法,用來啟動該項目。

直接運作啟動類 HelloworldApplication 中的 main() 方法,便可以啟動該項目,結果如下圖。

idea建立 Spring Boot 項目

圖10:Spring Boot 項目 helloWorld 運作日志

注意:Spring Boot 内部內建了 Tomcat,不需要人為手動配置 Tomcat,開發者隻需要關注具體的業務邏輯即可。

為了能比較的清楚的看到效果,我們在 net.biancheng.www 包下又建立一個 controller 包,并在該包内建立一個名為 HelloController 的 Controller,代碼如下。

  1. package net.biancheng.www.controller;
  2. import org.springframework.stereotype.Controller;
  3. import org.springframework.web.bind.annotation.RequestMapping;
  4. import org.springframework.web.bind.annotation.ResponseBody;
  5. @Controller
  6. public class HelloController {
  7. @ResponseBody
  8. @RequestMapping("/hello")
  9. public String hello() {
  10. return "Hello World!";
  11. }
  12. }

重新開機 Spring Boot 項目,然後在位址欄通路 “http://localhost:8080/hello”,結果如下圖。

idea建立 Spring Boot 項目

圖11:Spring Boot 項目 helloWorld 通路結果