Xlua分析:Lua调用C#

2024-01-29 10:12

本文主要是介绍Xlua分析:Lua调用C#,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

在之前的博客Lua与C#交互初析-CSDN博客中讲了有关lua和c#交互的比较浅层的概念,即C#侧注册[LuaCallCSharp]和[CSharpCallLua]的标签后,即可实现双侧沟通。但是还是没有讲明白里面的一些具体内容包括参数传递、xlua栈调用,甚至是C#如何调用lua都没研究。本篇主题是lua如何调用C#的补充。

xLua交互知识

参考官方文档《programming in lua》的第24章开头,里面很详细地阐述了Lua和C++是如何实现交互的:栈操作。Lua API用一个抽象的栈在Lua与C之间交换值。栈中的每一条记录都可以保存任何 Lua 值。如果想要从Lua请求一个值(比如一个全局变量的值)则调用Lua,被请求的值将会被压入栈;如果想要传递一个值给 Lua,首先将这个值压入栈,然后调用 Lua(这个值就会被弹 出)。几乎所有的 API函数都用到了栈。而C#显而易见也可以和C++一侧进行交互,由此即可得出lua和C#可以通过C/C++这一层来进行通信,主要方法即是lua的堆栈操作。

C#对象如何传递给Lua

如果是int、float、bool这种C和C#互通的数据类型,实际上就直接走以上说的Lua API形式即可,直接栈操作就能实现数据交互,但是C#这边的对象则很难进行这样的操作,所以需要更多的步骤。参考Xlua ObjectTranslator.cs的Push操作:

public void Push(RealStatePtr L, object o)
{int index = -1;Type type = o.GetType();
#if !UNITY_WSA || UNITY_EDITORbool is_enum = type.IsEnum;bool is_valuetype = type.IsValueType;
#elsebool is_enum = type.GetTypeInfo().IsEnum;bool is_valuetype = type.GetTypeInfo().IsValueType;
#endifbool needcache = !is_valuetype || is_enum;if (needcache && (is_enum ? enumMap.TryGetValue(o, out index) : reverseMap.TryGetValue(o, out index))){if (LuaAPI.xlua_tryget_cachedud(L, index, cacheRef) == 1){return;}//这里实在太经典了,weaktable先删除,然后GC会延迟调用,当index会循环利用的时候,不注释这行将会导致重复释放//collectObject(index);}bool is_first;int type_id = getTypeId(L, type, out is_first);//如果一个type的定义含本身静态readonly实例时,getTypeId会push一个实例,这时候应该用这个实例if (is_first && needcache && (is_enum ? enumMap.TryGetValue(o, out index) : reverseMap.TryGetValue(o, out index))) {if (LuaAPI.xlua_tryget_cachedud(L, index, cacheRef) == 1){return;}}index = addObject(o, is_valuetype, is_enum);LuaAPI.xlua_pushcsobj(L, index, type_id, needcache, cacheRef);
}

首先push一个object的时候会判断这个object是否有相关缓存,有的话就不用继续了,没有的话就还是需要addObject的操作的。 

int addObject(object obj, bool is_valuetype, bool is_enum)
{int index = objects.Add(obj);if (is_enum){enumMap[obj] = index;}else if (!is_valuetype){reverseMap[obj] = index;}return index;
}

首先会把object存进一个object list里,获得一个index,然后根据类型存进相应的map中,如果是引用(注意代码!is_valuetype指的就是非值类型,即引用类型)则存入引用map,如果是枚举则存入枚举map。

最后调用LuaAPI.xlua_pushcsobj(L, index, type_id, needcache, cacheRef)这个操作来进行压栈并且创建一个userdata并设置metatable来供lua侧调用。如果需要缓存,则存入缓存表中。从上方的C#代码中可以很明显的看到如果是引用或者枚举则都需要缓存。

LUA_API void xlua_pushcsobj(lua_State *L, int key, int meta_ref, int need_cache, int cache_ref) {int* pointer = (int*)lua_newuserdata(L, sizeof(int));*pointer = key;if (need_cache) cacheud(L, key, cache_ref);  // Lua侧缓存lua_rawgeti(L, LUA_REGISTRYINDEX, meta_ref);lua_setmetatable(L, -2);  // 为userdata设置元表
}// 将 key = userdata 存入缓存表
static void cacheud(lua_State *L, int key, int cache_ref) {lua_rawgeti(L, LUA_REGISTRYINDEX, cache_ref);lua_pushvalue(L, -2);lua_rawseti(L, -2, key);lua_pop(L, 1);
}

C#对象具体信息

如果仅仅是以上描述的这个流程,那么创建一个userdata时元表的信息还远远不够,我们依然无法直到为什么lua侧可以调用go:SetActive(false)。

在Push函数内有一行需要注意:int type_id = getTypeId(L, type, out is_first);在内部就执行了Xlua Wrap相关操作:

internal int getTypeId(RealStatePtr L, Type type, out bool is_first, LOGLEVEL log_level = LOGLEVEL.WARN)
{......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);}}......
}

