수니의 개발새발

[iOS/Swift] Coordinator 패턴의 이해

개발자 수니 — Thu, 16 May 2024 17:46:37 +0900

Coordinator 패턴의 이해

*Soroush Khanlou*가 NSSpain conference 2015에서는 Coordinator의 설명

So what is a coordinator? A coordinator is an object that bosses one or more view controllers around.
코디네이터란? 하나 이상의 View Controller에게 지시하는 object이다.

여기서 말하는 지시는 화면 전환에 대한 지시.

Coordinator는 ViewController 간의 흐름을 제어한다.

즉, ViewController의 Navigation의 책임을 별도의 객체(Coordinator Classs)로 분리한다.

Coordinator 기능

- 화면 전환에 필요한 인스턴스 생성(ViewController, ViewModel 등..)

- 생성된 ViewControll의 화면 전환 (push/present..)

Coordinator의 이점 : 유지보수성, 재사용성, 독립성

let vc = DetailViewController()	// 상세 페이지 뷰 컨트롤러
vc.id = detailId	// 상세 페이지 Id 전달
navigationController?.pushViewController(vc, animated: true)

기존 프로젝트

- ViewController의 전환이 필요할 경우, 위와 같은 코드를 반복적으로 사용한다. (이러한 화면 이동 코드들은 대부분 ViewController 내부에서 작성된다.)

- 화면 이동 기능에 대한 책임을 ViewController 가 가지게 되고 이동하는 ViewController 간 의존성이 생긴다. 이는 ViewController의 재사용성이 떨어진다.

- 만약 유지보수를 하면서 ViewController 간의 데이터 전달이 추가되면 해당 코드를 모두 찾아 변경하는 작업이 필요하다.
(ex. "상세 페이지 이동 코드에 userId 도 전달해주세요~" -> 상세 페이지 이동 코드가 프로젝트에 10개가 넘는데... )

Coordinator 패턴 프로젝트

- 화면 전환과 관련된 사항을 수정할 때 ViewController에서 일일이 찾지 않고 바로 Coordinator 객체를 보러 가면 된다.

- Navigation 책임을 독립시킨다.

- ViewController의 재사용성이 높아지고, 유지보수성이 높아진다.

‍♀️ 참고

간단한 예제로 살펴보는 iOS Design/Architecture Pattern: Coordinator - Basic

[iOS] Coordinator Pattern

[iOS/Swift] Clean Architecture 의 이해

개발자 수니 — Thu, 16 May 2024 17:02:08 +0900

Clean Architecture 의 이해

의존성 규칙

The Clean Architecture의 다이어그램

원 : 소프트웨어의 각기 다른 영역
외부에서 안쪽을 향해서만 의존한다. 내부에서 외부로는 종속성이 없다. ( -> 화살표가 의존성 규칙 )

Entities

Enterpise Business Rules : 대규모 프로젝트 레벨의 비즈니스 규칙 캡슐화, Application의 비즈니스 객체
메서드를 갖는 객체, 데이터 구조, 함수의 집합
Application의 동작에 관한 변경(페이지 내비게이션의 변경이나 보안 사항)에 영향을 받지 않아야 한다.
다른 계층의 어느 것도 포함하면 안된다.(의존성 규칙)

// iOS Clean Architecture MVVM Example 의 Entities
// GitHub: https://github.com/kudoleh/iOS-Clean-Architecture-MVVM
import Foundation

struct Movie: Equatable, Identifiable {
    typealias Identifier = String
    enum Genre {
        case adventure
        case scienceFiction
    }
    let id: Identifier
    let title: String?
    let genre: Genre?
    let posterPath: String?
    let overview: String?
    let releaseDate: Date?
}

Use Cases

Application Business Rules : Application 고유 비즈니스 규칙을 포함, 시스템의 모든 Use Cases를 캡슐화하고 구현
Entities 흐름을 조합
Use Cases의 변경이 Entities에 영향을 주지 않을 것을 기대하며 DataBase, UI 또는 공통 Framework의 변경으로부터 영향받지 않을 것을 기대한다. (의존성 규칙)
하지만, Application의 조직에 대한 변경은 Use Cases 영향이 있다. Use Cases의 상세가 바뀐다면 이 계층의 코드는 확실히 영향을 받는다.
Entities를 제외한 다른 계층의 어느 것도 포함하면 안된다. (의존성 규칙)

