fxFoldRaise

블록을 새 Raise<E> 스코프에서 실행하고, 무슨 일이 일어나든 — 값이든, raise된 에러든, 던져진 예외든 — 하나의 결과 타입으로 접습니다.

B fxFoldRaise<E, A, B>(A Function(Raise<E> r) block, {required B Function(E error) onRaise, required B Function(A value) onValue, B Function(Object thrown, StackTrace stackTrace)? onThrow}) Future<B> fxFoldRaiseAsync<E, A, B>(FutureOr<A> Function(Raise<E> r) block, {required FutureOr<B> Function(E error) onRaise, required FutureOr<B> Function(A value) onValue, FutureOr<B> Function(Object thrown, StackTrace stackTrace)? onThrow})

강의

fxEither는 raise 블록을 Either로, fxNullable은 T?로 바꿉니다. 둘 다 fxFoldRaise 한 번의 호출이며, 이것이 모든 빌더가 파생되는 단 하나의 기본 연산입니다 — Arrow의 fold를 이식한 것입니다. 새 스코프 r로 block을 실행하고, 블록이 어떻게 끝났는지에 따라 분기합니다:

경계에서 원하는 모양이 Either도 T?도 아닐 때 — 상태 문자열, HTTP 응답, 레코드, 직접 만든 sealed 타입 — 그리고 그렇지 않으면 바로 다음 줄에서 switch하려고 Either를 만들게 될 때 쓰세요. 나만의 빌더를 작성하는 방법도 이것입니다. fxEither는 Left를 만드는 onRaise와 Right를 만드는 onValue를 준 fxFoldRaise일 뿐, 그 이상은 없습니다. onThrow는 fxEitherCatching과 r.recover가 넘겨주는 세 절 형태이며, raise 신호 자체는 결코 여기에 전달되지 않습니다.

fxFoldRaiseAsync는 비동기 쌍둥이입니다. 블록과 모든 핸들러가 await할 수 있고, fxEitherAsync와 같은 규칙 — raise는 await 체인 안에서만 — 이 적용됩니다. 접기가 반환되면 스코프가 닫히므로, 나중에 raise할 지연 파이프라인은 블록 안에서 구체화해야 합니다. fxFoldRaise라는 이름은 fxFold가 이미 있어서 붙었습니다.

데모 1 · 세 가지 결과, 하나의 결과 타입

데모 2 · 나만의 빌더, 중첩 & 비동기

직접 해 보기

연습: 중간의 Either를 건너뛰고 스코프를 곧바로 메시지로 접어 보세요.

관련 항목: fxEither & Raise 스코프 — 이것 위에 만든 빌더 · fxNullable — 정보 없는 빌더, 역시 접기 한 번 · Either — 이미 가진 값에 대한 fold · 타입 있는 에러 — 전체 가이드