thread_safe 0.2.0-java → 0.3.1-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6ec4092b3c27528c0451830f13a0f1331b3d2073
-  data.tar.gz: 5e8f84e18a076856ce0d666f24c27060b6173124
+  metadata.gz: bd78f6716a19a528d4f244f47944740468398978
+  data.tar.gz: 92d44fadb74cb932282e682967b11c532ad7a678
 SHA512:
-  metadata.gz: 8d3761a208f3e25afadcf16182b03a296a119c4bf74b5b9db304237c9486c69f4f0df8bd385b3ee30355daf96405a4a6986e099c3e1c5394c7e236428a0a7520
-  data.tar.gz: aa4cc676aaa4c66290a454aecec9c57c23fac7be246bb1a42210792ba4f30dd81a6c4e2b91d3f547d923f0dd42d470714cd9f7ae73564c5123069028e3013891
+  metadata.gz: 50cd42d6dfaa8f703d9fe3034150b3012317d1af47690c88a1c906196760ccd3eafd4afa1f925c946a8842f026cb7ccec00056fdb3bcaff3ed00657fa9db8508
+  data.tar.gz: dddfe11774caf6f080292540c11cf795d9e8867d6917da1e2ff9d907fbb9e2eafa3b47ca6e9dcf5e07f2498c53bf238c6771df9e79540f310ae6ac3ef30bbd19

data/.gitignore

@@ -19,3 +19,4 @@ test/version_tmp
 tmp
 .DS_Store
 *.swp
+test/package.jar

data/README.md

