Class: Dalli::Server

Inherits:
Object
  • Object
show all
Defined in:
lib/dalli/server.rb

Defined Under Namespace

Classes: KSocket

Constant Summary collapse

DEFAULTS = 
{
  # seconds between trying to contact a remote server
  :down_retry_delay => 1,
  # connect/read/write timeout for socket operations
  :socket_timeout => 0.5,
  # times a socket operation may fail before considering the server dead
  :socket_max_failures => 2,
  # amount of time to sleep between retries when a failure occurs
  :socket_failure_delay => 0.01,
  # max size of value in bytes (default is 1 MB, can be overriden with "memcached -I <size>")
  :value_max_bytes => 1024 * 1024,
  :username => nil,
  :password => nil,
}

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(attribs, options = {}) ⇒ Server

Returns a new instance of Server.



27
28
29
30
31
32
33
34
35
36
37
38
39
 
# File 'lib/dalli/server.rb', line 27

def initialize(attribs, options = {})
  (@hostname, @port, @weight) = attribs.split(':')
  @port ||= 11211
  @port = Integer(@port)
  @weight ||= 1
  @weight = Integer(@weight)
  @fail_count = 0
  @down_at = nil
  @last_down_at = nil
  @options = DEFAULTS.merge(options)
  @sock = nil
  @msg = nil
end

Instance Attribute Details

#hostname ⇒ Object

Returns the value of attribute hostname.



7
8
9
 
# File 'lib/dalli/server.rb', line 7

def hostname
  @hostname
end

#options ⇒ Object

Returns the value of attribute options.



10
11
12
 
# File 'lib/dalli/server.rb', line 10

def options
  @options
end

#port ⇒ Object

Returns the value of attribute port.



8
9
10
 
# File 'lib/dalli/server.rb', line 8

def port
  @port
end

#weight ⇒ Object

Returns the value of attribute weight.



9
10
11
 
# File 'lib/dalli/server.rb', line 9

def weight
  @weight
end

Instance Method Details

#alive? ⇒ Boolean

Returns:

  • (Boolean) 


63
64
65
66
67
68
69
70
71
72
73
74
75
76
 
# File 'lib/dalli/server.rb', line 63

def alive?
  return true if @sock

  if @last_down_at && @last_down_at + options[:down_retry_delay] >= Time.now
    time = @last_down_at + options[:down_retry_delay] - Time.now
    Dalli.logger.debug { "down_retry_delay not reached for #{hostname}:#{port} (%.3f seconds left)" % time }
    return false
  end

  connect
  !!@sock
rescue Dalli::NetworkError
  false
end

#close ⇒ Object 



78
79
80
81
82
 
# File 'lib/dalli/server.rb', line 78

def close
  return unless @sock
  @sock.close rescue nil
  @sock = nil
end

#lock! ⇒ Object 



84
85
 
# File 'lib/dalli/server.rb', line 84

def lock!
end

#request(op, *args) ⇒ Object

Chokepoint method for instrumentation

Raises:



42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
 
# File 'lib/dalli/server.rb', line 42

def request(op, *args)
  raise Dalli::NetworkError, "#{hostname}:#{port} is down: #{@error} #{@msg}" unless alive?
  begin
    send(op, *args)
  rescue Dalli::NetworkError
    raise
  rescue Dalli::MarshalError => ex
    Dalli.logger.error "Marshalling error for key '#{args.first}': #{ex.message}"
    Dalli.logger.error "You are trying to cache a Ruby object which cannot be serialized to memcached."
    Dalli.logger.error ex.backtrace.join("\n\t")
    false
  rescue Dalli::DalliError
    raise
  rescue Exception => ex
    Dalli.logger.error "Unexpected exception in Dalli: #{ex.class.name}: #{ex.message}"
    Dalli.logger.error "This is a bug in Dalli, please enter an issue in Github if it does not already exist."
    Dalli.logger.error ex.backtrace.join("\n\t")
    down!
  end
end

#unlock! ⇒ Object 



87
88
 
# File 'lib/dalli/server.rb', line 87

def unlock!
end