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);
    }
}

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

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

在特殊情况下，您可能希望根据 API 方法和参数选择代理。getApiProxy 为您提供了采取此方法的灵活性（如果需要）。

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

（可选） 通过在调用 API 方法前修改或设置选项的实际值。例如，如果需要，您可以使用此方法为某些选项设置默认值。实际上，通常需要同时覆盖 interceptPropertyNames 方法和 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 消息调用的结果。如果要分割结果，您应该返回一个数组类型。