A JRuby wrapper to the JGroups toolkit

JGroups is toolkit that allows reliable multicast communication.

This wrapper will be attempt to expose some of the basic but hopefully useful parts of the API in a ruby fashion. Starting with the ability to send messages to the cluster.

Watch out for network configuration errors. If you see errors stating that the network is down, then you likely don't have multicasting setup correctly on network, or you are on a WIFI network. See the JGroups site for information on how to run without a network.

Let's see some code:

# connect to the multicast cluster
RGroups::Channel.connect 'MyCluster' do |ch|

  # set a callback to receive messages
  ch.receiver do |message|
    puts "#{message.source}: #{message}"
  end


  # sending a message
  ch.send_message('Howdy')
  ch.send_message('Hi', {:source => '192.168.1.1', 
                      :destination => '192.168.1.100'})

  # you can actually send any java object
  ch.send_message([1,2,3].to_java)

  # Don't forget to handle it on receive
  # message.data.to_a

end # channel closed at the end of the block

Second Style allows you to send messages outside of the initial block

channel = RGroups::Channel.bind 'AnotherCluster' do |ch|
  ch.receiver do |message|
    puts message
  end
end # this block will NOT close the channel

channel.send_message("TESTING")

# make sure you close the channel
channel.close

Check the examples to see an application using the library

# run an example
jruby --1.9 examples/rchat_test.rb

Running the Tests

bundle install && rake

Features I'd like to add:

• More examples
• use JGroups shared state facilities