如何对支持多个版本的服务器的特定服务进行节俭调用

Question

假设我在同一个 thrift 文件中声明了以下服务： [我将省略结构定义，因为这只是一个示例]

 service PositionService {
   PositionDTO findPosition(1:positionInputDTO) throws (1:PositionServiceException e);
 }

 service PositionServiceV2 {
   PositionDTO findPosition(1:positionInputDTO) throws (1:PositionServiceException e),
   OwnerStoresListDTO listPositions(1:ListPositionInputDTO) throws (1:PositionServiceException e);
 }

我编译了这个 thrift 文件并在 java 中为服务器生成了代码，并为客户端编写了代码。然后我尝试使用 PositionServiceV2Client 在服务器上调用 listPositions 方法，但我一直收到错误 Invalid method name: listPositions 作为服务器的响应。

请记住，客户端和服务器都在为这些调用使用兼容的堆栈，我已经实现了其他服务，但这是我遇到的第一个在同一个 thrift 文件中声明了多个服务的服务。我怎样才能让这样的电话发生？感谢任何帮助。

Answer 1

调用较新的服务"the old fashioned way"

无法使用 PositionServiceV2 客户端调用 PositionService 服务器，因为这是不同的服务。即使你成功了，当你开始使用服务多路复用时，你仍然会运行遇到麻烦。

即使方法名称意外匹配 findPosition()，也不能保证调用成功。参数列表可能不同，可能有不同的 return 数据或 throws 子句可能不匹配。从接口契约来看，这是两种不同的服务。

底线：您可以使用 PositionServiceV2 客户端调用 PositionServiceV2 服务，或使用 [=13] 调用 PositionService 服务器=] 客户.

但在那种情况下，您还有一个选择余地。 Thrift 支持服务级别的继承，像这样：

service PositionService {
    PositionDTO findPosition(1:PositionInputDTO) 
        throws (1: PositionServiceException e);
}

service PositionServiceV2 extends PositionService {
    OwnerStoresListDTO listPositions(1:ListPositionInputDTO)  
        throws (1:PositionServiceException e);
}

当然，服务器仍然只能响应服务器端实际实现的调用。使用 V2 客户端定位 V1 服务器不会神奇地实现 V2 接口。

"soft versioning" 到底是什么？

使用 Thrift，您不需要做所有这些。你基本上可以忘记我们上面写的，然后做的更简单：

service PositionService {

    // this method exists from the beginning
    PositionDTO findPosition(1:PositionInputDTO) 
        throws (1: PositionServiceException e);

    // this method has been added later
    OwnerStoresListDTO listPositions(1:ListPositionInputDTO)  
        throws (1:PositionServiceException e);

    // this method is no longer available
    //void SomeOlderCallThatIsNoLongerSupportedAnymore()
}

之所以称为"soft versioning"，是因为它完全消除了区分、调用、实现和维护相同API的不同"versions"的需要。呼叫存在或不存在。

对于像 COM 接口这样的二进制 API，这个概念是不可能的，因为更改现有的 API 会立即破坏契约。但是可以使用 Thrift 和类似的框架。如果您足够努力，您仍然可以引入不兼容的更改，但您仍然可以调用剩余部分。

如果您确实需要了解有关服务器的功能、支持的信息，请考虑引入一些辅助方法，例如：

enum ServerCaps = { CanFoo, CanBar, SupportsBaz }

service PositionService {
    // tell me what features you support
    set<ServerCaps>  GetServerCapabilities()

    //... other methods here ...
}

_{PS: Asked and answered before}

如何对支持多个版本的服务器的特定服务进行节俭调用

How do I make a thrift call to a specific service of a server that supports multiple versions

thrift

go

调用较新的服务"the old fashioned way"

"soft versioning" 到底是什么？