// iOS Clean Architecture MVVM Example 의 Use Cases
// GitHub: https://github.com/kudoleh/iOS-Clean-Architecture-MVVM
import Foundation

protocol SearchMoviesUseCase {
    func execute(requestValue: SearchMoviesUseCaseRequestValue,
                 cached: @escaping (MoviesPage) -> Void,
                 completion: @escaping (Result<MoviesPage, Error>) -> Void) -> Cancellable?
}

final class DefaultSearchMoviesUseCase: SearchMoviesUseCase {

    private let moviesRepository: MoviesRepository
    private let moviesQueriesRepository: MoviesQueriesRepository

    init(moviesRepository: MoviesRepository,
         moviesQueriesRepository: MoviesQueriesRepository) {

        self.moviesRepository = moviesRepository
        self.moviesQueriesRepository = moviesQueriesRepository
    }

    func execute(requestValue: SearchMoviesUseCaseRequestValue,
                 cached: @escaping (MoviesPage) -> Void,
                 completion: @escaping (Result<MoviesPage, Error>) -> Void) -> Cancellable? {

        return moviesRepository.fetchMoviesList(query: requestValue.query,
                                                page: requestValue.page,
                                                cached: cached,
                                                completion: { result in

            if case .success = result {
                self.moviesQueriesRepository.saveRecentQuery(query: requestValue.query) { _ in }
            }

            completion(result)
        })
    }
}

Controllers, GateWays, Presenters

Interface Adapters
Data : Entities나 Use Cases에 용이한 형식 > 사용하고 있는 Frame Work(Datatbase, Web 등)에 용이한 형식으로 변환
이 계층 내부(원 안)계층의 코드는 Database에 관해 아는 것이 없어야 한다.

Devices, Web, UI, DB, External Interfaces

Frameworks & Driver
Frame Work 도구로 구성 : Database, Web 등
내부(원 안)계층과 통신할 연결 코드 이외에는 별다른 코드를 작성하지 않는다.

Clean Architecture의 주의할 점

원의 경계를 넘나드는 Data는 단순한 구조로 이루어지게 한다.
Entities와 Database Row을 그대로 전달하는 것은 의존성 규칙 위반이다. 안쪽의 원이 강제로 바깥쪽 원에 관한 것을 알아버리기 때문이다.
경계를 넘나드는 Data는 항상 안쪽의 원이 다루기 쉬운 형식이어야 한다.

Clean Architecture의 핵심

원의 가지수와 종류가 중요한 것이 아니다.
의존 규칙이 가장 중요! : 소스 코드의 의존성은 항상 안쪽으로 향해야 한다.
안쪽으로 향해감 : 추상회 수준은 올라간다. 캡슐화한다.
가장 바깥쪽의 원 : 저수준의 구체적인 상세 정보를 담는다.

By separating the software into layers, and conforming to The Dependency Rule, you will create a system that is intrinsically testable, with all the benefits that implies.
소프트웨어를 계층으로 나누고 의존성 규칙을 따름으로써 본질적으로 테스트하기 쉬운 시스템을 만들 수 있고 의존성 규칙이 가져오는 이점을 얻을 수 있다.

‍♀️ 참고

Github : iOS-Clean-Architecture-MVVM

The Clean Architecture

[iOS/Swift] MVC 디자인 패턴의 이해

개발자 수니 — Thu, 16 May 2024 16:55:31 +0900

MVC 패턴의 이해

Model

- 앱의 Data + Status + Logic 을 담당

View

- 사용자에게 보여지는 User Interface를 구성

Controller

- Model과 View 사이의 중재자 역할

- 사용자가 View를 통해 Interaction하면 Controller가 이를 Control

Apple의 MVC

- View와 Controller를 ViewController 하나로 취급한다.

Apple's MVC

Swift 관점의 MVC 흐름

Controller to View/Model

- View에 대해서 outlet을 이용해 View에게 직접 접근할 수 있다.
- Model에 직접 접근할 수 있다.

View to Controller

