資訊專欄INFORMATION COLUMN
摘要：創建工程將框架代碼包解壓后放到工作目錄。方便起見，本教程使用為例。添加創建一個，負責響應相關的業務請求。添加標注在中，對輸入參數進行校驗通常使用標注。在本教程，我們將實現的增和查的工作。創建用戶用戶名重啟并提交創建請求。
環境準備
系統：MacOS
開發：IntelliJ IDEA
語言：Java8
其它：Mysql、Redis
腳手架代碼Spring提供了一個創建項目腳手架的官網，在這里可以直接定制項目的框架代碼。例如：
注意：在Dependencies中，添加了Web依賴。
點擊【Generate Project】，即可下載項目框架代碼。
創建工程將框架代碼包解壓后放到工作目錄。打開IDEA，點擊【File] -> 【Open】，打開對應目錄。
啟動工程找到com.spring.demo.demo下的DemoApplication，右鍵點擊運行后，console中即可顯示Spring啟動的信息。
在傳統MVC架構中，Controller負責接收Http請求并返回相應的應答，這個應答可以是一個頁面，也可以是一個JSON對象。方便起見，本教程使用RestfulAPI為例。
添加RestController創建一個UserController，負責響應User相關的業務請求。對于純數據的API接口，使用@RestControll進行標注，這樣每一個API接口的返回值就會被轉化為JSON結構的數據。
package com.spring.demo.demo.controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class UserController {
@RequestMapping("/user")
public String find() {
return "UserA";
}
}
重啟應用，在瀏覽器中請求http://localhost:8080/user，即可看到請求的返回內容：UserA。
路徑參數對于帶路徑參數的請求，可以通過@PathVariable 標注來獲取參數值。如：
package com.spring.demo.demo.controller;
import org.springframework.web.bind.annotation.PathVariable;
...
@RestController
public class UserController {
@RequestMapping("/user/{id}")
public String find(@PathVariable int id) {
return "用戶ID[" + id + "]";
}
}
POST請求
對于POST請求，可以使用@PostMapping 來標注方法，接收的JSON數據需要使用@RequestBody來標注。
...
@PostMapping("/user")
public void create(@RequestBody UserCreateRequest user) {
System.out.println(user.getName());
}
...
這里的UserCreateRequest，用來接收并轉換JSON數據。
package com.spring.demo.demo.dto;
public class UserCreateRequest {
private String name;
private boolean gender;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public boolean isGender() {
return gender;
}
public void setGender(boolean gender) {
this.gender = gender;
}
}
在IDEA的Terminal中，使用curl來進行測試。
curl -XPOST "http://127.0.0.1:8080/user" -H "Content-Type: application/json" -d"{"name":"用戶A","gender":0}"
參數校驗
有時我們需要對傳入參數進行非空或有效值的校驗，這個處理應該在正式進入controller前進行。
1. 添加@Validated標注在SpringMVC中，對輸入參數進行校驗通常使用@Validated標注。
...
@PostMapping("/user")
public void create(@RequestBody @Validated UserCreateRequest user) {
System.out.println(user.getName());
}
...
2. 添加校驗規則標注@
在對應的字段上，加上對應的校驗規則標注。
package com.spring.demo.demo.dto;
import javax.validation.constraints.NotNull;
public class UserCreateRequest {
@NotNull
private String name;
private boolean gender;
// Getters & Setters
...
}
添加后重啟服務，發送不含name字段的POST請求，結果如下：
MVC框架中，Controller負責接收請求和相應，Service則負責具體的業務處理，即Model層。
Service在定義是需要使用@Service標注，SpringBoot在啟動中將會注冊該Service并在Controller通過DI來實例化并使用該Service。
一般來說，我們會創建一個Service的接口類和一個對應的實現類。
IUserService
package com.spring.demo.demo.service;
public interface IUserService {
public String findUser(int id);
}
UserService
package com.spring.demo.demo.service;
import org.springframework.stereotype.Service;
@Service
public class UserService implements IUserService {
public String findUser(int id) {
return "用戶" + id;
}
}
在調用時，Controller會直接應用接口類，并添加@Autowired標簽。這里的調用原理，即是Sping最著名的DI（依賴注入）和IoC（控制反轉）。
package com.spring.demo.demo.controller;
import com.spring.demo.demo.dto.UserCreateRequest;
...
@RestController
public class UserController {
@Autowired
IUserService userService;
@RequestMapping("/user/{id}")
public String find(@PathVariable int id) {
return userService.findUser(id);
}
@PostMapping("/user")
public void create(@RequestBody @Validated UserCreateRequest user) {
System.out.println(user.getName());
}
}
此時重啟Spring，并使用curl進行請求，可以得到結果：
$ curl -XGET "http://127.0.0.1:8080/user/100" $ 用戶100Repository
Spring本身集成了Spring Data JPA，用來作為訪問數據庫的ORM工具，它采用了Hibernate實現。在本教程，我們將實現User的增和查的工作。
添加依賴修改pom.xml，添加對mysql和jpa的支持。
...服務配置... mysql mysql-connector-java org.springframework.boot spring-boot-starter-data-jpa
修改/resources/application.properties，添加相關的設置。
... spring.datasource.url=jdbc:mysql://localhost:3306/demo?useSSL=false spring.datasource.username=root spring.datasource.password=123456 ... spring.jpa.database-platform=org.hibernate.dialect.MySQL5Dialect spring.jpa.show-sql=true添加Repository和Entity
Repository在DDD中是一個非常重要的概念，字面意思來講它就是一個倉庫。它屏蔽了SQL和數據庫操作的細節，使得業務代碼無需再考慮更細節的數據處理。它和Mybatis可以說是兩個完全相反的流派。
Spring Data JPA中，默認實現了Crud操作的Repository，可以直接繼承并使用這個框架進行快速的CRUD實現。
