如何使用Spring構(gòu)建REST服務(wù)(二)

書接上文???

HTTP 是平臺(tái)

要使用 Web 層次包裝您的存儲(chǔ)庫(kù)，您必須使用 Spring MVC。多虧了 Spring Boot，代碼基礎(chǔ)設(shè)施很少。相反，我們可以專注于行動(dòng)：

nonrest/src/main/java/payroll/EmployeeController.java

package payroll;

import java.util.List;

import org.springframework.web.bind.annotation.DeleteMapping;

import org.springframework.web.bind.annotation.GetMapping;

import org.springframework.web.bind.annotation.PathVariable;

import org.springframework.web.bind.annotation.PostMapping;

import org.springframework.web.bind.annotation.PutMapping;

import org.springframework.web.bind.annotation.RequestBody;

import org.springframework.web.bind.annotation.RestController;

@RestController

class EmployeeController {

private final EmployeeRepository repository;

EmployeeController(EmployeeRepository repository) {

this.repository = repository;

}

// Aggregate root

// tag::get-aggregate-root[]

@GetMapping("/employees")

List all() {

return repository.findAll();

}

// end::get-aggregate-root[]

@PostMapping("/employees")

Employee newEmployee(@RequestBody Employee newEmployee) {

return repository.save(newEmployee);

}

// Single item

@GetMapping("/employees/{id}")

Employee one(@PathVariable Long id) {

return repository.findById(id)

.orElseThrow(() -> new EmployeeNotFoundException(id));

}

@PutMapping("/employees/{id}")

Employee replaceEmployee(@RequestBody Employee newEmployee, @PathVariable Long id) {

return repository.findById(id)

.map(employee -> {

employee.setName(newEmployee.getName());

employee.setRole(newEmployee.getRole());

return repository.save(employee);

})

.orElseGet(() -> {

newEmployee.setId(id);

return repository.save(newEmployee);

});

}

@DeleteMapping("/employees/{id}")

void deleteEmployee(@PathVariable Long id) {

repository.deleteById(id);

}

}

• @RestController表示每個(gè)方法返回的數(shù)據(jù)會(huì)直接寫入響應(yīng)體，而不是渲染模板。
• AnEmployeeRepository由構(gòu)造函數(shù)注入到控制器中。
• 我們有每個(gè)操作的路由（@GetMapping、@PostMapping、@PutMapping和@DeleteMapping，對(duì)應(yīng)于 HTTP GET、POST、PUT和DELETE調(diào)用）。（注意：閱讀每種方法并了解它們的作用很有用。）
• EmployeeNotFoundException是用于指示何時(shí)查找但未找到員工的異常。

nonrest/src/main/java/payroll/EmployeeNotFoundException.java

package payroll;

class EmployeeNotFoundException extends RuntimeException {

EmployeeNotFoundException(Long id) {

super("Could not find employee " + id);

}

}

當(dāng)EmployeeNotFoundException拋出 an 時(shí)，Spring MVC 配置的這個(gè)額外花絮用于呈現(xiàn)HTTP 404：

nonrest/src/main/java/payroll/EmployeeNotFoundAdvice.java

package payroll;

import org.springframework.http.HttpStatus;

import org.springframework.web.bind.annotation.ControllerAdvice;

import org.springframework.web.bind.annotation.ExceptionHandler;

import org.springframework.web.bind.annotation.ResponseBody;

import org.springframework.web.bind.annotation.ResponseStatus;

@ControllerAdvice

class EmployeeNotFoundAdvice {

@ResponseBody

@ExceptionHandler(EmployeeNotFoundException.class)

@ResponseStatus(HttpStatus.NOT_FOUND)

String employeeNotFoundHandler(EmployeeNotFoundException ex) {

return ex.getMessage();

}

}

• @ResponseBody表示此建議直接呈現(xiàn)到響應(yīng)正文中。
• @ExceptionHandlerEmployeeNotFoundException將建議配置為僅在拋出an 時(shí)才響應(yīng)。
• @ResponseStatus說(shuō)要發(fā)出一個(gè)HttpStatus.NOT_FOUND，即一個(gè)HTTP 404。
• 建議的主體生成內(nèi)容。在這種情況下，它會(huì)給出異常的消息。

要啟動(dòng)應(yīng)用程序，請(qǐng)右鍵單擊其中并從 IDEpublic static void main中PayRollApplication選擇運(yùn)行，或者：

