spymemcached.jruby 1.0.9-java → 1.0.10-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e8b5fb13cea1a40760e3c5238f88f4cf6dee3926
-  data.tar.gz: 45cde2c049dad6c2a43b41de8995a97cf60e3706
+  metadata.gz: 8eb6188bd806396129dbd6186e427323e48454e2
+  data.tar.gz: f30b1e50f0d2630ef62eac42553f6f09d5e6a6be
 SHA512:
-  metadata.gz: 2ff7964126978eee87bd847e1d7e7cfd60ba609f02728b5fbd28dc1c59bf874ac116a752ba9de4ffb072624b153ea058870f9a97ae0bec9111a8e4234c5a2225
-  data.tar.gz: 4120645054ffc7d2d5615a4498321df32f5ce04d868d91569359f480bf809c52fc5b6cf72dffa59bfd4b1c5b04c17e616fe46f9eb76413d5a178f1b003b9064b
+  metadata.gz: 462954604f84eca014be63ab9048356d8571e26fca26feb204c984ae0dbc8ba8aec38d66fd5c44db8288cdaa8a466dff3640b6aa81b9c72f27f900e6764db111
+  data.tar.gz: eef22bc388f1ed4450b4b8928b554c7efeb4bd41aa597e2180d2145d0665314692ce02b7f73ebb31fb7f1fef85ea64ed43b2bd73d1b57386da6eb97d850c20cf

data/README.md

@@ -1,11 +1,9 @@
-Spymemcached.jruby
-================
+# Spymemcached.jruby
 
 A JRuby extension wraps the latest spymemcached client.
+Fastest jruby memcached client, threadsafe.
 
-Usage
-----------------
-
+## Usage
 
 Start a local networked memcached server:
 
@@ -28,16 +26,48 @@ Valid +options+ are:
     [:timeout]     Time to use as the socket read timeout, seconds.  Defaults to 0.5 sec.
     [:binary]      Talks binary protocol with Memcached server. Default to true.
 
-Rails 3 & 4
+### Rails 4
+
+Use [spymemcached_store](https://github.com/ThoughtWorksStudios/spymemcached_store) gem to integrate ActiveSupport cache store and spymemcached.jruby gem.
+
+### Rails 3
+
+    require 'spymemcached'
+    config.cache_store = :mem_cache_store, Spymemcached.new(servers, options).rails23
+
+### Rails 2.x
+
+    require 'spymemcached'
+    ActionController::Base.cache_store = :mem_cache_store, Spymemcached.new(servers, options).rails23
+
+## Compatibility
+
+The most important different between spymemcached.jruby and other non spymemcached backended memcache client is the support of option :raw.
+
+As Spymemcached provides mechanism to encode and decode cache data, spymemcached.jruby does marshal dump & load for Ruby object in Java except Ruby string and integer.
+
+Any Ruby String or Integer type cache data will be directly converted to Java String or Integer.
 
-    TODO
+Hence we don't consider :raw option in spymemcached.jruby.
 
-Rails 2.3
+However, Rails cache store supports :raw option too when doing read and write on local cache.
+This behaviour is kept as I'm not sure what to do with it. I'm happy to fix it if you found anything wrong with it.
 
-    ActionController::Base.cache_store = :mem_cache_store, Spymemcached.new(servers).rails23
+## Default behaviors
 
+Spymemcached.jruby applies:
 
-Performance
----------------
+* Ketama key hash algorithm (see Spymemcached document or [RJ's blog post](http://www.last.fm/user/RJ/journal/2007/04/10/392555/) for details)
+* Gzip compressed when the cache data size is larger than 16kb.
+* Binary protocol
+
+Other default settings see Spymemcached DefaultConnectionFactory for details.
+
+## Performance
 
 [Benchmark result](https://github.com/ThoughtWorksStudios/memcached-client-benchmark) compared with gem dalli and jruby-memcached
+
+## Further resources
+
+* [Spymemcached](https://code.google.com/p/spymemcached/)
+* [Spymemcached Optimizations](https://code.google.com/p/spymemcached/wiki/Optimizations)

data/lib/spymemcached/rails23.rb

@@ -15,6 +15,9 @@ class Spymemcached
     end
 
     def get_multi(*args)
+      if [Hash, TrueClass, FalseClass].include?(args.last)
+        args.pop
+      end
       op(:get_multi, *args)
     end
 

data/test/spymemcached_rails23_test.rb

@@ -24,6 +24,12 @@ class SpymemcachedRails23Test < Test::Unit::TestCase
     assert @client.stats.values.first
   end
 
+  def test_rails3_api_compatible
+    @client.set("key1", '0')
+    @client.set("key2", '1')
+    assert_equal({"key1" => '0', 'key2' => '1'}, @client.get_multi(['key1', 'key2'], :raw => true))
+  end
+
   def response
     Spymemcached::Rails23::Response
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: spymemcached.jruby
 version: !ruby/object:Gem::Version
-  version: 1.0.9
+  version: 1.0.10
 platform: java
 authors:
 - Xiao Li
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2014-10-31 00:00:00.000000000 Z
+date: 2014-11-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake