hazelcast-client 0.0.1-jruby

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Adrian Madrid
+
+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/README.rdoc

@@ -0,0 +1,47 @@
+= hazelcast-client
+
+Connecting to a Hazelcast Cluster has never been easier!
+Hazelcast::Client is a little gem that wraps the Java Hazelcast Client library into a more comfortable JRuby package.
+
+Hazelcast is an open source clustering and highly scalable data distribution platform for Java, which is:
+
+* Lightning-fast; thousands of operations/sec.
+* Fail-safe; no losing data after crashes.
+* Dynamically scales as new servers added.
+* Super-easy to use; include a single jar.
+
+== Getting started
+
+Let's get the gem installed and test out the interactive console. Make sure you have a hazelcast cluster running
+in localhost and that is using the default username and password.
+
+  shell> rvm jruby
+  shell> gem install hazelcast-client
+  shell> hazelcast-client-console
+
+  hash = @client.map :test
+  hash[:a] = 1
+  hash[:b] = 2
+
+Let's open another console to check how this distributed hash works:
+
+  shell> hazelcast-client-console
+
+  hash = @client.map :test
+  hash[:a]
+
+  >> 1
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2011 Adrian Madrid. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,64 @@
+#require 'bundler'
+#Bundler::GemHelper.install_tasks
+
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name              = "hazelcast-client"
+    gem.authors           = ["Adrian Madrid"]
+    gem.email             = ["aemadrid@gmail.com"]
+    gem.homepage          = ""
+    gem.summary           = %q{Connecting to a Hazelcast Cluster has never been easier!}
+    gem.description       = %q{Hazelcast::Client is a little gem that wraps the Java Hazelcast Client library into a more comfortable JRuby package.}
+    gem.platform          = "jruby"
+
+    gem.rubyforge_project = "hazelcast-client"
+
+    gem.files             = FileList['bin/*', 'lib/**/*.rb', 'jars/**/*', 'test/**/*.rb', '[A-Z]*'].to_a
+    gem.test_files        = Dir["test/test*.rb"]
+    gem.executables       = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
+    gem.require_paths     = ["lib"]
+
+    gem.add_dependency "hazelcast-jars", "1.9.1"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+Rake::TestTask.new :test do |t|
+  t.libs << "lib"
+  t.test_files = FileList["test/**/test_*.rb"]
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |spec|
+    spec.libs << 'spec'
+    spec.pattern = 'spec/**/*_spec.rb'
+    spec.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version       = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = "rubyhaze #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/bin/hazelcast-client-console

@@ -0,0 +1,9 @@
+#!/usr/bin/env jruby
+require File.expand_path(File.dirname(__FILE__) + "/../lib/hazelcast-client.rb")
+
+@client = Hazelcast::Client.new ARGV[0], ARGV[1], ARGV[2]
+
+puts ">> Starting IRB session..."
+require 'irb'
+ARGV.clear
+IRB.start(__FILE__)

data/lib/hazelcast-client.rb

@@ -0,0 +1,108 @@
+raise "Rubyhaze only runs on JRuby. Sorry!" unless (RUBY_PLATFORM =~ /java/)
+require 'java'
+require 'rubygems'
+require 'hazelcast-jars'
+
+module Hazelcast
+  class Client
+
+    Hazelcast::Jars.all
+    GEM_ROOT = File.expand_path(File.dirname(__FILE__)) unless defined?(GEM_ROOT)
+
+    java_import 'com.hazelcast.client.HazelcastClient'
+#    java_import 'java.util.Map'
+
+    attr_reader :username, :password, :host
+
+    def initialize(username = nil, password = nil, host = nil)
+      @username = username || "dev"
+      @password = password || "dev-pass"
+      @host     = host || "localhost"
+      @client = self.class.connect @username, @password, @host
+    end
+
+    def cluster(name)
+      @client.getCluster name.to_s
+    end
+
+    def list(name)
+      @client.getList name.to_s
+    end
+
+    def lock(name)
+      @client.getLock name.to_s
+    end
+
+    def map(name)
+      @client.getMap name.to_s
+    end
+
+    def multi_map(name)
+      @client.getMultiMap name.to_s
+    end
+
+    def queue(name)
+      @client.getQueue name.to_s
+    end
+
+    def set(name)
+      @client.getSet name.to_s
+    end
+
+    def topic(name)
+      @client.getTopic name.to_s
+    end
+
+    def transaction
+      txn = @client.getTransaction
+      txn.begin
+      begin
+        yield
+        txn.commit
+        nil
+      rescue => e
+        txn.rollback
+        e
+      end
+    end
+
+    def respond_to?(meth)
+      super || @client.respond_to?(meth)
+    end
+
+    def method_missing(meth, *args, &blk)
+      if @client.respond_to? meth
+        @client.send meth, *args, &blk
+      else
+        super
+      end
+    end
+
+    def self.connections
+      @connections ||= {}
+    end
+
+    def self.connect(username, password, host)
+      conn_id = "#{username}:#{password}:#{host}"
+      if connections.key? conn_id
+        connections[conn_id]
+      else
+        puts ">> Connecting to [#{host}] as [#{username}] with [#{password}]..."
+        connections[conn_id] ||= HazelcastClient.newHazelcastClient username, password, host
+      end
+    end
+
+  end
+
+end
+
+%w{ map queue topic }.each do |name|
+  require Hazelcast::Client::GEM_ROOT + '/hazelcast-client/' + name
+end
+
+at_exit do
+  Hazelcast::Client.connections.each do |conn_id, client|
+    puts ">> Shutting down #{client} before closing shop ..."
+    client.shutdown
+  end
+end

