JRuby #02 - Ruby rozmawia z Javą, Java rozmawia z Ruby’im

napisane przez wiktor, 17:44 05-09-2008

Krok drugi: integracja

W poprzednim poście opisywałem proces instalacji JRuby'iego tak, żeby korzystanie z niego było proste. Czas wziąć na warsztat integrację Ruby'iego z Javą i odwrotnie.

Ruby rozumie Javę

Kiedy JRuby interpretuje skrypt Ruby'iego to mogą tam być używane wszystkie klasy Javowe. Chcemy, żeby skrypt korzystał z naszej wcześniej utworzonej biblioteki w Javie? Nie ma problemu, dołączamy ją do CLASSPATH i możemy z poziomu Ruby'iego z niej korzystać. Integracja została przedstawiona na poniższych przykładach. Dołożyłem wszelkich starań, aby komentarze były wyczerpujące.

Uruchommy interakcyjną konsolę JRuby'iego: jruby -S jirb i następnie pobawmy się kodem:

RUBY:
  1. # Znane z Javy importowanie wygląda standardowo.
  2. # Niestety importowanie z gwiazdką nie działa, więc import javax.swing.* poczęstuje nas błędem.
  3. import javax.swing.JFrame
  4. import javax.swing.JButton
  5.  
  6. # Składnia Ruby'iego została zachowana dla obiektów Javowych, widać to w tworzeniu nowego egzemplarza JFrame
  7. # Warto zauważyć, że nawiasy są nieobowiązkowe. Poniższe wywołanie jest równoznaczne z JFrame.new("...")
  8. frame = JFrame.new "Ruby swinguje z Java"
  9.  
  10. # Styl kodowania Ruby'iego zostaje zachowany także dla metod. W Javie lubimyTakPisać, a w Ruby'im trochę_inaczej.
  11. # Poniższe wywołanie jest równoważne z frame.setSize(300, 300), które także byłoby poprawne.
  12. frame.set_size 300, 300
  13.  
  14. # Gettery i settery Javowe są dostępne także w odmianie Ruby'iego.
  15. # Poniższa linijka jest równoważna z frame.setAlwaysOnTop(true), które także byłoby poprawne.
  16. frame.always_on_top = true
  17.  
  18. button = JButton.new "Nacisnij mnie"
  19.  
  20. # Blok kodu zostanie w locie przekształcony w klasę implementującą interfejs ActionListener. Niezłe!
  21. # Jest to domyślne zachowanie JRuby'iego, jeśli parametrem jest interfejs z jedną metodą.
  22. # Standardowo w Ruby'im używa się wcięć z 2 spacjami.
  23. button.add_action_listener do |event|            
  24.   # Przykład getterów ala Ruby. Równoznaczne z event.getSource().setText("..."), które także jest OK.
  25.   event.source.text = "Nie naciskaj mnie ponownie!"
  26.   event.source.enabled = false
  27. end
  28.  
  29.  
  30. frame.add(button)
  31. frame.show

Czas poczęstować Ciebie czytelniku jakimś smakołykiem. Oto on:

RUBY:
  1. # Rozszerzenie klasy Javowej String o mechanizm missing_method, czyli
  2. # ta metoda zostanie wywołana, jeśli na obiekcie zostanie wywołana metoda, która
  3. # nie została zdeklarowana.
  4. JavaUtilities.extend_proxy "java.lang.String" do
  5.   def method_missing(symbol, *args)
  6.     puts "Kogo wolasz?"
  7.   end
  8. end
  9.  
  10. txt = java.lang.String.new "Ala ma kota"
  11.  
  12. txt.hmmmm_jak_brzmiala_nazwa_tej_metody?()  # => "Kogo wolasz?"

Java rozumie Ruby'iego

Ruby może zostać wpleciony w kod Javy na 3 sposoby:

  • poprzez Scripting API (wprowadzone z Javą 6, JSR 223, unifikacja silników skryptowych używanych w Javie), szczegóły: https://scripting.dev.java.net,
  • poprzez Beans Scripting Framework (standard wprowadzany przez Apache Jakarta), szczegóły: http://jakarta.apache.org/bsf,
  • bezpośrednio odwołując się do interpretera JRuby'iego.

