zhou
在開始之前，我們需要確保我們的環境已經準備好。這意味著我們需要安裝了Maven、JDK以及一個文本編輯器或IDE（集成開發環境），如IntelliJ IDEA或Eclipse。如果這些軟件還沒有安裝，請按照相應的文檔進行安裝。
接下來，我們將逐步介紹如何使用Maven創建一個新的Spring Boot項目，並為其添加基本的設置以使其運行。
1. 使用Maven創建Spring Boot項目
首先，我們需要在本地計算機上擁有Maven的最新版本。你可以從官方網站下載最新的二進製文件，或者如果你的系統支持包管理器，比如apt-get（Linux）或Homebrew（MacOS），你可以通過它們來安裝Maven。
一旦Maven安裝完成，打開終端（Terminal/Command Prompt），輸入以下命令來初始化一個新項目：
mvn archetype:generate -DgroupId=com.example -DartifactId=springboot-demo -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false
這裡，`groupId`是你組織的ID，`artifactId`是你項目的名稱，`archetypeArtifactId`是一個預先定義好的範本，最後的參數 `interactiveMode=false` 表示不要進入交互模式，而是直接使用提供的值生成項目。
這個命令將會創建一個基本的Maven Web應用程序結構，並且包含了Spring Boot的基本依賴關係。
2. 在Spring Boot項目中創建Web接口
現在，我們有了基礎的Spring Boot項目結構，我們可以開始添加一些功能到我們的應用程式中。首先，我們會創建一個簡單的Web接口。
在你的IDE中打開剛才建立的專案，然後新增一個Java類別，例如叫作`HelloController.java`，並將下列代碼複製至其中：
package com.example;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.servlet.ModelAndView;
@Controller // 標記此類作為控制器
public class HelloController {
// GET映射，當瀏覽器訪問"/"時被調用
@GetMapping(value = "/")
public String home() {
return "index"; // 返回視圖的名稱
}
// GET映射，帶有一個query param (name)
@GetMapping(value = "/greeting")
public ModelAndView greeting(@RequestParam(required = false, defaultValue = "World") String name) {
System.out.println("Greeting called with name: " + name);
Model model = new Model(); // Spring MVC模型
model.addAttribute("message", "Hello, " + name + "!");
return new ModelAndView("greeting", model); // 返回模型與視圖
}
}
這個控制器類包含兩個方法：`home()` 和 `greeting()`。`home()` 方法返回了一個稱為「index」的視圖，而 `greeting()` 方法則接受一個 query parameter (`name`)，並根據它的值產生一個動態的消息。
3. 讀取配置資訊
Spring Boot提供了一套強大的特性來處理外部配置。這些配置可以來自於多種來源，例如環境變量、屬性文件或命令列引數。在Spring Boot中，你可以透過`application.properties`或是`application.yml`來指定這些配置。
在你的專案根目錄下，新增一個`src/main/resources`資料夾，裡面放一個`application.properties`檔案。將下面的內容複製到該檔案中：
server.port=8080
spring.datasource.url=jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1
spring.datasource.driver-class-name=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=
這個檔案中的每一對鍵值對都代表了一個Spring Boot的配置選項。在上面的例子中，我們設定了服務器的端口（`server.port`）、內存中的H2資料庫URL（`spring.datasource.url`）以及其他數據庫連線參數。
4. 執行Spring Boot項目
現在，我們已經完成了基本功能的實現，接下來要做的就是打包並執行這個項目。在大多數IDE中，你可以右擊你的專案選擇「Run as -> Maven install」來打包和執行項目。如果你是在終端中操作，可以使用以下的命令：
mvn clean package spring-boot:run
這樣一來，Spring Boot就會啟動一個嵌入式的伺服器（通常是Tomcat），並在控制檯中顯示出網頁的IP地址和端口號。
5. 測試我們的應用程式
使用瀏覽器或在終端中使用 curl 命令來驗證我們的應用程式是否正常工作。對於`/`路徑，應該看到一個歡迎訊息；對於`/greeting?name=John`路徑，應該看到一個客製化的問候消息。
curl http://localhost:8080/
# or
curl 'http://localhost:8080/greeting?name=John'
6. 小結
在本篇文章中，我們學習瞭如何使用Maven快速創建一個Spring Boot應用程式，並在其中添加了一些基本的配置和功能。這只是Spring Boot世界中的一小部分，還有更多的高級特性和最佳實踐等待你去探索。隨著經驗的不斷累積，你可以更深入地瞭解Spring Boot框架，並利用它來構建高效且可維護的企業級應用程式。
