Blitz Lua 对象接口

wiki

BlitzLua 对象接口

“对象接口”直接将 BlitzMAX 类型映射到相应的 Lua “类”，即带有关联元表的表。给定 BlitzMAX 模块的所有类型都存在于一个以底层模块命名的 Lua 表中：例如，在 Lua 下，模块 BRL.MaxGUI 中找到的 BlitzMAX 类型 TGadget 由 brl.maxgui.TGadget 复制（其中 brl 是一个全局表）。可选的“import”机制会将给定模块的所有类型全局化，从而无需以模块名称为前缀。

命名约定

由于 Lua 是区分大小写的语言（而 BlitzMAX 则不是），因此适用以下命名约定：

• 所有模块名称都为小写
• BlitzMAX 类型和方法名称的大小写保持不变 - 以下例外情况除外
  • 以动词或形容词开头的方法名称以小写字母开头
  • 所有其他名称都以大写字母开头

如有任何不确定之处，请仅考虑属于包的类型引用。

参数处理和类型转换

Lua 函数参数等于相应的 BlitzMAX 方法的参数，任何默认值都会得到适当的尊重（即，相应的 Lua 参数可能为 nil）。类型转换如下：

• BlitzMAX 字符串以 C 字符串形式传递给 Lua - 反之亦然（目前这会阻止使用 16 位字符集，未来可能会更改。目前，选择此方法是为了避免与宽字符相关的问题，这在 MaxGUI 中已有报告）
• 数值 BlitzMAX 值始终以双精度浮点数形式传递给 Lua - 反之亦然（即使对于范围在 - 9007199254740994...+9007199254740994 [1] 内的“长整数”也效果很好）
• 每当 BlitzMAX 期望或返回逻辑值时，相应的 Lua 值必须是（或将是）“boolean”类型
• 每当 BlitzMAX 期望或返回字节数组时，相应的 Lua 值必须是（或将是）“string”类型
• 而不是 BlitzMAX 对象，会传递相应的 Lua “对象”（请阅读下面的注释！）

此外，

• “可变参数”会与主函数返回值（如果存在）一起，按顺序（与参数列表中的顺序相同）一个接一个地返回。
• 每当 BlitzMAX 期望一个给定类型的数组（除了字节）时，Lua 必须提供一个具有所需元素类型的数值索引表。
• 每当 BlitzMAX 最初返回一个值数组（非字节类型）时，相应的接口函数会将一个“解包”的值列表传递给调用它的 Lua 脚本。

值得注意的细节：虽然“函数接口”将 BlitzMAX 对象作为“轻量级用户数据”传递，但“对象接口”仅使用 Lua “对象”。因此，该接口实现了一种查找技术，以便为给定的 BlitzMax 对象检索 Lua 表，反之亦然。

• 每个 Lua “对象”都有一个名为“_Peer”的字段，其中包含一个指向底层 BlitzMAX 对象的“引用”（请勿修改此字段！）
• 该接口还处理一个查找表，其中包含每个现有 BlitzMAX 对象关联的 Lua 表。

因此，“_Peer”被传递给 BlitzMAX 函数，而从 BlitzMAX 返回的每个对象都会被查找并替换为其关联的 Lua 表（如果存在这样的表，否则会“即时”创建一个新的）。

任何 BlitzMAX 常量也都可以在属于定义模块的表中访问 - 它们的名称已保持大写（例如 brl.event.EVENT_WINDOWCLOSE），就像在 BlitzMAX 中一样。

对象接口的一些细节

接口“类”提供基于原型的差异继承（实际上意味着，修改一个“类”会立即影响其所有实例，除非被修改的字段被实例“遮蔽”）。此外，它们管理其“_Peer”的生命周期：使用“keepers”（参见 BlitzLuaKeeper），每个 Lua “对象”都会在从内存中移除时收到垃圾收集器的通知。然后，它会调用其 destroy 方法，该方法会正确关闭并移除关联的 BlitzMAX peer。

同时使用“函数接口”和“对象接口”时，您不应混合处理 BlitzMAX 对象和 Lua “方法”的函数，除非您真的知道自己在做什么。然而，使用其他函数（不处理特定对象）是安全的（并且经常是必要的）。

与“函数接口”相比，“对象接口”允许面向对象的表示法，并使程序员摆脱了自己管理 BlitzMAX 对象的负担。

“对象接口”尚未完成，但有望于 2007 年 5 月 18 日左右发布。

--AndreasRozek