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

Posted 2023-02-16

【中文标题】如何对支持多个版本的服务器的特定服务进行节俭调用

【英文标题】：How do I make a thrift call to a specific service of a server that supports multiple versions

【发布时间】：2020-02-05 19:21:52

【问题描述】：

假设我在同一个 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 文件中声明多个服务的服务。我怎样才能打出这样的电话？任何帮助表示赞赏。

【参考方案1】：

以“老式方式”调用较新的服务

使用PositionServiceV2 客户端调用PositionService 服务器是不可能的，因为它是不同的服务。而且即使你成功了，你在开始使用服务多路复用的时候还是会遇到麻烦。

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

底线：您可以使用PositionServiceV2 客户端调用PositionServiceV2 服务，或使用PositionService 客户端调用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 接口。

到底什么是“软版本控制”？

使用 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()

这被称为“软版本控制”，因为它完全消除了区分、调用、实现和维护同一 API 的不同“版本”的需要。呼叫要么存在，要么不存在。

这种概念对于 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}

【讨论】：

我同意你的建议。我很抱歉没有很好地解释这个问题，或者我认为这就是问题所在是错误的。发生的情况是，即使我使用PositionServiceV2Client 来调用此服务，我仍然会点击 PositionServiceV1 而不是 V2，我认为这就是我收到“无效的方法名称作为错误”的原因。仅作记录，我无法控制客户端的服务器实现。对于无法解释整个情况，我深表歉意，正如您所知，我很困惑。

我明白了。是否有任何公开可用的服务器端文档？也许服务器对 V2 有不同的入口点？或者它可能使用多路复用并将 V1 设置为兼容性后备？

很遗憾，我正在尝试连接的这台服务器没有公开文档...不过我马上会给你答复，请稍候，谢谢。

好的，我可以确认。此服务器将 V1 设置为兼容性后备。