莊周夢蝶

//test/main.class
public?class?main
????implements?RubyProgram
{

????public?main()
????{
????}

????public?static?void?main(String?args[])
????{
????????RubyRuntime.init(args);
????????(new?main()).run();
????????RubyRuntime.fini();
????}

????public?RubyValue?run()
????{
????????RubyRuntime.ObjectClass.defineMethod("say_hello_three_times",?new?say_hello_three_times._cls0());
????????return?RubyRuntime.callMethod(ObjectFactory.topLevelSelfValue,?null,?null,?"say_hello_three_times");
????}
}


//say_hello_three_times$0.class
class?say_hello_three_times$0?extends?RubyMethod
{

????protected?RubyValue?run(RubyValue?rubyvalue,?RubyArray?arrayvalue,?RubyBlock?rubyblock)
????{
????????return?RubyRuntime.callPublicMethod(ObjectFactory.createFixnum(3),?null,?new?BLOCK._cls1(),?"times");
????}

????public?say_hello_three_times$0()
????{
????????super(0,?false);
????}
}


//test/BLOCK$1.class
class?BLOCK$1?extends?RubyBlock
{

????protected?RubyValue?run(RubyValue?rubyvalue,?RubyArray?arrayvalue)
????{
????????RubyArray?arrayvalue1?=?new?RubyArray(1);
????????arrayvalue1.add(ObjectFactory.createString("hello"));
????????return?RubyRuntime.callMethod(rubyvalue,?arrayvalue1,?null,?"puts");
????}

????public?BLOCK$1()
????{
????????super(0,?false);
????}
}

在main類中：首先在"Object"類中定義了一個私有的方法"say_hello_three_times",然后通過no parameter, no block和一個top level "self"作為接收者的方式調用這個方法。

"say_hello_three_times$0"類表示say_hello_three_times方法的實現（參考command模式）。在代碼中，我們可以看到Fixnum"3"(接收者）調用了"timer"這個方法，仍然沒有parameter，但是有一個block被傳進去（方法）。

BLOCK$1類則表示傳進"3.times"方法中的block，代碼中是"puts 'hello'"的實現。

源碼結構

• com.xruby.compiler.parser 提供了一個compiler前端(parser and tree parser)。 Parser轉換ruby腳本成AST (Abstract Syntax Tree)，然后 tree parser將AST轉換為內部結構（internal structure）。
  編譯器前端使用 Antlr 作為語法分析器的生成器.實踐證明，將這個前端分為兩部分可以帶來好處：parser 和 tree parser；其中 parser 解析腳本，而tree parser生成內部結構（internal structure）。
• com.xruby.compiler.codedom 定義了描述ruby腳本結構的內部結構（internal structure）。內部結構作為前端和后端的接口，對于xruby是非常重要的。
• com.xruby.compiler.codegen 實現了編譯器的后端（代碼生成）。后端將前端生成的內部結構轉換為java字節碼。代碼生成是通過ASM實現的，ASM簡化了對字節碼的操作。
• com.xruby.runtime 實現了xruby運行時（runtime），它維護著運行ruby腳本必需的類型系統, com.xruby.runtime.lang 描述了ruby類型的運行時結構，一些ruby內建標準庫實現在 com.xruby.runtime.builtin.

內建庫

通往xuby hacking之路最簡便的辦法就是學習 'com.xruby.runtime.builtin'包的源代碼。

下面是來自Fixnum::+方法實現的代碼片段：

class?Fixnum_operator_plus?extends?RubyMethod?{
????public?Fixnum_operator_plus()?{
????????super(1);
????}

????protected?RubyValue?run(RubyValue?receiver,?RubyArray?args,?RubyBlock?block)?{
????????RubyFixnum?value1?=?(RubyFixnum)receiver.getValue();
????????RubyFixnum?value2?=?(RubyFixnum)args.get(0).getValue();
????????return?ObjectFactory.createFixnum(value1.intValue()?+?value2.intValue());
????}
}


RubyClass?c?=?RubyRuntime.GlobalScope.defineNewClass("Fixnum",?RubyRuntime.IntegerClass);
c.defineMethod("+",?new?Fixnum_operator_plus());

XRuby的語法解析器

Xruby的解析器使用 Antlr 作為解析器的生成器。 這是目前相比于c ruby唯一另類的ruby語法。

對于大部分編程語言來說，詞法分析（lexing）和語法解析是兩個不同的步驟：首先詞法分析器將輸入的字符組織成單詞（token），然后解析器將單詞組織成句法單元。但是在ruby（和perl語言）中，詞法分析器和語法解析器是緊緊地耦合在一起的：有時候詞法分析器需要從語法分析器中獲取上下文信息。

疑難解決

作為Xruby的開發者，我們的任何改變都可能導致編譯器出錯并且生成有問題的字節碼。當這種情況發生時，我們可以依賴3樣工具：javap,ASM和你所喜歡的java反編譯器(比如jad）

如果生成的class文件格式正確但是運行結果不是預期的，我們可以簡單地使用反編譯工具將字節碼轉換成可讀的java源代碼,以便查找錯誤。

如果你遇到是一個verifier error，大部分的反編譯器都不能正常工作（jad在這種情況也許會crash掉）。我們不得不使用javap來研讀字節碼。多數情況下，JVM class驗證器（verifier）給出的信息沒什么用處，但是我們可以通過ASM更快地找到錯誤發生點。(see ASM FAQ: Why do I get the [xxx] verifier error?).