46.4. 编程模型

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

此方法中需要执行的主要操作是创建适当类型的代理类（API 类），以匹配 API 名称。API 名称（已从端点 URI 提取）可通过继承的 apiName 字段或通过 getApiName 访问器获得。通常，您要对 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);
    }
}

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

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

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

（可选） API 组件框架使用端点 URI 和提供的选项值来确定调用的方法（可能源自于过载和别名）。如果组件在内部添加了选项或方法参数，但框架可能需要帮助来确定调用的正确方法。在这种情况下，您必须覆盖 interceptPropertyNames 方法，并为 set 的 propertyNames 添加 extra（hidden 或 implicit）选项。当设置了 propertyNames 中的完整方法参数列表时，框架将能够识别要调用的正确方法。

（可选） 通过覆盖此方法，您可以在调用 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 消息调用的结果。如果要分割结果，您应该返回数组类型。