如何使用Spring構建REST服務(四)

書接上文???

不斷發(fā)展的 REST API

通過一個額外的庫和幾行額外的代碼，您已將超媒體添加到您的應用程序中。但這并不是使您的服務成為 RESTful 所需的唯一事情。REST 的一個重要方面是它既不是技術堆棧也不是單一標準。

REST 是架構約束的集合，采用這些約束會使您的應用程序更具彈性。彈性的一個關鍵因素是，當您對服務進行升級時，您的客戶不會遭受停機時間的困擾。

在“過去”的日子里，升級因破壞客戶端而臭名昭著。換句話說，升級到服務器需要更新客戶端。在當今時代，花費數(shù)小時甚至數(shù)分鐘進行升級的停機時間可能會造成數(shù)百萬美元的收入損失。

有些公司要求您向管理層提出一個計劃，以盡量減少停機時間。過去，您可以在周日凌晨 2:00 進行升級，此時負載最低。但在今天的基于互聯(lián)網(wǎng)的電子商務中，國際客戶在其他時區(qū)，這樣的策略就沒有那么有效了。

基于 SOAP 的服務和基于CORBA 的服務非常脆弱。很難推出可以同時支持新舊客戶端的服務器。使用基于 REST 的實踐，這要容易得多。特別是使用 Spring 堆棧。

支持對 API 的更改

想象一下這個設計問題：您已經(jīng)推出了一個具有Employee基于此記錄的系統(tǒng)。該系統(tǒng)大受歡迎。你已經(jīng)把你的系統(tǒng)賣給了無數(shù)的企業(yè)。突然，需要拆分員工的姓名firstName并lastName出現(xiàn)。

哦哦。沒想到。

在您打開課程并用andEmployee替換單個字段之前，請停下來想一想。這會破壞任何客戶嗎？升級它們需要多長時間。您甚至控制所有訪問您服務的客戶端嗎？namefirstNamelastName

停機時間 = 損失金錢。管理層準備好了嗎？

有一個比 REST 早幾年的舊策略。

永遠不要刪除數(shù)據(jù)庫中的列。

— 未知

您始終可以將列（字段）添加到數(shù)據(jù)庫表中。但不要帶走一個。RESTful 服務中的原理是相同的。

將新字段添加到您的 JSON 表示中，但不要帶走任何字段。像這樣：

支持多個客戶端的 JSON

{  "id": 1,  "firstName": "Bilbo",  "lastName": "Baggins",  "role": "burglar",  "name": "Bilbo Baggins",  "_links": {    "self": {      "href": "http://localhost:8080/employees/1"    },    "employees": {      "href": "http://localhost:8080/employees"    }  }}

請注意此格式如何顯示firstName, lastName, AND name？雖然它包含重復信息，但其目的是同時支持新老客戶。這意味著您可以升級服務器，而無需同時升級客戶端。一個可以減少停機時間的好舉措。

您不僅應該以“舊方式”和“新方式”顯示這些信息，還應該以兩種方式處理傳入的數(shù)據(jù)。

如何？簡單的。像這樣：

處理“舊”和“新”客戶的員工記錄

package payroll;import java.util.Objects;import javax.persistence.Entity;import javax.persistence.GeneratedValue;import javax.persistence.Id;@Entityclass Employee {  private @Id @GeneratedValue Long id;  private String firstName;  private String lastName;  private String role;  Employee() {}  Employee(String firstName, String lastName, String role) {    this.firstName = firstName;    this.lastName = lastName;    this.role = role;  }  public String getName() {    return this.firstName + " " + this.lastName;  }  public void setName(String name) {    String[] parts = name.split(" ");    this.firstName = parts[0];    this.lastName = parts[1];  }  public Long getId() {    return this.id;  }  public String getFirstName() {    return this.firstName;  }  public String getLastName() {    return this.lastName;  }  public String getRole() {    return this.role;  }  public void setId(Long id) {    this.id = id;  }  public void setFirstName(String firstName) {    this.firstName = firstName;  }  public void setLastName(String lastName) {    this.lastName = lastName;  }  public void setRole(String role) {    this.role = role;  }  @Override  public boolean equals(Object o) {    if (this == o)      return true;    if (!(o instanceof Employee))      return false;    Employee employee = (Employee) o;    return Objects.equals(this.id, employee.id) && Objects.equals(this.firstName, employee.firstName)        && Objects.equals(this.lastName, employee.lastName) && Objects.equals(this.role, employee.role);  }  @Override  public int hashCode() {    return Objects.hash(this.id, this.firstName, this.lastName, this.role);  }  @Override  public String toString() {    return "Employee{" + "id=" + this.id + ", firstName='" + this.firstName + '\'' + ", lastName='" + this.lastName        + '\'' + ", role='" + this.role + '\'' + '}';  }}

