야옹 야옹

Publisher

2020-01-12T00:00:00+09:00

protocol
순차적으로 값의 시퀀스를 전달할 수 있는 타입 선언.

Declaration

protocol Publisher

Overview

publisher는 여러개의 subscriber instance에 요소를 전달한다.
subscriber의 Input, Failure 타입은 publisher의 Output과 Failure와 일치해야한다. publisher는 subscrebier를 허용하기 위해 receive(subscriber:) 메소드를 구현한다.
그 후에, publisher는 아래의 subscriber의 메소드를 호출 할 수 있다.

receive(subscription:)
- 구독이 성공 됐음을 알려주고, Subscription instance를 리턴.
- subscription은 publisher에게 요소를 요청하거나, 구독을 취소할 때 사용한다.
receive(_:)
- publisher는 subscriber에게 하나의 요소를 전달한다.
receive(completion:)
- 성공 혹은 실패고 publishing이 끝났다고 subscriber에게 알린다.

정상적으로 동작하려면 모든 publisher는 downstream subscriber를 위해 이 조건을 준수해야한다.

publisher extension은 이벤트 처리 체인을 정교하게 만드는 많은 종류의 연산자를 정의한다.
각 연산자는 Publisher protocol을 구현하는 형식으로 반환한다.
이 타입 대부분은 Publishers enum의 extension으로 존재한다.

예를 들어, map( _ :) 연산자는 Publishers.Map 인스턴스를 반환한다.

Creating Your Own Publishers

Publisher protocol로 커스텀 publisher를 만드는 것보다, Combine 프레임워크에서 제공해주는 타입을 이용해서 publisher를 사용하는걸 권장한다.

PassthroughSubject과 같이 Subject를 상속받아서 사용. send( _ :) 메소드를 호출해서 요청에 따라 값을 publish.
CurrentValueSubject는 subject의 기본 값을 업데이트 될 때마다 사용.
property에다가 @Published 기입. property 값이 변경될 때마다 이벤트를 송출하는 publisher 획득 가능. Published 참고.

지극히 주관적으로 이해하기

요구사항에 따른 publisher들을 생성.
- 각 publisher는 요구사항에 맞게 연산함.
- 요구사항에 맞게 publisher들을 나열함. » 요구사항에 따라 publisher가 많을 수도 있고 적을 수도 있다.
- 나열된 순서대로 publisher가 수행될 예정. > 이것을 publihser chain이라고 함.
- upstream publihser : 바로 내 위에서 수행되는 publisher.
- downstrem publihser : 나 다음으로 수행될 publisher.
sink 또는 assign 메소드로 publisher를 구독할 subscriber 생성.
- sink와 assign은 publisher 메소드. subscriber를 리턴한다.
- publisher chain의 끝은 subscriber가 되야한다.

이벤트 처리

이벤트 발생
publisher chain 실행.
- publisher chain에 따라 나열된 순으로 차례대로 publisher 실행.
- publishr는 upstream publisher부터 받은 값으로 계산을 하고 새로운 Ouput과 함께 publisher(downstrem publisher)를 리턴한다.
publisher chain의 끝에서 subscriber에게 최종 결과 값 전달.

Topic

Declaring Publisher Topography

publisher는 꼭 Output과 Failure 타입을 정의해야한다.

associatedtype Output
associatedtype Failure

//NotificationCenter.Publisher 의 예

extension NotificationCenter {

/// A publisher that emits elements when broadcasting notifications.
public struct Publisher : Publisher {

    /// The kind of values published by this publisher.
    public typealias Output = Notification

    /// The kind of errors this publisher might publish.
    ///
    /// Use `Never` if this `Publisher` does not publish errors.
    public typealias Failure = Never
    }
}

Mapping Elements

Receiving and Handling Events with Combine

2020-01-12T00:00:00+09:00

asynchronous 소스로 이벤트를 사용자화하고 수신받는다.

Overview

Combine 프레임워크는 이벤트를 처리하기 위한 선언적인 접근법을 제공한다.
delegate 콜백 또는 종료 블록을 여러개 구현하는 것보다, 주어진 이벤트에 대한 하나의 접근 체인을 생선하는게 더 좋다.
체인의 각 부분은 Combine연산자를 가지고 있다.
이 Combine 연산자는 이전 단계에서 전달받은 요소로 구분된 동작을 수행한다.

TextField에서 입력받은 값으로 리스트를(tableView, collectionView) 필터링 해본다고 생각해보자.
AppKit에서, 키 입력을 받을 때마다 Combine으로 구독한 Notification을 생산한다.
Notification을 받으면, 내용과 이벤트 전달 시간을 수정하는 연산자를 사용할 것이고 앱을 업데이틑 하기 위한 최종 결과물을 사용할 것이다.

