Class: Kvs

Inherits:
Object
  • Object
show all
Defined in:
lib/sekka/kvs.rb

Instance Method Summary collapse

Constructor Details

#initialize(dbtype) ⇒ Kvs

Returns a new instance of Kvs.



37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
# File 'lib/sekka/kvs.rb', line 37

def initialize( dbtype )
  @tcFlag = true
  begin
    require 'tokyocabinet'
  rescue LoadError
    @tcFlag = false
  end

  @redisFlag = true
  begin
    require 'redis'
  rescue LoadError
    @redisFlag = false
  end

  @dbmFlag = true
  begin
    require 'dbm'
  rescue LoadError
    @dbmFlag = false
  end

  @dbtype = dbtype
  case dbtype
  when :tokyocabinet
    if @tcFlag
      @db = TokyoCabinet::HDB.new( )
    else
      raise RuntimeError, "Kvs.new() missed require( 'tokyocabinet' )."
    end

  when :redis
    if not @redisFlag
      raise RuntimeError, "Kvs.new() missed require( 'redis' )."
    end

  when :memcache
    # do nothing

  when :dbm
    if @dbmFlag
      # do nothing
    else
      raise RuntimeError, "Kvs.new() missed require( 'dbm' )."
    end

    # do nothing

  when :pure
    # do nothing
  else
    raise ArgumentError, "Kvs.new() requires reserved DB typename"
  end
end

Instance Method Details

#_dbObject

for testing



241
242
243
# File 'lib/sekka/kvs.rb', line 241

def _db()
  @db
end

#clearObject



175
176
177
178
179
180
181
182
183
184
185
186
# File 'lib/sekka/kvs.rb', line 175

def clear()
  case @dbtype
  when :tokyocabinet, :dbm, :pure
    @db.clear
  when :redis
    @db.flushall
  when :memcache
    # do nothing
  else
    raise RuntimeError
  end
end

#closeObject



225
226
227
228
229
230
231
232
233
234
235
236
237
238
# File 'lib/sekka/kvs.rb', line 225

def close()
  case @dbtype
  when :tokyocabinet, :dbm
    @db.close
  when :memcache, :redis
    # do nothign
  when :pure
    File.open( @name, "w" ) { |f|
      f.print( @db )
    }
  else
    raise RuntimeError
  end
end

#delete(key) ⇒ Object



165
166
167
168
169
170
171
172
173
# File 'lib/sekka/kvs.rb', line 165

def delete( key )
  case @dbtype
  when :redis
    @db.del( key )
  else
    @db.delete( key )
  end
  true
end

#fixdbObject



119
120
121
122
123
124
125
126
127
# File 'lib/sekka/kvs.rb', line 119

def fixdb( )
  case @dbtype
  when :tokyocabinet
    if not @db.optimize( )
      raise RuntimeError, sprintf( "TokyoCabinet::HDB.optimize error: file=%s", name )
    end
  end
  true
end

#forward_match_keys(prefix) ⇒ Object



204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
# File 'lib/sekka/kvs.rb', line 204

def forward_match_keys( prefix )
  case @dbtype
  when :tokyocabinet
    @db.fwmkeys( prefix ).each { |k|
      k.force_encoding("UTF-8")
    }
  when :redis
    @db.keys( prefix + "*" ).each { |k|
      k.force_encoding("UTF-8")
    }
  when :memcache
    raise RuntimeError, "Kvs#forward_match_keys method was not implemented for memcache."
  when :dbm, :pure
    self.keys( ).select {|key|
      key.match( "^" + prefix )
    }
  else
    raise RuntimeError
  end
end

#get(key, fallback = false) ⇒ Object



152
153
154
155
156
157
158
159
160
161
162
163
# File 'lib/sekka/kvs.rb', line 152

def get( key, fallback = false )
  if 0 == key.size
    fallback
  else
    val = @db[ key ]
    if val
      val.force_encoding("UTF-8")
    else
      fallback
    end
  end
end

#keysObject

return array of key string



189
190
191
192
193
194
195
196
197
198
199
200
201
202
# File 'lib/sekka/kvs.rb', line 189

def keys()
  case @dbtype
  when :tokyocabinet, :dbm, :redis
    @db.keys.map { |k|
      k.force_encoding("UTF-8")
    }
  when :memcache
    raise RuntimeError, "Kvs#keys method was not implemented for memcache."
  when :pure
    @db.keys
  else
    raise RuntimeError
  end
end

#open(name) ⇒ Object



92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
# File 'lib/sekka/kvs.rb', line 92

def open( name )
  case @dbtype
  when :tokyocabinet
    if not @db.open( name, TokyoCabinet::HDB::OWRITER | TokyoCabinet::HDB::OCREAT )
      raise RuntimeError, sprintf( "TokyoCabinet::HDB.open error: file=%s", name )
    end
  when :redis
    @db = Redis.new( :host => name )
  when :memcache
    @db = MemCache.new( name )
  when :dbm
    @db = DBM.new( name )
  when :pure
    @name = name
    if File.exist?( @name )
      File.open( @name ) {|f|
        @db = eval( f.read() )
      }
      @db
    else
      @db = Hash.new
    end
  else
    raise RuntimeError
  end
end

#pure_put!(key, value, timeout = 0) ⇒ Object



136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
# File 'lib/sekka/kvs.rb', line 136

def pure_put!( key, value, timeout = 0 )
  if 0 < key.size
    case @dbtype
    when :tokyocabinet, :dbm, :redis
      @db[ key.force_encoding("ASCII-8BIT") ] = value.force_encoding("ASCII-8BIT")
    when :memcache
      @db.set( key.force_encoding("ASCII-8BIT"), value.force_encoding("ASCII-8BIT"), timeout )
    when :pure
      @db[ key ] = value
    else
      raise RuntimeError
    end
  end
  value
end

#put!(key, value, timeout = 0) ⇒ Object



129
130
131
132
133
134
# File 'lib/sekka/kvs.rb', line 129

def put!( key, value, timeout = 0 )
  if not self.pure_put!( key, value, timeout )
    raise RuntimeError sprintf( "put! error: key=%s", key.force_encoding("ASCII-8BIT"))
  end
  value
end