从 C++ 反弹的对象的 SWIG Java 保留类信息

Question

好的，有一个关键字我故意远离标签和标题。那是“Android”，但那是因为即使该项目是在 Android 中的，我认为我的问题与它没有任何关系，并且我不想吓到没有 Android 经验的人。

所以，swig 的常见问题。我在 C++ 类中有一个虚拟方法，我通过在类中添加 director 功能使其在 Java 中可重载，并且它可以工作。问题是该方法接收到一个多态参数，该参数也在Java端进行了扩展，并且在Java中的虚拟方法调用期间，该对象带有所有多态信息。

呈现准确的情况；我正在用 C++ 编写一个游戏引擎，我想在 Java 中愉快地使用它。游戏引擎有一个GameObject 类，它注册CollisionListeners，当碰撞引擎检测到碰撞事件时，它调用所有已注册collisionListeners 的collidedWith(GameObject & collidee) 方法，将它们与碰撞的对象一起传递给它们。

class CollisionListener {
public:
    virtual bool collidedWith(GameObject &){};
    ~CollisionListener(){} // I know this needs to be virtual but let's forget about that now
};

我使用以下接口文件Bridge.i 将这个类以及GameObject 类公开给java

%module(directors="1") Bridge

%feature("director") CollisionListener;
%include "CollisionListener";
%feature("director") GameObject;
%include "GameObject.h"

现在，当我从 java 中的 CollisionListener 继承并重载 collidedWith 时，它会被 java 端 GameObject 对象调用。例如，如果我从 java 端 GameObject 类继承并定义一个 Bullet 类，当此子弹与另一个带有侦听器的对象发生冲突时，在 collidedWith 方法调用中，我收到的只是一个裸露的 GameObject ，因此(object instanceof Bullet) 不起作用。毫不奇怪，我研究了生成的 swig BridgeJNI.java 并发现了这个：

  public static boolean SwigDirector_CollisionListener_collidedWith(CollisionListener self, long arg0) {
    return self.collidedWith(new GameObject(arg0, false));
  }

所以它在调用 java 重载之前在指针周围包裹了一个新对象。

那么，主要问题是如何在发生碰撞时接收Bullet 对象？

我想出了一种方法来轻松实现这一点，但我需要修改自动生成的文件，这是个坏主意。所以我希望一些 swig 大师可以帮助我将修改注入到 swig 生成的文件中。

我的小窍门是在每个 C++ 端 GameObject 对象中保留一个 jobject * self，并在构建真正的 java 端 GameObject 期间分配真正的 java 对象的地址（而不是仅仅包装的那个）指针）。这样，我可以在 C++ 端 GameObject 中定义一个多态 getSelf 方法，并在 java 中愉快地使用结果。有没有办法将必要的代码注入到 swig 生成的文件中？

谢谢

注意：如果您在 Android 上尝试过 Director 并没有成功，那是因为当前的稳定版本不支持它。从 swig 网站下载 Bleeding Edge。但我在 2012 年 3 月 22 日写这篇文章，很快就不需要了。析构函数不是虚拟的原因是 Bleeding Edge 版本使程序在析构函数中崩溃，并且使其非虚拟似乎暂时可以控制它。

Answer 1

我已经为这个问题制定了一个解决方案。不过，这并不是您在问题中建议的解决方案，它是 Java 方面的更多代码，而 JNI/C++ 方面没有额外的代码。 （我发现在所有可能的情况下，按照您建议的方式进行操作非常棘手）。

我将你的类简化为一个头文件：

class GameObject {
};

class CollisionListener {
public:
    virtual bool collidedWith(GameObject &) { return false; }
    virtual ~CollisionListener() {} 
};

inline void makeCall(GameObject& o, CollisionListener& c) {
    c.collidedWith(o);
}

其中还添加了makeCall 以使问题变得明显。

我使用的技巧是在创建时自动在HashMap 中注册GameObject 的所有Java 派生实例。然后在调度director call时，只是在HashMap中查找它的问题。

然后是模块文件：

%module(directors="1") Test

%{
#include "test.hh"
%}

%pragma(java) jniclasscode=%{
  static {
    try {
        System.loadLibrary("test");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load. \n" + e);
      System.exit(1);
    }
  }
%}

/* Pretty standard so far, loading the shared object 
   automatically, enabling directors and giving the module a name. */    

// An import for the hashmap type
%typemap(javaimports) GameObject %{
import java.util.HashMap;
import java.lang.ref.WeakReference;
%}

// Provide a static hashmap, 
// replace the constructor to add to it for derived Java types
%typemap(javabody) GameObject %{
  private static HashMap<Long, WeakReference<$javaclassname>> instances 
                        = new HashMap<Long, WeakReference<$javaclassname>>();

  private long swigCPtr;
  protected boolean swigCMemOwn;

  public $javaclassname(long cPtr, boolean cMemoryOwn) {
    swigCMemOwn = cMemoryOwn;
    swigCPtr = cPtr;
    // If derived add it.
    if (getClass() != $javaclassname.class) {
      instances.put(swigCPtr, new WeakReference<$javaclassname>(this));
    }
  }

  // Just the default one
  public static long getCPtr($javaclassname obj) {
    return (obj == null) ? 0 : obj.swigCPtr;
  }

  // Helper function that looks up given a pointer and 
  // either creates or returns it
  static $javaclassname createOrLookup(long arg) {
    if (instances.containsKey(arg)) {
      return instances.get(arg).get();
    }
    return new $javaclassname(arg,false);
  }
%}

// Remove from the map when we release the C++ memory
%typemap(javadestruct, methodname="delete", 
         methodmodifiers="public synchronized") GameObject {
  if (swigCPtr != 0) {
    // Unregister instance
    instances.remove(swigCPtr);
    if (swigCMemOwn) {
      swigCMemOwn = false;
      $imclassname.delete_GameObject(swigCPtr);
    }
    swigCPtr = 0;
  }
}

// Tell SWIG to use the createOrLookup function in director calls.
%typemap(javadirectorin) GameObject& %{
    $javaclassname.createOrLookup($jniinput)
%}
%feature("director") GameObject;

// Finally enable director for CollisionListener and include the header
%feature("director") CollisionListener;    
%include "test.hh"

请注意，由于所有 Java 实例都存储在 HashMap 中，因此我们需要使用 WeakReference 来确保我们不会延长它们的寿命并防止垃圾收集发生。如果您关心线程，请根据需要添加同步。

我对此进行了测试：

public class main {
  public static void main(String[] argv) {
    JCollisionListener c = new JCollisionListener();
    JGameObject o = new JGameObject();
    c.collidedWith(o);  
    Test.makeCall(o,c);
  }
}

JCollisionListener 在哪里：

public class JCollisionListener extends CollisionListener {
  public boolean collidedWith(GameObject i) {
    System.out.println("In collide");
    if (i instanceof JGameObject) {
       System.out.println("Is J");
    }
    else {
       System.out.println("Not j");
    }
    JGameObject o = (JGameObject)i;
    return false;
  }
}

而JGameObject 是：

public class JGameObject extends GameObject {
}

（如果您想使用其他方法作为参考，您可以考虑编写 directorin 类型映射）。