akka - 什么是lagom.javadsl.api.Descriptor中的restcall，pathcall，namedcall；

我是微服务和Lagom框架的新手，在我们进行ServiceCall的服务api中，我不了解namedcall，pathcall和restcall的区别。我们应该在何时何地使用哪个？

例如在这些调用中:

  ServiceCall<NotUsed, Cargo, Done> register();
  restCall(Method.POST, "/api/registration", register()

  ServiceCall<NotUsed, NotUsed, Source<Cargo, ?>> getLiveRegistrations();
  pathCall("/api/registration/live", getLiveRegistrations())

  ServiceCall<User, NotUsed> createUser();
  namedCall("/api/users", this::createUser)

最佳答案

Lagom Documentation很好地涵盖了它:

命名为

标识符的最简单类型是名称，默认情况下，该名称设置为与实现它的接口上的方法名称相同的名称。也可以通过将自定义名称传递给namedCall方法来提供它:

default Descriptor descriptor() {
    return named("hello").withCalls(
        namedCall("hello", this::sayHello)
    );
}

在这种情况下，我们将其命名为hello，而不是默认的sayHello。使用REST实现时，这意味着此调用的路径为/ hello。

路径

标识符的第二种类型是基于路径的标识符。这使用URI路径和查询字符串来路由呼叫，并且可以从中提取动态路径参数。可以使用pathCall方法配置它们。
通过在路径中声明动态部分，可以从路径中提取动态路径参数。这些前缀以冒号为前缀，例如，/ order /:id路径具有称为id的动态部分。 Lagom将从路径中提取此参数，并将其传递给服务调用方法。

ServiceCall<NotUsed, Order> getOrder(long id);

default Descriptor descriptor() {
    return named("orders").withCalls(
        pathCall("/order/:id", this::getOrder)
    );
}

当然可以提取出多个参数，这些参数将按照从URL中提取的顺序传递给您的服务调用方法:

休息电话

标识符的最终类型是REST标识符。 REST标识符旨在在创建语义REST API时使用。它们既使用路径(与基于路径的标识符一样)，也使用请求方法来标识它们。可以使用restCall方法配置它们:

ServiceCall<Item, NotUsed> addItem(long orderId);
ServiceCall<NotUsed, Item> getItem(long orderId, String itemId);
ServiceCall<NotUsed, NotUsed> deleteItem(long orderId, String itemId);

default Descriptor descriptor() {
return named("orders").withCalls(
        restCall(Method.POST,   "/order/:orderId/item",         this::addItem),
        restCall(Method.GET,    "/order/:orderId/item/:itemId", this::getItem),
        restCall(Method.DELETE, "/order/:orderId/item/:itemId", this::deleteItem)
);
}