XLua 源码学习原理(一)
https://blog.csdn.net/zhaoguanghui2012/article/details/101675435
@https://zhuanlan.zhihu.com/p/68406928
刚刚初学XLua的源码,作为一个记录。
- XLua调用C#代码
在XLua中可以直接使用Lua代码来调用C#中的代码。
CS.UnityEngine.Debug.Log('hello world')
接下来就是记录XLua是如何实现其调用的.
- XLua中的CS变量的功能
CS是一个全局的Table,所以CS.UnityEngine可以当做是在一个名为CS的Table表中查询名为UnityEngine的值。获取其值是通过CS的元方法__index来实现的。其逻辑代码在创建LuaEnv时候调用下面的代码,进行CS表的初始化。
DoString(init_xlua, "Init");
下面代码是截取了部分的init_xlua代码。
这部分描述的是_index元方法的实现。元方法__index就是CS表中访问不存在的元素时候进行的操作。比如CS={'A='a','B'='b'},那么在Lua中直接访问CS.A就会返回a。但是如果访问C就会因为原来表中不存在这个记录,那么而调用__index这个方法。
代码实现注释如下
-
inti_xlua.lua
-
local metatable = {}
-
local rawget = rawget
-
local setmetatable = setmetatable
-
local import_type = xlua.import_type
-
local import_generic_type = xlua.import_generic_type
-
local load_assembly = xlua.load_assembly
-
function metatable:__index(key)
-
--查询自己Key为'.fqn'的值,并且不触发__index元方法
-
local fqn = rawget(self,'.fqn')
-
--拼接'.fqn'的值和本次调用的key
-
fqn = ((fqn and fqn .. '.') or '') .. key
-
--尝试查询CS类型.
-
local obj = import_type(fqn)
-
if obj == nil then
-
-- It might be an assembly, so we load it too
-
--如果为空,有可能这个字段还是类名的一部分,那么创建一个table记录,然后缓存返回.
-
obj = { ['.fqn'] = fqn }
-
setmetatable(obj, metatable)
-
elseif obj == true then
-
return rawget(self, key)
-
end
-
-- Cache this lookup
-
rawset(self, key, obj)
-
return obj
-
end
-
CS = CS or {}
-
setmetatable(CS, metatable)
- Lua中获取C#类对应的Table表
XLua中有两种方式来实现Lua调用CS中的方法,一种是反射来调用,一种是生成适配的代码。
在获取对应类的Lua表时候,使用的是import_type方法,也是在创建LuaEnv实例时候进行注册的代码如下。
-
ObjectTranslator.cs
-
public void OpenLib(RealStatePtr L) {
-
if (0 != LuaAPI.xlua_getglobal(L, "xlua")){ throw new Exception("call xlua_getglobal fail!" + LuaAPI.lua_tostring(L, -1));}
-
LuaAPI.xlua_pushasciistring(L, "import_type");
-
LuaAPI.lua_pushstdcallcfunction(L,importTypeFunction);
-
LuaAPI.lua_rawset(L, -3);
-
...
-
}
上面代码中的importTypeFunction是一个C#委托当Lua中是调用import_type时候Lua会调用对应的C方法(Lua调用CFunction的原理,请查找Lua手册),最后会调用到对应的C#委托上来。
其中xlua全局table是在C中设置的代码如下:
-
XLua.c
-
LUA_API void luaopen_xlua(lua_State *L) {
-
luaL_openlibs(L);
-
#if LUA_VERSION_NUM == 503
-
luaL_newlib(L, xlualib);
-
lua_setglobal(L, "xlua");
-
#else
-
luaL_register(L, "xlua", xlualib);
-
lua_pop(L, 1);
-
#endif
-
}
代码很简单,luaopen_xlua是一个c函数,属于xlua.dll在创建LuaEnv时候会调用。调用后会设置一个全局变量xlua,也就是ObjectTranslator类中获取的xlua变量。然后将键值对"import_type"=C#委托,压入xlua表中。这样就能在inti_xlua.lua中调用import_type方法了。
- C#中查找指定Type对应的Lua表的实现
在C#的ImportType方法中会尝试在缓存中获取对应的Type。如果Type为空,那么说明是第一次尝试引用对应的Type,代码就会判断是时使用生成适配代码还是反射模式,来生成对应的表。
代码如下
-
省略部分代码
-
ObjectTranslator.cs
-
public static int ImportType(RealStatePtr L)
-
{
-
try
-
{
-
ObjectTranslator translator = ObjectTranslatorPool.Instance.Find(L);
-
//需要查询的类名
-
string className = LuaAPI.lua_tostring(L, 1);
-
//查找C#对应的Type(此处还没去查找对应Lua的表)
-
Type type = translator.FindType(className);
-
if (type != null)
-
{
-
//这句查找Lua中Type对应的表
-
if (translator.GetTypeId(L, type) >= 0)
-
{
-
LuaAPI.lua_pushboolean(L, true);
-
}
-
else
-
{
-
return LuaAPI.luaL_error(L, "can not load type " + type);
-
}
-
}
-
else
-
{
-
LuaAPI.lua_pushnil(L);
-
}
-
return 1;
-
}
-
}
-
internal int getTypeId(RealStatePtr L, Type type, out bool is_first, LOGLEVEL log_level = LOGLEVEL.WARN)
-
{
-
int type_id;
-
is_first = false;
-
//查询是否缓存中有Type对应的Lua表,有就直接返回
-
if (!typeIdMap.TryGetValue(type, out type_id)) // no reference
-
{
-
...
-
is_first = true;
-
Type alias_type = null;
-
aliasCfg.TryGetValue(type, out alias_type);
-
LuaAPI.luaL_getmetatable(L, alias_type == null ? type.FullName : alias_type.FullName);
-
if (LuaAPI.lua_isnil(L, -1)) //no meta yet, try to use reflection meta
-
{
-
LuaAPI.lua_pop(L, 1);
-
//此处会去检查是使用反射还是生成适配代码的逻辑
-
if (TryDelayWrapLoader(L, alias_type == null ? type : alias_type))
-
{
-
LuaAPI.luaL_getmetatable(L, alias_type == null ? type.FullName : alias_type.FullName);
-
}
-
else
-
{
-
throw new Exception("Fatal: can not load metatable of type:" + type);
-
}
-
}
-
//循环依赖,自身依赖自己的class,比如有个自身类型的静态readonly对象。
-
if (typeIdMap.TryGetValue(type, out type_id))
-
{
-
LuaAPI.lua_pop(L, 1);
-
}
-
else
-
{
-
...
-
LuaAPI.lua_pushvalue(L, -1);
-
type_id = LuaAPI.luaL_ref(L, LuaIndexes.LUA_REGISTRYINDEX);
-
LuaAPI.lua_pushnumber(L, type_id);
-
LuaAPI.xlua_rawseti(L, -2, 1);
-
LuaAPI.lua_pop(L, 1);
-
...
-
//缓存type与其对应到lua中的表
-
typeIdMap.Add(type, type_id);
-
}
-
}
-
return type_id;
-
}
-
public bool TryDelayWrapLoader(RealStatePtr L, Type type)
-
{
-
if (loaded_types.ContainsKey(type)) return true;
-
loaded_types.Add(type, true);
-
LuaAPI.luaL_newmetatable(L, type.FullName); //先建一个metatable,因为加载过程可能会需要用到
-
LuaAPI.lua_pop(L, 1);
-
Action<RealStatePtr> loader;
-
int top = LuaAPI.lua_gettop(L);
-
//此处如果已经缓存,那么就是生成适配代码注册,
-
//这边的逻辑也是为了用的时候才实例化对应的.
-
//这个delayWrap是个字典,他的键值对在XLua_Gen_Initer_Register__类实例化时候自动填充
-
if (delayWrap.TryGetValue(type, out loader))
-
{
-
delayWrap.Remove(type);
-
//将类方法,字段,成员等加载上来
-
loader(L);
-
}
-
//那么这里就是反射的逻辑了
-
else
-
{
-
...
-
//用反射将类方法,字段,成员等加载上来
-
Utils.ReflectionWrap(L, type, privateAccessibleFlags.Contains(type));
-
...
-
}
-
...
-
...
-
return true;
-
}
在生成完Type对应的Lua表后还需要设置到Lua上去
下面的代码简单来说就是用前面代码生成的table表设置到CS.UnityEngine[Debug]中
-
//loader(L)和Utils.ReflectionWrap(L, type, privateAccessibleFlags.Contains(type));中都会调用此函数来设置CS.UnityEngine[Debug]
-
public static void SetCSTable(RealStatePtr L, Type type, int cls_table)
-
{
-
int oldTop = LuaAPI.lua_gettop(L);
-
cls_table = abs_idx(oldTop, cls_table);
-
LuaAPI.xlua_pushasciistring(L, LuaEnv.CSHARP_NAMESPACE);
-
LuaAPI.lua_rawget(L, LuaIndexes.LUA_REGISTRYINDEX);
-
List<string> path = getPathOfType(type);
-
for (int i = 0; i < path.Count - 1; ++i)
-
{
-
LuaAPI.xlua_pushasciistring(L, path[i]);
-
if (0 != LuaAPI.xlua_pgettable(L, -2))
-
{
-
LuaAPI.lua_settop(L, oldTop);
-
throw new Exception("SetCSTable for [" + type + "] error: " + LuaAPI.lua_tostring(L, -1));
-
}
-
if (LuaAPI.lua_isnil(L, -1))
-
{
-
LuaAPI.lua_pop(L, 1);
-
LuaAPI.lua_createtable(L, 0, 0);
-
LuaAPI.xlua_pushasciistring(L, path[i]);
-
LuaAPI.lua_pushvalue(L, -2);
-
LuaAPI.lua_rawset(L, -4);
-
}
-
else if (!LuaAPI.lua_istable(L, -1))
-
{
-
LuaAPI.lua_settop(L, oldTop);
-
throw new Exception("SetCSTable for [" + type + "] error: ancestors is not a table!");
-
}
-
LuaAPI.lua_remove(L, -2);
-
}
-
LuaAPI.xlua_pushasciistring(L, path[path.Count - 1]);
-
LuaAPI.lua_pushvalue(L, cls_table);
-
LuaAPI.lua_rawset(L, -3);
-
LuaAPI.lua_pop(L, 1);
-
LuaAPI.xlua_pushasciistring(L, LuaEnv.CSHARP_NAMESPACE);
-
LuaAPI.lua_rawget(L, LuaIndexes.LUA_REGISTRYINDEX);
-
ObjectTranslatorPool.Instance.Find(L).PushAny(L, type);
-
LuaAPI.lua_pushvalue(L, cls_table);
-
LuaAPI.lua_rawset(L, -3);
-
LuaAPI.lua_pop(L, 1);
-
}
现在可以看到在调用到CS.UnityEngine.Debug时候,我们在Lua中已经获取到了这个类对应Lua Table了,那么接下来调用CS.UnityEngine.Debug.Log("hello world"),大提上与之前的获取Type类是一致的。不过要注意的是调用static的方法字段和对象的方法字段使用的是不同的table。这次文章都讨论的是静态方法的调用.
- 调用指定的C#方法
上面的已经提到XLua中有两种方式来实现Lua调用CS中的方法,一种是反射来调用,一种是生成适配的代码.
使用生成适配代码调用
在XLua中生成适配代码后会在Gen目录生成代码如下
-
UnityEngineDebugWrap.cs
-
public class UnityEngineDebugWrap
-
{
-
public static void __Register(RealStatePtr L)
-
{
-
ObjectTranslator translator = ObjectTranslatorPool.Instance.Find(L);
-
System.Type type = typeof(UnityEngine.Debug);
-
//注册成员方法等
-
Utils.BeginObjectRegister(type, L, translator, 0, 0, 0, 0);
-
Utils.EndObjectRegister(type, L, translator, null, null,null, null, null);
-
//注册类方法等即Static
-
Utils.BeginClassRegister(type, L, __CreateInstance, 17, 3, 1);
-
...
-
//注册一个名为Log的回调
-
Utils.CLS_IDX(L, Utils.CLS_IDX, "Log", _m_Log_xlua_st_);
-
...
-
Utils.EndClassRegister(type, L, translator);
-
}
-
[MonoPInvokeCallbackAttribute(typeof(LuaCSFunction))]
-
static int _m_Log_xlua_st_(RealStatePtr L)
-
{
-
//根据Log方法的参数数量来生成各种调用
-
try {
-
ObjectTranslator translator = ObjectTranslatorPool.Instance.Find(L);
-
int gen_param_count = LuaAPI.lua_gettop(L);
-
if(gen_param_count == 1&& translator.Assignable<object>(L, 1))
-
{
-
object _message = translator.GetObject(L, 1, typeof(object));
-
UnityEngine.Debug.Log( _message );
-
return 0;
-
}
-
if(gen_param_count == 2&& translator.Assignable<object>(L, 1)&& translator.Assignable<UnityEngine.Object>(L, 2))
-
{
-
object _message = translator.GetObject(L, 1, typeof(object));
-
UnityEngine.Object _context = (UnityEngine.Object)translator.GetObject(L, 2, typeof(UnityEngine.Object));
-
UnityEngine.Debug.Log( _message, _context );
-
return 0;
-
}
-
} catch(System.Exception gen_e) {
-
return LuaAPI.luaL_error(L, "c# exception:" + gen_e);
-
}
-
return LuaAPI.luaL_error(L, "invalid arguments to UnityEngine.Debug.Log!");
-
}
-
}
-
注册代码如下
-
Utils.cs
-
public static void RegisterFunc(RealStatePtr L, int idx, string name, LuaCSFunction func)
-
{
-
//这里的idx指的是就是CLS_IDX,就是cls_table,也就是SetCSTable设置的表
-
idx = abs_idx(LuaAPI.lua_gettop(L), idx);
-
//压入方法名
-
LuaAPI.xlua_pushasciistring(L, name);
-
//压入C#委托指针
-
LuaAPI.lua_pushstdcallcfunction(L, func);
-
LuaAPI.lua_rawset(L, idx);
-
}
使用反射式调用
-
static int FixCSFunction(RealStatePtr L)
-
{
-
try
-
{
-
ObjectTranslator translator = ObjectTranslatorPool.Instance.Find(L);
-
//这边获取闭包中的upvalue值
-
int idx = LuaAPI.xlua_tointeger(L, LuaAPI.xlua_upvalueindex(1));
-
//GetFixCSFunction很简单就是return fix_cs_functions[index];
-
//fix_cs_functions这个是在PushFixCSFunction时候添加的,PushFixCSFunction是在之前ReflectionWrap中调用的
-
LuaCSFunction func = (LuaCSFunction)translator.GetFixCSFunction(idx);
-
return func(L);
-
}
-
catch (Exception e)
-
{
-
return LuaAPI.luaL_error(L, "c# exception in FixCSFunction:" + e);
-
}
-
}
那么到现在为止所有代码设置都已经完成,就差调用了。
当DoString到CS.UnityEngine.Debug.Log("hello world")时候,先从CS.UnityEngine.Debug[Log]获取到对应的value,在lua中这个值是一个function,那么就执行call,压入参数然后就开始调用了。如果是生成是适配代码的方式的话其对应的C#委托就是 _m_Log_xlua_st_(RealStatePtr L)了。但是如果是反射式调用的话,其对应的C#委托永远都是StaticLuaCallbacks.FixCSFunctionWraper这个委托,就是上面代码的FixCSFunction。当调用FixCSFunction后会从中取出upvalue,这个值是一个数字,是个索引。索引的是之前生成wrap时候缓存的方法。然后直接进行调用。
到此整一个调用就结束了.
- 点赞
- 评论
- 收藏 5
- 举报
- 关注
-
一键三连
点赞Mark关注该博主, 随时了解TA的最新博文
Unity中SLua、Tolua、XLua和ILRuntime效率评测
3万+
2万+