Class Certificate.Builder

java.lang.Object
com.google.protobuf.AbstractMessageLite.Builder
com.google.protobuf.AbstractMessage.Builder<BuilderT>
com.google.protobuf.GeneratedMessage.Builder<Certificate.Builder>
com.google.cloud.kms.v1.Certificate.Builder
All Implemented Interfaces:
CertificateOrBuilder, com.google.protobuf.Message.Builder, com.google.protobuf.MessageLite.Builder, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, Cloneable
Enclosing class:
Certificate

public static final class Certificate.Builder extends com.google.protobuf.GeneratedMessage.Builder<Certificate.Builder> implements CertificateOrBuilder
 A [Certificate][google.cloud.kms.v1.Certificate] represents an X.509
 certificate used to authenticate HTTPS connections to EKM replicas.
 
Protobuf type google.cloud.kms.v1.Certificate
  • Method Details

    • getDescriptor

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

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

      public Certificate.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.GeneratedMessage.Builder<Certificate.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.GeneratedMessage.Builder<Certificate.Builder>
    • getDefaultInstanceForType

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

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

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

      public Certificate.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<Certificate.Builder>
    • mergeFrom

      public Certificate.Builder mergeFrom(Certificate other)
    • isInitialized

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

      public Certificate.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<Certificate.Builder>
      Throws:
      IOException
    • getRawDer

      public com.google.protobuf.ByteString getRawDer()
       Required. The raw certificate bytes in DER format.
       
      bytes raw_der = 1 [(.google.api.field_behavior) = REQUIRED];
      Specified by:
      getRawDer in interface CertificateOrBuilder
      Returns:
      The rawDer.
    • setRawDer

      public Certificate.Builder setRawDer(com.google.protobuf.ByteString value)
       Required. The raw certificate bytes in DER format.
       
      bytes raw_der = 1 [(.google.api.field_behavior) = REQUIRED];
      Parameters:
      value - The rawDer to set.
      Returns:
      This builder for chaining.
    • clearRawDer

      public Certificate.Builder clearRawDer()
       Required. The raw certificate bytes in DER format.
       
      bytes raw_der = 1 [(.google.api.field_behavior) = REQUIRED];
      Returns:
      This builder for chaining.
    • getParsed

      public boolean getParsed()
       Output only. True if the certificate was parsed successfully.
       
      bool parsed = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      getParsed in interface CertificateOrBuilder
      Returns:
      The parsed.
    • setParsed

      public Certificate.Builder setParsed(boolean value)
       Output only. True if the certificate was parsed successfully.
       
      bool parsed = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Parameters:
      value - The parsed to set.
      Returns:
      This builder for chaining.
    • clearParsed

      public Certificate.Builder clearParsed()
       Output only. True if the certificate was parsed successfully.
       
      bool parsed = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Returns:
      This builder for chaining.
    • getIssuer

      public String getIssuer()
       Output only. The issuer distinguished name in RFC 2253 format. Only present
       if [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string issuer = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      getIssuer in interface CertificateOrBuilder
      Returns:
      The issuer.
    • getIssuerBytes

      public com.google.protobuf.ByteString getIssuerBytes()
       Output only. The issuer distinguished name in RFC 2253 format. Only present
       if [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string issuer = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      getIssuerBytes in interface CertificateOrBuilder
      Returns:
      The bytes for issuer.
    • setIssuer

      public Certificate.Builder setIssuer(String value)
       Output only. The issuer distinguished name in RFC 2253 format. Only present
       if [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string issuer = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Parameters:
      value - The issuer to set.
      Returns:
      This builder for chaining.
    • clearIssuer

      public Certificate.Builder clearIssuer()
       Output only. The issuer distinguished name in RFC 2253 format. Only present
       if [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string issuer = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Returns:
      This builder for chaining.
    • setIssuerBytes

      public Certificate.Builder setIssuerBytes(com.google.protobuf.ByteString value)
       Output only. The issuer distinguished name in RFC 2253 format. Only present
       if [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string issuer = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Parameters:
      value - The bytes for issuer to set.
      Returns:
      This builder for chaining.
    • getSubject

      public String getSubject()
       Output only. The subject distinguished name in RFC 2253 format. Only
       present if [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string subject = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      getSubject in interface CertificateOrBuilder
      Returns:
      The subject.
    • getSubjectBytes

      public com.google.protobuf.ByteString getSubjectBytes()
       Output only. The subject distinguished name in RFC 2253 format. Only
       present if [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string subject = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      getSubjectBytes in interface CertificateOrBuilder
      Returns:
      The bytes for subject.
    • setSubject

      public Certificate.Builder setSubject(String value)
       Output only. The subject distinguished name in RFC 2253 format. Only
       present if [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string subject = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Parameters:
      value - The subject to set.
      Returns:
      This builder for chaining.
    • clearSubject

      public Certificate.Builder clearSubject()
       Output only. The subject distinguished name in RFC 2253 format. Only
       present if [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string subject = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Returns:
      This builder for chaining.
    • setSubjectBytes

      public Certificate.Builder setSubjectBytes(com.google.protobuf.ByteString value)
       Output only. The subject distinguished name in RFC 2253 format. Only
       present if [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string subject = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Parameters:
      value - The bytes for subject to set.
      Returns:
      This builder for chaining.
    • getSubjectAlternativeDnsNamesList

      public com.google.protobuf.ProtocolStringList getSubjectAlternativeDnsNamesList()
       Output only. The subject Alternative DNS names. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      repeated string subject_alternative_dns_names = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      getSubjectAlternativeDnsNamesList in interface CertificateOrBuilder
      Returns:
      A list containing the subjectAlternativeDnsNames.
    • getSubjectAlternativeDnsNamesCount

      public int getSubjectAlternativeDnsNamesCount()
       Output only. The subject Alternative DNS names. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      repeated string subject_alternative_dns_names = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      getSubjectAlternativeDnsNamesCount in interface CertificateOrBuilder
      Returns:
      The count of subjectAlternativeDnsNames.
    • getSubjectAlternativeDnsNames

      public String getSubjectAlternativeDnsNames(int index)
       Output only. The subject Alternative DNS names. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      repeated string subject_alternative_dns_names = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      getSubjectAlternativeDnsNames in interface CertificateOrBuilder
      Parameters:
      index - The index of the element to return.
      Returns:
      The subjectAlternativeDnsNames at the given index.
    • getSubjectAlternativeDnsNamesBytes

      public com.google.protobuf.ByteString getSubjectAlternativeDnsNamesBytes(int index)
       Output only. The subject Alternative DNS names. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      repeated string subject_alternative_dns_names = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      getSubjectAlternativeDnsNamesBytes in interface CertificateOrBuilder
      Parameters:
      index - The index of the value to return.
      Returns:
      The bytes of the subjectAlternativeDnsNames at the given index.
    • setSubjectAlternativeDnsNames

      public Certificate.Builder setSubjectAlternativeDnsNames(int index, String value)
       Output only. The subject Alternative DNS names. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      repeated string subject_alternative_dns_names = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Parameters:
      index - The index to set the value at.
      value - The subjectAlternativeDnsNames to set.
      Returns:
      This builder for chaining.
    • addSubjectAlternativeDnsNames

      public Certificate.Builder addSubjectAlternativeDnsNames(String value)
       Output only. The subject Alternative DNS names. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      repeated string subject_alternative_dns_names = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Parameters:
      value - The subjectAlternativeDnsNames to add.
      Returns:
      This builder for chaining.
    • addAllSubjectAlternativeDnsNames

      public Certificate.Builder addAllSubjectAlternativeDnsNames(Iterable<String> values)
       Output only. The subject Alternative DNS names. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      repeated string subject_alternative_dns_names = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Parameters:
      values - The subjectAlternativeDnsNames to add.
      Returns:
      This builder for chaining.
    • clearSubjectAlternativeDnsNames

      public Certificate.Builder clearSubjectAlternativeDnsNames()
       Output only. The subject Alternative DNS names. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      repeated string subject_alternative_dns_names = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Returns:
      This builder for chaining.
    • addSubjectAlternativeDnsNamesBytes

      public Certificate.Builder addSubjectAlternativeDnsNamesBytes(com.google.protobuf.ByteString value)
       Output only. The subject Alternative DNS names. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      repeated string subject_alternative_dns_names = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Parameters:
      value - The bytes of the subjectAlternativeDnsNames to add.
      Returns:
      This builder for chaining.
    • hasNotBeforeTime

      public boolean hasNotBeforeTime()
       Output only. The certificate is not valid before this time. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      .google.protobuf.Timestamp not_before_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      hasNotBeforeTime in interface CertificateOrBuilder
      Returns:
      Whether the notBeforeTime field is set.
    • getNotBeforeTime

      public com.google.protobuf.Timestamp getNotBeforeTime()
       Output only. The certificate is not valid before this time. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      .google.protobuf.Timestamp not_before_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      getNotBeforeTime in interface CertificateOrBuilder
      Returns:
      The notBeforeTime.
    • setNotBeforeTime

      public Certificate.Builder setNotBeforeTime(com.google.protobuf.Timestamp value)
       Output only. The certificate is not valid before this time. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      .google.protobuf.Timestamp not_before_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
    • setNotBeforeTime

      public Certificate.Builder setNotBeforeTime(com.google.protobuf.Timestamp.Builder builderForValue)
       Output only. The certificate is not valid before this time. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      .google.protobuf.Timestamp not_before_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
    • mergeNotBeforeTime

      public Certificate.Builder mergeNotBeforeTime(com.google.protobuf.Timestamp value)
       Output only. The certificate is not valid before this time. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      .google.protobuf.Timestamp not_before_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
    • clearNotBeforeTime

      public Certificate.Builder clearNotBeforeTime()
       Output only. The certificate is not valid before this time. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      .google.protobuf.Timestamp not_before_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
    • getNotBeforeTimeBuilder

      public com.google.protobuf.Timestamp.Builder getNotBeforeTimeBuilder()
       Output only. The certificate is not valid before this time. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      .google.protobuf.Timestamp not_before_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
    • getNotBeforeTimeOrBuilder

      public com.google.protobuf.TimestampOrBuilder getNotBeforeTimeOrBuilder()
       Output only. The certificate is not valid before this time. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      .google.protobuf.Timestamp not_before_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      getNotBeforeTimeOrBuilder in interface CertificateOrBuilder
    • hasNotAfterTime

      public boolean hasNotAfterTime()
       Output only. The certificate is not valid after this time. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      .google.protobuf.Timestamp not_after_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      hasNotAfterTime in interface CertificateOrBuilder
      Returns:
      Whether the notAfterTime field is set.
    • getNotAfterTime

      public com.google.protobuf.Timestamp getNotAfterTime()
       Output only. The certificate is not valid after this time. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      .google.protobuf.Timestamp not_after_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      getNotAfterTime in interface CertificateOrBuilder
      Returns:
      The notAfterTime.
    • setNotAfterTime

      public Certificate.Builder setNotAfterTime(com.google.protobuf.Timestamp value)
       Output only. The certificate is not valid after this time. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      .google.protobuf.Timestamp not_after_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
    • setNotAfterTime

      public Certificate.Builder setNotAfterTime(com.google.protobuf.Timestamp.Builder builderForValue)
       Output only. The certificate is not valid after this time. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      .google.protobuf.Timestamp not_after_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
    • mergeNotAfterTime

      public Certificate.Builder mergeNotAfterTime(com.google.protobuf.Timestamp value)
       Output only. The certificate is not valid after this time. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      .google.protobuf.Timestamp not_after_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
    • clearNotAfterTime

      public Certificate.Builder clearNotAfterTime()
       Output only. The certificate is not valid after this time. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      .google.protobuf.Timestamp not_after_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
    • getNotAfterTimeBuilder

      public com.google.protobuf.Timestamp.Builder getNotAfterTimeBuilder()
       Output only. The certificate is not valid after this time. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      .google.protobuf.Timestamp not_after_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
    • getNotAfterTimeOrBuilder

      public com.google.protobuf.TimestampOrBuilder getNotAfterTimeOrBuilder()
       Output only. The certificate is not valid after this time. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      .google.protobuf.Timestamp not_after_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      getNotAfterTimeOrBuilder in interface CertificateOrBuilder
    • getSerialNumber

      public String getSerialNumber()
       Output only. The certificate serial number as a hex string. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string serial_number = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      getSerialNumber in interface CertificateOrBuilder
      Returns:
      The serialNumber.
    • getSerialNumberBytes

      public com.google.protobuf.ByteString getSerialNumberBytes()
       Output only. The certificate serial number as a hex string. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string serial_number = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      getSerialNumberBytes in interface CertificateOrBuilder
      Returns:
      The bytes for serialNumber.
    • setSerialNumber

      public Certificate.Builder setSerialNumber(String value)
       Output only. The certificate serial number as a hex string. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string serial_number = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Parameters:
      value - The serialNumber to set.
      Returns:
      This builder for chaining.
    • clearSerialNumber

      public Certificate.Builder clearSerialNumber()
       Output only. The certificate serial number as a hex string. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string serial_number = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Returns:
      This builder for chaining.
    • setSerialNumberBytes

      public Certificate.Builder setSerialNumberBytes(com.google.protobuf.ByteString value)
       Output only. The certificate serial number as a hex string. Only present if
       [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string serial_number = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Parameters:
      value - The bytes for serialNumber to set.
      Returns:
      This builder for chaining.
    • getSha256Fingerprint

      public String getSha256Fingerprint()
       Output only. The SHA-256 certificate fingerprint as a hex string. Only
       present if [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string sha256_fingerprint = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      getSha256Fingerprint in interface CertificateOrBuilder
      Returns:
      The sha256Fingerprint.
    • getSha256FingerprintBytes

      public com.google.protobuf.ByteString getSha256FingerprintBytes()
       Output only. The SHA-256 certificate fingerprint as a hex string. Only
       present if [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string sha256_fingerprint = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Specified by:
      getSha256FingerprintBytes in interface CertificateOrBuilder
      Returns:
      The bytes for sha256Fingerprint.
    • setSha256Fingerprint

      public Certificate.Builder setSha256Fingerprint(String value)
       Output only. The SHA-256 certificate fingerprint as a hex string. Only
       present if [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string sha256_fingerprint = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Parameters:
      value - The sha256Fingerprint to set.
      Returns:
      This builder for chaining.
    • clearSha256Fingerprint

      public Certificate.Builder clearSha256Fingerprint()
       Output only. The SHA-256 certificate fingerprint as a hex string. Only
       present if [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string sha256_fingerprint = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Returns:
      This builder for chaining.
    • setSha256FingerprintBytes

      public Certificate.Builder setSha256FingerprintBytes(com.google.protobuf.ByteString value)
       Output only. The SHA-256 certificate fingerprint as a hex string. Only
       present if [parsed][google.cloud.kms.v1.Certificate.parsed] is true.
       
      string sha256_fingerprint = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
      Parameters:
      value - The bytes for sha256Fingerprint to set.
      Returns:
      This builder for chaining.