Zajmiemy się tylko pierwszą opcją. Będziemy do tego potrzebowali opakowania silnika JRuby'iego dla javax.script, które znajdziemy tutaj (najlepiej wersję 1.1.3).

jruby-scripting-api

Powyższa grafika przedstawia zależności w Java Scripting API. Z naszego kodu będziemy odwoływać się wyłącznie do klas javax.script.*, żądać silnika JRuby'iego (jruby-engine.jar), który z kolei sam już będzie odpowiednio wywoływał interpreter JRuby'iego.

Czas podwinąć rękawy i trochę pokodować.

JAVA:
  1. import org.jruby.RubyHash;
  2. import javax.script.*;
  3. import java.util.List;
  4. import java.util.ArrayList;
  5. import java.util.Map;
  6. import static java.lang.System.*;
  7.  
  8. public class RubyInJava {
  9.  
  10.     public static void main(String[] args) {
  11.         // Od Java Scripting API żądamy silnik JRuby'iego
  12.         ScriptEngine rubyEngine = new ScriptEngineManager().getEngineByName("jruby");
  13.         ScriptContext context = rubyEngine.getContext();
  14.  
  15.         List<Integer> list = new ArrayList<Integer>() {{
  16.             add(1); add(2); add(3); add(4);  
  17.         }};
  18.  
  19.         // Do środowiska JRuby'iego dodajemy globalną zmienną list
  20.         rubyEngine.put("list", list);
  21.  
  22.         // Skrypt Ruby'iego, który będziemy wykonywać
  23.         StringBuilder script = new StringBuilder();
  24.         script.append("puts '--- Ruby ---'                                  ").append("\n")
  25.               .append("puts $list.inspect                                   ").append("\n")
  26.               // JRuby do kolekcji Javowych dodaje typowe metody Ruby'iego dla kolekcji
  27.               .append(" $list.each { |item|                                 ")
  28.               .append("   puts \"Element #{item}\"                          ")
  29.               .append(" }                                                   ").append("\n")
  30.               .append(" puts \"Suma: #{$list.inject { |sum, i| sum + i }}\" ").append("\n")
  31.               .append("\n")
  32.               .append(" $hash = { :ala => :ma, :co => :kota }               ").append("\n");
  33.  
  34.         // Wykonanie skryptu
  35.         try {
  36.             rubyEngine.eval(script.toString(), context);
  37.         } catch (ScriptException e) {
  38.             e.printStackTrace();
  39.             return;
  40.         }
  41.  
  42.         out.println("--- Java ---");
  43.  
  44.         // Pobranie zmiennej globalnej po wykonaniu skryptu
  45.         Object hashAsObject = rubyEngine.get("hash");
  46.         out.println("Klasa: " + hashAsObject.getClass());
  47.  
  48.         RubyHash hash = (RubyHash) hashAsObject;
  49.         for (Object o : hash.entrySet()) {
  50.             Map.Entry entry = (Map.Entry) o;
  51.             System.out.println(entry.getKey() + " => " + entry.getValue());
  52.         }
  53.     }
  54. }

Aby uruchomić powyższy kawałek kodu trzeba mieć w CLASSPATH: jruby.jar oraz jruby-engine.jar.

Powyższe przykłady ilustrują, że ludzie pracujący nad JRuby'im wykonali kawał dobrej roboty, żeby łączenie Javy z Ruby'im było bezstresowe dla developerów. Takie połączenie dwóch światów daje nam nowe możliwości: tworzenie mini-języków dla aplikacji Javowych, aplikacje Swingowe w Ruby'im, nie wspominając o Ruby on Rails, a dla Ruby'istów dostępny jest cały ekosystem Javy :).

Jeden komentarz

  1. mj napisał(a):

    niezłe :] czekam na #3

Zostaw komentarz

Możesz używać znaczników do formatowania kodu takich jak: <b>...</b>, <code>...</code> lub dla konkretnych języków programowania: [java]...[/java], [ruby]...[/ruby] itd.


Wiktor Gworek Nazywam się Wiktor Gworek i jestem gospodarzem tego bloga.
Przeczytaj więcej o mnie »