data/lib/hazelcast-client/map.rb

@@ -0,0 +1,49 @@
+class Java::ComHazelcastClient::MapClientProxy
+
+  java_import 'com.hazelcast.query.SqlPredicate'
+
+  def [](key)
+    get key.to_s
+  end
+
+  def []=(key, value)
+    put key.to_s, value
+  end
+
+  def keys(predicate = nil)
+    predicate = prepare_predicate(predicate) unless predicate.is_a?(SqlPredicate)
+    key_set(predicate).map
+  end
+
+  alias_method :unlearned_values, :values
+
+  def values(predicate = nil)
+    predicate = prepare_predicate(predicate) unless predicate.is_a?(SqlPredicate)
+    unlearned_values(predicate).map
+  end
+
+  alias :find :values
+
+  def prepare_predicate(predicate)
+    return if predicate.nil?
+    case predicate
+      when String
+        SqlPredicate.new predicate
+      when Hash
+        query = predicate.map do |field, value|
+          cmp = '='
+          if value.is_a?(String)
+            value = "'" + value + "'"
+            cmp = 'LIKE' if value.index('%')
+          end
+          "#{field} #{cmp} #{value}"
+        end.join(' AND ')
+        SqlPredicate.new query
+      else
+        raise "Unknown predicate type"
+    end
+  end
+
+end
+
+

data/lib/hazelcast-client/queue.rb

@@ -0,0 +1,9 @@
+class Java::ComHazelcastClient::QueueClientProxy
+
+  alias_method :unlearned_poll, :poll
+
+  def poll(timeout = 5, unit = :seconds)
+    unlearned_poll timeout, java.util.concurrent.TimeUnit.const_get(unit.to_s.upcase)
+  end
+
+end

data/lib/hazelcast-client/topic.rb

@@ -0,0 +1,12 @@
+class Java::ComHazelcastClient::TopicClientProxy
+
+  java_import 'com.hazelcast.core.MessageListener'
+
+  def on_message(&blk)
+    klass = Class.new
+    klass.send :include, MessageListener
+    klass.send :define_method, :on_message, &blk
+    add_message_listener klass.new
+  end
+
+end

data/test/helper.rb

@@ -0,0 +1,38 @@
+unless defined?(HELPER_LOADED)
+
+  require File.expand_path(File.dirname(__FILE__) + '/../lib/hazelcast-client')
+  require 'test/unit'
+  require 'forwardable'
+  require 'date'
+
+  # Load the Hazelcast cluster
+  CLIENT = Hazelcast::Client.new 'dev', 'dev-pass', 'localhost'
+
+  # Grab notices
+  class Notices
+    class << self
+      extend Forwardable
+      def all
+        @all ||= []
+      end
+      def_delegators :all, :size, :<<, :first, :last, :clear, :map
+    end
+  end
+
+  # Listen on messages
+  class TestListener
+    def initialize(name)
+      @name = name
+    end
+    def on_message(msg)
+      Notices << "[#{@name}] #{msg}"
+    end
+  end
+
+  # Loading the Employee Java class
+  $CLASSPATH << File.expand_path(File.dirname(__FILE__)) + '/'
+  java_import 'Employee'
+
+  # Finished loading helpers
+  HELPER_LOADED = true
+end

data/test/test_map.rb

