能力接入

应用能力装配范围

按应用能力键控制组件与清单装配,区分装配范围、权限和存量数据迁移。

浏览全部手册
本页目录
文档来源与 Markdown 原文

权威正文:ineed-core/docs/guides/application-capability-scope.md。网站按工作区快照同步,原文中的历史日期和验证范围保留。

开始编码前核对同版本源码;跨仓文件引用可在源码定位目录查找。

下载 Markdown 原文 ↓

ineed-core-base 的 ApplicationCapabilitySupport 为组件装配和 classpath 清单提供相同的能力判断。 能力键由业务模块声明,Core 不识别具体业务。此机制不替代认证、权限或数据范围。

ineed:
  application:
    capabilities:
      - party.member.personal

也支持逗号分隔字符串。未配置时保持旧应用全量装配;显式空字符串关闭所有声明门槛的能力。 键精确匹配,不支持隐式父子继承或通配符。未声明能力门槛的基础组件不受影响。

组件通过 @ConditionalOnApplicationCapability("party.member.personal") 声明条件。 可选依赖中的类必须隔离到条件配置/处理器,不能仅将 POM 改为 optional 后继续在常驻类签名中引用。

清单支持 requiredCapability 字符串或 requiredCapabilities 非空字符串数组;数组全部满足才允许加载。 两者同时出现时也必须全部满足。禁用父节点会删除整个子树;元数据在反序列化合同前移除。 筛选不修改原 JSON 树。错误类型和空能力键会拒绝加载,而不是静默放行。

Config 分类、字典(含旧格式)、参数,以及权限、流水号加载器复用该支持类。 自动注册范围收缩不会自动删除已有数据。迁移必须独立核对业务引用、管理员修改和关联授权, 并在备份后执行;不能按“未扫描到”删除用户自建定义。

源码:ineed-core-base/src/main/java/com/ineed/base/module/。 行为测试:ApplicationCapabilitySupportTest,覆盖缺省、空值、精确匹配、索引列表、嵌套清单和真实 Spring 条件组件。

仍有疑问?按反馈清单整理复现信息 →