@@ -28,14 +28,22 @@ sh = ThreadSafe::Hash.new # supports standard Hash.new forms
 ```
 
 `ThreadSafe::Cache` also exists, as a hash-like object, and should have
-much better performance characteristics under concurrency than
+much better performance characteristics esp. under high concurrency than
 `ThreadSafe::Hash`. However, `ThreadSafe::Cache` is not strictly semantically
-equivalent to ruby Hash -- for instance, it does not neccesarily ordered by
-insertion time as Hash is. For most uses it should do fine though, and we
-recommend you consider `ThreadSafe::Cache` instead of `ThreadSafe::Hash` for your
-concurrency-safe hash needs. 
+equivalent to a ruby `Hash` -- for instance, it does not necessarily retain
+ordering by insertion time as `Hash` does. For most uses it should do fine
+though, and we recommend you consider `ThreadSafe::Cache` instead of
+`ThreadSafe::Hash` for your concurrency-safe hash needs. It understands some
+options when created (depending on your ruby platform) that control some of the
+internals - when unsure just leave them out:
 
 
+```ruby
+require 'thread_safe'
+
+cache = ThreadSafe::Cache.new
+```
+
 ## Contributing
 
 1. Fork it

data/ext/org/jruby/ext/thread_safe/JRubyCacheBackendLibrary.java

@@ -178,11 +178,17 @@ public class JRubyCacheBackendLibrary implements Library {
             return getRuntime().newBoolean(map.replace(key, oldValue, newValue));
         }
 
-        @JRubyMethod(name = {"key?"}, required = 1)
+        @JRubyMethod(name = "key?", required = 1)
         public RubyBoolean has_key_p(IRubyObject key) {
             return map.containsKey(key) ? getRuntime().getTrue() : getRuntime().getFalse();
         }
 
+        @JRubyMethod
+        public IRubyObject key(IRubyObject value) {
+            final IRubyObject key = map.findKey(value);
+            return key == null ? getRuntime().getNil() : key;
+        }
+
         @JRubyMethod
         public IRubyObject replace_if_exists(IRubyObject key, IRubyObject value) {
             IRubyObject result = map.replace(key, value);

data/ext/org/jruby/ext/thread_safe/jsr166e/ConcurrentHashMap.java

@@ -25,4 +25,7 @@ public interface ConcurrentHashMap<K, V> {
     public Set<Map.Entry<K,V>> entrySet();
     public int size();
     public V getValueOrDefault(Object key, V defaultValue);
+
+    public boolean containsValue(V value);
+    public K findKey(V value);
 }

data/ext/org/jruby/ext/thread_safe/jsr166e/ConcurrentHashMapV8.java

@@ -2430,8 +2430,8 @@ public class ConcurrentHashMapV8<K, V>
     @SuppressWarnings("serial") static class Traverser<K,V,R> {
         final ConcurrentHashMapV8<K, V> map;
         Node next;           // the next entry to use
-        Object nextKey;      // cached key field of next
-        Object nextVal;      // cached val field of next
+        K nextKey;           // cached key field of next
+        V nextVal;           // cached val field of next
         Node[] tab;          // current table; updated if resized
         int index;           // index of bin to use next
         int baseIndex;       // current index of initial table
@@ -2461,9 +2461,9 @@ public class ConcurrentHashMapV8<K, V>
          * Advances next; returns nextVal or null if terminated.
          * See above for explanation.
          */
-        final Object advance() {
+        final V advance() {
             Node e = next;
-            Object ev = null;
+            V ev = null;
             outer: do {
                 if (e != null)                  // advance past used/skipped node
                     e = e.next;
@@ -2489,8 +2489,8 @@ public class ConcurrentHashMapV8<K, V>
                     }                           // visit upper slots if present
                     index = (i += baseSize) < n ? i : (baseIndex = b + 1);
                 }
-                nextKey = e.key;
-            } while ((ev = e.val) == null);    // skip deleted or special nodes
+                nextKey = (K) e.key;
+            } while ((ev = (V) e.val) == null);    // skip deleted or special nodes
             next = e;
             return nextVal = ev;
         }
@@ -2730,6 +2730,18 @@ public class ConcurrentHashMapV8<K, V>
         return false;
     }
 
+    public K findKey(Object value) {
+        if (value == null)
+            throw new NullPointerException();
+        Object v;
+        Traverser<K,V,Object> it = new Traverser<K,V,Object>(this);
+        while ((v = it.advance()) != null) {
+            if (v == value || value.equals(v))
+                return it.nextKey;
+        }
+        return null;
+    }
+
     /**
      * Legacy method testing if some key maps into the specified value
      * in this table.  This method is identical in functionality to

data/ext/org/jruby/ext/thread_safe/jsr166e/nounsafe/ConcurrentHashMapV8.java

@@ -2422,8 +2422,8 @@ public class ConcurrentHashMapV8<K, V>
     @SuppressWarnings("serial") static class Traverser<K,V,R> {
         final ConcurrentHashMapV8<K, V> map;
         Node next;           // the next entry to use
-        Object nextKey;      // cached key field of next
-        Object nextVal;      // cached val field of next
+        K nextKey;      // cached key field of next
+        V nextVal;      // cached val field of next
         AtomicReferenceArray<Node> tab;          // current table; updated if resized
         int index;           // index of bin to use next
         int baseIndex;       // current index of initial table
@@ -2453,9 +2453,9 @@ public class ConcurrentHashMapV8<K, V>
          * Advances next; returns nextVal or null if terminated.
          * See above for explanation.
          */
-        final Object advance() {
+        final V advance() {
             Node e = next;
-            Object ev = null;
+            V ev = null;
             outer: do {
                 if (e != null)                  // advance past used/skipped node
                     e = e.next;
@@ -2481,8 +2481,8 @@ public class ConcurrentHashMapV8<K, V>
                     }                           // visit upper slots if present
                     index = (i += baseSize) < n ? i : (baseIndex = b + 1);
                 }
-                nextKey = e.key;
-            } while ((ev = e.val) == null);    // skip deleted or special nodes
+                nextKey = (K) e.key;
+            } while ((ev = (V) e.val) == null);    // skip deleted or special nodes
             next = e;
             return nextVal = ev;
         }
@@ -2722,6 +2722,18 @@ public class ConcurrentHashMapV8<K, V>
         return false;
     }
 
+    public K findKey(Object value) {
+        if (value == null)
+            throw new NullPointerException();
+        Object v;
+        Traverser<K,V,Object> it = new Traverser<K,V,Object>(this);
+        while ((v = it.advance()) != null) {
+            if (v == value || value.equals(v))
+                return it.nextKey;
+        }
+        return null;
+    }
+
     /**
      * Legacy method testing if some key maps into the specified value
      * in this table.  This method is identical in functionality to

data/lib/thread_safe/cache.rb

@@ -95,6 +95,12 @@ module ThreadSafe
       each_pair {|k, v| yield v}
     end unless method_defined?(:each_value)
 
+    def key(value)
+      each_pair {|k, v| return k if v == value}
+      nil
+    end unless method_defined?(:key)
+    alias_method :index, :key if RUBY_VERSION < '1.9'
+
     def empty?
       each_pair {|k, v| return false}
       true

data/lib/thread_safe/version.rb

@@ -1,3 +1,21 @@
+module ThreadSafe
+  VERSION = "0.3.1"
+end
+
+# NOTE: <= 0.2.0 used Threadsafe::VERSION
+# @private
 module Threadsafe
-  VERSION = "0.2.0"
+
+  # @private
+  def self.const_missing(name)
+    name = name.to_sym
+    if ThreadSafe.const_defined?(name)
+      warn "[DEPRECATION] `Threadsafe::#{name}' is deprecated, use `ThreadSafe::#{name}' instead."
+      ThreadSafe.const_get(name)
+    else
+      warn "[DEPRECATION] the `Threadsafe' module is deprecated, please use `ThreadSafe` instead."
+      super
+    end
+  end
+
 end

