jruby-ehcache-rails2 1.2.0 → 1.3.0

data/.gitignore

@@ -0,0 +1,2 @@
+*.DS_Store
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Gemfile for the ehcache gem
+gemspec :name => "jruby-ehcache"

data/Gemfile.lock

@@ -0,0 +1,15 @@
+PATH
+  remote: .
+  specs:
+    jruby-ehcache (1.3.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+
+PLATFORMS
+  java
+  ruby
+
+DEPENDENCIES
+  jruby-ehcache!

data/History.txt

@@ -0,0 +1,15 @@
+== 0.0.3 2008-08-20
+* 1 bug fix
+  * removed un-needed marshalling
+* 1 major enhancement
+  * added support for configurable bootstrap cache loader and event listener
+
+== 0.0.2 2008-06-08
+
+* 1 bug fix
+  * add mutex, and marshalling for serialization to cache
+
+== 0.0.1 2008-06-05
+
+* 1 major enhancement:
+  * Initial release

data/License.txt

@@ -0,0 +1,23 @@
+Copyright (c) 2008 - 2010 Dylan Stamat <dstamat@elctech.com> and
+                          Jason Voegele <jason@jvoegele.com>
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

data/Manifest.txt

@@ -0,0 +1,37 @@
+History.txt
+License.txt
+Manifest.txt
+PostInstall.txt
+README.txt
+Rakefile
+bin/ehcache
+config/ehcache.yml
+config/hoe.rb
+config/requirements.rb
+ext/ehcache-1.4.1/ehcache-1.4.1-remote-debugger.jar
+ext/ehcache-1.4.1/ehcache-1.4.1.jar
+ext/ehcache-1.4.1/lib/backport-util-concurrent-3.0.jar
+ext/ehcache-1.4.1/lib/commons-logging-1.0.4.jar
+ext/ehcache-1.4.1/lib/jsr107cache-1.0.jar
+ext/rails/ehcache_store.rb
+lib/ehcache.rb
+lib/ehcache/cache.rb
+lib/ehcache/cache_manager.rb
+lib/ehcache/config.rb
+lib/ehcache/element.rb
+lib/ehcache/extensions.rb
+lib/ehcache/java.rb
+lib/ehcache/status.rb
+lib/ehcache/version.rb
+script/console
+script/destroy
+script/generate
+script/txt2html
+setup.rb
+spec/spec_helper.rb
+tasks/deployment.rake
+tasks/environment.rake
+tasks/website.rake
+test/test_ehcache.rb
+test/test_ehcachejr.rb
+test/test_helper.rb

data/PostInstall.txt

@@ -0,0 +1,2 @@
+For more information on this gem, and Ehcache proper, see:
+http://github.com/dylanz/ehcache/tree/master/README.txt

data/README.txt

@@ -51,6 +51,15 @@ OR
 $ jruby -S gem install jruby-ehcache-rails3
 
 
+== GEMFILE:
+
+Add the gem as you normally would in your Gemfile, making sure to require
+'ehcache' explicitly.  Here is an example of adding the rails3 gem to a Gemfile.
+
+gem 'jruby-ehcache-rails3', :require => 'ehcache'
+
+
+
 == REQUIREMENTS:
 
 Tested with JRuby 1.5.3.

data/Rakefile

@@ -0,0 +1,13 @@
+require "bundler/gem_helper"
+Bundler::GemHelper.install_tasks :name => "jruby-ehcache"
+
+task :default => [ :test ]
+
+require 'rdoc/task'
+require 'rake/testtask'
+desc "Executes the test suite"
+Rake::TestTask.new do |t|
+  t.name = :test
+  t.libs << 'lib' << 'ext' << 'test'
+  t.pattern = "test/test_*.rb"
+end

data/VERSION

@@ -0,0 +1 @@
+1.3.0

data/config/ehcache.yml

@@ -0,0 +1,22 @@
+disk_store:
+  path: java.io.tmpdir
+
+peer_providers:
+- class: net.sf.ehcache.distribution.RMICacheManagerPeerProviderFactory
+  properties: peerDiscovery=automatic,multicastGroupAddress=230.0.0.1,multicastGroupPort=4446,timeToLive=1
+  property_separator: "\,"
+
+peer_listeners:
+- class: net.sf.ehcache.distribution.RMICacheManagerPeerListenerFactory
+
+default_cache:
+  name: cache
+  max_elements_in_memory:  10000
+  time_to_live_seconds:  0
+  time_to_idle_seconds:  0
+  overflow_to_disk: true
+  eternal: false
+  disk_spool_buffer_size_mb: 30
+  disk_persistent: false
+  disk_expiry_thread_interval_seconds: 120
+  memory_store_eviction_policy: LRU

data/config/ehcache_manual_rmi.yml

@@ -0,0 +1,27 @@
+disk_store:
+  path: java.io.tmpdir
+
+peer_providers:
+- class: net.sf.ehcache.distribution.RMICacheManagerPeerProviderFactory
+  properties: peerDiscovery=manual,rmiUrls=//that_hostname:40001/cache
+  property_separator: "\,"
+
+peer_listeners:
+- class: net.sf.ehcache.distribution.RMICacheManagerPeerListenerFactory
+  properties: hostName=this_hostname,port=40000
+
+default_cache:
+  name: cache
+  max_elements_in_memory:  10000
+  time_to_live_seconds:  0
+  time_to_idle_seconds:  0
+  overflow_to_disk: true
+  eternal: false
+  disk_spool_buffer_size_mb: 30
+  disk_persistent: false
+  disk_expiry_thread_interval_seconds: 120
+  memory_store_eviction_policy: LRU
+  event_listener: { class: net.sf.ehcache.distribution.RMICacheReplicatorFactory }
+  bootstrap_loader: { class: net.sf.ehcache.distribution.RMIBootstrapCacheLoaderFactory,
+                      properties: 'bootstrapAsynchronously=true,maximumChunkSizeBytes=5000000',
+                      property_separator: "\," }

data/examples/ehcache.xml

@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<ehcache xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="../../main/config/ehcache.xsd">
+
+    <!-- Disable for test ehcache.xml. Should go to the same place. -->
+    <diskStore path="java.io.tmpdir"/>
+
+    <cacheManagerPeerProviderFactory class="net.sf.ehcache.distribution.RMICacheManagerPeerProviderFactory"
+                                     properties="peerDiscovery=automatic, multicastGroupAddress=230.0.0.1, multicastGroupPort=4446, timeToLive=0"/>
+
+
+    <cacheManagerPeerListenerFactory class="net.sf.ehcache.distribution.RMICacheManagerPeerListenerFactory"
+                                     properties="hostName=, port=, socketTimeoutMillis="/>
+
+
+    <defaultCache
+            name="default"
+            maxElementsInMemory="10"
+            eternal="false"
+            timeToIdleSeconds="5"
+            timeToLiveSeconds="10"
+            overflowToDisk="true"
+            />
+
+
+    <!-- Sample cache named sampleCache1 -->
+    <cache name="sampleCache1"
+           maxElementsInMemory="10000"
+           maxElementsOnDisk="1000"
+           eternal="false"
+           timeToIdleSeconds="360"
+           timeToLiveSeconds="1000"
+           overflowToDisk="true">
+    </cache>
+
+    <!-- Sample cache named sampleCache2. Is eternal. Is diskPersistent but does not overflow to disk -->
+    <cache name="sampleCache2"
+           maxElementsInMemory="1000"
+           eternal="true"
+           overflowToDisk="false"
+           diskPersistent="true"
+            />
+</ehcache>

data/examples/jruby-ehcache.rb

@@ -0,0 +1,13 @@
+require 'ehcache'
+
+manager = Ehcache::CacheManager.new
+cache = manager.cache
+
+cache.put("answer", "42", {:ttl => 120})
+answer = cache.get("answer")
+puts "Answer: #{answer}"
+
+question = cache.get("question") || 'unknown'
+puts "Question: #{question}"
+
+manager.shutdown

data/jruby-ehcache-rails2.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "ehcache/version"
+
+Gem::Specification.new do |s|
+  s.name = %q{jruby-ehcache-rails2}
+  s.version = Ehcache::VERSION
+  s.authors = [%q{Dylan Stamat}, %q{Jason Voegele}]
+  s.date = %q{2012-03-14}
+  s.description = %q{The Ehcache cache store provider for Rails 2}
+  s.email = [%q{dstamat@elctech.com}, %q{jvoegele@terracotta.org}]
+  s.extra_rdoc_files = [ "README.txt" ]
+  s.homepage = %q{http://ehcache.rubyforge.org}
+  s.rubyforge_project = %q{ehcache}
+  s.rubygems_version = %q{1.8.9}
+  s.summary = %q{Rails 2 cache store provider using Ehcache}
+
+  s.files = `git ls-files`.split("\n").concat(
+      ["lib/active_support/ehcache_store.rb",
+       "lib/ehcache/active_support_store.rb"])
+
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency "jruby-ehcache"
+end

data/jruby-ehcache-rails3.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "ehcache/version"
+
+Gem::Specification.new do |s|
+  s.name = %q{jruby-ehcache-rails3}
+  s.version = Ehcache::VERSION
+  s.authors = [%q{Dylan Stamat}, %q{Jason Voegele}]
+  s.date = %q{2012-03-14}
+  s.description = %q{The Ehcache cache store provider for Rails 3}
+  s.email = [%q{dstamat@elctech.com}, %q{jvoegele@terracotta.org}]
+  s.extra_rdoc_files = [ "README.txt" ]
+  s.homepage = %q{http://ehcache.rubyforge.org}
+  s.rubyforge_project = %q{ehcache}
+  s.rubygems_version = %q{1.8.9}
+  s.summary = %q{Rails 3 cache store provider using Ehcache}
+
+  s.files = `git ls-files`.split("\n").concat(
+      ["lib/active_support/cache/ehcache_store.rb",
+       "lib/ehcache/active_support_store.rb"])
+
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency "jruby-ehcache"
+end

data/jruby-ehcache.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "ehcache/version"
+
+Gem::Specification.new do |s|
+  s.name = %q{jruby-ehcache}
+  s.version = Ehcache::VERSION
+  s.authors = [%q{Dylan Stamat}, %q{Jason Voegele}]
+  s.date = %q{2012-03-14}
+  s.description = %q{JRuby interface to the popular Java caching library Ehcache}
+  s.email = [%q{dstamat@elctech.com}, %q{jvoegele@terracotta.org}]
+  s.extra_rdoc_files = [ "README.txt" ]
+  s.homepage = %q{http://ehcache.rubyforge.org}
+  s.rubyforge_project = %q{ehcache}
+  s.rubygems_version = %q{1.8.9}
+  s.summary = %q{JRuby interface to Ehcache}
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+end

data/lib/ehcache.rb

@@ -0,0 +1,22 @@
+unless $:.include?(File.dirname(__FILE__)) ||
+       $:.include?(File.expand_path(File.dirname(__FILE__)))
+  $:.unshift(File.dirname(__FILE__))
+end
+
+require 'java'
+
+module Ehcache
+  unless defined?(EHCACHE_HOME)
+    EHCACHE_HOME = File.expand_path(File.dirname(__FILE__) + '/..')
+  end
+
+  # wraps all native exceptions
+  class EhcacheError < RuntimeError; end
+end
+
+require 'ehcache/extensions'
+require 'ehcache/java'
+require 'ehcache/config'
+require 'ehcache/cache'
+require 'ehcache/cache_manager'
+require 'ehcache/element'

data/lib/ehcache/active_support_store.rb

@@ -44,4 +44,15 @@ module Ehcache
     end
 
   end
-end
+end
+
+if defined?(Rails)
+  Ehcache::ActiveSupportStore.default_cache_name = 'rails_cache'
+
+  case Rails::VERSION::MAJOR
+  when 2
+    Ehcache::ActiveSupportStore.config_directory = File.expand_path(File.join(RAILS_ROOT, 'config'))
+  when 3
+    Ehcache::ActiveSupportStore.config_directory = File.expand_path(File.join(::Rails.root, 'config'))
+  end
+end

data/lib/ehcache/cache.rb

@@ -0,0 +1,74 @@
+# Enhance net.sf.ehcache.Cache with a more Rubyesque API.
+class Java::NetSfEhcache::Cache
+  include Enumerable
+
+  # Yield each Element stored in this cache to the given block.  This method
+  # uses Cache#getKeys as its basis, and therefore it is possible that some
+  # of the yielded elements have expired.
+  def each
+    for key in self.getKeys
+      yield self.get(key)
+    end
+  end
+
+  # Does this cache require marshalling of Ruby objects?
+  def marshal?
+    config = self.cache_configuration
+    config.overflow_to_disk? || config.overflow_to_off_heap? || config.terracotta_clustered?
+  end
+
+  # Gets an element value from the cache.  Unlike the #get method, this method
+  # returns the element value, not the Element object.
+  def [](key)
+    element = self.get(key)
+    element ? element.value : nil
+  end
+
+  alias ehcache_put put
+
+  # Wrap the Cache#put method to allow for extra options to be passed to the
+  # created Element.
+  def put(*args)
+    options = args.extract_options!
+    if args.size == 1 && args.first.kind_of?(Ehcache::Element)
+      element = args.first
+    elsif args.size == 2
+      if marshal?
+        value = Java::NetSfEhcache::MarshaledRubyObject.new(Marshal.dump(args[1]).to_java_bytes)
+      end
+      element = Ehcache::Element.create(args[0], value, options)
+    else
+      raise ArgumentError, "Must be Element object or key and value arguments"
+    end
+
+    if options[:unless_exist] || options[:unlessExist] ||
+       options[:if_absent]    ||options[:ifAbsent]
+      put_if_absent(element)
+    else
+      ehcache_put(element)
+    end
+  end
+
+  alias []= put
+
+  alias include? isKeyInCache
+  alias member? isKeyInCache
+
+  # Atomic compare and swap for cache elements.  Invokes the given block with
+  # the current value of the element and attempts to replace it with the
+  # value returned from the block, repeating until replace returns true.
+  # Note that the provided block works only with element values, not Element
+  # objects: the result of element.getValue is passed to the block parameter,
+  # and the block is expected to return a value based on it.
+  # If there is no element with the given key, returns immediately without
+  # retrying.
+  def compare_and_swap(key, &block)
+    begin
+      old_element = self.get(key)
+      return nil unless old_element
+      new_element = Ehcache::Element.new(key, yield(old_element.value))
+    end until replace(old_element, new_element)
+  end
+
+  alias update compare_and_swap
+end