這個類與以前版本的Employee. 讓我們回顧一下變化：

• 字段name已替換為firstName和lastName。
• 定義了舊name屬性的“虛擬”吸氣劑。getName()它使用firstNameandlastName字段來產(chǎn)生一個值。
• name還定義了舊屬性的“虛擬”設置器， setName(). 它解析傳入的字符串并將其存儲到適當?shù)淖侄沃小?/li>

當然，并非對 API 的每一次更改都像拆分字符串或合并兩個字符串一樣簡單。但是對于大多數(shù)場景來說，想出一組轉(zhuǎn)換肯定不是不可能的，對吧？

不要忘記更改預加載數(shù)據(jù)庫的方式（在 中LoadDatabase）以使用這個新的構造函數(shù)。

log.info("Preloading " + repository.save(new Employee("Bilbo", "Baggins", "burglar")));

log.info("Preloading " + repository.save(new Employee("Frodo", "Baggins", "thief")));

適當?shù)姆磻?/strong>

@PostMapping("/employees")ResponseEntity newEmployee(@RequestBody Employee newEmployee) {  EntityModel entityModel = assembler.toModel(repository.save(newEmployee));  return ResponseEntity //      .created(entityModel.getRequiredLink(IanaLinkRelations.SELF).toUri()) //      .body(entityModel);}復制

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

> POST /員工 HTTP/1.1> 主機：本地主機：8080> 用戶代理：curl/7.54.0> 接受：*/*> 內(nèi)容類型：應用程序/json> 內(nèi)容長度：46>< 位置：http://localhost:8080/employees/3< 內(nèi)容類型：application/hal+json;charset=UTF-8< 傳輸編碼：分塊< 日期：格林威治標準時間 2018 年 8 月 10 日星期五 19:44:43<{  “身份證”：3，  "firstName": "Samwise",  "lastName": "Gamgee",  “角色”：“園丁”，  "name": "Samwise Gamgee",  “_鏈接”：{    “自己”： {      “href”：“http://localhost:8080/employees/3”    },    “雇員”： {      "href": "http://localhost:8080/employees"    }  }}

@PutMapping("/employees/{id}")ResponseEntity replaceEmployee(@RequestBody Employee newEmployee, @PathVariable Long id) {  Employee updatedEmployee = 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);      });  EntityModel entityModel = assembler.toModel(updatedEmployee);  return ResponseEntity //      .created(entityModel.getRequiredLink(IanaLinkRelations.SELF).toUri()) //      .body(entityModel);}復制

$ curl -v -X PUT localhost:8080/employees/3 -H 'Content-Type:application/json' -d '{"name": "Samwise Gamgee", "role": "ring bearer"}'* TCP_NODELAY 設置* 連接到 localhost (::1) 端口 8080 (#0)> PUT /employees/3 HTTP/1.1> 主機：本地主機：8080> 用戶代理：curl/7.54.0> 接受：*/*> 內(nèi)容類型：應用程序/json> 內(nèi)容長度：49>< HTTP/1.1 201< 位置：http://localhost:8080/employees/3< 內(nèi)容類型：application/hal+json;charset=UTF-8< 傳輸編碼：分塊< 日期：格林威治標準時間 2018 年 8 月 10 日星期五 19:52:56{“身份證”：3，"firstName": "Samwise","lastName": "Gamgee",“角色”：“戒指持有者”，"name": "Samwise Gamgee",“_鏈接”：{“自己”： {“href”：“http://localhost:8080/employees/3”},“雇員”： {"href": "http://localhost:8080/employees"}}}

@DeleteMapping("/employees/{id}")ResponseEntity deleteEmployee(@PathVariable Long id) {  repository.deleteById(id);  return ResponseEntity.noContent().build();}復制

$ curl -v -X 刪除本地主機：8080/employees/1* TCP_NODELAY 設置* 連接到 localhost (::1) 端口 8080 (#0)> 刪除 /employees/1 HTTP/1.1> 主機：本地主機：8080> 用戶代理：curl/7.54.0> 接受：*/*>< HTTP/1.1 204< 日期：格林威治標準時間 2018 年 8 月 10 日星期五 21:30:26