Impact Assessment: 将 apiKeysWithHosts 从 Map<String, String> 改为 Map<String, AppProduct>

📋 改动概述

目标：将 apiKeysWithHosts 的值类型从 String（host）改为 AppProduct 对象

原始：

Map<String, String> apiKeysWithHosts = new HashMap<>();
apiKeysWithHosts.put(apiKey, host);  // String host

改动后：

Map<String, AppProduct> apiKeysWithHosts = new HashMap<>();
apiKeysWithHosts.put(apiKey, eachAppProductName);  // AppProduct 对象

---

🎯 改动的价值

优势

1. ✅ 解决同一 host 多产品问题

   • 可以通过 AppProduct 对象精确识别每个产品
   • 不再依赖产品顺序或启发式匹配

2. ✅ 访问更多信息

   • 产品名称：appProduct.getProductName()
   • 应用名称：appProduct.getAppName()
   • API 配置：appProduct.getApiConfig()
   • Host：appProduct.getHost()
   • 其他字段…

3. ✅ 更严谨的验证逻辑

   • 可以精确匹配 API Key 和产品
   • 避免错误验证不相关的产品

4. ✅ 代码可读性提升

   • 意图更明确：API Key → 产品对象
   • 便于未来扩展

---

📊 影响范围评估

文件数量

• 2 个文件需要修改
  1. AmsSvcUtils.java - 1 个方法
  2. NautilusSvcDeploymentVerification.java - 5 个方法

修改点统计

文件	修改类型	数量	难度
AmsSvcUtils.java
方法签名	返回类型	1	简单
变量声明	Map 类型	1	简单
put 调用	值类型	1	简单
日志输出	可选	1	简单
NautilusSvcDeploymentVerification.java
变量声明	Map 类型	5	简单
空检查	无需修改	5	无
for 循环	泛型类型	5	简单
获取 host	entry.getValue() → entry.getValue().getHost()	5	简单
总计		~20	简单

---

📝 详细修改清单

1. AmsSvcUtils.java

修改 1.1：方法签名

位置：Line 34

// 修改前
public static Map<String, String> getApiKeysFromAms(String currentRegion, String currentProject, String routingKey)

// 修改后
public static Map<String, AppProduct> getApiKeysFromAms(String currentRegion, String currentProject, String routingKey)

修改 1.2：变量声明

位置：Line 99

// 修改前
Map<String, String> apiKeysWithHosts = new HashMap<>();

// 修改后
Map<String, AppProduct> apiKeysWithHosts = new HashMap<>();

修改 1.3：put 调用

位置：Line 183

// 修改前
apiKeysWithHosts.put(apiKey, eachAppProductName.getHost());

// 修改后
apiKeysWithHosts.put(apiKey, eachAppProductName);

修改 1.4：日志输出（可选）

位置：Line 201

// 修改前
logger.info("Found apikeys with hosts: " + apiKeysWithHosts);

// 修改后（可选优化）
logger.info("Found {} apikeys with products", apiKeysWithHosts.size());
// 或者
StringBuilder logMsg = new StringBuilder("Found apikeys with products: ");
for (Map.Entry<String, AppProduct> entry : apiKeysWithHosts.entrySet()) {
    logMsg.append(String.format("[%s -> %s/%s/%s], ", 
        entry.getKey(), 
        entry.getValue().getProductName(),
        entry.getValue().getAppName(),
        entry.getValue().getHost()));
}
logger.info(logMsg.toString());

---

2. NautilusSvcDeploymentVerification.java

需要修改 5 个方法：

方法 2.1：getEntityVerifyResponse

位置：Lines 239, 252, 257-259

