Class: Couchbase::Options::Replace

Inherits:
Base
  • Object
show all
Defined in:
lib/couchbase/options.rb,
/home/runner/work/couchbase-ruby-client/couchbase-ruby-client/lib/couchbase/options.rb

Overview

Options for Collection#replace

Instance Attribute Summary collapse

Attributes inherited from Base

#client_context, #parent_span, #retry_strategy, #timeout

Instance Method Summary collapse

Constructor Details

#initialize(expiry: nil, preserve_expiry: false, transcoder: JsonTranscoder.new, cas: nil, durability_level: :none, replicate_to: :none, persist_to: :none, timeout: nil, retry_strategy: nil, client_context: nil, parent_span: nil) {|| ... } ⇒ Replace

Creates an instance of options for Collection#replace

Parameters:

  • expiry (Integer, #in_seconds, nil) (defaults to: nil) —

    expiration time to associate with the document

  • preserve_expiry (Boolean) (defaults to: false) —

    if true and the document exists, the server will preserve current expiration for the document, otherwise will use #expiry from the operation.

  • transcoder (JsonTranscoder, #encode(Object)) (defaults to: JsonTranscoder.new) —

    used for encoding

  • cas (Integer, nil) (defaults to: nil) —

    a CAS value that will be taken into account on the server side for optimistic concurrency

  • durability_level (Symbol) (defaults to: :none) —

    level of durability :none::

    no enhanced durability required for the mutation

    :majority::

    the mutation must be replicated to a majority of the Data Service nodes
(that is, held in the memory allocated to the bucket)

    :majority_and_persist_to_active::

    The mutation must be replicated to a majority of the Data Service nodes.
Additionally, it must be persisted (that is, written and synchronised to disk) on the
node hosting the active partition (vBucket) for the data.

    :persist_to_majority::

    The mutation must be persisted to a majority of the Data Service nodes.
Accordingly, it will be written to disk on those nodes.
  • replicate_to (Symbol) (defaults to: :none) —

    number of nodes to replicate :none:: do not apply any replication requirements. :one:: wait for replication to at least one node. :two:: wait for replication to at least two nodes. :three:: wait for replication to at least three nodes.

  • persist_to (Symbol) (defaults to: :none) —

    number of nodes to persist :none:: do not apply any persistence requirements. :active:: wait for persistence to active node :one:: wait for persistence to at least one node. :two:: wait for persistence to at least two nodes. :three:: wait for persistence to at least three nodes. :four:: wait for persistence to four nodes (active and replicas).

  • timeout (Integer, #in_milliseconds, nil) (defaults to: nil)
  • retry_strategy (Symbol, nil) (defaults to: nil) —

    :best_effort or :fail_fast; the cluster's default when nil

  • client_context (Hash, nil) (defaults to: nil) —

    the client context data, if set

  • parent_span (Span, nil) (defaults to: nil) —

    if set holds the parent span, that should be used for this request

Yield Parameters:



900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
 
# File 'lib/couchbase/options.rb', line 900

def initialize(expiry: nil,
               preserve_expiry: false,
               transcoder: JsonTranscoder.new,
               cas: nil,
               durability_level: :none,
               replicate_to: :none,
               persist_to: :none,
               timeout: nil,
               retry_strategy: nil,
               client_context: nil,
               parent_span: nil)
  super(timeout: timeout, retry_strategy: retry_strategy, client_context: client_context, parent_span: parent_span)
  @expiry = expiry
  @preserve_expiry = preserve_expiry
  @transcoder = transcoder
  @cas = cas
  if durability_level != :none && (replicate_to != :none || persist_to != :none)
    raise ArgumentError, "durability_level conflicts with replicate_to and persist_to options"
  end

  @persist_to = persist_to
  @replicate_to = replicate_to
  @durability_level = durability_level
  yield self if block_given?
end

Instance Attribute Details

#cas ⇒ Integer?

Returns:

  • (Integer, nil) 


857
858
859
 
# File 'lib/couchbase/options.rb', line 857

def cas
  @cas
end

#durability_level ⇒ Symbol

Returns:

  • (Symbol) 


858
859
860
 
# File 'lib/couchbase/options.rb', line 858

def durability_level
  @durability_level
end

#expiry ⇒ Integer, ...

Returns:

  • (Integer, #in_seconds, nil) 


855
856
857
 
# File 'lib/couchbase/options.rb', line 855

def expiry
  @expiry
end

#preserve_expiry ⇒ Boolean

Returns:

  • (Boolean) 


859
860
861
 
# File 'lib/couchbase/options.rb', line 859

def preserve_expiry
  @preserve_expiry
end

#transcoder ⇒ JsonTranscoder, #encode(Object)

Returns:



856
857
858
 
# File 'lib/couchbase/options.rb', line 856

def transcoder
  @transcoder
end

Instance Method Details

#to_backend ⇒ Object 



926
927
928
929
930
931
932
933
934
935
936
937
 
# File 'lib/couchbase/options.rb', line 926

def to_backend
  {
    timeout: Utils::Time.extract_duration(@timeout),
    retry_strategy: @retry_strategy,
    expiry: Utils::Time.extract_expiry_time(@expiry),
    preserve_expiry: @preserve_expiry,
    durability_level: @durability_level,
    persist_to: @persist_to,
    replicate_to: @replicate_to,
    cas: @cas,
  }
end