com.google.cloud.storage.JsonResumableSession Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of google-cloud-storage Show documentation
Java idiomatic client for Google Cloud Storage.
There is a newer version: 2.45.0
/*
 * Copyright 2023 Google LLC
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *       http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.google.cloud.storage;

import com.google.api.gax.retrying.ResultRetryAlgorithm;
import com.google.api.services.storage.model.StorageObject;
import com.google.cloud.storage.Conversions.Decoder;
import com.google.cloud.storage.Retrying.RetryingDependencies;
import com.google.cloud.storage.spi.v1.HttpRpcContext;
import com.google.cloud.storage.spi.v1.HttpStorageRpc;
import io.opencensus.trace.EndSpanOptions;
import java.util.concurrent.atomic.AtomicBoolean;
import org.checkerframework.checker.nullness.qual.Nullable;

final class JsonResumableSession {

  static final String SPAN_NAME_WRITE =
      String.format("Sent.%s.write", HttpStorageRpc.class.getName());
  static final EndSpanOptions END_SPAN_OPTIONS =
      EndSpanOptions.builder().setSampleToLocalSpanStore(true).build();

  private final HttpClientContext context;
  private final RetryingDependencies deps;
  private final ResultRetryAlgorithm alg;
  private final JsonResumableWrite resumableWrite;

  JsonResumableSession(
      HttpClientContext context,
      RetryingDependencies deps,
      ResultRetryAlgorithm alg,
      JsonResumableWrite resumableWrite) {
    this.context = context;
    this.deps = deps;
    this.alg = alg;
    this.resumableWrite = resumableWrite;
  }

  /**
   * Not automatically retried. Usually called from within another retrying context. We don't yet
   * have the concept of nested retry handling.
   */
  ResumableOperationResult<@Nullable StorageObject> query() {
    return new JsonResumableSessionQueryTask(context, resumableWrite.getUploadId()).call();
  }

  ResumableOperationResult<@Nullable StorageObject> put(
      RewindableContent content, HttpContentRange contentRange) {
    JsonResumableSessionPutTask task =
        new JsonResumableSessionPutTask(
            context, resumableWrite.getUploadId(), content, contentRange);
    HttpRpcContext httpRpcContext = HttpRpcContext.getInstance();
    httpRpcContext.newInvocationId();
    AtomicBoolean dirty = new AtomicBoolean(false);
    return Retrying.run(
        deps,
        alg,
        () -> {
          if (dirty.getAndSet(true)) {
            ResumableOperationResult<@Nullable StorageObject> query = query();
            long persistedSize = query.getPersistedSize();
            if (contentRange.endOffsetEquals(persistedSize) || query.getObject() != null) {
              return query;
            } else {
              task.rewindTo(persistedSize);
            }
          }
          return task.call();
        },
        Decoder.identity());
  }
}