- target-Action 구조로 사용자의 행위에 따라 필요한 함수를 호출 할 수 있다.

- 또한, delegate, datasource 로 미리 정해진 방식의 요청을 수행할 수 있다.

Model to Controller

- Notification & KVO 방식을 통해 Model의 변화를 Controller에 알릴 수 있다.

MVC 특징

장점

- 간단하고 직관적인 구조를 갖고 있어, 작은 프로젝트에서는 쉽고 빠르게 개발할 수 있다.

- Apple에서 기본적으로 지원하고 있는 패턴이기 때문에 쉽게 개발할 수 있다.

단점

- View와 Controller의 강한 결합도 : Controller가 View의 Life Cycle까지 관리하기 때문에 View와 Controller 분리가 어렵다. 이로 인해 재사용성이 떨어지고 유닛 테스트를 진행하기 어렵다.

- 거대한 View Controller (Massive View Controller) : Life Cycle 관리, delegate, datasource 관리, 네트워크 요청 등 많은 코드가 Controller에 작성되어 Controller의 크기가 비대해지고 내부 구조는 복잡하게 된다. 이는 프로젝트 규모가 커질수록 유지보수가 어렵다.

‍♀️ 참고

[iOS/Swift] MVC (Model-View-Controller)

[iOS/Swift/Basic] 범위 연산자

개발자 수니 — Tue, 13 Feb 2024 14:07:06 +0900

Swift의 범위 연산자

부호	설명
A...B	A이상 B 이하의 수
A..<B	A이상 B 미만의 수
A...	A 이상의 수
...A	A 이하의 수
..<A	A 미만의 수

[iOS/Swift/Basic] 참조 비교 연산자 : === !==

개발자 수니 — Mon, 29 Jan 2024 18:59:57 +0900

참조 비교 연산자

Swift의 유일한 참조(Reference) 타입인 클래스의 인스턴스에서만 참조 비교 연산자를 사용할 수 있다.
나머지 기본 데이터 타입(값 Value)의 비교 연산에는 ==를 사용

A === B

A와 B가 같은 인스턴스를 가리킨다.

A !== B

A와 B가 같지 않은 인스턴스를 가리킨다.

let referenceA: referenceClass = referenceClass()
let referenceB: referenceClass = referenceClass()
let referenceC: referenceClass = referenceA

// 같은 인스턴스를 가리킨다.
print(referenceA === referenceB)    // false
print(referenceA === referenceC)    // true

// 같지 않은 인스턴스를 가리킨다
print(referenceA !== referenceB)    // true
print(referenceA !== referenceC)    // false

[iOS/Swift/Basic] 나머지 연산자 : % truncatingRemainder

개발자 수니 — Mon, 29 Jan 2024 18:37:16 +0900

나머지 연산자

%

정수 타입 나머지 연산자

let intNum: Int = 10

print(intNum % 3)   // 1

truncatingReminder(dividingBy:)

부동소수점 타입 나머지 연산자

let doubleNum: Double = 5.0

print(doubleNum.truncatingRemainder(dividingBy: 1.5))   // 0.5
print(doubleNum.truncatingRemainder(dividingBy: 2))     // 1.0
print(12.truncatingRemainder(dividingBy: 2.5))          // 2.0

[iOS/Swift/Basic] 열거형 Enumerations : 비교 가능한 열거형 - Comparable

개발자 수니 — Fri, 26 Jan 2024 21:17:26 +0900

[iOS/Swift/Basic] 열거형 Enumerations : 원시값 Raw Values, 연관값 Associated Values

[iOS/Swift/Basic] 열거형 Enumerations : 항목 순회 - CaseIterable

[iOS/Swift/Basic] 열거형 Enumerations : 순환 열거형 - indirect

Comparable

Swift 프로그래밍 언어에서 제공하는 프로토콜
이 프로토콜을 채택하면 연관 값(Associated Values)만 갖거나 연관 값(Associated Values)이 없는 열거형(Enumerations)은 각 케이스를 비교할 수 있다.
앞에 위치한 케이스가 더 작은 값

연관 값(Associated Values)이 없는 예제

enum AppleDevice: Comparable {
    case iPhone
    case iPad
    case macBook
    case iMac
}

