2

HBase Javadoc は、HTable.get(List) メソッドに関して非常に紛らわしいものです。

戻りパラメータのドキュメントとして、次のステートメントがあります。

リトライしても失敗する場合は、
これらの Get の結果配列には null が含まれます。
AND 例外がスローされます。

「AND」がわかりません。返された配列に例外または null のいずれかを含めることができますが、ドキュメントが示すように両方を同時に持つことはできません。

例外を発生させて何かを返すことができる Java メソッドは聞いたことがありません。

このメソッドを呼び出すときにコードで例外を処理しますが、結果配列の null 参照についても心配する必要がありますか?

4

1 に答える 1

0

この関数は結果を返さず、失敗した場合に同時にエラーをスローするため、ここのドキュメントは誤解を招きます。

私も混乱していたので、これを掘り下げました。

この関数のソース コードは次のとおりです。

  /** {@inheritDoc} */
  @Override
  public Result[] get(List<Get> gets) throws IOException {
    LOG.trace("get(List<>)");
    Preconditions.checkNotNull(gets);
    if (gets.isEmpty()) {
      return new Result[0];
    } else if (gets.size() == 1) {
      try {
        return new Result[] {get(gets.get(0))};
      } catch (IOException e) {
        throw createRetriesExhaustedWithDetailsException(e, gets.get(0));
      }
    } else {
      try (Scope scope = TRACER.spanBuilder("BigtableTable.get").startScopedSpan()) {
        addBatchSizeAnnotation(gets);
        return getBatchExecutor().batch(gets);
      }
    }
  }

さて、複数のアイテムのリストの場合、 を呼び出しますgetBatchExecutor().batch(gets)。その関数は次のように定義されます。

  public Result[] batch(List<? extends Row> actions) throws IOException {
    try {
      Object[] resultsOrErrors = new Object[actions.size()];
      batchCallback(actions, resultsOrErrors, null);
      // At this point we are guaranteed that the array only contains results,
      // if it had any errors, batch would've thrown an exception
      Result[] results = new Result[resultsOrErrors.length];
      System.arraycopy(resultsOrErrors, 0, results, 0, results.length);
      return results;
    } catch (InterruptedException e) {
      Thread.currentThread().interrupt();
      LOG.error("Encountered exception in batch(List<>).", e);
      throw new IOException("Batch error", e);
    }
  }

そこのコメントを参照してください：

この時点で、配列に結果のみが含まれていることが保証されています。エラーがあった場合、バッチは例外をスローしていました。

つまり、この関数は失敗した場合にのみ IOException を発生させ、結果に関する詳細情報はありません。それでは、バッチの失敗したアイテムと適切に処理されたアイテムをどのように見つけますか? このケースをサポートする上で定義された関数の別のバージョンがbatchTableあることが判明しました。

  /** {@inheritDoc} */
  @Override
  public void batch(List<? extends Row> actions, Object[] results)
      throws IOException, InterruptedException {
    LOG.trace("batch(List<>, Object[])");
    try (Scope scope = TRACER.spanBuilder("BigtableTable.batch").startScopedSpan()) {
      addBatchSizeAnnotation(actions);
      getBatchExecutor().batch(actions, results);
    }
  }

および対応する定義は次のBatchExecutorとおりです。

  public void batch(List<? extends Row> actions, @Nullable Object[] results)
      throws IOException, InterruptedException {
    batchCallback(actions, results, null);
  }
  public <R> void batchCallback(
      List<? extends Row> actions, Object[] results, Batch.Callback<R> callback)
      throws IOException, InterruptedException {
    Preconditions.checkArgument(
        results == null || results.length == actions.size(),
        "Result array must have same dimensions as actions list.");
    if (actions.isEmpty()) {
      return;
    }
    if (results == null) {
      results = new Object[actions.size()];
    }
    Timer.Context timerContext = batchTimer.time();
    List<ApiFuture<?>> resultFutures = issueAsyncRowRequests(actions, results, callback);
    // Don't want to throw an exception for failed futures, instead the place in results is
    // set to null.
    List<Throwable> problems = new ArrayList<>();
    List<Row> problemActions = new ArrayList<>();
    List<String> hosts = new ArrayList<>();
    for (int i = 0; i < resultFutures.size(); i++) {
      try {
        resultFutures.get(i).get();
      } catch (ExecutionException e) {
        problemActions.add(actions.get(i));
        problems.add(e.getCause());
        hosts.add(options.getDataHost());
      }
    }
    if (problems.size() > 0) {
      throw new RetriesExhaustedWithDetailsException(problems, problemActions, hosts);
    }
    timerContext.close();
  }

この関数を使用してresults、バッチのサイズを (空の) 配列に渡します。この配列は、結果が入ると埋められます。最終的に、バッチ内のアイテムのいずれかが失敗した場合、詳細を含む例外が発生します。失敗した理由についてですが、それでもresults配列にはすべての項目の結果が含まれています。失敗した項目はnullその配列にあり、残りには実際のResult.

于 2020-01-23T13:38:45.867 に答える