Class Snapshot.Builder

java.lang.Object
com.google.protobuf.AbstractMessageLite.Builder
com.google.protobuf.AbstractMessage.Builder<BuilderT>
com.google.protobuf.GeneratedMessageV3.Builder<Snapshot.Builder>
com.google.pubsub.v1.Snapshot.Builder
All Implemented Interfaces:
com.google.protobuf.Message.Builder, com.google.protobuf.MessageLite.Builder, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, SnapshotOrBuilder, Cloneable
Enclosing class:
Snapshot

public static final class Snapshot.Builder extends com.google.protobuf.GeneratedMessageV3.Builder<Snapshot.Builder> implements SnapshotOrBuilder
 A snapshot resource. Snapshots are used in
 [Seek](https://cloud.google.com/pubsub/docs/replay-overview)
 operations, which allow you to manage message acknowledgments in bulk. That
 is, you can set the acknowledgment state of messages in an existing
 subscription to the state captured by a snapshot.
 
Protobuf type google.pubsub.v1.Snapshot
  • Method Details

    • getDescriptor

      public static final com.google.protobuf.Descriptors.Descriptor getDescriptor()
    • internalGetMapFieldReflection

      protected com.google.protobuf.MapFieldReflectionAccessor internalGetMapFieldReflection(int number)
      Overrides:
      internalGetMapFieldReflection in class com.google.protobuf.GeneratedMessageV3.Builder<Snapshot.Builder>
    • internalGetMutableMapFieldReflection

      protected com.google.protobuf.MapFieldReflectionAccessor internalGetMutableMapFieldReflection(int number)
      Overrides:
      internalGetMutableMapFieldReflection in class com.google.protobuf.GeneratedMessageV3.Builder<Snapshot.Builder>
    • internalGetFieldAccessorTable

      protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
      Specified by:
      internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessageV3.Builder<Snapshot.Builder>
    • clear

      public Snapshot.Builder clear()
      Specified by:
      clear in interface com.google.protobuf.Message.Builder
      Specified by:
      clear in interface com.google.protobuf.MessageLite.Builder
      Overrides:
      clear in class com.google.protobuf.GeneratedMessageV3.Builder<Snapshot.Builder>
    • getDescriptorForType

      public com.google.protobuf.Descriptors.Descriptor getDescriptorForType()
      Specified by:
      getDescriptorForType in interface com.google.protobuf.Message.Builder
      Specified by:
      getDescriptorForType in interface com.google.protobuf.MessageOrBuilder
      Overrides:
      getDescriptorForType in class com.google.protobuf.GeneratedMessageV3.Builder<Snapshot.Builder>
    • getDefaultInstanceForType

      public Snapshot getDefaultInstanceForType()
      Specified by:
      getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuilder
      Specified by:
      getDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilder
    • build

      public Snapshot build()
      Specified by:
      build in interface com.google.protobuf.Message.Builder
      Specified by:
      build in interface com.google.protobuf.MessageLite.Builder
    • buildPartial

      public Snapshot buildPartial()
      Specified by:
      buildPartial in interface com.google.protobuf.Message.Builder
      Specified by:
      buildPartial in interface com.google.protobuf.MessageLite.Builder
    • clone

      public Snapshot.Builder clone()
      Specified by:
      clone in interface com.google.protobuf.Message.Builder
      Specified by:
      clone in interface com.google.protobuf.MessageLite.Builder
      Overrides:
      clone in class com.google.protobuf.GeneratedMessageV3.Builder<Snapshot.Builder>
    • setField

      public Snapshot.Builder setField(com.google.protobuf.Descriptors.FieldDescriptor field, Object value)
      Specified by:
      setField in interface com.google.protobuf.Message.Builder
      Overrides:
      setField in class com.google.protobuf.GeneratedMessageV3.Builder<Snapshot.Builder>
    • clearField

      public Snapshot.Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field)
      Specified by:
      clearField in interface com.google.protobuf.Message.Builder
      Overrides:
      clearField in class com.google.protobuf.GeneratedMessageV3.Builder<Snapshot.Builder>
    • clearOneof

      public Snapshot.Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof)
      Specified by:
      clearOneof in interface com.google.protobuf.Message.Builder
      Overrides:
      clearOneof in class com.google.protobuf.GeneratedMessageV3.Builder<Snapshot.Builder>
    • setRepeatedField

      public Snapshot.Builder setRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field, int index, Object value)
      Specified by:
      setRepeatedField in interface com.google.protobuf.Message.Builder
      Overrides:
      setRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<Snapshot.Builder>
    • addRepeatedField

      public Snapshot.Builder addRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field, Object value)
      Specified by:
      addRepeatedField in interface com.google.protobuf.Message.Builder
      Overrides:
      addRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<Snapshot.Builder>
    • mergeFrom

      public Snapshot.Builder mergeFrom(com.google.protobuf.Message other)
      Specified by:
      mergeFrom in interface com.google.protobuf.Message.Builder
      Overrides:
      mergeFrom in class com.google.protobuf.AbstractMessage.Builder<Snapshot.Builder>
    • mergeFrom

      public Snapshot.Builder mergeFrom(Snapshot other)
    • isInitialized

      public final boolean isInitialized()
      Specified by:
      isInitialized in interface com.google.protobuf.MessageLiteOrBuilder
      Overrides:
      isInitialized in class com.google.protobuf.GeneratedMessageV3.Builder<Snapshot.Builder>
    • mergeFrom

      public Snapshot.Builder mergeFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Specified by:
      mergeFrom in interface com.google.protobuf.Message.Builder
      Specified by:
      mergeFrom in interface com.google.protobuf.MessageLite.Builder
      Overrides:
      mergeFrom in class com.google.protobuf.AbstractMessage.Builder<Snapshot.Builder>
      Throws:
      IOException
    • getName

      public String getName()
       Optional. The name of the snapshot.
       
      string name = 1 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getName in interface SnapshotOrBuilder
      Returns:
      The name.
    • getNameBytes

      public com.google.protobuf.ByteString getNameBytes()
       Optional. The name of the snapshot.
       
      string name = 1 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getNameBytes in interface SnapshotOrBuilder
      Returns:
      The bytes for name.
    • setName

      public Snapshot.Builder setName(String value)
       Optional. The name of the snapshot.
       
      string name = 1 [(.google.api.field_behavior) = OPTIONAL];
      Parameters:
      value - The name to set.
      Returns:
      This builder for chaining.
    • clearName

      public Snapshot.Builder clearName()
       Optional. The name of the snapshot.
       
      string name = 1 [(.google.api.field_behavior) = OPTIONAL];
      Returns:
      This builder for chaining.
    • setNameBytes

      public Snapshot.Builder setNameBytes(com.google.protobuf.ByteString value)
       Optional. The name of the snapshot.
       
      string name = 1 [(.google.api.field_behavior) = OPTIONAL];
      Parameters:
      value - The bytes for name to set.
      Returns:
      This builder for chaining.
    • getTopic

      public String getTopic()
       Optional. The name of the topic from which this snapshot is retaining
       messages.
       
      string topic = 2 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
      Specified by:
      getTopic in interface SnapshotOrBuilder
      Returns:
      The topic.
    • getTopicBytes

      public com.google.protobuf.ByteString getTopicBytes()
       Optional. The name of the topic from which this snapshot is retaining
       messages.
       
      string topic = 2 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
      Specified by:
      getTopicBytes in interface SnapshotOrBuilder
      Returns:
      The bytes for topic.
    • setTopic

      public Snapshot.Builder setTopic(String value)
       Optional. The name of the topic from which this snapshot is retaining
       messages.
       
      string topic = 2 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
      Parameters:
      value - The topic to set.
      Returns:
      This builder for chaining.
    • clearTopic

      public Snapshot.Builder clearTopic()
       Optional. The name of the topic from which this snapshot is retaining
       messages.
       
      string topic = 2 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
      Returns:
      This builder for chaining.
    • setTopicBytes

      public Snapshot.Builder setTopicBytes(com.google.protobuf.ByteString value)
       Optional. The name of the topic from which this snapshot is retaining
       messages.
       
      string topic = 2 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
      Parameters:
      value - The bytes for topic to set.
      Returns:
      This builder for chaining.
    • hasExpireTime

      public boolean hasExpireTime()
       Optional. The snapshot is guaranteed to exist up until this time.
       A newly-created snapshot expires no later than 7 days from the time of its
       creation. Its exact lifetime is determined at creation by the existing
       backlog in the source subscription. Specifically, the lifetime of the
       snapshot is `7 days - (age of oldest unacked message in the subscription)`.
       For example, consider a subscription whose oldest unacked message is 3 days
       old. If a snapshot is created from this subscription, the snapshot -- which
       will always capture this 3-day-old backlog as long as the snapshot
       exists -- will expire in 4 days. The service will refuse to create a
       snapshot that would expire in less than 1 hour after creation.
       
      .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      hasExpireTime in interface SnapshotOrBuilder
      Returns:
      Whether the expireTime field is set.
    • getExpireTime

      public com.google.protobuf.Timestamp getExpireTime()
       Optional. The snapshot is guaranteed to exist up until this time.
       A newly-created snapshot expires no later than 7 days from the time of its
       creation. Its exact lifetime is determined at creation by the existing
       backlog in the source subscription. Specifically, the lifetime of the
       snapshot is `7 days - (age of oldest unacked message in the subscription)`.
       For example, consider a subscription whose oldest unacked message is 3 days
       old. If a snapshot is created from this subscription, the snapshot -- which
       will always capture this 3-day-old backlog as long as the snapshot
       exists -- will expire in 4 days. The service will refuse to create a
       snapshot that would expire in less than 1 hour after creation.
       
      .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getExpireTime in interface SnapshotOrBuilder
      Returns:
      The expireTime.
    • setExpireTime

      public Snapshot.Builder setExpireTime(com.google.protobuf.Timestamp value)
       Optional. The snapshot is guaranteed to exist up until this time.
       A newly-created snapshot expires no later than 7 days from the time of its
       creation. Its exact lifetime is determined at creation by the existing
       backlog in the source subscription. Specifically, the lifetime of the
       snapshot is `7 days - (age of oldest unacked message in the subscription)`.
       For example, consider a subscription whose oldest unacked message is 3 days
       old. If a snapshot is created from this subscription, the snapshot -- which
       will always capture this 3-day-old backlog as long as the snapshot
       exists -- will expire in 4 days. The service will refuse to create a
       snapshot that would expire in less than 1 hour after creation.
       
      .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
    • setExpireTime

      public Snapshot.Builder setExpireTime(com.google.protobuf.Timestamp.Builder builderForValue)
       Optional. The snapshot is guaranteed to exist up until this time.
       A newly-created snapshot expires no later than 7 days from the time of its
       creation. Its exact lifetime is determined at creation by the existing
       backlog in the source subscription. Specifically, the lifetime of the
       snapshot is `7 days - (age of oldest unacked message in the subscription)`.
       For example, consider a subscription whose oldest unacked message is 3 days
       old. If a snapshot is created from this subscription, the snapshot -- which
       will always capture this 3-day-old backlog as long as the snapshot
       exists -- will expire in 4 days. The service will refuse to create a
       snapshot that would expire in less than 1 hour after creation.
       
      .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
    • mergeExpireTime

      public Snapshot.Builder mergeExpireTime(com.google.protobuf.Timestamp value)
       Optional. The snapshot is guaranteed to exist up until this time.
       A newly-created snapshot expires no later than 7 days from the time of its
       creation. Its exact lifetime is determined at creation by the existing
       backlog in the source subscription. Specifically, the lifetime of the
       snapshot is `7 days - (age of oldest unacked message in the subscription)`.
       For example, consider a subscription whose oldest unacked message is 3 days
       old. If a snapshot is created from this subscription, the snapshot -- which
       will always capture this 3-day-old backlog as long as the snapshot
       exists -- will expire in 4 days. The service will refuse to create a
       snapshot that would expire in less than 1 hour after creation.
       
      .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
    • clearExpireTime

      public Snapshot.Builder clearExpireTime()
       Optional. The snapshot is guaranteed to exist up until this time.
       A newly-created snapshot expires no later than 7 days from the time of its
       creation. Its exact lifetime is determined at creation by the existing
       backlog in the source subscription. Specifically, the lifetime of the
       snapshot is `7 days - (age of oldest unacked message in the subscription)`.
       For example, consider a subscription whose oldest unacked message is 3 days
       old. If a snapshot is created from this subscription, the snapshot -- which
       will always capture this 3-day-old backlog as long as the snapshot
       exists -- will expire in 4 days. The service will refuse to create a
       snapshot that would expire in less than 1 hour after creation.
       
      .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
    • getExpireTimeBuilder

      public com.google.protobuf.Timestamp.Builder getExpireTimeBuilder()
       Optional. The snapshot is guaranteed to exist up until this time.
       A newly-created snapshot expires no later than 7 days from the time of its
       creation. Its exact lifetime is determined at creation by the existing
       backlog in the source subscription. Specifically, the lifetime of the
       snapshot is `7 days - (age of oldest unacked message in the subscription)`.
       For example, consider a subscription whose oldest unacked message is 3 days
       old. If a snapshot is created from this subscription, the snapshot -- which
       will always capture this 3-day-old backlog as long as the snapshot
       exists -- will expire in 4 days. The service will refuse to create a
       snapshot that would expire in less than 1 hour after creation.
       
      .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
    • getExpireTimeOrBuilder

      public com.google.protobuf.TimestampOrBuilder getExpireTimeOrBuilder()
       Optional. The snapshot is guaranteed to exist up until this time.
       A newly-created snapshot expires no later than 7 days from the time of its
       creation. Its exact lifetime is determined at creation by the existing
       backlog in the source subscription. Specifically, the lifetime of the
       snapshot is `7 days - (age of oldest unacked message in the subscription)`.
       For example, consider a subscription whose oldest unacked message is 3 days
       old. If a snapshot is created from this subscription, the snapshot -- which
       will always capture this 3-day-old backlog as long as the snapshot
       exists -- will expire in 4 days. The service will refuse to create a
       snapshot that would expire in less than 1 hour after creation.
       
      .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getExpireTimeOrBuilder in interface SnapshotOrBuilder
    • getLabelsCount

      public int getLabelsCount()
      Description copied from interface: SnapshotOrBuilder
       Optional. See [Creating and managing labels]
       (https://cloud.google.com/pubsub/docs/labels).
       
      map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getLabelsCount in interface SnapshotOrBuilder
    • containsLabels

      public boolean containsLabels(String key)
       Optional. See [Creating and managing labels]
       (https://cloud.google.com/pubsub/docs/labels).
       
      map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      containsLabels in interface SnapshotOrBuilder
    • getLabels

      @Deprecated public Map<String,String> getLabels()
      Deprecated.
      Use getLabelsMap() instead.
      Specified by:
      getLabels in interface SnapshotOrBuilder
    • getLabelsMap

      public Map<String,String> getLabelsMap()
       Optional. See [Creating and managing labels]
       (https://cloud.google.com/pubsub/docs/labels).
       
      map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getLabelsMap in interface SnapshotOrBuilder
    • getLabelsOrDefault

      public String getLabelsOrDefault(String key, String defaultValue)
       Optional. See [Creating and managing labels]
       (https://cloud.google.com/pubsub/docs/labels).
       
      map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getLabelsOrDefault in interface SnapshotOrBuilder
    • getLabelsOrThrow

      public String getLabelsOrThrow(String key)
       Optional. See [Creating and managing labels]
       (https://cloud.google.com/pubsub/docs/labels).
       
      map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getLabelsOrThrow in interface SnapshotOrBuilder
    • clearLabels

      public Snapshot.Builder clearLabels()
    • removeLabels

      public Snapshot.Builder removeLabels(String key)
       Optional. See [Creating and managing labels]
       (https://cloud.google.com/pubsub/docs/labels).
       
      map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
    • getMutableLabels

      @Deprecated public Map<String,String> getMutableLabels()
      Deprecated.
      Use alternate mutation accessors instead.
    • putLabels

      public Snapshot.Builder putLabels(String key, String value)
       Optional. See [Creating and managing labels]
       (https://cloud.google.com/pubsub/docs/labels).
       
      map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
    • putAllLabels

      public Snapshot.Builder putAllLabels(Map<String,String> values)
       Optional. See [Creating and managing labels]
       (https://cloud.google.com/pubsub/docs/labels).
       
      map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
    • setUnknownFields

      public final Snapshot.Builder setUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
      Specified by:
      setUnknownFields in interface com.google.protobuf.Message.Builder
      Overrides:
      setUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<Snapshot.Builder>
    • mergeUnknownFields

      public final Snapshot.Builder mergeUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
      Specified by:
      mergeUnknownFields in interface com.google.protobuf.Message.Builder
      Overrides:
      mergeUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<Snapshot.Builder>