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 方法，并将额外的（隐藏或隐式）选项添加到 propertyNames 设置中。在 propertyNames 集合中提供了 method 参数的完整列表，框架将能够识别要调用的正确方法。

（可选） 通过覆盖这个方法，您可以在调用 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!
        ...
    }
}

在此实施中，您应该在 super-class 上调用 doInvokeMethod，以确保 Java API 方法被调用。

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

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