Module: Couchbase::Operations::Touch

Defined in:
lib/couchbase/operations/touch.rb

Instance Method Summary collapse

Instance Method Details

#touch(key, options = {}) {|ret| ... } ⇒ true, false #touch(keys) {|ret| ... } ⇒ Hash

Update the expiry time of an item

The touch method allow you to update the expiration time on a given key. This can be useful for situations where you want to prevent an item from expiring without resetting the associated value. For example, for a session database you might want to keep the session alive in the database each time the user accesses a web page without explicitly updating the session value, keeping the user's session active and available.

Overloads:

  • #touch(key, options = {}) {|ret| ... } ⇒ true, false

    Returns true if the operation was successful and false otherwise.

    Examples:

    Touch value using default_ttl

    c.touch("foo")

    Touch value using custom TTL (10 seconds)

    c.touch("foo", :ttl => 10)

    Parameters:

    • key (String, Symbol) —

      Key used to reference the value.

    • options (Hash) (defaults to: {}) —

      Options for operation.

    Options Hash (options):

    • :ttl (Fixnum) — default: self.default_ttl —

      Expiry time for key. Values larger than 302460*60 seconds (30 days) are interpreted as absolute times (from the epoch).

    • :quiet (true, false) — default: self.quiet —

      If set to true, the operation won't raise error for missing key, it will return nil.

    Yield Parameters:

    • ret (Result) —

      the result of operation in asynchronous mode (valid attributes: error, operation, key).

    Returns:

    • (true, false) —

      true if the operation was successful and false otherwise.

    Raises:

  • #touch(keys) {|ret| ... } ⇒ Hash

    Returns Mapping keys to result of touch operation (+true+ if the operation was successful and false otherwise).

    Examples:

    Touch several values

    c.touch("foo" => 10, :bar => 20) #=> {"foo" => true, "bar" => true}

    Touch several values in async mode

    c.run do
  c.touch("foo" => 10, :bar => 20) do |ret|
     ret.operation   #=> :touch
     ret.success?    #=> true
     ret.key         #=> "foo" and "bar" in separate calls
  end
end

    Touch single value

    c.touch("foo" => 10)             #=> true

    Parameters:

    • keys (Hash) —

      The Hash where keys represent the keys in the database, values -- the expiry times for corresponding key. See description of :ttl argument above for more information about TTL values.

    Yield Parameters:

    • ret (Result) —

      the result of operation for each key in asynchronous mode (valid attributes: error, operation, key).

    Returns:

    • (Hash) —

      Mapping keys to result of touch operation (+true+ if the operation was successful and false otherwise)

Since:

  • 1.0.0



67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
 
# File 'lib/couchbase/operations/touch.rb', line 67

def touch(*args, &block)
  sync_block_error if !async? && block_given?
  key, options = expand_touch_args(args)

  if key.respond_to?(:to_hash)
    multi_touch_hash(key, options)
  elsif key.respond_to?(:to_ary)
    multi_touch_array(key, options)
  else
    if async?
      java_async_touch(key, options[:ttl], &block)
    else
      success = java_touch(key, options[:ttl])
      not_found_error(!success, options)
      success
    end
  end
end