47.7. 额外选项

extraOptions 选项通常用于通过提供更简单的选项来计算或隐藏复杂的 API 参数。例如，API 方法可能采用 POJO 选项，该选项可以更轻松地作为 URI 中的 POJO 的部分提供。组件可以通过添加部分作为额外选项并在内部创建 POJO 参数来实现此目的。要完成这些额外选项的实现，您还需要覆盖 EndpointConsumer 和/或 EndpointProducer 类中的 interceptProperties 方法（请参阅 第 46.4 节 “编程模型”）。

extraOptions 元素可使用一个或多个 extraOption 子元素定义，如下所示：

<extraOptions>
  <extraOption>
    <type>TypeName</type>
    <name>OptionName</name>
  </extraOption>
</extraOptions>

其中 TypeName 是额外选项的完全限定类型名称，OptionName 是额外 URI 选项的名称。

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

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

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

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

以下示例定义了一个额外的 URI 选项 customOption，它是 java.util.list<String> 类型：

<extraOptions>
  <extraOption>
    <type>java.util.List<String></type>
    <name>customOption</name>
  </extraOption>
</extraOptions>