从JRuby迁移至Truffle Ruby：如何实现Java类的猴子补丁？

正在评估将大型项目从JRuby迁移至Truffle Ruby，遇到阻碍：Truffle文档明确无法重新打开Java类。项目使用GraalVM多语言包，依赖自研Java映射实现GMap，JRuby中可通过扩展该类添加便捷方法，隐藏Java强类型特性。

Java原生用法 #

GMap map = new GMap();
map.put("k1","test");
map.put("k2", 123);
String s = map.getStr("k1"); 
int i = map.getInt("k2");
// ...

JRuby扩展后的便捷写法 #

map = GMap.new
map[:key1] = 'test'
map[:key2] = 123
s = map[:key1]
i = map[:key2]
// ...

尝试改用多语言语法的JRuby猴子补丁写法时，在Truffle Ruby中报错：

#<Polyglot::ForeignClass[Java] type org.jellyfish.gmap.GMap> is not a class

该错误可通过任意标准Java类复现。

由于Truffle Ruby不允许直接修改外部（Java）类的定义，可通过以下几种方式实现类似的便捷操作：

1. 使用Ruby包装器类 #

创建一个Ruby类包裹GMap实例，在包装器中实现[]和[]=方法，内部转发调用到Java实例：

Java.import 'org.jellyfish.gmap.GMap'

class GMapWrapper
  def initialize
    @gmap = GMap.new
  end

  # 实现读取操作
  def [](key)
    @gmap.getObj(key.to_s.to_java(:string))
  end

  # 实现写入操作
  def []=(key, value)
    # 根据value类型选择对应的put方法，或统一调用通用put方法（如果GMap支持）
    case value
    when String
      @gmap.put(key.to_s.to_java(:string), value.to_java(:string))
    when Integer
      @gmap.put(key.to_s.to_java(:string), value.to_java(:int))
    else
      # 处理其他类型或默认逻辑
      @gmap.put(key.to_s.to_java(:string), value)
    end
  end

  # 转发其他需要的GMap方法
  def method_missing(name, *args, &block)
    if @gmap.respond_to?(name)
      @gmap.__send__(name, *args, &block)
    else
      super
    end
  end

  def respond_to_missing?(name, include_private = false)
    @gmap.respond_to?(name) || super
  end
end

使用方式：

map = GMapWrapper.new
map[:key1] = 'test'
map[:key2] = 123
s = map[:key1]
i = map[:key2]

2. 使用Ruby Refinements #

通过Refinements为GMap类型添加临时扩展，仅在激活的作用域内生效：

Java.import 'org.jellyfish.gmap.GMap'

module GMapExtensions
  refine Polyglot::ForeignClass do
    def [](key)
      self.getObj(key.to_s.to_java(:string))
    end

    def []=(key, value)
      case value
      when String
        self.put(key.to_s.to_java(:string), value.to_java(:string))
      when Integer
        self.put(key.to_s.to_java(:string), value.to_java(:int))
      else
        self.put(key.to_s.to_java(:string), value)
      end
    end
  end
end

使用时需要激活Refinement：

using GMapExtensions

map = GMap.new
map[:key1] = 'test'
map[:key2] = 123
s = map[:key1]
i = map[:key2]

注意：Refinements的作用域有限，仅在using语句所在的文件/作用域内生效，适合局部代码改造。

3. 扩展单个实例的单例类 #

如果仅需要对特定的GMap实例添加便捷方法，可以直接修改实例的单例类：

Java.import 'org.jellyfish.gmap.GMap'

map = GMap.new

# 给单个实例添加[]方法
def map.[](key)
  self.getObj(key.to_s.to_java(:string))
end

# 给单个实例添加[]=方法
def map.[]=(key, value)
  case value
  when String
    self.put(key.to_s.to_java(:string), value.to_java(:string))
  when Integer
    self.put(key.to_s.to_java(:string), value.to_java(:int))
  else
    self.put(key.to_s.to_java(:string), value)
  end
end

这种方式适合零散的实例操作，但如果需要大量实例都使用该特性，包装器或Refinements更高效。

内容的提问来源于stack exchange，提问作者David Semeria