Class: Couchbase::Options::Increment

Inherits:
Base
  • Object
show all
Defined in:
lib/couchbase/options.rb,
/Users/sergey.auseyau/code/couchbase-ruby-client/lib/couchbase/options.rb more...

Overview

Options for BinaryCollection#increment

Instance Attribute Summary collapse

Attributes inherited from Base

#client_context, #parent_span, #retry_strategy, #timeout

Instance Method Summary collapse

Constructor Details

#initialize(delta: 1, initial: nil, expiry: nil, preserve_expiry: false, durability_level: :none, timeout: nil, retry_strategy: nil, client_context: nil, parent_span: nil) {|self| ... } ⇒ Increment

Creates an instance of options for BinaryCollection#increment

Parameters:

  • delta (Integer) (defaults to: 1) —

    the delta for the operation

  • initial (Integer) (defaults to: nil) —

    if present, holds the initial value

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

    if set, holds the expiration for the operation

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

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

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

Raises:

  • (ArgumentError)
[View source]

925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
 
# File 'lib/couchbase/options.rb', line 925

def initialize(delta: 1,
               initial: nil,
               expiry: nil,
               preserve_expiry: false,
               durability_level: :none,
               timeout: nil,
               retry_strategy: nil,
               client_context: nil,
               parent_span: nil)
  raise ArgumentError, "the delta cannot be less than 0" if delta.negative?

  super(timeout: timeout, retry_strategy: retry_strategy, client_context: client_context, parent_span: parent_span)
  @delta = delta
  @initial = initial
  @expiry = Utils::Time.extract_expiry_time(expiry)
  @preserve_expiry = preserve_expiry
  @durability_level = durability_level
  yield self if block_given?
end

Instance Attribute Details

#delta ⇒ Integer

Returns:

  • (Integer) 

892
893
894
 
# File 'lib/couchbase/options.rb', line 892

def delta
  @delta
end

#durability_level ⇒ Symbol

Returns:

  • (Symbol) 

895
896
897
 
# File 'lib/couchbase/options.rb', line 895

def durability_level
  @durability_level
end

#expiry ⇒ Integer, #in_seconds

Returns:

  • (Integer, #in_seconds) 

894
895
896
 
# File 'lib/couchbase/options.rb', line 894

def expiry
  @expiry
end

#initial ⇒ Integer

Returns:

  • (Integer) 

893
894
895
 
# File 'lib/couchbase/options.rb', line 893

def initial
  @initial
end

#preserve_expiry ⇒ Boolean

Returns:

  • (Boolean) 

896
897
898
 
# File 'lib/couchbase/options.rb', line 896

def preserve_expiry
  @preserve_expiry
end