Class 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 Detail

      • getDescriptor

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

        protected com.google.protobuf.MapField internalGetMapField​(int number)
        Overrides:
        internalGetMapField in class com.google.protobuf.GeneratedMessageV3.Builder<Snapshot.Builder>
      • internalGetMutableMapField

        protected com.google.protobuf.MapField internalGetMutableMapField​(int number)
        Overrides:
        internalGetMutableMapField 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>
      • 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()
         The name of the snapshot.
         
        string name = 1;
        Specified by:
        getName in interface SnapshotOrBuilder
        Returns:
        The name.
      • getNameBytes

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

        public Snapshot.Builder setName​(String value)
         The name of the snapshot.
         
        string name = 1;
        Parameters:
        value - The name to set.
        Returns:
        This builder for chaining.
      • clearName

        public Snapshot.Builder clearName()
         The name of the snapshot.
         
        string name = 1;
        Returns:
        This builder for chaining.
      • setNameBytes

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

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

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

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

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

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

        public boolean hasExpireTime()
         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;
        Specified by:
        hasExpireTime in interface SnapshotOrBuilder
        Returns:
        Whether the expireTime field is set.
      • getExpireTime

        public com.google.protobuf.Timestamp getExpireTime()
         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;
        Specified by:
        getExpireTime in interface SnapshotOrBuilder
        Returns:
        The expireTime.
      • setExpireTime

        public Snapshot.Builder setExpireTime​(com.google.protobuf.Timestamp value)
         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;
      • setExpireTime

        public Snapshot.Builder setExpireTime​(com.google.protobuf.Timestamp.Builder builderForValue)
         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;
      • mergeExpireTime

        public Snapshot.Builder mergeExpireTime​(com.google.protobuf.Timestamp value)
         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;
      • clearExpireTime

        public Snapshot.Builder clearExpireTime()
         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;
      • getExpireTimeBuilder

        public com.google.protobuf.Timestamp.Builder getExpireTimeBuilder()
         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;
      • getExpireTimeOrBuilder

        public com.google.protobuf.TimestampOrBuilder getExpireTimeOrBuilder()
         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;
        Specified by:
        getExpireTimeOrBuilder in interface SnapshotOrBuilder
      • getLabelsCount

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

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

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

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

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

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

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

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

        public Snapshot.Builder putAllLabels​(Map<String,​String> values)
         See [Creating and managing labels]
         (https://cloud.google.com/pubsub/docs/labels).
         
        map<string, string> labels = 4;
      • 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>