47.5. 参数名称替换

API 组件框架要求 URI 选项名称 在每个代理类(Java API 类)中是唯一的。但是，这并非总是是方法参数名称的情况。例如，考虑 API 类中的以下 Java 方法：

public void doSomething(int id, String name);
public void doSomethingElse(int id, String name);

构建 Maven 项目时，camel-api-component-maven-plugin 生成配置类 ProxyClassEndpointConfiguration，其中包含 ProxyClass 类中 所有参数 的 getter 和 setter 方法。例如，给定前面的方法，插件将在配置类中生成以下 getter 和 setter 方法：

public int  getId();
public void setId(int id);
public String getName();
public void   setName(String name);

但是，如果 id 参数显示为不同类型多次，如下例所示：

public void doSomething(int id, String name);
public void doSomethingElse(int id, String name);
public String lookupByID(String id);

在这种情况下，代码生成会失败，因为您无法定义一个返回 int 的 getId 方法，以及一个在同一范围内返回 String 的 getId 方法。这个问题的解决方案是使用 参数名称替换来自定义参数名称到 URI 选项名称 的映射。

可以使用一个或多个 替换 子元素定义 替换 元素，如下所示：

<substitutions>
  <substitution>
    <method>MethodPattern</method>
    <argName>ArgumentNamePattern</argName>
    <argType>TypeNamePattern</argType>
    <replacement>SubstituteArgName</replacement>
    <replaceWithType>[true|false]</replaceWithType>
  </substitution>
  ...
</substitutions>

其中 argType 元素和 replaceWithType 元素是可选的，可以省略。

如以下提取所示，replaces 元素可以选择性地显示为 apis 元素和/或作为 api 元素子元素的子级：

<configuration>
  <apis>
    <api>
      <apiName>...</apiName>
      ...
      <substitutions>...</substitutions>
    </api>
    <substitutions>...</substitutions>
    ...
  </apis>
</configuration>

您可以在以下范围中定义 replaces 元素：

每个 替换 元素可使用以下子元素定义：

以下替换示例通过将后缀 Param 添加到参数名称来修改 java.lang.String 类型的每个参数：

<substitutions>
  <substitution>
    <method>^.+$</method>
    <argName>^.+$</argName>
    <argType>java.lang.String</argType>
    <replacement>$1Param</replacement>
    <replaceWithType>false</replaceWithType>
  </substitution>
</substitutions>

例如，给定以下方法签名：

public String greetUs(String name1, String name2);

此方法的参数将通过端点 URI 中的选项 name1Param 和 name2Param 指定。