using-backstage-catalog
该技能用于在 Backstage 插件中与 Catalog(软件目录)交互,涵盖按 ref 获取单个实体、按过滤条件查询实体,以及以编程方式注册、刷新或注销目录位置。技能同时适用于前端和后端代码,并给出各自的入口点与调用模式。前端通过 useApi(catalogApiRef) 调用 getEntityByRef、getEntities、addLocation、refreshEntity、removeLocationById;后端通过 catalogServiceRef 获取 catalog 服务,方法需传入 { credentials }。技能还说明了两种调用模式(独立开发中、脚手架生成后)以及常见陷阱,例如前端 catalogApiRef 来自 @backstage/plugin-catalog-react,后端依赖 @backstage/plugin-catalog-node 的 catalogServiceRef,getEntityByRef 可能返回 undefined,getEntities 返回 { items },过滤条件在对象内为 AND、数组间为 OR,前端应使用 useAsync/useAsyncFn 而非在渲染中直接请求,后端热路径应使用 coreServices.cache 缓存。
编程与开发48 次安装