GAE Java8迁移Java11：com.google.appengine.datastore.Text替代方案

问题描述 #

我的GAE应用基于Java 8，正赶在1月30日的截止日期前迁移至Java 11。迁移步骤之一是在POM中替换依赖，从com.google.appengine改为com.google.cloud。当前应用实体类使用的数据类型com.google.appengine.api.datastore.Text来自以下依赖：

<dependency>
    <groupId>com.google.appengine</groupId>
    <artifactId>appengine-api-1.0-sdk</artifactId>
    <version>1.9.64</version>
</dependency>

而Java 11推荐使用的依赖是：

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-datastore</artifactId>
  <version>${version}</version>
</dependency>

我检查了该依赖的最新版本2.18.0，发现其中不存在com.google.appengine.api.datastore.Text类型。查看相关Stack Overflow问题及该依赖的旧版本，均未找到该类型。请问是否找错了位置？如果是，正确位置在哪里？如果没有找错，该用什么类型替代它？

解决方案 #

你没找错依赖，com.google.appengine.api.datastore.Text是旧版App Engine SDK专属的类型，在新版google-cloud-datastore客户端中确实没有直接对应的类型，推荐用以下两种方式替代：

1. 直接使用Java原生String类型 #

新版Datastore客户端已经简化了文本存储逻辑，无需专门的Text类型处理长文本。当存储的字符串超过Datastore普通字符串1500字节的限制时，客户端会自动将其转换为长文本存储类型，行为和旧版Text一致——不参与索引、支持大文本内容。

替换示例：
旧代码：

import com.google.appengine.api.datastore.Text;
// ...
Text longText = new Text("超长文本内容...");
entity.setProperty("content", longText);

新代码：

String longText = "超长文本内容...";
entity.set("content", longText);

2. 显式创建不参与索引的长文本 #

如果需要明确控制文本不参与索引（和旧版Text的核心特性一致），可以使用StringValue并设置excludeFromIndexes属性：

示例代码：

import com.google.cloud.datastore.StringValue;
// ...
String longText = "超长文本内容...";
entity.set("content", StringValue.newBuilder(longText).setExcludeFromIndexes(true).build());

额外建议 #

如果项目中大量使用了旧版Text类型，可以编写一个简单的工具类批量处理类型转换，减少手动修改工作量：

public class DatastoreUtils {
    public static Object convertTextToString(Object value) {
        if (value instanceof Text) {
            return ((Text) value).getValue();
        }
        return value;
    }
}

内容的提问来源于stack exchange，提问作者Applix Systems