fxMapCatching

원소마다의 실패를 값으로 대체하는 map — 잘못된 행 하나가 순회를 끝내지 않습니다.

Iterable<R> fxMapCatching<A, R>(R Function(A a) f, R Function(Object error, StackTrace stackTrace) onError, Iterable<A> iterable) FxAsyncIterable<R> fxMapCatchingAsync<A, R>(FutureOr<R> Function(A a) f, FutureOr<R> Function(Object error, StackTrace stackTrace) onError, FxAsyncIterable<A> iterable) Fx<R> Fx<T>.mapCatching<R>(R Function(T a) f, R Function(Object error, StackTrace stackTrace) onError) // chain (sync) FxAsync<R> FxAsync<T>.mapCatching<R>(FutureOr<R> Function(T a) f, FutureOr<R> Function(Object error, StackTrace stackTrace) onError) // chain (async)

강의

콜백이 예외를 던지는 map은 그 원소에서 파이프라인 전체를 끝냅니다. 만 개 중 잘못된 행이 하나만 있어도 9,999개의 결과가 아니라 예외를 받게 됩니다. mapCatching(f, onError)는 각 원소에 f를 실행하고, 예외가 나면 에러와 스택 트레이스를 onError에 넘겨 그 반환값을 실패한 원소의 자리에 내보냅니다. 다음 원소는 아무 일도 없었던 것처럼 매핑됩니다. 지연 평가를 유지하며, Fx에서는 동기 체인에 그대로 머뭅니다 — 기다릴 것이 없기 때문입니다.

mapRetry 옆에 놓이며, 둘은 실패한 원소에 대한 두 가지 대답입니다. mapRetry는 그 원소를 다시 실행하고, mapCatching은 포기하고 대체합니다. 비동기 형태인 fxMapCatchingAsync / fxAsync(…).mapCatching은 f와 onError 모두 await할 수 있고, 병렬 안전한 fxMapAsync 위에 만들어졌으므로 concurrent(n) 아래에서 진행 중인 각 원소가 따로 복구되고 순서도 유지됩니다. RxDart는 이를 onErrorReturnWith라고 씁니다. fxdart 푸시 스트림에서 이웃하는 연산자는 onErrorReturn(에러마다 고정된 값 하나로 대체)과 attempt(에러를 대체하지 않고 Left로 보존)입니다.

절대 복구되지 않는 것이 하나 있습니다. 라이브러리 자체의 raise 신호입니다. bind, ensure, 혹은 중첩된 빌더에서 나온 r.raise(…)가 f를 가로지르면 다시 던져지므로, 바깥의 fxEither / fxNullable 블록을 여전히 단락합니다. 이것을 복구하면 타입 있는 에러가 사라진 에러로 바뀝니다. raise 블록 안의 지연 파이프라인이 늘 그렇듯, 블록 안에서 구체화 (toList())하세요. fxdart 확장 기능입니다(FxTS에는 없습니다).

데모 1 · 잘못된 행 하나를 그 자리에서 복구

데모 2 · concurrent 아래의 비동기, 그리고 통과하는 raise

직접 해 보기

연습: try/catch 루프를 연산자 하나로 바꿔 보세요.

관련 항목: retry — 대체하는 대신 그 원소를 다시 실행 · onErrorReturn — 푸시 스트림에서의 같은 발상 · 타입 있는 에러 — 실패를 살펴볼 수 있는 값으로 남겨야 할 때