@@ -0,0 +1,49 @@
+require File.expand_path(File.dirname(__FILE__) + '/helper')
+
+class TestRubyHazeHash < Test::Unit::TestCase
+
+  java_import 'com.hazelcast.query.SqlPredicate'
+
+  def test_same_object
+    hash = CLIENT.map :test_same_object
+    map  = CLIENT.map :test_same_object
+    assert_equal hash.name, map.name
+    hash[:a] = 1
+    assert_equal hash[:a], map[:a]
+  end
+
+  def test_string_keys
+    hash     = CLIENT.map :test_string_keys
+
+    hash[:a] = 1
+    assert_equal hash['a'], 1
+    assert_equal hash[:a], 1
+
+    hash['b'] = 2
+    assert_equal hash[:b], 2
+
+    hash[Date.new(2010, 3, 18)] = 3
+    assert_equal hash['2010-03-18'], 3
+
+    hash[4] = 4
+    assert_equal hash['4'], 4
+    assert_equal hash[4], 4
+  end
+
+  def test_predicates
+    map       = CLIENT.map :test_predicates
+
+    predicate = map.prepare_predicate "active = false AND (age = 45 OR name = 'Joe Mategna')"
+    assert_kind_of SqlPredicate, predicate
+    assert_equal "(active=false AND (age=45 OR name=Joe Mategna))", predicate.to_s
+
+    predicate = map.prepare_predicate :quantity => 3
+    assert_kind_of SqlPredicate, predicate
+    assert_equal 'quantity=3', predicate.to_s
+
+    predicate = map.prepare_predicate :country => "Unites States of America"
+    assert_kind_of SqlPredicate, predicate
+    assert_equal "country=Unites States of America", predicate.to_s
+  end
+
+end

data/test/test_queue.rb

@@ -0,0 +1,18 @@
+require File.expand_path(File.dirname(__FILE__) + '/helper')
+
+class TestRubyHazeQueue < Test::Unit::TestCase
+
+  def test_single_queing
+    tasks = CLIENT.queue :test_single
+    qty = 50
+    qty.times { |idx| tasks.put [idx, Process.pid] }
+    found = []
+    while !tasks.empty? do
+      task = tasks.poll
+      found << task
+    end
+    assert !found.empty?
+    assert_equal found.size, qty
+  end
+
+end

data/test/test_topic.rb

@@ -0,0 +1,32 @@
+require File.expand_path(File.dirname(__FILE__) + '/helper') unless defined?(HELPER_LOADED)
+
+class TestRubyHazeTopic < Test::Unit::TestCase
+
+  def test_block_listener
+    Notices.clear
+    topic = CLIENT.topic :test_block
+    topic.on_message do |msg|
+      Notices << "#{msg}"
+    end
+    assert_equal Notices.size, 0
+    topic.publish "Hola!"
+    sleep 0.25
+    assert_equal Notices.size, 1
+    assert_equal Notices.last, "Hola!"
+  end
+
+  def test_class_listener
+    Notices.clear
+    topic = CLIENT.topic :test_class
+    topic.add_message_listener TestListener.new("test_class")
+    assert_equal Notices.size, 0
+    topic.publish "Hola!"
+    sleep 0.25
+    assert_equal Notices.size, 1
+    assert_equal Notices.last, "[test_class] Hola!"
+  end
+
+  def test_class2_listener
+    Notices.clear
+  end
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification 
+name: hazelcast-client
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+    - 0
+    - 0
+    - 1
+  version: 0.0.1
+platform: jruby
+authors: 
+  - Adrian Madrid
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-07 00:00:00 -07:00
+default_executable: hazelcast-client-console
+dependencies: 
+  - !ruby/object:Gem::Dependency 
+    name: hazelcast-jars
+    prerelease: false
+    requirement: &id001 !ruby/object:Gem::Requirement 
+      requirements: 
+        - - "="
+          - !ruby/object:Gem::Version 
+            segments: 
+              - 1
+              - 9
+              - 1
+            version: 1.9.1
+    type: :runtime
+    version_requirements: *id001
+description: Hazelcast::Client is a little gem that wraps the Java Hazelcast Client library into a more comfortable JRuby package.
+email: 
+  - aemadrid@gmail.com
+executables: 
+  - hazelcast-client-console
+extensions: []
+
+extra_rdoc_files: 
+  - LICENSE
+  - README.rdoc
+files: 
+  - LICENSE
+  - README.rdoc
+  - Rakefile
+  - VERSION
+  - bin/hazelcast-client-console
+  - lib/hazelcast-client.rb
+  - lib/hazelcast-client/map.rb
+  - lib/hazelcast-client/queue.rb
+  - lib/hazelcast-client/topic.rb
+  - test/helper.rb
+  - test/test_map.rb
+  - test/test_queue.rb
+  - test/test_topic.rb
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+  - lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+          - 0
+        version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+          - 0
+        version: "0"
+requirements: []
+
+rubyforge_project: hazelcast-client
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Connecting to a Hazelcast Cluster has never been easier!
+test_files: 
+  - test/test_map.rb
+  - test/test_queue.rb
+  - test/test_topic.rb