Показаны сообщения с ярлыком iOS. Показать все сообщения
Показаны сообщения с ярлыком iOS. Показать все сообщения

четверг, 11 января 2018 г.

iOS. Swift. Enum with associated values for UITableView, UICollectionView

Статья из категории `Я решил это так, возможно у тебя есть другое решение :)`.

К нам приходит очередная задача - `экран фильтров`, на котором отображаются диапазон цен, категории ( можно добавлять несколько категорий к фильтру ), тип продавца (магазин, частный продавец) и тд.

Хороший вариант использовать UITableView или UICollectionView. Но как отобразить настолько разные данные в таблице?

Для таблицы нам нужен массив элементов и хотелось бы не делать никаких преобразований данных в методе cellForRowAtIndexPath. Так как фильтра содержать достаточно разные данные,  а элемент массива у нас должен быть одного типа, нам нужно как то сконвертировать модель фильтра в понятный формат для таблицы. Лучше всего в данном случае ( но это не точно ) подойдет enum.


Представление модели фильтра через enum для таблицы.

enum Item {
    case price(min: Int, max: Int, cur: Int)
    case seller(type: String)
    case categories(selected: [String], all: [String])
    ...
}


В результате использования enum-a мы можем сделать массив элементов для таблицы.

items = [
    .price(min: 100, max: 5000, cur: 1200), // ценовой диапазон и текущее значение
    .seller(type: "private"),
    .categories(selected: ["a"], all: ["a", "b", "c"]) // категории фильтра 
]


Полный пример выглядит следующим образом:

class FilterViewController {

    enum SellerType {
        case all, shop, private
    }

    enum Item {
        case price(min: Int, max: Int, cur: Int)
        case seller(type: SellerType)
        case categories(selected: [String], all: [String])
        ...
    }

    var items: [Item] = []

    override func viewDidLoad() {
        super.viewDidLoad()

        items = [
            .price(min: 100, max: 5000, cur: 1200),
            .seller(type: .private),
            .categories(selected: ["a"], all: ["a", "b", "c"])
        ]
    }
}

extension FilterViewController: UITableViewDataSource {

    override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        switch(items[indexPath.row]) {
        case let .price(min, max, cur):
            let cell = tableView.dequeueReusableCell(withIdentifier: "PriceCell", for: indexPath)
            // отображаем min, max, cur в ячейке

            return cell

        case let .seller(type):
            let cell = tableView.dequeueReusableCell(withIdentifier: "SellerCell", for: indexPath)
            // отображаем type в ячейке (или переключаем switch, segmented control)

            return cell

        case let .categories(selected, all):
            let cell = tableView.dequeueReusableCell(withIdentifier: "CategoriesCell", for: indexPath)
            // отображаем selected, all в ячейке

            return cell
        }
    }
}

В результате наш метод `cellForRow` становится достаточно простым и не нагружен никакой бизнес логикой. Мы можем протестировать создание, обновление нашего массива элементов.

P.S. Оставляем комментарии, темы для рассмотрения. И кликаем +1, f, в, t, что располагаются чуть ниже статьи.

суббота, 18 ноября 2017 г.

iOS. Swift. Router with protocol composition

В данной статье хочу поделится своим вариантов как вынести переходы между экранами в iOS приложении в отдельный класс ( Router ). Как дополнять возможности router-a переходить на большее количество экранов при этом не копируя код и избегая наследования.

Если у нас приложение построено на MVC ( да и любой другой ) архитектуре, то мы часто можем столкнуться в коде ViewController-a со следующим вариантом показать экран ( пример перейти на экран деталей пользователя ):

func showUserProfile() {
    let profile = UserProfileViewController()

    self.show(profile, sender: nil)
}

Теперь нам нужно перейти на экран деталей пользователя например из списка контактов, результатов поиска или из пин-а на карте. Итого получается что нам нужно открыть экран деталей пользователя из нескольких ViewController-ов.

Как вынести метод showUserProfile в одно место?

Для решение задачи можно создать отдельный класс ( в нашем варианте UserRouter ) и скопировать туда метод. Получаем:

class UserRouter {

    func showUserProfile(from controller: UIViewController) {
        let profile = UserProfileViewController()

        controller.show(profile, sender: nil)
    }
}

Теперь нам нужно подключить наш роутер во все controller-ы где мы будем использовать метод showUserProfile. Итого получаем:

UsersListViewController.swift
class UsersListViewController {

    var router: UserRouter?

    ...

    router?.showUserProfile(from: self)

    ...
}

SearchResultViewController.swift
class SearchResultViewController {

    var router: UserRouter?

    ...

    router?.showUserProfile(from: self)

    ...
}

Вроде все хорошо и мы получили что хотели.

Но теперь нам потребовалось добавить переход на экран добавления нового пользователя из экрана UsersListViewController. Можно просто добавить метод showAddUserScreen метод в UserRouter, но SearchResultViewController-у этот метод не нужен и не хотелось бы видеть лишние метод при использовании router-a. Простой вариант создаем новый роутер UsersListRouter наследуемся от UserRouter и добавляем метод showAddUserScreen. Получаем:

class UsersListRouter: UserRouter {

