완료 핸들러
완료 핸들러 (CompletionHandler)
비동기 I/O 연산이 완료되었을 때 결과를 받을 콜백을 정의하는 인터페이스예요. 비동기 채널 연산의 완료를 처리합니다.
본문
CompletionHandler는 비동기 I/O 연산이 완료되었을 때 호출되는 콜백을 정의하는 인터페이스예요.
public interface CompletionHandler<V, A>
비동기 채널 연산을 시작할 때 이 핸들러를 넘기면, 연산이 성공적으로 완료되거나 실패했을 때 해당 메서드가 호출됩니다.
void completed(V result, A attachment)
void failed(Throwable exc, A attachment)
completed(V result, A attachment)— 연산이 성공적으로 완료되면 호출돼요.result는 연산의 결과이고,attachment는 연산 시작 시 넘긴 첨부 객체입니다.failed(Throwable exc, A attachment)— 연산이 실패하면 호출돼요.exc는 실패 원인을 담고 있습니다.
이 인터페이스는 비동기 채널의 read/write/connect/accept/lock 같은 연산의 완료 처리를 위해 사용돼요. 결과 값(예: 전송된 바이트 수)을 받거나 예외를 처리하기 위해 두 메서드를 모두 구현해야 합니다.