A modified WeakRef impl for JRuby plus some weakref-related tools
Java Ruby
Latest commit 939a9b0 Mar 16, 2015 @headius Merge pull request #1 from cdwijayarathna/edit
gemspec corrected
Failed to load latest commit information.
ext Remove unused import. Mar 22, 2010
lib Fix a bug where IdHash#[] was still using __getobj__ Mar 22, 2010
nbproject Add specs. Mar 22, 2010
spec Fix a bug where IdHash#[] was still using __getobj__ Mar 22, 2010
.gitignore Add NB project files. Mar 22, 2010
HISTORY.txt Set gem platform to java. Jun 3, 2010
LICENSE Add Apache 2.0 license file. Dec 1, 2010
README.txt Minor tweaks, added HISTORY, updated to 0.0.2 Mar 19, 2010
weakling.gemspec gemspec corrected Mar 16, 2015


weakling: a collection of weakref utilities for Ruby

== Summary ==

This library provides:

* a modified WeakRef implementation for JRuby that supports a reference queue
* a WeakRef::RefQueue class
* a weak-valued ID map to replace typical uses of _id2ref

In the future it may provide additional features like a generic WeakHash or other
reference types like soft and phantom references.

The weakling repository is at http://github.com/headius/weakling.

== Usage ==

Just require 'weakling'. It will require 'weakref' along with the refqueue JRuby
extension and the weakling/collections library containing the weak id hash.

== RefQueue Example ==

require 'weakling'
require 'java'

q = WeakRef::RefQueue.new
wr = WeakRef.new(Object.new, q)
puts "weakref object: #{wr.__id__}"

puts "running GC"

puts "weakref alive?: #{wr.weakref_alive?}"
puts "weakref object from queue: #{q.poll.__id__}"

== WeakRef::IdHash Example ==

require 'weakling'
wh = WeakRef::IdHash.new
ary = (1..10).to_a.map {Object.new}
ids = ary.map {|o| wh.add(o)}
puts "all items in weak_id_hash:"
ids.each {|i| puts "#{i} = #{wh[i]}"}
puts "dereferencing objects"
ary = nil
puts "forcing GC"
  require 'java'
puts "all items in weak id hash:"
ids.each {|i| puts "#{i} = #{wh[i]}"}