let myDevice: AppleDevice = .iMac
let yourDevice: AppleDevice = .iPhone

if myDevice > yourDevice {
    print("제 디바이스가 더 크네요!")
} else if myDevice < yourDevice {
    print("당신의 디바이스가 더 크네요!")
} else {
    print("우리 디바이스가 같네요!")
}
// 제 디바이스가 더 크네요!

연관 값(Associated Values)만 갖는 예제

enum AppleDevice: Comparable {
    case iPhone(version: String)
    case iPad(version: String)
    case macBook
    case iMac
}

var devices: [AppleDevice] = []
devices.append(.iMac)
devices.append(.iPhone(version: "6.1"))
devices.append(.iPhone(version: "14.3"))
devices.append(.iPad(version: "10.3"))
devices.append(.macBook)

let sortedDevices: [AppleDevice] = devices.sorted()
print(sortedDevices)
// [AppleDevice.iPhone(version: "14.3"), AppleDevice.iPhone(version: "6.1"), AppleDevice.iPad(version: "10.3"), AppleDevice.macBook, AppleDevice.iMac]

‍♀️ 참고

야곰, ⌜스위프트 프로그래밍: Swift5⌟, 한빛미디어(2019)

[iOS/Swift/Basic] 열거형 Enumerations : 순환 열거형 - indirect

개발자 수니 — Fri, 26 Jan 2024 20:35:20 +0900

[iOS/Swift/Basic] 열거형 Enumerations : 원시값 Raw Values, 연관값 Associated Values

[iOS/Swift/Basic] 열거형 Enumerations : 항목 순회 - CaseIterable

순환 열거형 Recursive Enumerations

열거형(Enumerations)의 연관 값(Associated Values)이 열거형 자신의 값이고자 할 때 사용
이진 탐색 트리 등의 순한 알고리즘을 구현할 때 유용하게 사용 가능

indirect

순환 열거형(Recursive Enumerations)을 명시할 때 사용하는 키워드

indirect case

특정 항목(case)에만 한정

enum ArithmeticExpression {
    case number(Int)
    indirect case addition(ArithmeticExpression, ArithmeticExpression)
    indirect case multiplication(ArithmeticExpression, ArithmeticExpression)
}

indirect enum

열거형(Enumerations) 전체에 적용

indirect enum ArithmeticExpression {
    case number(Int)
    case addition(ArithmeticExpression, ArithmeticExpression)
    case multiplication(ArithmeticExpression, ArithmeticExpression)
}

순환 열거형(Recursive Enumerations)를 활용한 계산기 예제

// ArithmeticExpression 계산을 도와주는 Recursive Function
func evaluate(_ expression: ArithmeticExpression) -> Int {
    switch expression {
    case let .number(value):
        return value
    case let .addition(left, right):
        return evaluate(left) + evaluate(right)
    case let .multiplication(left, right):
        return evaluate(left) * evaluate(right)
    }
}

func recurciveEnumerationsExample() {
    let six = ArithmeticExpression.number(6)
    let three = ArithmeticExpression.number(3)
    let sum = ArithmeticExpression.addition(six, three)
    let final = ArithmeticExpression.multiplication(sum, ArithmeticExpression.number(2))

    let result: Int = evaluate(final)
    print("(6 + 3) * 2 = \(result)")    // (6 + 3) * 2 = 18
}

‍♀️ 참고

야곰, ⌜스위프트 프로그래밍: Swift5⌟, 한빛미디어(2019)

[iOS/Swift/Basic] 열거형 Enumerations : 항목 순회 - CaseIterable

개발자 수니 — Wed, 24 Jan 2024 20:42:20 +0900

[iOS/Swift/Basic] 열거형 Enumerations : 원시값 Raw Values, 연관값 Associated Values

CaseIterable

Swift 프로그래밍 언어에서 제공하는 프로토콜
이 프로토콜을 채택한 열거형(Enumeration)은 모든 항목(case)을 순회할 수 있다.

allCases

CaseIterable을 채택한 열거형의 모든 항목(case)를 얻을 수 있다.

CaseIterable 활용한 열거형(Enumeration)의 항목 순회

기본형

// CaseIterable Protocol을 채택한 Enumeration
enum Color: CaseIterable {
    case red, green, blue, yellow
}

