序列化协议选择
不论采用 JAX-RS、Spring MVC,还是采用 透明RPC 开发,都涉及接口的返回值和参数。java-chassis 采用的是一种平台无关的数据序列化方式,当 Transport 为 REST 的时候,序列化方式为 json,当 Transport 为 Highway 的时候,序列化方式为 protobuffer。 平台无关的数据序列化方式有个基本 特征:作为 Consumer, 从序列化的数据中,无法获取任何和 Consuemr 开发语言有关的类型信息。 平台无关 特性给接口定义的数据类型提供了更严格的要求,符合这些要求的接口定义,一方面运行更加高效,另外一方面更加方便的 动态调整 Transport, 而无需对代码做出修改。
对于 REST, 虽然 json 本身不包含特定平台的类型信息,但是 JAVA 可以通过在反序列化的时候,指定目标 类型,所以对于 REST, 可以更加灵活的使用不同的类型。
本章节主要介绍为了实现最大的夸平台和高性能,开发者定义接口的最佳实践。同时介绍在使用 REST 的情况下,如何 更加灵活的支持不同的类型。
接口定义的最佳实践和类型约束
java-chassis 的所有接口定义,都可以生成符合 OpenAPI 的 swagger 接口描述,当使用 Highway 协议时, swagger 文件还会在内部被转换为等价的 proto 文件。 接口定义的最佳实践需要满足 OpenAPI 和 proto的 数据类型要求。