    func showAddUserScreen(from controller: UIViewController) {
        let add = AddUserViewController()

        controller.show(add, sender: nil)
    }
}

Итого наш UsersListController может открыть экран деталей пользователи и экран добавления нового пользователя. В свою очередь SearchResultController может только открыть экран деталей пользователя. В результате мы не нарушили наше правило НЕ дублировать код.

Наш проект не стоит на месте и добавление нового функционала влечет за собой изменения в нашем коде.
Пришло новое требование: добавить возможность отравления сообщения из UsersListViewController и из UserProfileViewController.

Сейчас нам нужно сделать так чтобы
UserListViewController мог переходить на экраны: UserProfile, AddUser, SendMessage,
SearchResultViewController на экраны: UserProfile
UserProfileViewController на экраны: SendMessage

Наследование здесь не поможет потому что так или иначе какой то класс будет видеть методы ( возможность ) перехода на экран, на который ему переходить не надо :)

В данном случае нам помогут protocol и protocol extension. Изменим наш UserRouter:

UserRouter.swift
protocol UserRouter {

    func showUserProfile(from controller: UIViewController)
}

extension UserRouter {

    func showUserProfile(from controller: UIViewController) {
        let profile = UserProfileViewController()

        controller.show(profile, sender: nil)
    }
}

Добавим новый роутер SystemToolsRouter:

SystemToolsRouter.swift
protocol SystemToolsRouter {

    func showSendMessageScreen(from controller: UIViewController)
}

extension SystemToolsRouter {

    func showSendMessageScreen(from controller: UIViewController) {
        let sendMessage = SendMessageViewController()

        controller.show(sendMessage, sender: nil)
    }
}

И добавим изменения в наши роутеры экранов:

UsersListRouter.swift
class UsersListRouter: SystemToolsRouter, UserRouter {

    func showAddUserScreen(from controller: UIViewController) {
        let add = AddUserViewController()

        controller.show(add, sender: nil)
    }
}

SearchResultRouter.swift
class SearchResultRouter: UserRouter {

}

UsersProfileRouter.swift
class UserProfileRouter: SystemToolsRouter {

}

В результате наши контроллеры будут выглядеть:

UsersListViewController.swift
class UsersListViewController {

    var router: UsersListRouter?

    ...

    router?.showUserProfile(from: self)
    router?.showSendMessageScreen(from: self)
    router?.showAddUserScreen(from: self)

    ...
}


SearchResultViewController.swift
class SearchResultViewController {

    var router: SearchResultRouter?

    ...

    router?.showUserProfile(from: self)

    ...
}


UserProfileViewController.swift
class UserProfileViewController {

    var router: UserProfileRouter?

    ...

    router?.showSendMessageScreen(from: self)

    ...
}

Итого при использовании protocol composition, protocol extension мы легко можем добавлять переходы на другие экраны не используя наследования и дублирования кода.

P.S. Оставляем комментарии, темы для рассмотрения. И кликаем +1, f, в, t, что располагаются чуть ниже статьи.

пятница, 12 июля 2013 г.

iOS Image Loader. Загрузка картинок.

В этой статье я покажу как пользоваться небольшой библиотечкой ( собственной разработки ) для загрузки картинок. Так как все время копировать код и подправлять немного мне надоело, решил написать загрузку с простым кэшированием картинок. Сделал так чтобы можно было подключить как говорится в один клик. Библиотека называется DLImageLoader.

Создаем проект. Добавляем в него библиотеку.

Я покажу пример на UITableView.
Наследуем ViewController от UITableViewController.
Изменяем класс ViewController должно получиться примерно вот так:

 #import "ViewController.h"  
 #import "DLImageLoader.h"  

 @interface ViewController ()  

 @property (nonatomic, strong) NSArray *urls;  

 @end  

 @implementation ViewController  

 - (id)initWithStyle:(UITableViewStyle)style {  
   self = [super initWithStyle:style];  
   if (self) {  
     // Custom initialization  
   }  
   return self;  
 }  
 
- (void)viewDidLoad {  
   [super viewDidLoad];  
   self.urls = [NSArray arrayWithObjects:@"url to image here", nil];  
 }  

 - (void)didReceiveMemoryWarning {  
   [super didReceiveMemoryWarning];  
   // Dispose of any resources that can be recreated.  
 }  

 #pragma mark - Table view data source  

 - (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {  
   return 1;  
 }  

 - (NSInteger)tableView:(UITableView *)tableView  
  numberOfRowsInSection:(NSInteger)section {  
   return [self.urls count];  
 }  

 - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {  
   static NSString *CellIdentifier = @"Cell";  
   UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:CellIdentifier];  
   if (cell == nil) {  
     cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault  
                    reuseIdentifier:CellIdentifier];  
   }  
   // Configure the cell...  
   cell.imageView.image = nil;  
   [[DLImageLoader sharedInstance] loadImageFromURL:[self.urls objectAtIndex:indexPath.row]  
                         completed:^(NSError *error, NSData *imgData) {  
                             cell.imageView.image = [UIImage imageWithData:imgData];  
                             [cell setNeedsLayout];  
   }];  
   return cell;  
 }  
 @end  

Вот и все.



Библиотека c полным примером -> DLImageLoader-iOS