ComputerCraft API/1.75/ILuaObjectの利用

ComputerCraft API >

この記事は"Minecraft Forge Universal 10.13.0.x～"及び"ComputerCraft 1.75～"を前提MODとしています。

ILuaObjectの利用

ILuaObjectを利用してJava側のオブジェクトをLua側から扱えるようにする方法について解説します。

• ILuaObjectの実装
• Lua側での利用

ILuaObjectの実装

ILuaObjectとは、通常Luaでは扱えない独自のオブジェクトをLua側からでも間接的に扱えるようにするためのインターフェイスです。

実装例（IPeripheral.callMethod()の戻り値でLua側へ渡す場合）：

public class MyPeripheral implements IPeripheral {

	/* 略 */

	@Override
	public Object[] callMethod(IComputerAccess computer, ILuaContext context, int method, Object[] arguments) throws LuaException, InterruptedException {
		/* 略 */

			MyObject myObject = new MyObject();	// ILuaObjectで扱うオブジェクトの例
			return new Object[] { wrapMyObject(myObject) };

		/* 略 */
	}

	private ILuaObject wrapMyObject(final MyObject myObject) {
		return new ILuaObject() {

			@Override
			public String[] getMethodNames() {
				return new String[] { /* myObject を扱うためのメソッド名の配列 */ };
			}

			@Override
			public Object[] callMethod(ILuaContext context, int method, Object[] arguments) throws LuaException, InterruptedException {
				// TODO: myObject を扱うためのメソッドの処理を実装
				return null;
			}

		};
	}

}

この例ではILuaObjectを匿名クラス（無名クラス）で実装しましたが、もちろん通常のクラスで実装しても構いません。

Java側のオブジェクトをLua側から扱うためのメソッドを ILuaObject.getMethodNames() 及び ILuaObject.callMethod() で実装します。
実装方法については IPeripheral.getMethodNames() 及び IPeripheral.callMethod() と同じなので、「周辺機器メソッドの追加」を参考にしてください。

ILuaObjectの引き渡し

実装したILuaObjectオブジェクトは、以下のようなメソッドでLua側へ渡すことができます。

• IPeripheral.callMethod()の戻り値のObject[]の要素
• IComputerAccess.queueEvent()の引数のObject[]の要素
• TurtleCommandResult.success()の引数のObject[]の要素

Lua側での利用

ILuaObjectオブジェクトはテーブルに変換されてLua側へ渡されます。テーブルの要素はキーがメソッド名の文字列、値がそのメソッドを呼ぶための関数です。

例えばJava側で以下のようにILuaObjectを実装した場合、

// Java:
// ILuaObject.getMethodNames()
@Override
public String[] getMethodNames() {
	return new String[] { "getType", "getPos", "getName", "kill" };
}

Lua側では以下のようにメソッドを呼び出すことができます。

-- Lua:
-- 以下 tObject に、実装した ILuaObject が入っているものとする
tObject.getType()
tObject.getPos()
tObject.getName()
tObject.kill()

Lua側でメソッドを呼び出した場合、Java側では実装したcallMethod()が呼び出されます。

// Java:
// ILuaObject.callMethod()
@Override
public Object[] callMethod(ILuaContext context, int method, Object[] arguments) throws LuaException, InterruptedException {
	switch(method) {
	case 0:
		// getType の処理
	case 1:
		// getPos の処理
	case 2:
		// getName の処理
	case 3:
		// kill の処理
	}

	return null;
}