Class: Couchbase::Options::RemoveMulti

Inherits:

Base

• Object
• Base
• Couchbase::Options::RemoveMulti

Defined in:

lib/couchbase/options.rb

Overview

Options for Collection#remove_multi

Constant Summary

DEFAULT =

This constant is part of a private API. You should avoid using this constant if possible, as it may be removed or be changed in the future.

RemoveMulti.new.freeze

Instance Attribute Summary

• #durability_level ⇒ Symbol

Attributes inherited from Base

#client_context, #parent_span, #retry_strategy, #timeout

Instance Method Summary

• #initialize(durability_level: :none, replicate_to: :none, persist_to: :none, timeout: nil, retry_strategy: nil, client_context: nil, parent_span: nil) {|| ... } ⇒ RemoveMulti constructor

  Creates an instance of options for Collection#remove.

• #to_backend ⇒ Object private

Constructor Details

#initialize(durability_level: :none, replicate_to: :none, persist_to: :none, timeout: nil, retry_strategy: nil, client_context: nil, parent_span: nil) {|| ... } ⇒ RemoveMulti

Creates an instance of options for Collection#remove

Parameters:

• 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 (Proc, nil) (defaults to: nil) —

  the custom retry strategy, if set

• 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:

• (Remove)

# File 'lib/couchbase/options.rb', line 507

def initialize(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)
  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

#durability_level ⇒ Symbol

Returns:

• (Symbol)

# File 'lib/couchbase/options.rb', line 471

def durability_level
  @durability_level
end

Instance Method Details

#to_backend ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

# File 'lib/couchbase/options.rb', line 526

def to_backend
  {
    timeout: Utils::Time.extract_duration(@timeout),
    durability_level: @durability_level,
    persist_to: @persist_to,
    replicate_to: @replicate_to,
  }
end