Files
UserhomeService/src/main/java/com/yunhai/userhome/service/AppIconKeyService.java
T
chenxing b621c959cf
build / build-push (push) Successful in 13m48s
feat(appicon): 应用图标键下发出栏(YschAppIcons 10-04 轮 P2 后端)
- AppIconKeyService/AppIconEntryVo(新):icon_key/icon_color 资产库键值读取
- UserController:getUserApp 返回体加图标键注入(withIconKeys)
- UserSettingsController:用户设置应用列表注入 iconKey/iconColor(未配置 null 走原 img 回退)
- UsedAppController/UsedAppServiceImpl:常用应用列表同口径注入
依据:根目录《AppIcon资产库落地-执行报告-20261004.md》P2 数据侧/管理端
2026-10-06 20:21:04 +08:00

80 lines
3.3 KiB
Java
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package com.yunhai.userhome.service;
import com.yunhai.platform.openapi.core.YschOpenCall;
import com.yunhai.userhome.model.AppIconEntryVo;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.Collections;
import java.util.List;
import java.util.Map;
import java.util.function.Function;
import java.util.stream.Collectors;
/**
* 应用矢量图标映射补拉(AppIcon 资产库 P2/P3 数据通道)。<br>
* UserBase 的 {@code GET /oapi/app/icon-map} 返回全量已配置行 [{id, iconKey, iconColor}],
* 本服务拉取后建 id 索引供各出参组装点合并注入(BoaApp 属 SDK 本期不动,矢量字段走本通道)。<br>
* <ul>
* <li>60 秒本地缓存:多个出参点(GetUserApp/常用区/搜索)一次渲染只打一次跨仓调用;</li>
* <li>失败降级:返回上次成功值(无则空映射),绝不阻塞主应用列表——空映射下端侧
* 走原 关键词→URL→首字 回退链,表现与改造前一致(零回归要求);</li>
* <li>失败后 10 秒内不重试(简单防雪崩)。</li>
* </ul>
*/
@Service
public class AppIconKeyService {
private static final Logger log = LoggerFactory.getLogger(AppIconKeyService.class);
/** 服务目录目标名:userbase(与 UserController.TARGET_USERBASE 同口径) */
private static final String TARGET_USERBASE = "userbase";
private static final String PATH_ICON_MAP = "/oapi/app/icon-map";
/** 成功结果缓存时长 */
private static final long TTL_MS = 60_000L;
/** 拉取失败后的静默期 */
private static final long FAIL_BACKOFF_MS = 10_000L;
@Autowired
private YschOpenCall openCall;
private volatile Map<Integer, AppIconEntryVo> cached = Collections.emptyMap();
private volatile long fetchedAt = Long.MIN_VALUE;
/**
* id → 矢量图标条目 映射(含缓存与降级)。空映射 = 无任何应用配置矢量键或通道不可达。
*/
public Map<Integer, AppIconEntryVo> iconMap() {
long now = System.currentTimeMillis();
if (now - fetchedAt < TTL_MS) {
return cached;
}
try {
List<AppIconEntryVo> list = openCall.getList(TARGET_USERBASE, PATH_ICON_MAP, null,
AppIconEntryVo.class);
Map<Integer, AppIconEntryVo> map = (list == null) ? Collections.emptyMap()
: list.stream()
.filter(v -> v != null && v.getId() != null && v.getIconKey() != null)
.collect(Collectors.toMap(AppIconEntryVo::getId, Function.identity(), (a, b) -> a));
cached = Collections.unmodifiableMap(map);
fetchedAt = now;
return cached;
} catch (Exception e) {
// 降级:沿用上次值;10 秒内不再重试。应用列表主链路绝不因此报错
fetchedAt = now - TTL_MS + FAIL_BACKOFF_MS;
log.warn("[appicon] icon-map 拉取失败,按空映射降级:{}", e.toString());
return cached;
}
}
/** 按 id 取单条;无配置返回 null。 */
public AppIconEntryVo byId(Integer appId) {
return (appId == null) ? null : iconMap().get(appId);
}
}