此处代码即是首先用type中寻找类对应的元表,如果没有则采用TryDelayWrapLoader生成。参考上一篇将xlua wrap生成的文章:Xlua Wrap-CSDN博客

 总的来说,xlua会为C#类这边生成一个wrap文件,里面对于方法生成了对应的函数,对于属性值则会生成getter和setter方法来供xlua“调用”。

比如:

[LuaCallCSharp]
public class TestXLua
{public string Name;public void Test1(int a){}public static void Test2(int a, bool b, string c){}
}

生成wrap之后的代码:

public class TestXLuaWrap 
{public static void __Register(RealStatePtr L){ObjectTranslator translator = ObjectTranslatorPool.Instance.Find(L);System.Type type = typeof(TestXLua);Utils.BeginObjectRegister(type, L, translator, 0, 1, 1, 1);Utils.RegisterFunc(L, Utils.METHOD_IDX, "Test1", _m_Test1);Utils.RegisterFunc(L, Utils.GETTER_IDX, "Name", _g_get_Name);Utils.RegisterFunc(L, Utils.SETTER_IDX, "Name", _s_set_Name);Utils.EndObjectRegister(type, L, translator, null, null,null, null, null);Utils.BeginClassRegister(type, L, __CreateInstance, 2, 0, 0);Utils.RegisterFunc(L, Utils.CLS_IDX, "Test2", _m_Test2_xlua_st_);Utils.EndClassRegister(type, L, translator);}[MonoPInvokeCallbackAttribute(typeof(LuaCSFunction))]static int __CreateInstance(RealStatePtr L){try {ObjectTranslator translator = ObjectTranslatorPool.Instance.Find(L);if(LuaAPI.lua_gettop(L) == 1){TestXLua gen_ret = new TestXLua();translator.Push(L, gen_ret);return 1;}}catch(System.Exception gen_e) {return LuaAPI.luaL_error(L, "c# exception:" + gen_e);}return LuaAPI.luaL_error(L, "invalid arguments to TestXLua constructor!");}[MonoPInvokeCallbackAttribute(typeof(LuaCSFunction))]static int _m_Test1(RealStatePtr L){try {ObjectTranslator translator = ObjectTranslatorPool.Instance.Find(L);TestXLua gen_to_be_invoked = (TestXLua)translator.FastGetCSObj(L, 1);{int _a = LuaAPI.xlua_tointeger(L, 2);gen_to_be_invoked.Test1( _a );return 0;}} catch(System.Exception gen_e) {return LuaAPI.luaL_error(L, "c# exception:" + gen_e);}}[MonoPInvokeCallbackAttribute(typeof(LuaCSFunction))]static int _m_Test2_xlua_st_(RealStatePtr L){try {{int _a = LuaAPI.xlua_tointeger(L, 1);bool _b = LuaAPI.lua_toboolean(L, 2);string _c = LuaAPI.lua_tostring(L, 3);TestXLua.Test2( _a, _b, _c );return 0;}} catch(System.Exception gen_e) {return LuaAPI.luaL_error(L, "c# exception:" + gen_e);}}[MonoPInvokeCallbackAttribute(typeof(LuaCSFunction))]static int _g_get_Name(RealStatePtr L){try {ObjectTranslator translator = ObjectTranslatorPool.Instance.Find(L);TestXLua gen_to_be_invoked = (TestXLua)translator.FastGetCSObj(L, 1);LuaAPI.lua_pushstring(L, gen_to_be_invoked.Name);} catch(System.Exception gen_e) {return LuaAPI.luaL_error(L, "c# exception:" + gen_e);}return 1;}[MonoPInvokeCallbackAttribute(typeof(LuaCSFunction))]static int _s_set_Name(RealStatePtr L){try {ObjectTranslator translator = ObjectTranslatorPool.Instance.Find(L);TestXLua gen_to_be_invoked = (TestXLua)translator.FastGetCSObj(L, 1);gen_to_be_invoked.Name = LuaAPI.lua_tostring(L, 2);} catch(System.Exception gen_e) {return LuaAPI.luaL_error(L, "c# exception:" + gen_e);}return 0;}
}

里面都直接是对lua栈进行操作。

Xlua cache表

xlua和C#相互都有独立的GC系统,但是中间建立了一层cache表用来存储所有的userdata。这层cache表是采用弱引用的方式实现的。在lua不需要用到相关userdata 的时候,这层cache表会自动清除这个userdata;在最初创建userdata的时候,还会为userdata 的元表添加__gc方法,用以在被gc的时候直接自动调用函数来清理C#这边的管理池:

