配置開發環境
在使用 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 相關的依賴。
- <project>
- ...
- <parent>
- <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter-parent</artifactId>
- <version>2.4.5</version>
- <relativePath/> <!-- lookup parent from repository -->
- </parent>
- <dependencies>
- <dependency>
- <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter-web</artifactId>
- </dependency>
- <dependency>
- <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter-test</artifactId>
- <scope>test</scope>
- </dependency>
- </dependencies>
- ...
- </project>
3. 在 net.biancheng.www 包下,建立一個名為 helloWorldApplication 主程式,用來啟動 Spring Boot 應用,代碼如下。
- package net.biancheng.www;
- import org.springframework.boot.SpringApplication;
- import org.springframework.boot.autoconfigure.SpringBootApplication;
- @SpringBootApplication
- public class helloWorldApplication {
- public static void main(String[] args) {
- SpringApplication.run(helloWorldApplication.class, args);
- }
- }
Spring Boot 項目目錄結構如下圖。
圖1:Spring Boot 項目結構
使用 Spring Initializr 建立
IntelliJ IDEA 支援使用者使用 Spring 項目建立向導(Spring Initializr )快速地建立一個 Spring Boot 項目,步驟如下。
1. 在 IntelliJ IDEA 歡迎頁面左側選擇 Project ,然後在右側選擇 New Project,如下圖。
圖2:IDEA 歡迎頁面建立項目
或者在 IntelliJ IDEA 工作區上方的菜單欄中選擇 File ,在下拉菜單中選則 New,然後選擇 Project,如下圖。
圖3:IDEA 工作區 建立 Maven 項目
2. 在建立工程界面左側,選擇 Spring Initializr,選擇項目的 SDK 為 1.8,選擇 starter service URL 為 http://start.spring.io(預設),最後點選下方的 Next 按鈕進行下一步。
圖4:Spring Intializr 建立向導
3. IDEA 會連接配接網絡,并根據 starter service URL 查詢 Spring Boot 的目前可用版本群組件清單,如下圖。
圖5:IDEA 聯網查詢 Springboot 可以用版本及元件清單
4. 在 Spring Initializr Project Settings 中,輸入項目的 GroupId、ArtifactId 等内容,注意 Type 為 Maven,packaging 為 jar,Java version 切換為 8(預設為 11),最後點選下方的 Next 按鈕,進行下一步。
圖6:Spring Boot Initializr Settings
5. 在 dependencise 界面中,選擇 Spring Boot 的版本及所依賴的 Spring Boot 元件(例如 Spring Boot 的版本為 2.4.5, Spring Boot 元件為 Web),然後點選下方的 Next 按鈕。
圖7:Spring Boot 元件和版本選擇
6. 根據需要修改項目名稱及項目存儲位置等資訊,最後點選 Finish 按鈕,完成 Spring Boot 項目的建立,如下圖。
圖8:Initializr 完成建立 Spring Boot 項目
7. 傳回 IDEA 工作區,可以看到 Spring Boot 項目 helloworld 已經建立完成。該項目不但具有完整的目錄結構,還有完整的 Maven 配置,并預設生成了一個名為 HelloworldApplication 的主啟動程式。
圖9:Spring Boot 項目結構
此時,幾乎所有的準備工作都已經準備就緒,我們可以在沒有編寫任何代碼的情況下,直接将該 Spring Boot 項目運作起來。
啟動 Spring Boot
預設情況下,Spring Boot 項目會建立一個名為 ***Application 的主程式啟動類 ,該類中使用了一個組合注解 @SpringBootApplication,用來開啟 Spring Boot 的自動配置,另外該啟動類中包含一個 main() 方法,用來啟動該項目。
直接運作啟動類 HelloworldApplication 中的 main() 方法,便可以啟動該項目,結果如下圖。
圖10:Spring Boot 項目 helloWorld 運作日志
注意:Spring Boot 内部內建了 Tomcat,不需要人為手動配置 Tomcat,開發者隻需要關注具體的業務邏輯即可。
為了能比較的清楚的看到效果,我們在 net.biancheng.www 包下又建立一個 controller 包,并在該包内建立一個名為 HelloController 的 Controller,代碼如下。
- package net.biancheng.www.controller;
- import org.springframework.stereotype.Controller;
- import org.springframework.web.bind.annotation.RequestMapping;
- import org.springframework.web.bind.annotation.ResponseBody;
- @Controller
- public class HelloController {
- @ResponseBody
- @RequestMapping("/hello")
- public String hello() {
- return "Hello World!";
- }
- }
重新開機 Spring Boot 項目,然後在位址欄通路 “http://localhost:8080/hello”,結果如下圖。
圖11:Spring Boot 項目 helloWorld 通路結果