打開(kāi)一個(gè)簡(jiǎn)單的 REST 接口

@RestSchema(schemaId = "ProviderController")
@RequestMapping(path = "/")
public class ProviderController {
  @PostMapping("/benchmark")
  public DataModel sayHello(@RequestHeader("wait") int wait, @RequestBody DataModel dataModel) {
    if (wait > 0) {
      Thread.sleep(wait);
    }
    return dataModel;
  }
}

契約

openapi: 3.0.1
info:
  title: swagger definition for org.apache.servicecomb.samples.ProviderController
  version: 1.0.0
servers:
- url: /
paths:
  /benchmark:
    post:
      operationId: sayHello
      parameters:
      - name: wait
        in: header
        required: true
        schema:
          type: integer
          format: int32
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DataModel'
          application/protobuf:
            schema:
              $ref: '#/components/schemas/DataModel'
          text/plain:
            schema:
              $ref: '#/components/schemas/DataModel'
        required: true
        x-name: dataModel
      responses:
        "200":
          description: response of 200
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataModel'
            application/protobuf:
              schema:
                $ref: '#/components/schemas/DataModel'
            text/plain:
              schema:
                $ref: '#/components/schemas/DataModel'
components:
  schemas:
    ChildDataModel:
      type: object
      properties:
        numInt:
          type: integer
          format: int32
        numLong:
          type: integer
          format: int64
        numDouble:
          type: number
          format: double
        numFloat:
          type: number
          format: float
        data:
          type: string
      x-java-class: org.apache.servicecomb.samples.ChildDataModel
    DataModel:
      type: object
      properties:
        data:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/ChildDataModel'
      x-java-class: org.apache.servicecomb.samples.DataModel

可以看到 Java Chassis使用了Open API 3.0.1的協(xié)議規(guī)范，Request Body 和 responses 增加了 application/protobuf 、 text/plain 的支持。 這種使用形式，奠定了Java Chassis 3多序列化支持方式的基礎(chǔ)，細(xì)心的讀者應(yīng)該很快能夠發(fā)現(xiàn)這種方式與其他支持多序列化框架之間的差異。

Spring Boot

支持多序列化方式，需要實(shí)現(xiàn) HttpMessageConverter 接口，并在 Controller 聲明支持的 Content-Type。 如果使用 Spring Fox 或者 Spring Doc 等 Open API工具生成契約，契約內(nèi)容只會(huì)包含 Controller 聲明的序列化類型。 Spring Boot存在隱式的契約情況，這意味著契約并不能完全代表 Controller 服務(wù)的能力。 如果需要對(duì)接口增加或者減少序列化支持，都需要修改代碼。

Dubbo

Dubbo 需要在 Provider 使用 dubbo:protocol 聲明序列化方式， 在Consumer使用 dubbo:reference 聲明序列化方式。 由于 Dubbo 是基于IDL的契約系統(tǒng)， 在使用 RPC 的場(chǎng)景下，可以通過(guò)配置動(dòng)態(tài)調(diào)整序列化方式。 REST 支持在 Dubbo 是完全獨(dú)立的單元， 序列化方式也獨(dú)立于 RPC 接口， RPC 和 REST 不能互操作。

Open API基于 REST 的語(yǔ)義，來(lái)支持 IDL 的語(yǔ)義。 Java Chassis能夠更加直觀的支持通過(guò)第三方工具以HTTP協(xié)議族訪問(wèn)微服務(wù)， 只需要按照契約的描述構(gòu)造HTTP的報(bào)文。 在編碼側(cè)， Java Chassis的客戶端可以使用 REST 語(yǔ)義的接口，如 RestOperations，也可以使用 RPC 語(yǔ)義的接口訪問(wèn)服務(wù)端。

定義服務(wù)端接口

public interface ProviderService {
  DataModel sayHello(int wait, DataModel dataModel);
}

通過(guò)RPC訪問(wèn)

@RestSchema(schemaId = "ConsumerController")
@RequestMapping(path = "/")
public class ConsumerController {
  @RpcReference(schemaId = "ProviderController", microserviceName = "provider")
  private ProviderService providerService;

  @PostMapping("/benchmark")
  public DataModel sayHello(@RequestHeader("wait") int wait, @RequestBody DataModel dataModel) {
    return providerService.sayHello(wait, dataModel);
  }
}

