「ComputerCraft API/1.75/ILuaObjectの利用」を編集中

[[ComputerCraft_API|ComputerCraft API]] >
{{前提MOD|reqmod="Minecraft Forge Universal 10.13.0.x～"及び"ComputerCraft 1.75～"}}

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

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


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

次の例では、MyObjectというJava側で作成したオブジェクトをILuaObjectを用いてLua側で扱えるようにしています。

実装例（IPeripheral.callMethod()の戻り値でLua側へ渡す場合）：
<source lang = "java">
public class SamplePeripheral implements IPeripheral {

	@Override
	public String getType() {
		return "sample";
	}

	@Override
	public String[] getMethodNames() {
		return new String[] { "createMyObject" }
	}

	@Override
	public Object[] callMethod(IComputerAccess computer, ILuaContext context, int method, Object[] arguments) throws LuaException, InterruptedException {
		switch (method) {
		case 0:  // createMyObject
			MyObject myObject = new MyObject();  // ILuaObjectで扱うJava側のオブジェクトの例
			return new Object[] { wrapMyObject(myObject) };  // myObjectをILuaObjectでラップしてLua側へ渡す
		}

		return null;
	}

	private ILuaObject wrapMyObject(final MyObject myObject) {  // 匿名クラス内で利用するためにfinalにする
		return new ILuaObject() {

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

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

		};
	}

	/* 略 */

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

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

=== ILuaObjectの引き渡し ===

実装したILuaObjectオブジェクトは、以下のようなメソッドでLua側へ渡すことができます。
*'''IPeripheral.callMethod()'''の戻り値のObject[]の要素
*'''IComputerAccess.queueEvent()'''の引数のObject[]の要素
*'''TurtleCommandResult.success()'''の引数のObject[]の要素

=== Lua側での利用 ===

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

ここでは、上の例で実装した周辺機器を元に、ILuaObjectの実装部分に手を加えて解説します。

例えばJava側で以下のようにILuaObjectを実装した場合、
<source lang = "java">
// Java:
// ILuaObject.getMethodNames()
@Override
public String[] getMethodNames() {
	return new String[] { "getType", "getPos", "getName", "kill" };
}
</source>
Lua側では以下のようにメソッドを呼び出すことができます。
<source lang = "lua">
-- Lua:
-- 周辺機器からILuaObjectを取得
local tSample = peripheral.find("sample")
local tMyObject = tSample.createMyObject()
-- 取得したILuaObjectのメソッド呼び出し
tMyObject.getType()
tMyObject.getPos()
tMyObject.getName()
tMyObject.kill()
</source>
Lua側でメソッドを呼び出した場合、Java側では実装したcallMethod()が呼び出されます。
<source lang = "java">
// 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;
}
</source>
以上の仕組みにより、Lua側から呼び出されたメソッドによって、Java側のオブジェクトを操作したり、値を返したりすることができます。