Google 无状态后端应用的应用云端点 API

Question

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

Google 云端点上的示例围绕创建实体 - 定义 CloudEndpoint Class。大多数示例似乎都与 DataStore - 后端数据库相关联。

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

我们有一个使用标准 servlet（req.string 和不同的 resp string）的解决方案，使用 doPost 方法。

任何建议 - 对于我们的场景 - 是否需要 CloudEndPoint and/or 如果有一种简单的方法可以在 Cloud Endpoint 中执行此操作？

谢谢

Answer 1

没有什么可以强制您使用数据存储。不需要就不要用

例如，您可以从一个 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;
    }

}

通过 APIs 资源管理器（对我来说 http://localhost:8888/_ah/api/explorer）显示它导致 POST 请求/响应等效 JSON 对象：

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

哪个returns

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

端点的一大优点是您可以编写简单的 Java 方法，例如 Output hello(Input input) 并从自动生成的 (Java) 客户端代码中使用它们，而不是 "see" 这些方法是通过 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

Google 无状态后端应用的应用云端点 API

Google App Cloud Endpoint API for Stateless Backend App

java

google-app-engine

google-cloud-endpoints