Class TransportRequest.Builder

java.lang.Object
codes.grow.packages.betterstack.core.TransportRequest.Builder
Enclosing class:
TransportRequest

public static final class TransportRequest.Builder extends Object
Builder for TransportRequest.
  • Method Details

    • query

      public TransportRequest.Builder query(String name, Object value)
      Adds a query parameter (repeatable).
      Parameters:
      name - parameter name
      value - parameter value; null values are skipped
      Returns:
      this builder
    • header

      public TransportRequest.Builder header(String name, String value)
      Sets a header.
      Parameters:
      name - header name
      value - header value
      Returns:
      this builder
    • body

      public TransportRequest.Builder body(byte[] body, String contentType)
      Sets a raw body.
      Parameters:
      body - bytes
      contentType - media type
      Returns:
      this builder
    • json

      public TransportRequest.Builder json(Object value)
      Sets a JSON body encoded with Jackson.
      Parameters:
      value - any serialisable value
      Returns:
      this builder
    • idempotent

      public TransportRequest.Builder idempotent(boolean idempotent)
      Marks the request idempotent (or not), overriding the method default.
      Parameters:
      idempotent - flag
      Returns:
      this builder
    • operation

      public TransportRequest.Builder operation(String operation)
      Sets the operation name used in error messages.
      Parameters:
      operation - e.g. kv.read secret/app
      Returns:
      this builder
    • acceptStatus

      public TransportRequest.Builder acceptStatus(int... statuses)
      Returns these statuses to the caller instead of raising an error (no retries for them).
      Parameters:
      statuses - HTTP statuses, e.g. 404
      Returns:
      this builder
    • acceptAnyStatus

      public TransportRequest.Builder acceptAnyStatus()
      Returns every status to the caller (health probes); no status is retried.
      Returns:
      this builder
    • maxRetries

      public TransportRequest.Builder maxRetries(int maxRetries)
      Overrides the retry limit for this call.
      Parameters:
      maxRetries - retries, >= 0
      Returns:
      this builder
    • timeout

      public TransportRequest.Builder timeout(Duration timeout)
      Overrides the per-attempt timeout for this call.
      Parameters:
      timeout - positive duration
      Returns:
      this builder
    • build

      public TransportRequest build()
      Builds the request.
      Returns:
      the request