// CaseIterable 프로토콜을 채택했기 때문에 allCases 속성을 통해 모든 케이스를 얻을 수 있다.
let allColors = Color.allCases
for color in allColors {
    print(color)	// red green blue yellow
}

단순한 열거형(Enumeration)에는 CaseIterable을 채택해 주는 것만으로 allCases 프로퍼티를 사용할 수 있지만,

조금 복잡해지는 열거형(Enumeration)의 경우 allCases 프로퍼티를 직접 구현해 주어야 한다.

플랫폼별 사용 조건을 추가하는 경우 : available 속성을 갖는 열거형(Enumeration)

// 플랫폼별 사용 조건을 추가하는 경우 : available 속성을 갖는 열거형(Enumeration)
enum Color: CaseIterable {
    case red, green, blue, yellow
    @available(iOS 13.0, *)
    case white

    // allCases 프로퍼티를 직접 구현
    static var allCases: [Color] {
        let all: [Color] = [.red, .green, .blue, .yellow]
        #if os(iOS)
        return all + [.white]
        #else
        return all
        #endif
    }
}

let allColors = Color.allCases
for color in allColors {
    print(color)	// 실행환경에 따라 다른 결과
}

연관 값(Associated Values)을 갖는 열거형(Enumeration)의 경우

enum Burger: CaseIterable {
    case bulgogi
    case shrimp
    case cheese
}

enum Drink: CaseIterable {
    case coke
    case fanta
}

// Associated Values을 가지는 Enumerations
enum Menu: CaseIterable {
    case set(burger: Burger, drink: Drink)
    case single(burger: Burger)

    static var allCases: [Menu] {
        return Burger.allCases.reduce([]) { (result, burger) -> [Menu] in
            result + Drink.allCases.map { (drink) -> Menu in
                Menu.set(burger: burger, drink: drink)
            }
        }
        + Burger.allCases.map(Menu.single)
    }
}

print(Menu.allCases.count)  // 9 : 모든 경우의 수
print(Menu.allCases)        // 모든 경우의 항목(case) 컬렉션

처음 열거형(Enumeration)을 정의하고 allCases를 구현한 이후에 항목(case)를 추가할 일이 생긴다면 꼭 잊지 말고 allCases를 다시 살펴봐야겠다.

‍♀️ 참고

야곰, ⌜스위프트 프로그래밍: Swift5⌟, 한빛미디어(2019)

[iOS/Swift/Basic] 열거형 Enumerations : 원시값 Raw Values, 연관값 Associated Values

개발자 수니 — Wed, 24 Jan 2024 19:30:58 +0900

열거형 Enumerations

연관된 항목들을 묶어서 표현할 수 있는 타입
프로그래머가 정의해준 항목 값 외에는 추가/수정이 불가

열거형(Enumerations)을 사용하는 경우

제한된 선택지를 주고 싶을 때
정해진 값 외에는 입력받고 싶지 않을 때
예상된 입력 값이 한정되어 있을 때

열거형(Enumerations)의 선언

// Pay Enumerations 선언
enum Pay {
    case cash   // 현금
    case card   // 카드
    case etc    // 기타
    case empty  // 결제 종류 없음
}

// Pay Enumerations 선언 - 한 줄 버전
enum Pay {
    case cash, card, etc, empty
}

열거형(Enumerations) 변수의 생성 및 변경

var userPay: Pay = Pay.empty
// 같은 타입인 Pay 내부의 항목으로만 변경 가능
userPay = .card

원시 값 Raw Values

열거형(Enumerations)은 항목의 원시 값(Raw Values)을 가질 수 있다.

원시 값(Raw Values) 지정과 사용

// Raw Values 지정
enum Pay: String {
    case cash   = "현금"
    case card   = "카드"
    case etc    = "기타"
    case empty  = "결제 종류 없음"
}

// Raw Values 사용
var userPay: Pay = .card
print("회원님의 결제 타입은 '\(userPay.rawValue)' 입니다.") // 회원님의 결제 타입은 '카드' 입니다.

원시 값(Raw Values) 자동 처리

