关于GUI生成默认ObjEntity中主键特殊处理的技术问询

一、为啥主键会被特殊处理？ #

ORM框架里，主键是实体的唯一标识核心，特意被封装到ObjectId中与普通业务属性做区分。这么做是为了统一管理实体的身份识别、缓存关联、脏数据检查等核心逻辑，避免开发者随意修改主键导致缓存失效、关联数据混乱这类问题。GUI工具默认把主键从属性里移除，就是遵循这个框架规范，引导开发者用框架提供的API操作主键，减少踩坑概率。

二、有没有更顺手的主键操作方式？ #

嫌Map方式不类型安全、用着麻烦的话，有这几个可行方案：

1. 自己封装类型安全的getter/setter
   基于getIdSnapshot()返回的Map，写专属的主键访问方法即可，比如：

// 假设主键是Long类型的id字段
public Long getId() {
    return (Long) this.getObjectId().getIdSnapshot().get("id");
}

public void setId(Long id) {
    this.setObjectId(ObjectId.of("你的实体类名", Map.of("id", id)));
}

这样既不违反框架设计，又能像操作普通属性一样用类型安全的方法处理主键。

2. 手动加主键属性映射并非逆设计
   你觉得手动在ObjEntity编辑窗口添加主键属性映射是逆工具设计？其实不是——工具的默认行为是遵循通用规范，但也预留了灵活调整的空间。如果你的业务场景确实需要把主键当作普通属性使用，完全可以这么做，生成对应的getter/setter即可。
   注意：添加映射后要避免主键被双重管理，比如可以把该属性设为只读，或者确保修改属性时同步更新ObjectId。

3. 修改代码生成模板批量解决
   如果项目里大量实体都需要这类操作，可以自定义cgen的代码生成模板，让生成的实体类自动带上主键的getter/setter，底层依然调用ObjectId的API，省去手动重复编写的麻烦。

三、总结 #

框架把主键封装起来是为了降低风险，不是故意增加操作成本；要是追求便捷性和类型安全，自己封装方法或者调整ObjEntity映射都是可行方案，手动添加映射也不是反设计，而是工具提供的灵活配置选项。

内容的提问来源于stack exchange，提问作者Vin