springboot菜鳥教程學習與實踐

雲端運算與程式碼 2024年10月03日 22:18 4.5K+ 品悟

本

文

摘

要

文章介紹 Spring Boot 框架，包括其優點如快速搭建、嵌入式容器和簡化依賴管理等。闡述環境搭建、創建首個應用、配置方法及數據訪問層使用 Spring Data JPA 的步驟。強調其提高開發效率，為 Java 開發者提供從簡單 API 到數據訪問的完整解決方案。 -

一、Spring Boot簡介

Spring Boot是一個基於Spring框架的快速開發框架，它簡化了Spring應用的初始搭建以及開發過程。其主要目的是讓開發者能夠快速創建獨立的、基於生產級別的Spring應用程序。

springboot菜鳥教程學習與實踐第1张

1. 優點

- 快速搭建：不需要大量的配置文件。傳統的Spring項目可能需要復雜的XML配置或者多個Java配置類來配置數據源、事務管理等，而Spring Boot通過默認配置和自動配置功能，能讓開發者在短時間內啟動一個項目。

- 嵌入式容器：可以直接將Tomcat、Jetty等Web容器嵌入到應用程序中，這樣在開發和部署時就不需要單獨安裝和配置Web服務器。

- 簡化依賴管理：Spring Boot通過starter - pom機制，將相關的依賴打包在一起。例如，當你想要開發一個Web應用時，只需要添加`spring - boot - starter - web`依賴，它就會自動引入Spring MVC、Jackson（用於JSON處理）等相關的依賴。

2. 環境搭建

- 安裝JDK：確保你的系統中安裝了JDK，建議使用JDK 11或更高版本。可以從Oracle官網或者OpenJDK官網下載適合你操作系統的JDK版本，安裝完成後設置好環境變量`JAVA_HOME`和`PATH`。

- 選擇IDE：可以使用IntelliJ IDEA或者Eclipse等主流的Java開發IDE。這裏以IntelliJ IDEA為例，下載並安裝社區版或者旗艦版。

- 創建項目：在IntelliJ IDEA中，選擇新建項目，然後選擇Spring Initializr。填寫項目的基本信息，如組名（groupId）、項目名（artifactId）等。在依賴選項中，可以根據需求選擇添加`spring - boot - starter - web`等依賴。點擊完成後，IDEA會自動下載相關的依賴並構建項目結構。

二、創建第一個Spring Boot應用

1. 編寫簡單的RESTful API

- 控制器類：創建一個`HelloController`類，在`com.qunapu.demo`包下（假設項目的groupId為`com.qunapu`，artifactId為`demo`）。

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class HelloController {
    @GetMapping("/hello")
    public String sayHello() {
        return "Hello, Spring Boot!";
    }
}

- 這個控制器類使用了`@RestController`註解，它是`@Controller`和`@ResponseBody`註解的組合，表示這個類中的方法返回的數據直接作為響應體。`@GetMapping`註解指定了這個方法處理`/hello`路徑的GET請求。

這段代碼是Java語言編寫的，用於創建一個簡單的Spring Boot Web應用程序中的一個控制器（Controller）。Spring Boot是Spring框架的一個子項目，它提供了默認配置、創建獨立、生產級別的基於Spring的應用程序所需的幾乎全部功能。下面是這段代碼的詳細解釋：

1). 導入必要的包：

- `import org.springframework.web.bind.annotation.GetMapping;`：這行代碼導入了`@GetMapping`註解，它用於將HTTP GET請求映射到特定的處理方法上。

- `import org.springframework.web.bind.annotation.RestController;`：這行代碼導入了`@RestController`註解，它是一個方便的註解，它本身是一個特殊的`@Controller`，它包含了`@ResponseBody`註解的功能，意味著所有從這個控制器返回的對象都會自動轉換為JSON或XML格式的響應體。

2). 定義控制器類：

- `public class HelloController { ... }`：這裏定義了一個名為`HelloController`的公開類。這個類是一個Spring MVC控制器，用於處理Web請求。

3). 應用`@RestController`註解：