if ((type == null || !translator.HasCustomOp(type)) && type != typeof(decimal))
{LuaAPI.xlua_pushasciistring(L, "__gc");LuaAPI.lua_pushstdcallcfunction(L, translator.metaFunctions.GcMeta);LuaAPI.lua_rawset(L, -3);  // 为元表设置__gc方法
}
[MonoPInvokeCallback(typeof(LuaCSFunction))]
public static int LuaGC(RealStatePtr L)
{try{int udata = LuaAPI.xlua_tocsobj_safe(L, 1);if (udata != -1){ObjectTranslator translator = ObjectTranslatorPool.Instance.Find(L);if ( translator != null ){translator.collectObject(udata);}}return 0;}catch (Exception e){return LuaAPI.luaL_error(L, "c# exception in LuaGC:" + e);}
}

而这个translator.collectObject实际上就是在清理之前创建时候添加进list和map的object数据了:

internal void collectObject(int obj_index_to_collect)
{object o;if (objects.TryGetValue(obj_index_to_collect, out o)){objects.Remove(obj_index_to_collect);if (o != null){int obj_index;//lua gc是先把weak table移除后再调用__gc,这期间同一个对象可能再次push到lua,关联到新的indexbool is_enum = o.GetType().IsEnum();if ((is_enum ? enumMap.TryGetValue(o, out obj_index) : reverseMap.TryGetValue(o, out obj_index))&& obj_index == obj_index_to_collect){if (is_enum){enumMap.Remove(o);}else{reverseMap.Remove(o);}}}}
}

这篇关于Xlua分析:Lua调用C#的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/656575

相关文章

Go标准库常见错误分析和解决办法

《Go标准库常见错误分析和解决办法》Go语言的标准库为开发者提供了丰富且高效的工具,涵盖了从网络编程到文件操作等各个方面,然而,标准库虽好,使用不当却可能适得其反,正所谓工欲善其事,必先利其器,本文将... 目录1. 使用了错误的time.Duration2. time.After导致的内存泄漏3. jsO

使用C#代码在PDF文档中添加、删除和替换图片

《使用C#代码在PDF文档中添加、删除和替换图片》在当今数字化文档处理场景中,动态操作PDF文档中的图像已成为企业级应用开发的核心需求之一,本文将介绍如何在.NET平台使用C#代码在PDF文档中添加、... 目录引言用C#添加图片到PDF文档用C#删除PDF文档中的图片用C#替换PDF文档中的图片引言在当

详解C#如何提取PDF文档中的图片

《详解C#如何提取PDF文档中的图片》提取图片可以将这些图像资源进行单独保存,方便后续在不同的项目中使用,下面我们就来看看如何使用C#通过代码从PDF文档中提取图片吧... 当 PDF 文件中包含有价值的图片,如艺术画作、设计素材、报告图表等,提取图片可以将这些图像资源进行单独保存,方便后续在不同的项目中使

C#使用SQLite进行大数据量高效处理的代码示例

《C#使用SQLite进行大数据量高效处理的代码示例》在软件开发中,高效处理大数据量是一个常见且具有挑战性的任务,SQLite因其零配置、嵌入式、跨平台的特性,成为许多开发者的首选数据库,本文将深入探... 目录前言准备工作数据实体核心技术批量插入:从乌龟到猎豹的蜕变分页查询:加载百万数据异步处理:拒绝界面

C#数据结构之字符串(string)详解

《C#数据结构之字符串(string)详解》:本文主要介绍C#数据结构之字符串(string),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录转义字符序列字符串的创建字符串的声明null字符串与空字符串重复单字符字符串的构造字符串的属性和常用方法属性常用方法总结摘

C#如何动态创建Label,及动态label事件

《C#如何动态创建Label,及动态label事件》:本文主要介绍C#如何动态创建Label,及动态label事件,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录C#如何动态创建Label,及动态label事件第一点:switch中的生成我们的label事件接着,

C# WinForms存储过程操作数据库的实例讲解

《C#WinForms存储过程操作数据库的实例讲解》:本文主要介绍C#WinForms存储过程操作数据库的实例,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、存储过程基础二、C# 调用流程1. 数据库连接配置2. 执行存储过程(增删改)3. 查询数据三、事务处

Spring事务中@Transactional注解不生效的原因分析与解决

《Spring事务中@Transactional注解不生效的原因分析与解决》在Spring框架中,@Transactional注解是管理数据库事务的核心方式,本文将深入分析事务自调用的底层原理,解释为... 目录1. 引言2. 事务自调用问题重现2.1 示例代码2.2 问题现象3. 为什么事务自调用会失效3

C#基础之委托详解(Delegate)

《C#基础之委托详解(Delegate)》:本文主要介绍C#基础之委托(Delegate),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录1. 委托定义2. 委托实例化3. 多播委托(Multicast Delegates)4. 委托的用途事件处理回调函数LINQ

找不到Anaconda prompt终端的原因分析及解决方案

《找不到Anacondaprompt终端的原因分析及解决方案》因为anaconda还没有初始化,在安装anaconda的过程中,有一行是否要添加anaconda到菜单目录中,由于没有勾选,导致没有菜... 目录问题原因问http://www.chinasem.cn题解决安装了 Anaconda 却找不到 An