46.4. 编程模型

（可选） 在组件停止期间调用代码的回调。停止组件意味着其所有资源都会关闭，内部状态被删除，缓存会被清除，以此类推。

在此方法中您需要执行的主要操作是创建适当的代理类(API 类)来匹配 API 名称。API 名称（已经从端点 URI 中提取）可以通过继承的 apiName 字段或通过 getApiName accessor 获取。通常，您需要在 apiName 字段中执行交换机来创建对应的代理类。例如：

// Java
private Object apiProxy;
...
@Override
protected void afterConfigureProperties() {
    // TODO create API proxy, set connection properties, etc.
    switch (apiName) {
        case HELLO_FILE:
            apiProxy = new ExampleFileHello();
            break;
        case HELLO_JAVADOC:
            apiProxy = new ExampleJavadocHello();
            break;
        default:
            throw new IllegalArgumentException("Invalid API name " + apiName);
    }
}

覆盖此方法，返回您在 afterConfigureProperties 中创建的代理实例。例如：

@Override
public Object getApiProxy(ApiMethod method, Map<String, Object> args) {
    return apiProxy;
}

特殊情况下，您可能想要选择代理取决于 API 方法和参数。getApiProxy 为您提供了在必要时使用此方法的灵活性。

（可选） API 组件框架使用端点 URI 和提供选项值来决定要调用的方法（模糊的可能是由于过载和别名造成的）。但是，如果组件内部添加选项或方法参数，则框架可能需要帮助来确定要调用的正确方法。在这种情况下，您必须覆盖 interceptPropertyNames 方法，并将额外的（隐藏或隐式）选项添加到 属性名称 集。在 attribute Names 集合中提供方法参数的完整列表时，该框架将能够识别要调用的正确方法。

（可选） 通过覆盖此方法，您可以在调用 API 方法前修改或设置选项的实际值。例如，如果需要，您可以使用此方法为某些选项设置默认值。在实践中，通常需要覆盖 intercept Property Names 方法和 interceptProperty 方法。

（可选） 覆盖此方法可让您截获 Java API 方法的调用。覆盖此方法的最常见原因是自定义有关方法调用的错误处理。例如，以下代码片段中显示了覆盖 doInvokeMethod 的典型方法：

// Java
@Override
protected Object doInvokeMethod(Map<String, Object> args) {
    try {
        return super.doInvokeMethod(args);
    } catch (RuntimeCamelException e) {
        // TODO - Insert custom error handling here!
        ...
    }
}

在实施的某个时候，您应该在超级类上调用 doInvokeMethod，以确保 Java API 方法被调用。

（可选） 默认情况下，如果方法 API 调用的结果是 java.util.Collection 对象或 Java 数组，API 组件框架会将结果分成多个交换对象（因此单个调用结果转换为多个消息）。

如果要更改默认的行为，可以覆盖消费者端点中的 splitResult 方法。result 参数包含 API 消息调用的结果。如果要分割结果，您应该返回数组类型。