data/test/test_cache.rb

@@ -371,6 +371,16 @@ class TestCache < Test::Unit::TestCase
   end
 
   def test_key
+    with_or_without_default_proc do
+      assert_equal nil, @cache.key(1)
+      @cache[:a] = 1
+      assert_equal :a,  @cache.key(1)
+      assert_equal nil,  @cache.key(0)
+      assert_equal :a,  @cache.index(1) if RUBY_VERSION =~ /1\.8/
+    end
+  end
+
+  def test_key?
     with_or_without_default_proc do
       assert_equal false, @cache.key?(:a)
       @cache[:a] = 1
@@ -378,7 +388,7 @@ class TestCache < Test::Unit::TestCase
     end
   end
 
-  def test_value
+  def test_value?
     with_or_without_default_proc do
       assert_equal false, @cache.value?(1)
       @cache[:a] = 1

data/thread_safe.gemspec

@@ -16,7 +16,7 @@ Gem::Specification.new do |gem|
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.name          = "thread_safe"
   gem.require_paths = ["lib"]
-  gem.version       = Threadsafe::VERSION
+  gem.version       = ThreadSafe::VERSION
   gem.license       = "Apache-2.0"
 
   gem.add_dependency 'atomic', ['>= 1.1.7', '< 2']

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: thread_safe
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: java
 authors:
 - Charles Oliver Nutter
@@ -9,15 +9,15 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2014-02-26 00:00:00.000000000 Z
+date: 2014-03-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '>='
       - !ruby/object:Gem::Version
         version: 1.1.7
-    - - "<"
+    - - <
       - !ruby/object:Gem::Version
         version: '2'
   name: atomic
@@ -25,16 +25,16 @@ dependencies:
   type: :runtime
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '>='
       - !ruby/object:Gem::Version
         version: 1.1.7
-    - - "<"
+    - - <
       - !ruby/object:Gem::Version
         version: '2'
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   name: rake
@@ -42,7 +42,7 @@ dependencies:
   type: :development
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 description: Thread-safe collections and utilities for Ruby
@@ -53,8 +53,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".travis.yml"
+- .gitignore
+- .travis.yml
 - Gemfile
 - LICENSE
 - README.md
@@ -73,7 +73,6 @@ files:
 - lib/thread_safe.rb
 - lib/thread_safe/atomic_reference_cache_backend.rb
 - lib/thread_safe/cache.rb
-- lib/thread_safe/jruby_cache_backend.jar
 - lib/thread_safe/mri_cache_backend.rb
 - lib/thread_safe/non_concurrent_cache_backend.rb
 - lib/thread_safe/synchronized_cache_backend.rb
@@ -96,6 +95,7 @@ files:
 - test/test_helper.rb
 - test/test_synchronized_delegator.rb
 - thread_safe.gemspec
+- lib/thread_safe/jruby_cache_backend.jar
 homepage: https://github.com/headius/thread_safe
 licenses:
 - Apache-2.0
@@ -106,17 +106,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project:
-rubygems_version: 2.2.2
+rubygems_version: 2.1.9
 signing_key:
 specification_version: 4
 summary: A collection of data structures and utilities to make thread-safe programming in Ruby easier