열거형(Enumerations) 선언 시, 원시 값(Raw Values)을 지정하지 않을 경우 Swift는 원시 값(Raw Values)을 자동으로 처리

String타입 enum

// String enum
enum Pay: String {
    case cash   = "현금"
    case card   = "카드"
    case kakaopay
}
let myPay = Pay.kakaopay
print("나의 결제 타입은 '\(myPay.rawValue)' 입니다.") // 나의 결제 타입은 'kakaopay' 입니다.

Int타입 enum

// Int enum
enum Numbers: Int {
    case zero, one, two
    case ten = 10
}

print("\(Numbers.zero.rawValue) - \(Numbers.one.rawValue) - \(Numbers.two.rawValue) - \(Numbers.ten.rawValue)")
// 0 - 1 - 2 - 10

원시 값(Raw Values)을 사용한 열거형(Enumerations)초기화

enum Pay: String {
    case cash   = "현금"
    case card   = "카드"
    case kakaopay
}

// Raw Values를 사용한 Enumerations 초기화
var card = Pay(rawValue: "카드")  // card
var kakaoPay = Pay(rawValue: "카카오 페이") // nil

연관 값 Associated Values

열거형(Enumerations)의 각 항목(case)은 연관 값(Associated Values)을 가질 수 있다.

// Associated Values을 가지는 Enumerations
enum Menu {
    case set(burger: String, drink: String)
    case single(burger: String)
}

// 사용
var order: Menu = Menu.single(burger: "불고기") // 불고기 버거 단품
order = .set(burger: "치즈", drink: "콜라")   // 치즈 버거 + 콜라 세트

여러 열거형(Enumerations) 응용

enum Burger {
    case bulgogi
    case shrimp
    case cheese
}

enum Drink {
    case coke
    case fanta
}

// Associated Values을 가지는 Enumerations
enum Menu {
    case set(burger: Burger, drink: Drink)
    case single(burger: Burger)
}

// 사용
var order: Menu = Menu.single(burger: .bulgogi) // 불고기 버거 단품
order = .set(burger: .cheese, drink: .coke)   // 치즈 버거 + 콜라 세트

‍♀️ 참고

야곰, ⌜스위프트 프로그래밍: Swift5⌟, 한빛미디어(2019)

수니의 개발새발

[iOS/Swift] Coordinator 패턴의 이해

Coordinator 패턴의 이해

Coordinator 기능

Coordinator의 이점 : 유지보수성, 재사용성, 독립성

[iOS/Swift] Clean Architecture 의 이해

Clean Architecture 의 이해

의존성 규칙

Entities

Use Cases

Controllers, GateWays, Presenters

Devices, Web, UI, DB, External Interfaces

Clean Architecture의 주의할 점

Clean Architecture의 핵심

[iOS/Swift] MVC 디자인 패턴의 이해

MVC 패턴의 이해

Swift 관점의 MVC 흐름

MVC 특징

[iOS/Swift/Basic] 범위 연산자

Swift의 범위 연산자

[iOS/Swift/Basic] 참조 비교 연산자 : === !==

참조 비교 연산자

A === B

A !== B

[iOS/Swift/Basic] 나머지 연산자 : % truncatingRemainder

나머지 연산자

%

truncatingReminder(dividingBy:)

[iOS/Swift/Basic] 열거형 Enumerations : 비교 가능한 열거형 - Comparable

이전글

Comparable

[iOS/Swift/Basic] 열거형 Enumerations : 순환 열거형 - indirect

이전글

순환 열거형 Recursive Enumerations

indirect

[iOS/Swift/Basic] 열거형 Enumerations : 항목 순회 - CaseIterable

이전글

CaseIterable

allCases

CaseIterable 활용한 열거형(Enumeration)의 항목 순회

[iOS/Swift/Basic] 열거형 Enumerations : 원시값 Raw Values, 연관값 Associated Values

열거형 Enumerations

열거형(Enumerations)을 사용하는 경우

열거형(Enumerations)의 선언

열거형(Enumerations) 변수의 생성 및 변경

원시 값 Raw Values

원시 값(Raw Values) 지정과 사용

원시 값(Raw Values) 자동 처리

원시 값(Raw Values)을 사용한 열거형(Enumerations)초기화

연관 값 Associated Values