Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
This projects provides memcached based stores for JRuby. It is a gem based on Ikai Lan's jruby-memcache-client project hosted at

This project is a JRuby wrapper of the Java MemCache library by Greg Whalin

In production, the standard Ruby MemCache client can cause a thread to hang. In the Glassfish application server, by default there are 5 Grizzly connectors that handle incoming requests. A site that uses MemCache heavily can quickly cause all Grizzly connectors to block and take down a site. I'm hoping that this work I am doing here will help others adopt JRuby as a production platform for their Ruby on Rails applications.

The Ruby MemCache library was never written with threaded applications in mind. All threads use the same socket, and multithreaded mode basically wraps the IO with a Mutex. The Java library provides several features that are not available in the Ruby MemCache library:

- connection pooling
- socket timeouts. In forks of the Ruby MemCache library this is achieved either with a Mongrel timeout or use of the Ruby Timeout class, which, at least at the writing of this README, will work unpredictably when being used as a failsafe against hanging IO.

As of right now this code only provides a very minimal amount of functionality, but it is enough to use with the Rails cache and cache_fu.

This is a ruby gem that can be installed from

You will first need to install the gemcutter gem and configure your system to use it:

jruby -S gem install gemcutter
jruby -S gem tumble

You will then be able to install the JRuby Memcache Client gem:

jruby -S gem install jruby-memcache-client

Java Requirements

The underlying library used for this project was compiled using Java 6. You will not be able to run this gem under Java 5 out of the box. You can however clone and attempt to build it under Java 5 if you must. (You really should consider upgrading to Java 6 since Oracle no longer supports Java 5.)

Replacing Rail's MemCache Client

Rails ships with a bundled copy of the MemCache client. This client will prevent you from using this gem instead. Adding the following code into your environment.rb file:

if RUBY_PLATFORM =~ /java/i
  # Based on instructions from
  # Brain surgery to use our own version of memcache-client without
  # having to modify activesupport directly.
  # Unload any previous instance of the class
  if Object.const_defined? :MemCache
    Object.instance_eval { remove_const :MemCache }
  # Pull in the exact version we want
  gem 'jruby-memcache-client', '1.6.1'

  # Ensure that the memcache-client path is at the front of the loadpath
  $LOAD_PATH.each do |path|
    if path =~ /jruby-memcache-client/
  # If Ruby thinks it's already loaded memcache.rb, force
  # a reload otherwise just require.
  if $".find { |file| file =~ /\Amemcache.rb\Z/ }
    load 'memcache.rb'
    require 'memcache'

This will remove the original MemCache client and load our version of the MemCache class instead.

The JRuby MemCache client uses the same configuration options as the regular MemCache client. Here is how to build the configuration in your environment.rb file:

memcache_options = {
  :namespace => 'fortaleza:production_live:',
memcached_servers = [ ENV['MEMCACHED_LOCATION'] || '']

# Constant used by libs
CACHE = memcached_servers, memcache_options if RUBY_PLATFORM =~ /java/

Note that this may vary based on your particular configuration method and environment.


A wrapper of the Java Whalin MemCache client for JRuby







No packages published