springboot菜鳥教程學習與實踐
一、Spring Boot簡介
Spring Boot是一個基於Spring框架的快速開發框架，它簡化了Spring應用的初始搭建以及開發過程。其主要目的是讓開發者能夠快速創建獨立的、基於生產級別的Spring應用程序。
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的深入學習和實踐，開發者可以更好地利用其優勢來構建高質量的應用程序。