Connect a Publisher to a Subscriber

Combine으로 textField의 Notification을 받아보자.

NotificationCenter의 default instance에 접근.
인스턴스의 publisher(for:object:) 메소드 호출.
- 수신받고 싶은 notification 이름과 object 설정.
- notification 요소를 생성하는 publisher 리턴.

let publisher = NotificationCenger.default
                    .publisher(for: NSControl.textDidChangeNotification, object: textField)

publisher로부터 요소들을 받기 위해 Subscriber를 사용한다.
subscriber는 수신받을 타입을 선언하기 위해 associated type, Input을 정의한다. publisher 또한 생성할 associated type Output을 정의한다.
publisher와 subscriber는 생성 혹은 수신을 실패 했을 때 알려주기 위해 Failure도 정의한다.
subscriber가 publisher를 구독하려면 반드시 Output과 Input은 매치해야한다. Failure또한 동일.

Combine은 기본적으로 2개의 subscriber을 제공해준다. 이 들은 자동으로 연결된 publisher의 output과 failure와 매치된다.

sink(receiveCompletion:receiveValue:)
- 2개의 closure 사용.
- receiveCompletion: publisher가 완료되거나 실패했을 때 실행됨.
- receiveValue: publisher로부터 요소를 받을 때 실행됨.
assign(to:on:)
- property의 key path를 사용해 주어진 object에 바로 모든 요소가 할당된다. (수신 받을 때마다 모델의 property에 변경사항이 바로 적용된다는 뜻)

let subscriber = NotificationCenger.default
                    .publisher(for: NSControl.textDidChangeNotification, object: textField)
                    .sink(receiveCompletion:{ pring($0)},
                        receiveValue:{ pring($0) }) //notification.userInfo 수신

Both the sink(receiveCompletion:receiveValue:) and assign(to:on:) subscribers request an unlimited number of elements from their publishers. To control the rate at which you receive elements, create your own subscriber by implementing the Subscriber protocol.

Change the Output Type with Operators

sink subscriger에서는 receiveValue closure에서 모든 작업을 수행한다.
수신받은 요소로 많은 작업을 하거나, 호출간의 상태를 유지보수 하는건 부담스러운 작업이 될 수 있다. combine 연산자로 이벤트 전달을 사용자화하면 부담을 완화시킬 수 있다.

textField의 string 값만 필요하지만 NotificationCenter.Publisher.Output은 많은 데이타를 콜백해준다.
publisher의 output은 순차적인 요소이기 때문에, combine은 순차적인 수정 연산자를 제공한다.( map( _ :), flatMap(maxPublishers: _ :), reduce( _ : _ :))

let sub = NotificationCenter.default
            .publisher(for: NSControl.textDidChangeNotification, object: filterField)
            .map( { ($0.object as! NSTextField).stringValue } )
            .sink(receiveCompletion: { print ($0) },
                receiveValue: { print ($0) })

map( :) 연산자로 publisher output 타입 변경.
textField의 string value값 수신.

struct MyViewModel {
    var filterString: String
}

var myViewModel = MyViewModel(filterString: "filter")

let sub = NotificationCenter.default
            .publisher(for: NSControl.textDidChangeNotification, object: filterField)
            .map( { ($0.object as! NSTextField).stringValue } )
            .assign(to: \MyViewModel.filterString, on: myViewModel)

Customize Publishers with Operators

연산자로 너가 원하는 동작을 수행하기 위해 publisher를 확장할 수 있다. 확장하지 않으면 직접 코드를 작성해야한다.
이벤트 처리 체인을 향상시키는 3개의 연산자가 있다.

filter( _ :)
- 특정 길이의 입력을 무시하거나 영숫자가 아닌 문자를 거부하는 등 사용.
debounce(for:scheduler:options:)
- 위 필터링 작업이 큰 경우 - 큰 database에서 쿼리 하는 경우 - 유저가 입력을 마칠 때까지 가디릴 수 있다.
- publisher가 이벤트를 생성하기 전 기다려야하는 시간을 설정할 수 있다.
- RunLoop class에서 seconds 혹은 milliseconds 시간을 편하게 정의 할 수 있다.
receive(on:options:)
- UI 업데이를위해, 콜백을 메인스레드에서 실행할 수 있게 해준다.
- RunLoop에서 제공하는 Scheduler 인스턴스를 매개변수로 사용해, combine이 main run loop에서 subscriber를 호출하게 한다.

let sub = NotificationCenter.default
            .publisher(for: NSControl.textDidChangeNotification, object: filterField)
            .map( { ($0.object as! NSTextField).stringValue } )
            .filter( { $0.unicodeScalars.allSatisfy({CharacterSet.alphanumerics.contains($0)}) } )
            .debounce(for: .milliseconds(500), scheduler: RunLoop.main)
            .receive(on: RunLoop.main)
            .assign(to:\MyViewModel.filterString, on: myViewModel)

