17370845950

本文介绍如何通过静态不可变映射（如 `map`）优雅地实现基于 uuid 的名称查找，并支持跨模块复用，避免重复初始化与线程安全问题。

在 Java 中，若需全局共享一个“UUID → 名称”的映射关系（例如蓝牙服务 UUID 到可读名称），并确保线程安全、启动即可用、且调用简洁（如 getNameByUUID(uid)），最干净、推荐的方案是使用 static final Map 配合 Map.of()（Java 9+）或 Collections.unmodifiableMap()（兼容旧版）进行一次性初始化，而非直接暴露可变的 static List —— 因为列表本身不支持键值查找，违背语义；而 HashMap 虽可查，但若未封装则易被误修改。

✅ 推荐实现（Java 9+，简洁安全）：

public final class BluetoothUUIDs {
    private static final Map SERVICE_NAME_MAP = Map.of(
        "1800", "org.bluetooth.service.generic_access",
        "1801", "org.bluetooth.service.generic_attribute",
        "180A", "org.bluetooth.service.device_information",
        "FEAA", "google:eddystone"
        // 可按需扩展
    );

    private BluetoothUUIDs() {} // 工具类禁止实例化

    public static String getNameByUUID(String uuid) {
        return SERVICE_NAME_MAP.getOrDefault(uuid, "unknown_service");
    }
}

✅ 兼容 Java 8 的写法（使用静态块 + 不可变包装）：

public final class BluetoothUUIDs {
    private static final Map SERVICE_NAME_MAP;

    static {
        Map temp = new HashMap<>();
        temp.put("1800", "org.bluetooth.service.generic_access");
        temp.put("1801", "org.bluetooth.service.generic_attribute");
        temp.put("180A", "org.bluetooth.service.device_information");
        SERVICE_NAME_MAP = Collections.unmodifiableMap(temp);
    }

    private BluetoothUUIDs() {}

    public static String getNameByUUID(String uuid) {
        return SERVICE_NAME_MAP.get(uuid); // 返回 null 表示未匹配，也可用 getOrDefault
    }
}

? 关键优势说明：

• 静态 final + 不可变性：保证单例、线程安全、不可篡改；
• 封装方法 getNameByUUID()：对外隐藏底层数据结构，便于未来替换（如切换为数据库或缓存）；
• 零依赖、无 Spring 等框架要求：纯 Java 实现，适用于 Android、嵌入式或轻量服务；
• 调用直观：可直接用于你原目标代码：

  updateSingleItem(new InformationListModule(BluetoothUUIDs.getNameByUUID(uid), value));

⚠️ 注意事项：

• 避免使用 static List 存储键值对（如 List

  air>），会导致 O(n) 查找、无索引、易出错；

• 若映射数据量极大（>10k 条）或需动态更新，请考虑 ConcurrentHashMap + 懒加载/缓存策略，但本场景静态常量表已足够；
• 所有键建议统一格式（如全大写、去 - 和 0x 前缀），提升健壮性，可在 getNameByUUID() 中预处理。

总结：静态不可变 Map 是解决“全局 UUID 名称映射”问题最清晰、高效、符合 Java 最佳实践的方式——它让代码自解释、易测试、难出错。