viper architecture

Екатерина КоровкинаИнженер-разработчик iOS

наш взгляд на вопросАрхитектура VIPER

VIPER. Наш взгляд на вопрос

Поддержка проекта без архитектуры


• TDD• Code review• ???

Процесс разработки


MVCController

Model View


MVVM

ViewController ViewModel Model


Presenter Data Store(Entity)View Interactor

VIPERRouter


Что же такое «модуль»?


class, NSObject

UIViewController

class,NSObject

class,NSObject

NSManagedObjectNSObject,struct

View Presenter Interactor Data Store(Entity)

Router

VIPER


Конфигурация модуля


Запуск конфигурации модуля

class MoviesListModuleInitializer: NSObject {

override func awakeFromNib() {

let configurator = factory.moduleConfigurator() configurator.configureModule(self.viewController) }}


Конфигурацияclass MoviesListModuleConfigurator { func configureModule(viewController: ViewController) {

let presenter = Presenter() let service = ServiceDefault()

… viewController.presenter = presenter presenter.builder = builder

… }}


let controller = UIViewController(data: data)let controller = UIViewController()controller.data = data

Проблема: Не хотим отказываться от Segue

Передача данных между модулями


Есть же метод

prepareForSegue


class BaseViewController: UIViewController, ModuleDataTransferProtocol {

func performSegueWithIdentifier(identifier: String, configurationBlock: (destination: ConfigurableController) -> Void) {

… } func prepareForSegue(segue: UIStoryboardSegue,

sender: AnyObject?) {

var destination = segue.destinationViewController block(destination: destination) }}

Базовый контроллер


Открытие модуля func openMovieWithId(movieId: String) {

controller.performSegueWith(block: { destinationController in

destinationController.configureModule(movieId) })

}


Схема передачи данныхrouter.openMoviewWithId(id)

vC.performSegueWithBlock(…)

prepareForSegue(…)

configurationBlock(destination)


Дополнительные соглашения

• NSManagedObject не дальше интерактора• Service Oriented Architecture (SOA) за интерактором• Общие части в pod’ы


Пример экранаVIPER + Swift


Пример модуля


Viewprotocol MoviesListViewInput: class {

func showData(dataStructure: DataStructure)

func showError(error: NSError)

func showEmptyView()}


Presenter// Данные от вьюшкиprotocol MoviesListViewOutput {

func viewIsReadyToAppear()

func didSelectMovieWithIndex(index: Int)}

// Данные от интерактораprotocol MoviesListInteractorOutput: class {

func didObtainMoviesList(movies: [Movie]?)

func didFailToObtainMoviesListWithError(error: NSError)}


Interactor

//Получение данных для модуляprotocol MoviesListInteractorInput {

func obtainMoviesList()

}


Router// Открытие другого экранаprotocol MoviesListRouterInput {

func openMovieWithId(movieId: String)}


Конкретнее

View

Presenter

Interactor

Service

viewIsReadyToAppear()

obtainData()

fetchData()


Все идет хорошоService

Interactor

Presenter

completionBlock()Array <Objects>

didObtainData()Array <Objects>


Отображаем данные

Presenter

View

showData()


Все идет плохо

Service

Interactor

Presenter

View

completionBlock()Error

didFailWithError()

showError()


Пример экранаVIPER + Swift


Viewprotocol WriteUsViewInput: class {

func showEmailError()

func clearInputViews()

func showSpinner()

func hideSpinner() }


Presenterprotocol WriteUsOutput: class {

func userRequestToWriteUs(withName name: String, email: String, message: String)

func userWantsToGoBack(areFieldsEmpty: Bool)}

protocol WriteUsInteractorOutput: class { func didSendFeedbackMessage() func didFailToSendFeedbackMessage(error: NSError)}


Interactorprotocol WriteUsInteractorInput {

func isValidEmail(email: String) -> Bool

func sendMessage(fromAuthor username: String, email: String, message: String)

}


Routerprotocol WriteUsRouterInput: class {

func goBackFromViewController(viewController: UIViewController)

func showAlertExitSubmitAlert(actionHandler: AlertActionsHandler)

func showAlertFeedbackSendDidSucceed()

func showAlertFeedbackSendDidFail()}


Конкретнее

View

Presenter

Interactor

userRequestToWriteUs()

isValidEmail()


Все идет хорошоPresenter

Interactor

Service

sendMessage()

sendMessage()


Отображаем данные

Presenter

Router

showFeedbackSucceed()


Ввод не валиден Presenter

View

showEmailError()


Что получается

Presenter ServiceView Interactor

Router Local storage

Networkclient


Достоинства• Быстрый вход в новый проект• Приемлемый код даже у новичков• Легкое переиспользование созданных компонент• Легкая модификация/поддержка кода


Недостатки• Большое количество времени• Большое количество кода• Большое количество интеграционных тестов• Холивары на тему «Где должен быть такой-то код?»


А нужен ли VIPER?/// Контролер для отображения информации о

приложенииclass AboutViewController: UIViewController {

//Текст текущей версии приложения @IBOutlet weak var versionLabel: UILabel! override func viewDidLoad() { super.viewDidLoad() let versionNumber = NSBundle.mainBundle().objectForInfoDictionaryKey("CFBundleShortVersionString") let buildNumber = NSBundle.mainBundle().objectForInfoDictionaryKey("CFBundleVersion") versionLabel.text = "Версия \(versionNumber!) (\(buildNumber!))" }

/** Метод для открытия нашей странички в iTunes */ @IBAction func openAppstore(sender: AnyObject) { UIApplication.sharedApplication().openURL(NSURL(string: "https://itunes.apple.com/ru/app/lenta.ru-vse-novosti-dna-politika/id975805914?mt=8")!) }}


Выводы

• Длинные по времени проекты

• Необходимость подключения новых людей в середине проекта

Стоит использовать Не стоит использовать

• Рекламное приложение/визитка/прототипирование

• Стартап, когда нужно выпустить MVP как можно быстрее


Open Source• Рамблер.Конференции — приложение• Generamba — генератор• VIPER McFlurry — библиотека• The Book of VIPER — сборник статей

https://github.com/rambler-ios

https://github.com/rambler-ios


THANKS!

viper architecture

Mobile