如何创建无需连接BigQuery服务的Stub Table对象用于集成测试

核心思路 #

直接基于官方BigQuery SDK的原生构造能力实现，无需连接远程服务，无需引入Mock框架。

实现步骤 #

• 第一步：构造空BigQuery测试桩
  匿名实现BigQuery接口，所有方法默认抛出UnsupportedOperationException，仅保留构造Table依赖的基础结构：

  BigQuery emptyBigQueryStub = new BigQuery() {
      // 所有接口方法默认抛出不支持异常，测试需要用到的方法可以单独重写返回固定值
      @Override
      public Table get(TableId tableId, TableOption... options) {
          throw new UnsupportedOperationException("测试桩不支持该操作");
      }
      // 其余BigQuery接口方法全部按上述格式实现即可，无需编写业务逻辑
  };
  

• 第二步：构造Table测试桩实例
  调用官方提供的Builder构造方法，传入空BigQuery实例和自定义的表标识，按需补充测试需要的属性即可：

  // 自定义测试用的项目、数据集、表名
  TableId testTableId = TableId.of("test-project", "test-dataset", "test-table");
  Table testTable = Table.newBuilder(emptyBigQueryStub, testTableId, TableDefinition.newBuilder(Type.TABLE).build())
      // 测试逻辑依赖的属性可在此处手动设置，非必要属性不需要填写
      .setDescription("集成测试专用测试桩表")
      .setFriendlyName("test_stub_table")
      .build();
  

适用说明 #

• 所有不需要服务端交互的getter方法（如getTableId()、getDescription()等），只要构造时设置了对应属性即可正常返回预期值，可直接用于测试逻辑校验
• 涉及远程请求的方法（如update()、delete()、listRows()等）默认会抛出不支持异常，符合「大部分功能不可用」的要求，若测试需要用到这些方法可单独重写返回固定值

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