ReactorKit 1

ReactorKit?

• ReactorKit is a framework for a reactive and unidirectional Swift application architecture. 

 

ReactorKit 장점

• 뷰와 리액터로 UI와 비즈니스 로직을 분리
• 모듈간 결합도가 낮아지고 테스트하기 쉽다.
• 상태관리 용이 : API를 통해 앱에서 연속적인 페이지 로드할 때 이전 페이지를 기록해놓아야 하듯이, 이전 페이지를 기록하는 상태 컴포넌트가 따로 관리되게끔 설계된 구조

 

 

 

Unidirectional Data Flow

1. View는 Action(사용자 입력 등)을 Reactor에게 전달한다

2. Reactor는 전달받은 Action에 따라 비즈니스 로직을 수행한다.

2-1. mutate()

• Action 스트림을 Mutation 스트림으로 변환하는 역할
• action이 state를 바로 변경하지는 않음 (ex : 사용자를 팔로우하는 api 요청 이후 state 변경) -> action과 state 사이에 mutation을 둬서 비동기 처리
• 이곳에서 네트워킹이나 비동기 로직 등의 사이드 이펙트를 처리한다.
• 그 결과로 Mutation을 방출하는데, 그 값이 reduce() 함수로 전달된다.

2-2. reduce()

• 이전 상태와 Mutation을 받아서 다음 상태를 반환한다.

3. 그 후 Reactor는 상태를 변경하여 View에게 전달한다 

 

View

• 뷰는 상태를 표현, 뷰 컨트롤러나 셀도 모두 뷰에 해당.
• View 프로토콜을 준수하면 DisposeBag 속성과 bind(reactor:) 메서드를 필수로 정의함으로써 뷰를 정의
• bind()메서드를 통해 뷰와 리엑터 사이의 액션 스트림과 상태 스트림을 바인딩

 

Reactor

• 리액터는 뷰의 상태를 관리.
• 뷰에서 전달받은 action에 따라 비즈니스 로직을 수행한 뒤 상태를 변경하여 다시 뷰에 전달.
• Reactor 프로토콜을 준수하면,  Action, Mutation, State, initialState 프로퍼티 정의
• Action : represent user actions
• Mutation : represent state changes
• State : represents the current view state
• mutate() : mutate() receives an Action and generates an Observable<Mutation>
• reduce() :  reduce() generates a new State from a previous State and a Mutation.

 

View Testing

func testAction_refresh() {
  // 1. Stub 리액터를 준비합니다.
  let reactor = MyReactor()
  reactor.stub.isEnabled = true

  // 2. Stub된 리액터를 주입한 뷰를 준비합니다.
  let view = MyView()
  view.reactor = reactor

  // 3. 사용자 인터랙션을 발생시킵니다.
  view.refreshControl.sendActions(for: .valueChanged)

  // 4. Reactor에 액션이 잘 전달되었는지를 검증합니다.
  XCTAssertEqual(reactor.stub.actions.last, .refresh)
}

func testState_isLoading() {
  // 1. Stub 리액터를 준비합니다.
  let reactor = MyReactor()
  reactor.stub.isEnabled = true

  // 2. Stub된 리액터를 주입한 뷰를 준비합니다.
  let view = MyView()
  view.reactor = reactor

  // 3. 리액터의 상태를 임의로 설정합니다.
  reactor.stub.state.value = MyReactor.State(isLoading: true)

  // 4. 그 때 뷰 컴포넌트의 속성이 잘 변하는지를 검증합니다.
  XCTAssertEqual(view.activityIndicator.isAnimating, true)
}

• 사용자 인터랙션이 발생했을 때 Action이 리액터로 잘 전달되는지
• 리액터의 상태가 바뀌었을 때 뷰의 컴포넌트 속성이 잘 변경되는지
• 리액터의 stub 기능을 이용하면 리액터가 받은 Action을 모두 기록하고, mutate()와 reduce()를 실행하는 대신 외부에서 상태를 설정

 

Reactor Testing

func testBookmark() {
  // 1. 리액터를 준비합니다.
  let reactor = MyReactor()

  // 2. 리액터에 액션을 전달합니다.
  reactor.action.onNext(.toggleBookmarked)

  // 3. 리액터의 상태가 변경되는지를 검증합니다.
  XCTAssertEqual(reactor.currentState.isBookmarked, true)
}

func testUnbookmark() {
  // 1. 리액터를 준비합니다. 액션을 미리 한 번 전달해서 테스트 환경을 만들어둡니다.
  let reactor = MyReactor()
  reactor.action.onNext(.toggleBookmarked)

  // 2. 리액터에 액션을 한 번 더 전달합니다.
  reactor.action.onNext(.toggleBookmarked)

  // 3. 리액터의 상태가 변경되는지를 검증합니다.
  XCTAssertEqual(reactor.currentState.isBookmarked, false)
}

• Action을 받았을 때 원하는 State로 잘 변경되는지

 

 

 

 

 

참고자료

https://velog.io/@sso0022/iOS-ReactorKit-%EC%95%8C%EC%95%84%EB%B3%B4%EA%B8%B0

https://www.slideshare.net/devxoul/reactorkit/1

https://eunjin3786.tistory.com/100

https://github.com/ReactorKit/ReactorKit

https://ios-development.tistory.com/783

https://medium.com/styleshare/reactorkit-%EC%8B%9C%EC%9E%91%ED%95%98%EA%B8%B0-c7b52fbb131a

https://you9010.tistory.com/289