7.1 KiB
7. 资源、类型与类
Endorphin 的资源模型从基础常量值开始：数值、文本以及图片、视频、音频和 GIS 数据等内容由平台统一保存和解释。变量保存对资源的引用；class 与 agent 在这些基础上组织更高级的结构。
类型描述资源或值的结构及其允许的用法。类型标注用于字段、函数参数和返回值，使不同应用部分能够依据同一声明理解数据。
7.1 类型标注
类型标注采用 名称: 类型 的形式：
price: Number
name: String
本文示例使用：
| 类型名 | 表达的值 |
|---|---|
Number |
统一数值，包含整数与小数，不按机器位宽或浮点表示分成语言类型 |
String |
文本内容 |
| 用户声明的类名 | 属于该声明类型并满足字段约束的数据 |
Number 是本书采用的统一数值类型名提案，String 沿用文本类型名提案。基础资源类别已经确定，完整类型命名、精度和转换规则见规范状态。String 表示文本值，与第 12 章的 Text 界面组件不同。
基础常量资源
基础常量资源的内容不可原地修改。数字和文本可以通过字面量表达，媒体和 GIS 数据由平台接收并转换成类型化资源；它们不要求用户先声明 class。
| 基础类别 | 语言层面的内容 | 平台承担的表示工作 |
|---|---|---|
| 数值 | 数字及其运算 | 选择可保存该数值的表示，不要求调用者选择 int32、float 等机器类型 |
| 文本 | 字符与文本内容 | 保存和提供统一文本值 |
| 图片 | 图像内容 | 导入转换、内部标准表示与导出编码 |
| 视频 | 随时间变化的影像内容 | 导入转换、内部标准表示与导出编码 |
| 音频 | 声音内容 | 导入转换、内部标准表示与导出编码 |
| GIS 数据 | 地理空间内容 | 导入转换、统一空间数据表示与导出编码 |
数值表示以可表达和保存为优先目标，平台可以使用大数或其他可扩展表示，接受由此产生的性能成本。100 与 1.5 都属于统一数值类别，不因是否包含小数点而选择不同的机器类型。大数表示本身不决定除法、舍入或任意实数的精确性，这些算术规则仍需明确。
平台接受的媒体与 GIS 格式在导入后转写为各自的内部标准格式，导出时再编码为受支持的目标格式。业务代码面对图片、视频、音频或 GIS 数据的类型语义，无需为每种输入编码自行解析句柄和 buffer。修改基础内容产生新的内容值；变量可以改为引用新值。
具体标准格式、支持的导入与导出格式，以及转换中的精度、元数据和坐标系统规则另行定义。格式归一化不直接规定所有类别具有同一种文件编码，也不要求源码暴露平台内部的缓冲区。
资源与引用
基础值可以作为表达式结果、函数参数或返回值。变量是一项可改变目标的语言引用，可以指向基础常量资源，也可以指向函数、class 或 agent 定义及其可用实例；引用与实例的具体类型表达仍待定义。
这里的“指向”表达语言语义，不要求开发者处理裸内存地址、手动分配或释放。变量改变引用目标与修改基础常量内容是不同操作，详见变量与资源引用。
资源需要独立保存、分享或再次引用时，纳入用户与 namespace 的归属和检索体系。namespace 中资源的登记形式、资源成员定位和实例标识待定；临时值不因此自动获得永久名称。
7.2 class 声明
代码归属：atelier:shop.data。
class Product {
name: String
price: Number
}
该声明定义名为 Product 的数据结构，含有两个字段：name 为文本，price 为数值。使用 Product 数据的代码依据同一结构读取字段，不需要为前端另写一份对应结构。
类名是标识符。本文最小示例展示字段声明，每个字段写出名称和类型，字段之间不使用逗号或分号。class 也可以组织成员函数；函数作为成员时需要类内作用域和实例关联规则，具体形式见规范状态。
7.3 类型与值
Product 表示一个声明的类型；具有 Product 类型并满足其字段约束的值，才包含本次业务数据。仅有相同字段不自动使其他类型的值成为 Product。
类声明本身不取得某件商品，也不指定数据库、表或连接。通过类型取得数据的用法在数据读取中说明；构造、方法与默认值属于独立的类型规则。
7.4 字段访问
函数体片段；局部名称 product 表示已取得的 Product 值：
let name = product.name
let price = product.price
成员访问使用点号。第一行取得文本字段，第二行取得数值字段。字段使用的类型由声明决定；读取不存在的字段不是有效的 Product 用法。
成员访问和 let 的表达式规则见下一章。
7.5 类型检查与共享
Preflight 理解类和字段声明，检查字段访问、函数参数与返回值的类型关系。inflight 中取得和使用的数据必须符合对应类型及字段约束。
跨 namespace 引用类时，引用的是定义该结构的声明，不改变调用方代码的归属。声明是否可访问取决于可见性和权限规则，见程序结构与导入。
7.6 类型身份与兼容
Endorphin 不采用仅依据成员结构判断兼容的结构类型规则。用户声明的类型按其声明身份区分；字段或方法相同，不自动建立类型兼容或能力实现关系。
类型声明通过所属 namespace 与声明定位。引用同一个声明不创建新类型；不同声明不能仅凭名称或成员相同被认定为同一类型。
代码归属：atelier:shop.data。沿用本章 Product 声明，并增加以下类声明：
class ListedProduct {
name: String
price: Number
}
Product 与 ListedProduct 都有 name 和 price，但它们是不同的类型。本例没有建立继承、转换或其他兼容关系，因此 ListedProduct 值不能自动作为 Product 参数使用。
Product 值 → 接收 Product 的参数：类型符合要求
ListedProduct 值 → 接收 Product 的参数：不能仅凭字段相同通过检查
构造某个声明类型的值时仍须检查字段及其类型；这类检查不等于允许不同类型按结构互换。类型推断也不要求结构兼容，具体推断规则仍待定义。
继承、接口或协议关系、显式能力实现及类型转换的规则另行定义，见规范状态。本节不增加相应关键字或写法。
上一章：词法结构 · 下一章：表达式与绑定 · 目录