Blitz Lua 对象接口

wiki

BlitzLua 对象接口

“对象接口”直接将 BlitzMAX 类型映射到相应的 Lua “类”，即一个带有关联元表的表。给定 BlitzMAX 模块的所有类型都驻留在一个 Lua 表中，该表的名称与底层模块相同：例如，在 Lua 中，BlitzMAX 类型 TGadget（位于模块 BRL.MaxGUI 中）由 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 表。

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

任何 BlitzMAX 常量也可以在定义模块所属的表中使用 - 它们的名称保持大写（例如 brl.event.EVENT_WINDOWCLOSE），与 BlitzMAX 中一样。

对象接口的一些细节

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

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

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

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

--AndreasRozek