Spring Initializr 使用 maven 包裝器，所以輸入：

$ ./mvnw clean spring-boot:run

或者使用您安裝的 Maven 版本輸入：

$ mvn clean spring-boot:run

當(dāng)應(yīng)用程序啟動(dòng)時(shí)，我們可以立即對(duì)其進(jìn)行詢。

$ curl -v localhost:8080/員工

這將產(chǎn)生：

* 嘗試 ::1...* TCP_NODELAY 設(shè)置* 連接到 localhost (::1) 端口 8080 (#0)> GET /員工 HTTP/1.1> 主機(jī)：本地主機(jī)：8080> 用戶代理：curl/7.54.0> 接受：*/*>< HTTP/1.1 200< 內(nèi)容類型：application/json;charset=UTF-8< 傳輸編碼：分塊< 日期：格林威治標(biāo)準(zhǔn)時(shí)間 2018 年 8 月 9 日星期四 17:58:00<* 連接 #0 到主機(jī) localhost 保持不變[{"id":1,"name":"Bilbo Baggins","role":"竊賊"},{"id":2,"name":"Frodo Baggins","角色":"小偷"} ]

在這里，您可以看到壓縮格式的預(yù)加載數(shù)據(jù)。

如果您嘗試查詢一個(gè)不存在的用戶......

$ curl -v localhost:8080/employees/99

你得到…

* 嘗試 ::1...* TCP_NODELAY 設(shè)置* 連接到 localhost (::1) 端口 8080 (#0)> 獲取 /employees/99 HTTP/1.1> 主機(jī)：本地主機(jī)：8080> 用戶代理：curl/7.54.0> 接受：*/*>< HTTP/1.1 404< 內(nèi)容類型: text/plain;charset=UTF-8< 內(nèi)容長(zhǎng)度：26< 日期：格林威治標(biāo)準(zhǔn)時(shí)間 2018 年 8 月 9 日星期四 18:00:56<* 連接 #0 到主機(jī) localhost 保持不變找不到員工 99

此消息很好地顯示了HTTP 404錯(cuò)誤以及自定義消息Could not find employee 99。

顯示當(dāng)前編碼的交互并不難……?

如果您使用 Windows 命令提示符發(fā)出 cURL 命令，則以下命令可能無(wú)法正常工作。您必須選擇一個(gè)支持單引號(hào)參數(shù)的終端，或者使用雙引號(hào)，然后轉(zhuǎn)義 JSON 中的那些。

要?jiǎng)?chuàng)建新Employee記錄，我們?cè)诮K端中使用以下命令——$開(kāi)頭的表示后面是終端命令：

$ curl -X POST localhost:8080/employees -H 'Content-type:application/json' -d '{"name": "Samwise Gamgee", "role": "gardener"}'

然后它存儲(chǔ)新創(chuàng)建的員工并將其發(fā)送回給我們：

{"id":3,"name":"Samwise Gamgee","role":"gardener"}

您可以更新用戶。讓我們改變他的角色。

$ curl -X PUT localhost:8080/employees/3 -H 'Content-type:application/json' -d '{"name": "Samwise Gamgee", "role": "ring bearer"}'

我們可以看到輸出中反映的變化。

{"id":3,"name":"Samwise Gamgee","role":"戒指持有者"}

您構(gòu)建服務(wù)的方式可能會(huì)產(chǎn)生重大影響。在這種情況下，我們說(shuō)update，但replace是更好的描述。例如，如果未提供名稱，則它將被取消。

最后，您可以像這樣刪除用戶：

$ curl -X DELETE 本地主機(jī)：8080/employees/3# 現(xiàn)在如果我們?cè)倏匆槐?，它就不?jiàn)了$ curl localhost:8080/employees/3找不到員工 3

這一切都很好，但是我們有 RESTful 服務(wù)了嗎？（如果你沒(méi)有聽(tīng)懂提示，答案是否定的。）

少了什么東西？

......未完待續(xù)......

2022就業(yè)季｜Spring認(rèn)證教你，如何使用 Spring 構(gòu)建 REST 服務(wù)

#java##spring##spring認(rèn)證##2022就業(yè)季#

以上就是今天關(guān)于Spring的一些討論，對(duì)你有幫助嗎？如果你有興趣深入了解，歡迎到Spring中國(guó)教育管理中心留言交流！

審核編輯：湯梓紅