46.4. 프로그래밍 모델

(선택 사항) 구성 요소가 중지되는 동안 코드를 호출하는 콜백입니다. 구성 요소를 중지하면 모든 리소스가 종료되고 내부 상태가 삭제되고 캐시가 지워집니다.

이 메서드에서 수행해야 하는 주요 작업은 API 이름과 일치하도록 적절한 유형의 프록시 클래스(API 클래스)를 생성하는 것입니다. API 이름( endpoint 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 메서드를 재정의하고 propertyNames 세트에 추가(hidden 또는 implicit) 옵션을 추가해야 합니다. 메서드 매개 변수의 전체 목록이 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!
        ...
    }
}

Java API 메서드가 호출되도록 이 구현의 일정 시점에서 super-class에서 doInvokeMethod 를 호출해야 합니다.

(선택 사항) 메서드 API 호출 결과가 java.util.Collection 개체 또는 Java 배열인 경우 API 구성 요소 프레임워크에서 결과를 여러 교환 개체로 분할합니다(단일 호출 결과가 여러 메시지로 변환됨).

기본 동작을 변경하려면 소비자 끝점에서 splitResult 메서드를 덮어쓸 수 있습니다. 결과 인수에는 API 메시지 호출 결과가 포함됩니다. 결과를 분할하려면 배열 유형을 반환해야 합니다.