For those who may not be familiar, Tom Enebo and Charles Nutter were full-time Sun employees until late July when they switched companies to Engine Yard. As many others have said, it’s a different experience (and in my opinion, a very good one) seeing JRuby posts show up on the EngineYard blog.
You have to make a decision at some point when developing a JRuby application as to whether or not you are going to hide the ‘Java’ in your JRuby application from the main bulk of your code. Obviously, if you are developing a Swing GUI, it’s pretty much a foregone conclusion that it’s a JRuby app, and JRuby alone. On the other hand, it’s very possible now-a-days to code a Rails app that can run concurrently on JRuby, MRI, and any other compliant platform.
No answer is ‘right’. Each approach has its own virtues, and it really depends on your goals. A Java developer who simply wants to make coding Java apps easier could easily switch to JRuby and sprinkle Java references throughout their app. On the flip-side, you may just choose to deploy an existing Ruby app on JRuby for it’s compelling performance characteristics and its alternative deployment/scalability options; or perhaps your company would rather manage a Glassfish cluster than a Mongrel cluster - there are a variety of possible reasons.
Tom’s article (part 2) delves a little deeper into the influence of Java from an API perspective (as opposed to the basic Java-integration language constructs). His comments on delegation are compelling:
Delegation as a concept is not specific to Ruby, but is worth bringing up. Why decorate a Java class and get all of that Java class’s methods exposed when you can hide them behind another Ruby class that only exposes what you want? This is especially powerful when you want to write a common API that works across multiple Ruby implementations (e.g. JRuby, MRI, and Rubinius), but has different native backends.
In practice, even if you have committed to JRuby as your platform and have Java libraries referenced all over the place, it can still be very valuable to abstract APIs around the original Java implementation - if for no other reason than Java APIs needing some TLC to feel natural in Ruby. Likewise, there are cases where using Java libraries as the driver for a particular component of your application may give you a competitive advantage on JRuby.
In that vein, I was recently working on a high-concurrency component of a JRuby application. In my opinion, the Java libraries for concurrency are much further evolved than those in Ruby; particularly after the advent of
java.util.concurrent in Java 5. One of those areas where Ruby is lacking is the existence of a read-write lock. Jonah Burke previously blogged about implementing a read-write lock using the standard Ruby mutex objects. His implementation is simple, well-implemented, and should be quite reliable. However, Java’s
ReentrantReadWriteLock is fully integrated into the underlying Java platform, including in the instrumentation libraries (detailed briefly here). To me, if you plan to run on a Java platform, being able to independently monitor locks held by the Ruby runtime is a Good Thing.
Here is a simple JRuby implementation of a ReadWriteLock that uses a Java lock via delegation:
1require 'java' 2 3class ReadWriteLock 4 include_package 'java.util.concurrent.locks' 5 def initialize 6 @java_lock = ReentrantReadWriteLock.new 7 end 8 9 def read(&block) 10 read_lock = @java_lock.read_lock 11 read_lock.lock 12 begin 13 block.call 14 ensure 15 read_lock.unlock 16 end 17 end 18 19 def write(&block) 20 write_lock = @java_lock.write_lock 21 write_lock.lock 22 begin 23 block.call 24 ensure 25 write_lock.unlock 26 end 27 end 28end
As you can see, JRuby makes using Java objects and extending them very straightforward.
This particular implementation is not 100% API-compatible with the one provided by Jonah, however with a little manipulation it could be easily (I’ll leave it as an exercise to the reader). This is really more of an example of how Java can provide the underlying engine for Ruby libraries when running on JRuby (this is how the majority of JRuby is implemented, after all) - and if this were API compatible with Jonah’s, it’d simply be a matter of constructing this in an isolated factory method, and switching implementations then becomes simply a matter of flipping a flag.
Note that instead of delegation, you could also simply extend the existing Java object with more goodies. Here is an alternate implementation of these same block methods that simply appends these methods to the Java class itself:
1require 'java' 2 3class java::util::concurrent::locks::ReentrantReadWriteLock 4 def read(&block) 5 read_lock = self.read_lock 6 read_lock.lock 7 begin 8 block.call 9 ensure 10 read_lock.unlock 11 end 12 end 13 14 def write(&block) 15 write_lock = self.write_lock 16 write_lock.lock 17 begin 18 block.call 19 ensure 20 write_lock.unlock 21 end 22 end 23end
In practice this works almost identically to the first example. This implementation has some API-leakage (the Java methods on ReentrantReadWriteLock are available to call by the client code), but also has one less object involved, as the methods are added to the Java lock class itself, rather than provided by a proxy object. Which approach you would use for your particular use-case is really dependent upon the scenario in question, and your goals for the API.
Either way for this example, the core usage of this library is identical irrespective of which implementation you choose:
1lock = ReadWriteLock.new 2# Alternatively, the second example would be created this way: 3# require 'java' 4# import java.util.concurrent.locks.ReentrantReadWriteLock 5# lock = ReentrantReadWriteLock.new 6 7# Usage is identical 8lock.read do 9 puts 'Executing with read lock' 10end 11 12lock.write do 13 puts 'Executing with write lock' 14end