Cancel Publishing when Desired

publisher는 완료되거나 실패할 때까지 계속 요소들을 방출한다.
만역 publisher를 그만 구독하고 싶을 때, 구독취소를 하면된다.
sink(receiveCompletion:receiveValue:), assign(to:on:)메소드로 생성된 subscriber는 Cancellable protocol를 따르고 있고, cancel()메소드를 부를 수 있다.

sub?.cancel()

만약 커스텀 subscriber를 만들었다면, publisher를 처음에 구독할 때 Subscription 객체를 받을 것이다. subscription 객체를 따로 저장하고, cancel()메소드를 호출하면 된다.
Cancellable protocol을 따르는 커스텀 subscriber를 만들었다면, subscriber또한 cancel( ) method가 있을 것이다. 저장한 subscription.cancel()메소드와 한께 subscriber.cancel() 호출해라.

git push

2020-01-11T00:00:00+09:00

$ git add .
$ git commit -m "커밋 내용"
$ git push -u origin branch

Dictionary

2020-01-11T00:00:00+09:00

struct
key-value로 쌍을 이루는 collection

Declaration

@frozen struct Dictionary<Key, Value> where Key : Hashable

Hashable

Overview

Dictionary는 해시 테이블로, entry에 빠르게 접근할 수 있다.
테이블의 각 entry는 key값으로 식별되며, key값은 string 혹은 number와 같이 hashable 타입이어야 한다.
key값으로 key에 해당하는 value를 찾을 수 있다. value는 모든 object(any object)가 될 수 있다.

다른 언어에서는 hashes 혹은 관련 array가 Dictionary와 비슷한 데이타 타입일 수도 있다.

init

let dict = ["key" : "value", 
           "a" : "value a", 
           "b" : "value b"]
            
var emptyDict: [Int: String] = [:]

Getting and Setting Dictionary Values

print(dict["key"])
//Prints "value"

dict["c"] = "value c" //set data
dict["a"] = nil //set data nil where key is a

Topic

Creating a Dictionary

init(grouping: S, by: (S.Element) -> Key)

init<S>(grouping values: S, by keyForValue: (S.Element) throws -> Key) rethrows where Value == [S.Element], S : Sequence

values : 그룹핑할 데이타.
keyForValue : closure. values의 각 element의 key값을 리턴.

let students = ["Kofi", "Abena", "Efua", "Kweku", "Akosua"]
let studentsByLetter = Dictionary(grouping: students, by: { $0.first! })
// ["E": ["Efua"], "K": ["Kofi", "Kweku"], "A": ["Abena", "Akosua"]]

Choosing Between Structures and Classes(작성중)

2020-01-11T00:00:00+09:00

Decide how to store data and model behavior.

Overview

Struct를 기본으로 사용하라.
Objective-c와 사용해야한다면Class 사용 권장.
모델링하 데이타의 identity를 제어해야한다면 Class 사용 권장.
동작이 필요하면 Protocol과 함께 Struct를 사용. (Use structures along with protocols to adopt behavior by sharing implementations.)

Choose Structures by Default

Swift의 Struct에는 다른 언어에서 Class에서만 제공되는 기능을 사용할 수 있다.

property 저장.
property 계산.
method 포함.
동작을 얻기 위해 protocol 채택.

standard library, Foundation에서 구조체를 사용하고 있다.
많이 사용하고 있는 number, string, array, dictionary가 그 예이다.

struct를 사용하면 앱의 전체 상태를 고려할 필요없이 코드의 일부를 쉽게 이해할 수 있다.
Because structures are value types—unlike classes—local changes to a structure aren’t visible to the rest of your app unless you intentionally communicate those changes as part of the flow of your app.As a result, you can look at a section of code and be more confident that changes to instances in that section will be made explicitly, rather than being made invisibly from a tangentially related function call.

Use Classes When You Need Objective-C Interoperability

Hashable

2020-01-11T00:00:00+09:00

protocol
해시로 사용할 수 있는 타입. Hasher로 integer hash 값을 생성한다.

Declaration

protocol Hashable

Overview

Hashable protocol을 준수한다면 Set 혹은 Dictionary key로 모든 타입을 사용할 수 있다.
String, integer, floating-point, boolean은 기본적으로 Hashable protocol을 준수하고 있다.

커스텀 타입도 해시 가능하다.
연관된 값 없이 enum을 정의하면, 자동적으로 Hashable을 준수한다.
그리고 커스텀 타입에다가 직접 hash(into:)를 구현하여 Hashable를 따르게 할 수 있다.

