combine.md

description
이벤트 처리 연산자를 결합하여 비동기 이벤트 처리를 커스터마이즈 하세요

Combine

원문 출처
https://developer.apple.com/documentation/Combine

Summary

SDKs

• iOS 13.0+
• macOS 10.15+
• Mac Catalyst 13.0+
• tvOS 13.0+
• watchOS 6.0+

개요

Combine 프레임워크는 시간 경과에 따른 처리를 위한 선언적 Swift API를 제공합니다. 처리되는 값들은 여러 종류의 비동기 이벤트로 표현됩니다. Combine은 값을 노출시키기 위해 Publisher를 선언하며 이 값은 시간에 따라 바뀝니다. 그리고 Subscriber는 Publisher로부터 값을 받습니다.

• Publisher 프로토콜은 시간에 따라 일련의 값을 전달할 수 있는 타입을 선언합니다. Publisher에는 업스트림 Publisher로부터 받은 값에 대해 동작하고 이를 다시 게시하는 연산자가 있습니다.
• Publisher 체인 끝에는 Subscriber가 존재하여 받은 값에 따라서 요소에 동작을 수행합니다. Publisher는 Subscriber로부터 명시적인 요청을 받을 때에만 값을 전달하며 이는 코드를 통해 Subscriber가 연결된 Publisher로부터 이벤트를 받는 속도를 조절할 수 있게 해줍니다.

Timer, NotificationCenter, URLSession과 같은 몇몇 Foundation 타입들은 Publisher를 통해 그 기능을 노출합니다. 또한 Combine은 프로퍼티에 내장 publisher를 제공하며 Key-Value Observing과 호환됩니다.

여러 publisher들의 출력값을 조합하고 상호작용을 조절하는 것도 가능합니다. 예를 들어, 텍스트 필드의 publisher 업데이트를 추적하는 subscriber를 사용하면 해당 텍스트를 사용하여 URL 요청을 수행할 수 있고, 그 응답값을 처리하여 앱을 업데이트하는데 다른 publisher를 활용할 수 있습니다.

Combine을 사용하면 이벤트 처리 코드를 집중화 시키고 중첩 클로저와 컨벤션 기반 콜백과 같은 복잡한 기술들을 제거할 수 있습니다. 이렇게 함으로써 읽거나 유지보수하기에 더 좋은 코드가 만들어집니다.

주제

Essentials

• Combine으로 이벤트 받고 처리하기 비동기 소스로부터 이벤트를 받고 커스터마이징하세요

Publishers

• protocol Publisher 시간에 따라 일련의 값을 전송하는 타입을 선언합니다
• enum Publishers publisher 기능을 하는 타입들의 네임스페이스
• struct AnyPublisher 다른 publisher로 감싸서 타입 삭제를 수행하는 publisher
• struct Published attribute로 지정된 property를 퍼블리싱하는 타입
• protocol Cancellable 활동이나 동작의 취소가 가능함을 가리키는 프로토콜
• class AnyCancellable 타입을 삭제하는 cacellable 객체로써 취소될 때 제공된 클로저를 실행합니다

Convenience Publishers

• class Future 단일값을 생성한 후 완료되거나 실패하는 publisher
• struct Just 각 subscriber마다 단 한번 결과값을 주고 완료되는 publisher
• struct Deferred 대기 중에 subscription이 발생하면 제공된 클로저를 실행해서 새 subscriber를 위한 publisher를 생성합니다.
• struct Empty 어떤 값도 내놓지 않고 경우에 따라 즉시 완료됩니다
• struct Fail 지정된 에러와 함께 즉시 중단됩니다
• struct Record 각 subscriber가 추후 다시 볼 수 있도록 일련의 입력값과 완료 상태를 기록하는 것이 가능합니다

Connectable Publishers

• 연결 가능한 Publisher로 퍼블리싱 조작하기 Publisher가 Subscriber에게 요소를 보내기 시작할 때 조정합니다.
• protocol ConnectablePublisher Publication의 연결과 취소라는 명시적인 의미를 제공하는 publisher

Subscribers

• 퍼블리싱 된 요소를 Subscriber로 처리하기 Publisher가 요소를 생성하는 시점을 정확하게 제어하기 위해 반대 방향의 압력을 적용합니다.
• protocol Subscriber Publisher로부터 입력값을 받을 수 있는 타입을 선언하는 프로토콜
• enum Subscribers Subscriber 역할을 하는 타입들의 네임스페이스
• struct AnySubscriber 타입을 삭제하는 subscriber
• protocol Subscription Subscriber에서 Publisher로 향하는 연결을 표현하는 프로토콜
• enum Subscriptions Subscription과 연관된 symbol들의 네임스페이스

Subjects

• protocol Subject 외부 호출자가 요소를 퍼블리싱할 수 있도록 Publisher가 노출시키는 메소드
• class CurrentValueSubject 단일 값을 감싸서 값의 변화가 일어날 때마다 새 요소를 퍼블리싱하는 객체
• class PassthroughSubject 요소를 다운스트림 subscriber들에게 전파하는 객체

Schedulers

• protocol Scheduler 클로저를 언제, 어떻게 실행할 것인지 정의하는 프로토콜
• struct ImmediateScheduler 동기적인 동작을 위한 스케줄러
• protocol SchedulerTimeIntervalConvertible 스케줄러에 상대 시간에 대한 표현식을 제공하는 프로토콜

Combine Migration

• 노티피케이션을 Combine Subscriber로 라우트하기 노티피케이션 센터의 Publisher를 사용해서 노티피케이션을 Subscriber로 전달하세요
• Timer Publisher로 Foundation Timer 대체하기 Timer를 사용해서 주기적으로 요소를 퍼블리싱합니다
• Combine으로 Key-Value Observing 수행하기 Combine publisher를 사용해서 KVO 변화를 노출시킵니다
• 비동기 코드를 위한 Combine 사용법 클로저 기반의 이벤트 처리 코드를 마이그레이션하는 일반적인 패턴

Observable Objects

• protocol ObservableObject 변화가 일어나기 전에 값을 내보내는 Publisher가 포함된 객체 타입
• class ObservableObjectPublisher Observable object의 변화를 퍼블리싱하는 Publisher

Encoders and Decoders

• protocol TopLevelEncoder 인코딩 메소드를 정의하는 타입
• protocol TopLevelDecoder 디코딩 메소드를 정의하는 타입

Debugging Identifiers

• protocol CustomCombineIdentifierConvertible 유니크하게 식별되는 Publisher 스트림을 위한 프로토콜
• struct CombineIdentifier Publisher 스트림을 식별하기 위한 유니크 식별자

Structures

• struct AsyncPublisher
• struct AsyncThrowingPublisher