Java Chassis以O(shè)penAPI為基礎(chǔ)的Edge Service部件，能夠?qū)崿F(xiàn)請(qǐng)求在通信協(xié)議、序列化方式上的自動(dòng)轉(zhuǎn)換。比如將HTTP協(xié)議轉(zhuǎn)Highway協(xié)議、application/json轉(zhuǎn)application/protobuf等。

基于 Java Chassis Benchmark ，做一個(gè)簡(jiǎn)單性能測(cè)試。該測(cè)試對(duì)比了兩種場(chǎng)景：

場(chǎng)景一的默認(rèn)配置：

servicecomb:
  rest:
    parameter:
      default-request-encoding: "application/json"
      default-response-encoding: "application/json"

場(chǎng)景二的默認(rèn)配置：

servicecomb:
  rest:
    parameter:
      default-request-encoding: "application/protobuf"
      default-response-encoding: "application/protobuf"

測(cè)試結(jié)果參考下表。該數(shù)據(jù)主要用于說(shuō)明序列化差異，因此省去了測(cè)試環(huán)境的描述。下表的平均時(shí)延統(tǒng)計(jì)了測(cè)試客戶端計(jì)算的請(qǐng)求-響應(yīng)時(shí)間的平均值。

從這組數(shù)據(jù)可以看出：

• 在數(shù)據(jù)量比較小的場(chǎng)景下，使用 json 和 proto-buffer 性能差異很小。 在數(shù)據(jù)量比較大的情況下，proto-buffer 的性能明顯好于 json。
• 在業(yè)務(wù)時(shí)延比較大（>100ms）的時(shí)候， 序列化的時(shí)延可以忽略。

不同的序列化方式除了性能差異，在可維護(hù)方面也會(huì)存在很大的差異。比如 proto-buffer 在兼容性方面的表現(xiàn)會(huì)比 json 差，當(dāng)修改接口定義的時(shí)候， 比如增加屬性、刪除屬性、修改屬性等，proto-buffer 更容易導(dǎo)致兼容性問(wèn)題，做好兼容性防范對(duì)多數(shù)用戶而言，都是比較困難的事情。

支持多協(xié)議、多序列化方式的另外一個(gè)考慮，是對(duì)接遺留系統(tǒng)。對(duì)接遺留系統(tǒng)會(huì)背負(fù)大量歷史債務(wù)，使得新系統(tǒng)本身設(shè)計(jì)偏離預(yù)期的方向。在 Java Chassis 多序列化方式的選擇上， 只提供了目前廣泛使用的 json 和 proto-buffer 支持， 而沒(méi)有選擇支持其他序列化方案。 以架構(gòu)的韌性去處理遺留系統(tǒng)問(wèn)題，是 Java Chassis堅(jiān)持的一個(gè)重要設(shè)計(jì)理念，對(duì)接遺留系統(tǒng)或者保持與遺留系統(tǒng)的兼容，不是它的主要設(shè)計(jì)目標(biāo)。

在序列化方式選擇上，簡(jiǎn)單的總結(jié)如下：

• 使用 REST 協(xié)議是絕大多數(shù)場(chǎng)景的最優(yōu)選擇，能夠最好的兼顧性能、可靠性、韌性等方面的要求。
• 對(duì)于數(shù)據(jù)量比較大，業(yè)務(wù)時(shí)延很低(<100ms)，并且業(yè)務(wù)比較穩(wěn)定，業(yè)務(wù)接口不需要頻繁變動(dòng)的場(chǎng)景，可以采用 proto-buffer來(lái)優(yōu)化性能，按需調(diào)整。

客戶故事：某個(gè)客戶的關(guān)鍵核心系統(tǒng)對(duì)于時(shí)延要求很高，因此需要采用私有協(xié)議和序列化方式來(lái)提升性能。但是對(duì)于一些非核心系統(tǒng)，需要使用REST接口，方便日常開(kāi)發(fā)、調(diào)試。Java Chassis的解耦設(shè)計(jì)使得客戶無(wú)需對(duì)代碼進(jìn)行任何改造，就可以滿足兩方面的要求。

以上就是Java Chassis 3多種序列化方式支持技術(shù)解密的詳細(xì)內(nèi)容，更多關(guān)于Java Chassis3序列化方式的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論