Java Chassis | English Maven Central License

Apache ServiceComb Java Chassis 给开发者提供一个快速构建微服务的JAVA SDK。它包含如下特性：

  • 多种开发风格，REST(JAX-RS、Spring MVC）和RPC
  • 多种通信协议, HTTP over Vert.x、Http Over Servlet、Highway等
  • 统一一致的服务提供者、服务消费者处理链，以及基于契约的开箱即用的服务治理能力

开发者可以通过设计选型参考了解更多特性和设计原理。

releases

版本火车最新版本编译的JDK版本支持的JDK版本Open API备注
Java Chassis 33.0.1OpenJDK 17OpenJDK 173.0.x依赖Spring Boot 3
Java Chassis 22.8.14OpenJDK 8OpenJDK 8, 11, 172.0.x依赖Spring 5
Java Chassis 11.3.11OpenJDK 8OpenJDK 82.0.x停止更新

NOTICE: Open API 3.0.x 不兼容 2.0.x， 因此Java Chassis 2、Java Chassis 1不能与Java Chassis 3共存互访. 升级Java Chassis 3, 需要将相关的消费者、提供者和边缘服务同时升级.

NOTICE: Java Chassis 1 第一个版本于2018发布，已经停止更新.

为什么使用Java Chassis

  • 高性能

    Java Chassis 网络层基于 Vert.x 实现, 支持开发者使用响应式编程, 开发者在使用熟悉的REST风格设计业务接口的时候，也能够获取到非常高性能的吞吐量。同时还提供了Highway协议，满足更高性能场景的要求。

  • 原生支持OpenAPI

    Java Chassis 的接口开发、服务治理都基于 Swagger ，并通过接口语义检查，使得接口定义符合 OpenAPI 规范.

  • 灵活的开发方式

    开发者可以使用 SpringMVC/JAX-RS/Transparent RPC 任意一种方式定义服务端接口, 并使用RPC/RestTemplate 等方式访问这些接口. 得益于Java Chassis的通信层与开发方式分离的设计，开发者可以在 Rest over Vertx/Rest over Servlet/Highway等通信模式下自由切换.

  • 开箱即用的服务治理能力

    Java Chassis 提供了大量开箱即用的服务治理能力，包括服务发现、熔断容错、负载均衡、流量控制等。

快速开始 (Spring MVC)

定义提供者。

@RestSchema(schemaId = "ProviderController")
@RequestMapping(path = "/")
public class ProviderController {
  @GetMapping("/sayHello")
  public String sayHello(@RequestParam("name") String name) {
    return "Hello " + name;
  }
}

定义消费者。首先定义一个接口，与需要访问的提供者的方法拥有一样的签名(方法名、返回值类型、参数名称和参数类型)。

public interface ProviderService {
  String sayHello(String name);
}

使用RPC方式访问提供者。

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

  // consumer service which delegate the implementation to provider service.
  @GetMapping("/sayHello")
  public String sayHello(@RequestParam("name") String name) {
    return providerService.sayHello(name);
  }
}

下载并体验上述示例项目 .

用户文档

请访问 ServiceComb Java Chassis 开发指南.

编译Java Chassis

开发者可以通过MAVEN仓库使用Java Chassis。 如果需要构建项目，需要使用JDK 17版本，并预先安装maven。

  mvn clean install

运行测试用例

开发者需要预先安装docker。

  mvn clean install -Pdocker -Pit

使用docker machine。

  mvn clean install -Pdocker -Pit -Pdocker-machine

联系我们

报告缺陷: issues

邮件列表: subscribe dev

参与代码提交

参考 如何做贡献.

License

Licensed under an Apache 2.0 license.