Conforming to the Hashable Protocol

Hashable protocol은 Equatable protocol을 상속받는다.

커스텀 Hashable 타입을 만들려면 아래의 조건들을 만족해야한다.

구조체: 저장 property들은 Hashable을 준수해야한다.
enum : 관련된 값들은 모두 Hashable을 준수해야한다. (An enum without associated values has Hashable conformance even without the declaration.)

만약 위 조건들을 만족하지 못하거나, Hashable을 준수하게 확장하고 싶으면 hash(into:) 메소드를 구현해야한다.

struct GridPoint {
	var x: Int
	var y: Int
}

extension GridPoint: Hashable {
	static func == (lhs: GridPoint, rhs: GridPoint) -> Bool {
		return lhs.x == rhs.x && lhs.y == rhs.y
	}

func hash(into hasher: inout Hasher) {
	hasher.combine(x)
	hasher.combine(y)
}

hash(into:) 구현부에서 필수 구성요소들로 Hasher의 combine(_:)을 호출해야한다.
Hashable, Equatable protocol의 요구사항을 만족하는지 확실하게 하기 위해, Equatable conformance(적합성)을 커스텀화 하면 좋다. (== 함수)

var tappedPoints: Set 	= [GridPoint(x: 2, y: 3), GridPoint(x: 4, y: 1)]
let nextTap 		= GridPoint(x: 0, y: 1)

if tappedPoints.contains(nextTap) {
	print("Already tapped at (\(nextTap.x), \(nextTap.y)).")
} else {
	tappedPoints.insert(nextTap)
	print("New tap detected at (\(nextTap.x), \(nextTap.y)).")
}

// Prints "New tap detected at (0, 1).")

Topic

Providing a Hash Value

func hash(into: inout Hasher)
- 이 값의 필수 구성요소를 제공된 Hasher를 통해 해시함.
- hasher의 finalize()를 절대로 호출해서는 안됨. complie-time error 발생할 수 있음.

Hasher(작성중)

2020-01-11T00:00:00+09:00

ForEach

2020-01-11T00:00:00+09:00

struct
식별(identified) 데이타의 collection에 따라 뷰를 계산.

Declaration

struct ForEach<Data, ID, Content> where Data : RandomAccessCollection, ID : Hashable

Example

let items = ["a", "b", "c", "d", "f"]

VStack{
    ForEach(items, id: \.self) {
        Text($0)
    }
}

객체의 key path는 \로 표시.
\.self : 각 아이템은 자기 값(self value)에 따라 고유하게 식별된다. 첫번째 아이템 식별값은 a, 두번째 아이템 식별값은 b라는 뜻이다.

struct Item {
    var id = UUID()
    var value: String
}

let items = [Item(value: "a"), Item(value: "b"), Item(value: "c")]

VStack{
    ForEach(items, id: \.id) { item in 
        Text(item.value)
    }
}

각 아이템은 item.id 값에 따라 식별된다.
\Item.id 를 생략해서 \.id 로 쓸 수 있다.

View Layout and Presentation

2020-01-11T00:00:00+09:00

뷰들을 스택으로 합치고, 그룹 및 리스트 뷰를 동적으로 생성하며 노출과 계층 구조를 정의한다.

Overview

스택과 리스트를 사용해 뷰들을 나열한다.
데이타에 따라 동적으로 생석되는 뷰와 스태틱 뷰를 합칠 수 있다.
모든 컨테이너뷰들은 내용 혹은 인터페이스 크기가 변경이 되면 자식뷰의 위치를 조정한다.

Topic

Lists and Scroll Views

ForEach

Touches, Presses, and Gestures

2020-01-11T00:00:00+09:00

Topic

First Steps

Using Responders and the Responder Chain to Handle Events
class UIResponder

야옹 야옹

Publisher

Declaration

Overview

Creating Your Own Publishers

지극히 주관적으로 이해하기

구독하기

이벤트 처리

Topic

Declaring Publisher Topography

Mapping Elements

Receiving and Handling Events with Combine

Overview

Connect a Publisher to a Subscriber

Change the Output Type with Operators

Customize Publishers with Operators

Cancel Publishing when Desired

git push

Dictionary

Declaration

Overview

init

Getting and Setting Dictionary Values

Topic

Creating a Dictionary

Choosing Between Structures and Classes(작성중)

Overview

Choose Structures by Default

Use Classes When You Need Objective-C Interoperability

Hashable

Declaration

Overview

Conforming to the Hashable Protocol

Topic

Providing a Hash Value

Hasher(작성중)

ForEach

Declaration

Example

View Layout and Presentation

Overview

Topic

Lists and Scroll Views

Touches, Presses, and Gestures

Topic

First Steps