游戏客户端架构 / 系统课时
数值、文本和布尔类型怎么选
数值、文本和布尔类型怎么选
配置表里的字段类型不是“能存进去就行”,而是在决定导入时怎么校验、序列化后如何表达,以及运行时要不要再次转换。本节用伤害、名称和开关三个典型字段建立一套选择规则,让错误尽量在导入阶段暴露,而不是进入游戏后才发现。
学习目标
- 根据业务含义选择整数、浮点数、文本和布尔类型
- 理解类型选择对导入校验、序列化和运行时访问的影响
- 能为边界值、空值和非法字面量设计明确的校验规则
字段类型先表达业务含义
判断字段类型时,先问“这个值允许做什么”,再问“表格软件里看起来像什么”。伤害次数、等级、堆叠上限通常是整数;移动速度、暴击倍率这类允许小数的量适合浮点数;名称、资源键、描述属于文本;是否可交易、是否默认启用则应使用布尔类型。
| 业务字段 | 推荐类型 | 不推荐做法 | 主要原因 |
|---|---|---|---|
level |
整数 | 文本 "10" |
会把数值校验推迟到运行时 |
moveSpeed |
浮点数 | 整数缩放值 | 除非项目明确采用定点数约定 |
displayName |
文本 | 枚举 | 文案通常需要频繁调整或本地化 |
tradable |
布尔 | 0/1、Y/N 混用 |
字面量不统一容易产生歧义 |
文本并不等于“万能类型”。把所有字段都导成字符串虽然省事,但每个使用方都要重新解析,错误也会从一次导入检查扩散到多个运行时分支。
导入阶段要严格拒绝模糊值
配置导入器应把原始单元格转换成明确类型,并在转换失败时直接报错。特别是布尔值,不要依赖“非空就算真”或把未知字符串悄悄当成 false。
下面的 Java 17 示例模拟一行配置的导入过程,对正整数和布尔值做严格校验:
import java.util.Map;
public class ConfigTypeDemo {
record ItemConfig(int maxStack, String displayName, boolean tradable) {}
public static void main(String[] args) {
Map<String, String> row = Map.of(
"maxStack", "99",
"displayName", "治疗药水",
"tradable", "true"
);
ItemConfig config = new ItemConfig(
parsePositiveInt(row.get("maxStack"), "maxStack"),
requireText(row.get("displayName"), "displayName"),
parseStrictBoolean(row.get("tradable"), "tradable")
);
System.out.println(config);
}
static int parsePositiveInt(String raw, String field) {
int value = Integer.parseInt(raw);
if (value <= 0) {
throw new IllegalArgumentException(field + " must be > 0");
}
return value;
}
static String requireText(String raw, String field) {
if (raw == null || raw.isBlank()) {
throw new IllegalArgumentException(field + " must not be blank");
}
return raw;
}
static boolean parseStrictBoolean(String raw, String field) {
if ("true".equalsIgnoreCase(raw)) return true;
if ("false".equalsIgnoreCase(raw)) return false;
throw new IllegalArgumentException(field + " must be true or false");
}
}预期输出:
ItemConfig[maxStack=99, displayName=治疗药水, tradable=true]实际项目中,Integer.parseInt 的格式异常也应被导入框架捕获,并补充表名、行号和字段名,这样策划能直接定位原始数据。
序列化后不要丢失类型信息
配置转成 JSON、二进制或引擎资产后,应继续保留原始类型。整数仍是数字,布尔值仍是 true 或 false,不要为了“格式统一”再次变回字符串。这样运行时读取后可以直接参与计算和条件判断,不需要二次解析。
如果某个字段允许“未填写”,要显式定义它的语义。比如冷却时间为空究竟表示 0 秒、继承默认值,还是配置错误,三者不能靠调用方猜测。稳定的做法是在导入规则里把空值转换成明确默认值,或者直接拒绝缺失。
运行时类型要兼顾范围与精度
整数还要考虑范围,浮点数还要考虑精度。数量、ID、自增计数等只要可能超过 32 位上限,就应在数据模型里使用更大的整数类型;货币、固定倍率等如果要求精确十进制,不应直接依赖二进制浮点数做最终结算。
当字段含义清晰时,优先使用最具体的类型:能用布尔就不要用文本开关,能用数字就不要存数字字符串;只有真正属于标识、文案或自由输入的内容才使用文本。