// 修改前
Map<String, String> apiKeysWithHosts = AmsSvcUtils.getApiKeysFromAms(request.getRegion(), request.getProject(), configKey);
// ...
if (apiKeysWithHosts == null || apiKeysWithHosts.isEmpty()) {
    // error handling
}
for (Map.Entry<String, String> entry : apiKeysWithHosts.entrySet()) {
    String apiKey = entry.getKey();
    String host = entry.getValue();  // ← 修改这里

// 修改后
Map<String, AppProduct> apiKeysWithHosts = AmsSvcUtils.getApiKeysFromAms(request.getRegion(), request.getProject(), configKey);
// ...
if (apiKeysWithHosts == null || apiKeysWithHosts.isEmpty()) {
    // error handling (无需修改)
}
for (Map.Entry<String, AppProduct> entry : apiKeysWithHosts.entrySet()) {
    String apiKey = entry.getKey();
    AppProduct appProduct = entry.getValue();  // ← 获取 AppProduct 对象
    String host = appProduct.getHost();        // ← 从对象获取 host

方法 2.2：getEvVerifyResponse

位置：Lines 356, 359, 365-367
修改：与 2.1 相同

方法 2.3：getOnStreetParkingVerifyResponse

位置：Lines 408, 411, 417-419
修改：与 2.1 相同

方法 2.4：getAdasVerifyResponse

位置：Lines 451, 457, 464-466
修改：与 2.1 相同

方法 2.5：getVerifyResponse

位置：Lines 519, 525, 533+
修改：与 2.1 相同

---

💡 改动后的增强功能

增强 1：在 amsValidation 中精确匹配产品

private VerifyResponse amsValidation(..., String apiKey, AppProduct expectedProduct, ...) {
    // ...
    
    for (AppProduct eachAppsProducts : appsProductsNames) {
        String tempHost = eachAppsProducts.getHost();
        
        // 精确匹配：检查是否是当前 API Key 对应的产品
        if (!tempHost.equalsIgnoreCase(expectedProduct.getHost())) {
            continue;
        }
        
        // 更精确的匹配：通过产品名和应用名
        if (!eachAppsProducts.getProductName().equals(expectedProduct.getProductName()) ||
            !eachAppsProducts.getAppName().equals(expectedProduct.getAppName())) {
            logger.debug("Product {}/{} does not match expected {}/{}, skipping",
                        eachAppsProducts.getProductName(), 
                        eachAppsProducts.getAppName(),
                        expectedProduct.getProductName(),
                        expectedProduct.getAppName());
            continue;
        }
        
        // 现在可以确信这是正确的产品
        // 继续验证...
    }
}

增强 2：amsValidation 方法签名修改

// 修改前
private VerifyResponse amsValidation(
    VerifyNautilusSvcRequest request,
    String amsUrl,
    String apiKey,
    String host,  // ← 只有 host
    List<AppProduct> appsProductsNames
)

// 修改后（推荐）
private VerifyResponse amsValidation(
    VerifyNautilusSvcRequest request,
    String amsUrl,
    String apiKey,
    AppProduct expectedProduct,  // ← 完整的 AppProduct 对象
    List<AppProduct> appsProductsNames
)

增强 3：调用方修改

// 修改前
for (Map.Entry<String, String> entry : apiKeysWithHosts.entrySet()) {
    String apiKey = entry.getKey();
    String host = entry.getValue();
    
    VerifyResponse amsResponse = amsValidation(request, amsUrl, apiKey, host, appsProductsNames);
}

// 修改后
for (Map.Entry<String, AppProduct> entry : apiKeysWithHosts.entrySet()) {
    String apiKey = entry.getKey();
    AppProduct appProduct = entry.getValue();
    
    VerifyResponse amsResponse = amsValidation(request, amsUrl, apiKey, appProduct, appsProductsNames);
}

---

🔍 风险评估

低风险

✅ 类型安全：编译器会捕获所有类型错误
✅ 向后兼容：只是内部实现改动，不影响外部接口
✅ 简单修改：大部分是机械式的类型替换

需要注意

⚠️ 空指针检查：

AppProduct appProduct = entry.getValue();
if (appProduct != null) {
    String host = appProduct.getHost();
}

⚠️ 日志输出：

• toString() 方法可能输出大量信息
• 建议只输出关键字段

⚠️ 性能影响：

• 可忽略不计（只是对象引用而不是字符串）

---

📈 改动成本估算

项目	估算
代码修改时间	30-45 分钟
测试时间	30-60 分钟
总工作量	1-2 小时
风险等级	🟢 低
测试复杂度	🟡 中
代码审查难度	🟢 简单

---

✅ 推荐的实施步骤

步骤 1：修改 AmsSvcUtils.java

1. 修改方法签名返回类型
2. 修改局部变量声明
3. 修改 put 调用
4. 优化日志输出（可选）

步骤 2：修改 NautilusSvcDeploymentVerification.java

1. 全局搜索替换：

   • Map<String, String> apiKeysWithHosts → Map<String, AppProduct> apiKeysWithHosts
   • Map.Entry<String, String> entry → Map.Entry<String, AppProduct> entry

2. 逐个方法修改：

   • 添加 AppProduct appProduct = entry.getValue();
   • 修改 String host = entry.getValue(); → String host = appProduct.getHost();

步骤 3：增强 amsValidation 方法（可选但推荐）

1. 修改方法签名，添加 AppProduct 参数
2. 在循环中添加精确匹配逻辑
3. 移除之前的 break 逻辑（不再需要）

步骤 4：测试

1. 单元测试：AmsSvcUtils.getApiKeysFromAms
2. 集成测试：各个验证方法
3. 端到端测试：完整的验证流程
4. 特别测试：同一 host 多产品场景

---

📊 改动前后对比

场景：同一 host 多产品

YAML 配置：

apps_products:
  - product_name: "NIO"
    app_name: "nio for Jiangziya"
    host: https://nioeu.telenav.com
    api_config:
      configGroup: nio.jiangziya
      
  - product_name: "NIO"
    app_name: "NIO FireFly EU"
    host: https://nioeu.telenav.com
    api_config:
      configGroup: nio.firefly.jiangziya

API Keys：

• apiKey1_jiangziya
• apiKey2_firefly

改动前（当前方案）

Map<String, String> apiKeysWithHosts = {
  "apiKey1_jiangziya": "https://nioeu.telenav.com",
  "apiKey2_firefly": "https://nioeu.telenav.com"
}

// 外层循环1：apiKey1, host="https://nioeu.telenav.com"
amsValidation(request, amsUrl, apiKey1, "https://nioeu.telenav.com", appsProductsNames);
  // 遍历所有产品，第一个匹配的会被验证，然后 break
  // 问题：无法确定验证的是哪个产品

// 外层循环2：apiKey2, host="https://nioeu.telenav.com"  
amsValidation(request, amsUrl, apiKey2, "https://nioeu.telenav.com", appsProductsNames);
  // 同样的问题

❌ 问题：

• 依赖产品顺序
• 可能验证错误的产品
• 无法保证 API Key 与产品的正确对应

改动后（推荐方案）

Map<String, AppProduct> apiKeysWithHosts = {
  "apiKey1_jiangziya": AppProduct(productName="NIO", appName="nio for Jiangziya", host="https://nioeu.telenav.com", ...),
  "apiKey2_firefly": AppProduct(productName="NIO", appName="NIO FireFly EU", host="https://nioeu.telenav.com", ...)
}

// 外层循环1：apiKey1, expectedProduct=Jiangziya AppProduct
amsValidation(request, amsUrl, apiKey1, jiangziyaAppProduct, appsProductsNames);
  // 精确匹配：只验证 productName="NIO" AND appName="nio for Jiangziya" 的产品
  // 确保使用正确的 API Key 验证正确的产品

// 外层循环2：apiKey2, expectedProduct=FireFly AppProduct
amsValidation(request, amsUrl, apiKey2, fireflyAppProduct, appsProductsNames);
  // 精确匹配：只验证 productName="NIO" AND appName="NIO FireFly EU" 的产品

✅ 优势：

• 精确的产品匹配
• 不依赖顺序
• API Key 与产品的对应关系明确
• 代码逻辑清晰

---

🎯 总结

改动规模

• ✅ 代码量：~20 处修改
• ✅ 复杂度：低（机械式修改）
• ✅ 风险：低（编译器保护）

价值

• 🌟 解决核心问题：同一 host 多产品
• 🌟 提升代码质量：更清晰、更严谨
• 🌟 未来可扩展：便于添加更多功能

建议

强烈推荐实施此改动！

虽然有约 20 处修改点，但：

1. 修改都是机械式的，容易操作
2. 编译器会捕获所有错误
3. 解决了一个重要的架构问题
4. 为未来的功能扩展打下基础

---

🔧 需要帮助吗？

我可以帮你：

1. ✅ 生成完整的修改代码
2. ✅ 提供测试用例
3. ✅ 逐步执行修改
4. ✅ 验证修改后的代码

需要我开始实施这些修改吗？

欢迎使用Markdown编辑器

你好！ 这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章，了解一下Markdown的基本语法知识。

新的改变

我们对Markdown编辑器进行了一些功能拓展与语法支持，除了标准的Markdown编辑器功能，我们增加了如下几点新功能，帮助你用它写博客：

1. 全新的界面设计 ，将会带来全新的写作体验；
2. 在创作中心设置你喜爱的代码高亮样式，Markdown 将代码片显示选择的高亮样式 进行展示；
3. 增加了 图片拖拽 功能，你可以将本地的图片直接拖拽到编辑区域直接展示；
4. 全新的 KaTeX数学公式 语法；
5. 增加了支持甘特图的mermaid语法¹ 功能；
6. 增加了 多屏幕编辑 Markdown文章功能；
7. 增加了 焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置 等功能，功能按钮位于编辑区域与预览区域中间；
8. 增加了 检查列表 功能。

功能快捷键

撤销：Ctrl/Command + Z
重做：Ctrl/Command + Y
加粗：Ctrl/Command + B
斜体：Ctrl/Command + I
标题：Ctrl/Command + Shift + H
无序列表：Ctrl/Command + Shift + U
有序列表：Ctrl/Command + Shift + O
检查列表：Ctrl/Command + Shift + C
插入代码：Ctrl/Command + Shift + K
插入链接：Ctrl/Command + Shift + L
插入图片：Ctrl/Command + Shift + G
查找：Ctrl/Command + F
替换：Ctrl/Command + G

合理的创建标题，有助于目录的生成

直接输入1次#，并按下space后，将生成1级标题。
输入2次#，并按下space后，将生成2级标题。
以此类推，我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。

如何改变文本的样式

强调文本 强调文本

加粗文本 加粗文本

标记文本

删除文本

引用文本

H₂O is是液体。

2¹⁰ 运算结果是 1024.

插入链接与图片

链接: link.

图片:

带尺寸的图片:

居中的图片:

居中并且带尺寸的图片:

当然，我们为了让用户更加便捷，我们增加了图片拖拽功能。

如何插入一段漂亮的代码片

去博客设置页面，选择一款你喜欢的代码片高亮样式，下面展示同样高亮的 代码片.

// An highlighted block
var foo = 'bar';

生成一个适合你的列表

• 项目
  • 项目
    • 项目

1. 项目1
2. 项目2
3. 项目3

• 计划任务
• 完成任务

创建一个表格

一个简单的表格是这么创建的：

项目	Value
电脑	$1600
手机	$12
导管	$1

设定内容居中、居左、居右

使用:---------:居中
使用:----------居左
使用----------:居右

第一列	第二列	第三列
第一列文本居中	第二列文本居右	第三列文本居左

SmartyPants

SmartyPants 是一个文本转换工具，主要功能是将普通的 ASCII 标点符号自动转换为更美观的印刷体标点符号。例如：

原始符号	转换后	说明
"引号"	“引号”	直引号变弯引号
'单引号'	‘单引号’	直单引号变弯单引号
--	–	两个连字符变短破折号
---	—	三个连字符变长破折号
...	…	三个点变省略号

创建一个自定义列表

Markdown

Text-to- HTML conversion tool

Authors

John

Luke

如何创建一个注脚

一个具有注脚的文本。²

注释也是必不可少的

Markdown将文本转换为 HTML。

KaTeX数学公式

您可以使用渲染LaTeX数学表达式 KaTeX:

Gamma公式展示 $\Gamma (n)=(n-1)!\forall n\in \mathbb{N}$ 是通过欧拉积分

$$\Gamma (z)={\int }_0^{\infty }{t}^{z-1}{e}^{-t}dt.$$

你可以找到更多关于的信息 LaTeX 数学表达式here.

新的甘特图功能，丰富你的文章

• 关于 甘特图 语法，参考 这儿,

UML图表

可以使用UML图表进行渲染，例如下面产生的一个序列图：

• 关于 UML图表 语法，参考 这儿,

流程图

• 关于 Mermaid 语法，参考 这儿,

FLowchart流程图

我们依旧会支持flowchart.js的流程图语法：

• 关于 Flowchart流程图 语法，参考 这儿.

导出与导入

导出

如果你想尝试使用此编辑器, 你可以在此篇文章任意编辑。当你完成了一篇文章的写作, 在上方工具栏找到 文章导出 ，生成一个.md文件或者.html文件进行本地保存。

导入

如果你想加载一篇你写过的.md文件，在上方工具栏可以选择导入功能进行对应扩展名的文件导入，
继续你的创作。

---

1. mermaid语法说明 ↩︎

2. 注脚的解释 ↩︎