java - 用于无状态后端应用程序的 Google App Cloud Endpoint API

Question

我们有一个在 Google App Engine (GAE) 上运行的无状态后端 Java 应用程序。引擎接收字符串 A (json) 并返回不同的字符串 B (json)。

Google Cloud Endpoints 上的示例围绕创建实体 - 定义 CloudEndpoint 类。大多数示例似乎都与数据存储(后端数据库)相关。

在我们的例子中，数据没有被持久化并且没有主键。我们成功创建了一个实体 - 将输入和输出字符串作为两个字段。它有效，但是 resp 有效负载还包含输入字符串的副本。

我们有一个使用 doPost 方法的标准 servlet(req.string 和不同的 resp 字符串)的解决方案。

对于我们的场景，有什么建议吗？CloudEndPoint 是否必要和/或是否有一种简单的方法可以在 Cloud Endpoint 中执行此操作？

谢谢

Answer 1

没有什么会强制您使用数据存储。如果您不需要它，请不要使用它。

例如，您可以从一个 Pojo 转换为另一个 Pojo

public class Input {
    public String inputValue;
}

public class Output {
    public String outputValue;
}

@Api(name = "myApi", version = "v1")
public class MyApi {

    @ApiMethod(name = "hello")
    public Output hello(Input input) {
        Output response = new Output();
        response.resultValue = "Hello " + input.inputValue;
        return response;
    }

}

通过 API 资源管理器(对我来说 http://localhost:8888/_ah/api/explorer)显示它会产生等效 JSON 对象的 POST 请求/响应:

POST http://localhost:8888/_ah/api/myApi/v1/hello
{
 "inputValue": "Hans"
}

返回

200 OK
{
 "resultValue": "Hello Hans"
}

端点的一大优点是，您可以编写简单的 Java 方法，例如 Output hello(Input input) 并从自动生成的 (Java) 客户端代码中使用它们，这些代码不会“看到”这些方法方法通过 HTTP 调用。

如果您知道 URL 是什么，则可以通过常规 http 使用它们，但这不是预期用途。

在应用程序引擎中执行 JSON 方法的更通用方法是使用 JAX-RS 实现，例如 Jersey。这样您就不必拥有_ah/api/vN/apiname/methodname方法以及它们附带的限制(例如出现异常时的特定错误响应)。

使用 JAX-RS 的代码可能看起来像这样

@Path("/whatEverILike")
@Produces(MediaType.APPLICATION_JSON)
@Consumes(MediaType.APPLICATION_JSON)
public class MyApi {

    @POST
    public Output hello(Input input) {
        Output response = new Output();
        response.resultValue = "Hello " + input.inputValue;
        return response;
    }
}

但是设置这样的项目有点困难，因为您需要很多依赖项。例如，对于 Jersey，您可能需要以下 2 个，其中包括几个传递依赖项:

org.glassfish.jersey.containers:jersey-container-servlet-core:2.22
org.glassfish.jersey.media:jersey-media-json-jackson:2.22

展开为

aopalliance-repackaged-2.4.0-b31.jar  jackson-core-2.5.4.jar                     javassist-3.18.1-GA.jar       jersey-client-2.22.jar                  jersey-media-jaxb-2.22.jar
hk2-api-2.4.0-b31.jar                 jackson-databind-2.5.4.jar                 javax.annotation-api-1.2.jar  jersey-common-2.22.jar                  jersey-media-json-jackson-2.22.jar
hk2-locator-2.4.0-b31.jar             jackson-jaxrs-base-2.5.4.jar               javax.inject-1.jar            jersey-container-servlet-core-2.22.jar  jersey-server-2.22.jar
hk2-utils-2.4.0-b31.jar               jackson-jaxrs-json-provider-2.5.4.jar      javax.inject-2.4.0-b31.jar    jersey-entity-filtering-2.22.jar        osgi-resource-locator-1.0.1.jar
jackson-annotations-2.5.4.jar         jackson-module-jaxb-annotations-2.5.4.jar  javax.ws.rs-api-2.0.1.jar     jersey-guava-2.22.jar                   validation-api-1.1.0.Final.jar