- `@RestController`：這個註解被應用於`HelloController`類上，表明這個類是一個控制器，並且所有從這個控制器返回的對象都將被自動轉換為JSON或XML格式（取決於請求的`Accept`頭部）的HTTP響應體。這是構建RESTful Web服務時常用的模式。

4). 定義處理方法：

- `@GetMapping("/hello")`：這個註解被應用於`sayHello`方法上，它表示當HTTP GET請求發送到`/hello`路徑時，這個方法將被調用。`@GetMapping`是一個組合註解，它是`@RequestMapping(method = RequestMethod.GET)`的簡寫形式。

- `public String sayHello() { return "Hello, Spring Boot!"; }`：這是一個公開的方法，沒有參數，返回一個字符串。當`/hello`路徑接收到GET請求時，這個方法會被執行，並且返回的字符串（"Hello, Spring Boot!"）會自動被Spring MVC框架轉換為HTTP響應體發送給客戶端。

綜上所述，這段代碼定義了一個簡單的Spring Boot Web控制器，它監聽`/hello`路徑的GET請求，並返回一個簡單的字符串（"Hello, Spring Boot!"）作為響應。這是Spring Boot Web應用程序中非常典型的用法，用於快速構建RESTful API或Web服務的端點。

2. 運行項目

- 在IntelliJ IDEA中，可以直接點擊運行按鈕來啟動項目。Spring Boot會自動啟動嵌入式的Web容器（如Tomcat），默認監聽在`8080`端口。打開瀏覽器，輸入`http://localhost:8080/hello`，就可以看到`Hello, Spring Boot!`的響應。

三、Spring Boot配置

1. 配置文件

- Spring Boot支持兩種格式的配置文件：`application.properties`和`application.yml`（或`application.yaml`）。

- 在`application.properties`中設置端口號的示例：`server.port = 8081`。

- 在`application.yml`中的相同配置示例：

yaml
server:
  port: 8081

- `application.yml`文件使用縮進表示層級關系，更加簡潔直觀。

2. 自定義配置

- 假設我們想要定義一個自定義的配置項，比如一個歡迎消息。

- 首先在`application.yml`中添加配置：

yaml
myapp:
  welcome - message: "Welcome to my Spring Boot application"

- 然後創建一個配置類來讀取這個配置項：

java
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
@Component
@ConfigurationProperties(prefix = "myapp")
public class MyAppConfig {
    private String welcomeMessage;
    public String getWelcomeMessage() {
        return welcomeMessage;
    }
    public void setWelcomeMessage(String welcomeMessage) {
        this.welcomeMessage = welcomeMessage;
    }
}
```
   - 可以在控制器中註入這個配置類並使用配置項：
```java
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class HelloController {
    @Autowired
    private MyAppConfig myAppConfig;
    @GetMapping("/welcome")
    public String getWelcomeMessage() {
        return myAppConfig.getWelcomeMessage();
    }
}

四、數據訪問層

1. 使用Spring Data JPA

- 首先添加`spring - boot - starter - data - jpa`依賴到項目中。

- 假設我們有一個簡單的實體類`User`：

java
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private String email;
    // 省略構造函數、getter和setter方法
}

- 然後創建一個`UserRepository`接口繼承自`JpaRepository`：

java
import org.springframework.data.jpa.repository.JpaRepository;
public interface UserRepository extends JpaRepository<User, Long> {
}

- 在控制器中可以註入`UserRepository`並進行數據操作，比如保存用戶數據：

java
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class UserController {
    @Autowired
    private UserRepository userRepository;
    @PostMapping("/users")
    public User saveUser(@RequestBody User user) {
        return userRepository.save(user);
    }
}

五、總結

Spring Boot為Java開發者提供了一種快速開發Spring應用的方式。通過簡化配置、自動配置、嵌入式容器等特性，能夠大大提高開發效率。無論是構建小型的Web應用還是大型的企業級應用，Spring Boot都能發揮重要的作用。從創建簡單的RESTful API到進行數據訪問，Spring Boot提供了一整套完善的解決方案。隨著對Spring Boot的深入學習和實踐，開發者可以更好地利用其優勢來構建高質量的應用程序。