如何在本地使用Objectify？解决GAE Java本地应用写入远程Datastore问题

Hey there! Let's break down your Objectify questions with clear, actionable steps tailored for local development with Google App Engine Java.

要在本地用Objectify，需要搭建开发环境、配置依赖，并让Objectify连接到本地Datastore模拟器，具体步骤如下：

• 准备本地GAE开发环境
  先确保你已经安装了Google Cloud SDK，包含App Engine Java组件。这个SDK提供的dev_appserver工具会启动本地Datastore模拟器，默认端口是8081。

• 添加Objectify依赖
  如果用Maven，在pom.xml里加入以下依赖（记得替换为最新稳定版本）：

  <dependency>
      <groupId>com.googlecode.objectify</groupId>
      <artifactId>objectify</artifactId>
      <version>6.1.11</version>
  </dependency>
  

  Gradle用户则对应在build.gradle里添加相关配置。

• 初始化Objectify连接本地Datastore
  创建一个初始化类，在应用启动时配置Objectify连接本地模拟器：

  import com.googlecode.objectify.Objectify;
  import com.googlecode.objectify.ObjectifyFactory;
  import com.googlecode.objectify.ObjectifyService;
  import com.google.cloud.datastore.DatastoreOptions;
  
  public class ObjectifyInitializer {
      static {
          // 配置本地Datastore模拟器连接
          DatastoreOptions localOpts = DatastoreOptions.getDefaultInstance()
              .toBuilder()
              .setHost("http://localhost:8081") // 本地模拟器地址
              .setProjectId("local-test-project") // 随便填一个测试用项目ID
              .build();
  
          // 将本地Datastore服务绑定到Objectify
          ObjectifyFactory factory = new ObjectifyFactory(localOpts.getService());
          ObjectifyService.setFactory(factory);
  
          // 注册你的实体类，比如：
          factory.register(YourEntity.class);
      }
  
      // 获取Objectify实例的工具方法
      public static Objectify ofy() {
          return ObjectifyService.ofy();
      }
  }
  

• 开始用Objectify操作本地数据
  现在就可以通过初始化类获取Objectify实例，进行增删改查了：

  // 保存实体
  YourEntity testEntity = new YourEntity();
  testEntity.setName("本地测试数据");
  ObjectifyInitializer.ofy().save().entity(testEntity).now();
  
  // 查询实体
  YourEntity savedEntity = ObjectifyInitializer.ofy()
      .load()
      .type(YourEntity.class)
      .id(testEntity.getId())
      .now();
  

如果本地应用意外把数据写到了远程云Datastore，可以通过以下步骤修复：

• 检查DatastoreOptions配置
  确认你的Objectify初始化代码（比如上面的示例）明确设置了本地模拟器地址http://localhost:8081和测试用的项目ID，绝对不要用真实的云项目ID，否则会强制连接远程Datastore。

• 设置DATASTORE_EMULATOR_HOST环境变量
  GAE本地服务器和Objectify会识别这个变量，自动连接本地模拟器。启动本地服务器前先设置变量：

  # Linux/macOS
  export DATASTORE_EMULATOR_HOST=localhost:8081
  dev_appserver.sh 你的应用目录
  
  # Windows命令行
  set DATASTORE_EMULATOR_HOST=localhost:8081
  dev_appserver.cmd 你的应用目录
  

  这样Objectify会优先使用本地模拟器，而非远程连接。

• 确认本地模拟器正在运行
  启动dev_appserver时会自动启动本地Datastore模拟器，你可以访问http://localhost:8081/datastore在浏览器里查看本地数据，确认实体都存在这里，而非云Datastore控制台。

• 检查Objectify版本
  旧版本的Objectify可能和本地模拟器存在兼容性问题，建议升级到最新稳定版，避免意外连接远程。

内容的提问来源于stack exchange，提问作者Allan Veloso