iOS Delegates - Mobile Conf Rio 2014

DELEGATESDesvendando esse poderoso padrão

na API do iOS

APRESENTAÇÃO

Osni Oliveira

[email protected]

@osnipso

github.com/osnipso

mailto:[email protected]


CONHECIMENTO

• Básico de Objective-C

• Conceitos fundamentais do iOS

• Views

• Actions

•Outlets

slideshare.net/osnipso/primeiros-passos-no-ios-com-objectivec

DELEGATES

• Padrão de Projeto (Design Pattern)

•Divisão de responsabilidades

• Princípio da responsabilidade única

• Comunicação entre objetos

• Inversão de Controle (IoC)

DELEGATES

Colaboração entre objetos

IMPORTÂNCIA

• É *o* padrão mais importante no iOS

•Muito utilizado pela API

•Muito utilizado pelos desenvolvedores

• Imprescindível compreender

•Necessário dominar

• Boa prática utilizar - padronização

DEFINIÇÕES

•Delegation (iOS Developer Library - Cocoa Core Competencies)

https://developer.apple.com/library/ios/documentation/general/conceptual/DevPedia-CocoaCore/Delegation.html

•Delegates and Data Sources (iOS Developer Library - Concepts in Objective-C Programming)

https://developer.apple.com/library/ios/documentation/general/conceptual/CocoaEncyclopedia/DelegatesandDataSources/DelegatesandDataSources.html#//apple_ref/doc/uid/TP40010810-CH11









CONCEITO

Apple (Cocoa Core Competencies):

Delegação é um padrão simples e poderoso em que um objeto em um programa age no lugar de, ou em coordenação com outro objeto.

(...)

O objeto que delega é tipicamente um objeto do framework e o delegado é tipicamente um objeto controller customizado.

CONCEITO

Delega(framework) Delegado

MensagemProtocolo (opcional)

CONCEITO

• Recebe o delegado como dependência (injeção)

• Faz a “primeira parte” da tarefa

• Envia a mensagem

Delega(framework)

CONCEITO

• É injetado para o objeto que delega

• Garante a implementação da mensagem

• Faz a “segunda parte” da tarefa

Delegado

CONCEITO

•Opcional

• Contrato formal

• Acoplamento através do contrato (leve)

Protocolo

CONCEITO

Dois objetos colaboram para realizar uma tarefa.

O primeiro, faz até onde ele consegue fazer.

O que ele não consegue? Delega para o segundo!

CONCEITO

Delega(framework) Delegado

MensagemProtocolo (opcional)

EXEMPLO: UIAlertView

(ViewController.h)

@interface ViewController : UIViewController <UIAlertViewDelegate>

(ViewController.m)

UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"Exemplo 1" message:@"Começando com delegates" delegate:self cancelButtonTitle:@"Cancela" otherButtonTitles:@"Ok", nil];

- (void)alertView:(UIAlertView *)alertView clickedButtonAtIndex:(NSInteger)buttonIndex { ... }


UIAlertView ViewController

alertView:clickedButtonAtIndex:

UIAlertViewDelegate

delegatereferência


• Sabe exibir a mensagem e os botões

• Sabe qual botão foi tocado (“clicado”) pelo usuário

•Não sabe o que fazer a partir desse ponto!

•Depende da aplicação

• Aciona o delegado para fazer

EXEMPLO: UIImagePickerController

(ViewController.h)

@interface ViewController : UIViewController <UINavigationControllerDelegate, UIImagePickerControllerDelegate>

(ViewController.m)

UIImagePickerController *imagePicker = [[UIImagePickerController alloc] init];imagePicker.sourceType = UIImagePickerControllerSourceTypePhotoLibrary;imagePicker.delegate = self; [self presentViewController:imagePicker animated:YES completion:nil];

- (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary *)info { ... }


UIImagePickerController ViewController

imagePickerController:didFinishPickingMediaWithInfo:

UINavigationControllerDelegate (*)UIImagePickerControllerDelegate

delegatereferência


• Sabe exibir a galeria de imagens/vídeos (câmera, etc.)

• Sabe qual image/vídeo foi selecionado pelo usuário

•Não sabe o que fazer a partir desse ponto!

•Depende da aplicação

• Aciona o delegado para fazer

OUTROS EXEMPLOS

• UITableView

• UITableViewDelegate (interação com UI / exibição avançada)

• UITableViewDataSource (exibição básica)

OUTROS EXEMPLOS

• UIApplicationDelegate

(AppDelegate.h)

@interface AppDelegate : UIResponder <UIApplicationDelegate>

E O CONTRATO?

• Acoplamento a um protocolo específico

•Melhor que acoplar diretamente à classe...

•Obrigatoriedade de implementar todas as mensagens (?)

• Péssimo. Implementações vazias, adapters, etc.

EXEMPLO - SEM PROTOCOLO

• UIPickerController, porém seleciona ao confirmar

• Permite cancelar seleção

• Exibido como modal


• MYPickerViewController é quem implementa UIPickerViewDataSource, UIPickerViewDelegate

(MYPickerViewController.h)

@interface MYPickerViewController : UIViewController <UIPickerViewDataSource, UIPickerViewDelegate>

• Exibe conteúdo fixo

• Seguindo a mesma idéia, podemos perguntar a um DataSource o que exibir... (desafio)


• Precisamos usar performSelector:

•Delegate pode ser genérico, mas precisa implementar o protocolo NSObject


@property (weak, atomic) id<NSObject> delegate;

(MYPickerViewController.m)

if ([self.delegate respondsToSelector:@selector(pickedItem:)]) { [self.delegate performSelector:@selector(pickedItem:) withObject:@(self.selectedItem)];}


• Problemas com o compilador:

• Até dá pra desligar esse aviso, mas...


MYPickerViewController ViewController

cancelPicking (opcional)pickedItem: (opcional)

NSObject

delegatereferência


Prós:

•Menos trabalho

• Sem implementações desnecessárias, adapters

Contras:

• Contrato implícito!

• Sem autocomplete

• Sem ajuda do compilador

•Muito limitado!


Limitações

• Protocolo NSObject

performSelector:

performSelector:withObject:

performSelector:withObject:withObject:

• Boxing (syntax sugar)

EXEMPLO - COM PROTOCOLO


@class MYPickerViewController;

@protocol MYPickerViewControllerDelegate <NSObject>

@optional- (void)cancelPickerViewController: (MYPickerViewController *)pickerViewController;

@required- (void)pickerViewController:(MYPickerViewController *)pickerViewController pickedItem:(NSInteger)itemIndex;

@end

@property (weak, atomic) id<MYPickerViewControllerDelegate> delegate;



- (IBAction)cancelPicking:(id)sender{ if ([self.delegate respondsToSelector: @selector(cancelPickerViewController:)]) { [self.delegate cancelPickerViewController:self]; }}

- (IBAction)confirmPicking:(id)sender{ [self.delegate pickerViewController:self pickedItem:self.selectedItem];}



cancelPickerViewController: (opcional)pickerViewController:pickedItem:

MYPickerViewControllerDelegate

delegatereferência


Prós:

• Contrato explícito

• Com autocomplete

• Com ajuda do compilador

•Mais flexível e poderoso

Contras:

•Mais trabalho

Com @optional:

• Sem implementações desnecessárias, adapters

• Continua autocomplete!

EXEMPLO - COM BLOCOS


@property (copy, atomic) void (^cancelBlock) (MYPickerViewController *pickerViewController);

@property (copy, atomic) void (^successBlock) (MYPickerViewController *pickerViewController, NSInteger itemIndex);



- (IBAction)cancelPicking:(id)sender{ if (self.cancelBlock) { self.cancelBlock(self); }}

- (IBAction)confirmPicking:(id)sender{ if (self.successBlock) { self.successBlock(self, self.selectedItem); }}


(ViewController.m)

MYPickerViewController *pickerViewController = [[MYPickerViewController alloc] init]; pickerViewController.cancelBlock = ^(MYPickerViewController *pickerViewController) { [self dismissViewControllerAnimated:YES completion:nil]; }; pickerViewController.successBlock = ^(MYPickerViewController *pickerViewController, NSInteger itemIndex) { NSLog(@"Item selecionado: %ld", (unsigned long)itemIndex);

[self dismissViewControllerAnimated:YES completion:nil]; };

[self presentViewController:pickerViewController animated:YES completion:nil];



void (^cancelBlock)(MYPickerViewController *pickerViewController);void (^successBlock)(MYPickerViewController *pickerViewController, NSInteger itemIndex);

Contrato está na assinatura do bloco!

blocobloco (cópia)


Prós:

• Contrato explícito

• Com ajuda do compilador

• (Ainda) mais flexível e poderoso

Contras:

• Uma propriedade por callback

• Sintaxe bizarra!

• Problemas de gerenciamento de memória...


•Dá pra melhorar um pouquinho a sintaxe...


typedef void (^MYPickerViewControllerCancelBlock) (MYPickerViewController *pickerViewController);

typedef void (^MYPickerViewControllerSuccessBlock) (MYPickerViewController *pickerViewController, NSInteger itemIndex);

@property (copy, atomic) MYPickerViewControllerCancelBlock cancelBlock;@property (copy, atomic) MYPickerViewControllerSuccessBlock successBlock;


• Cuidado com ciclos de retenção!


blocobloco (cópia de self - “strong”)

picker

pickerViewController (strong)


Cuidado:

• Fechamento (closure) no escopo da instância

• Programação funcional - paradigma misto

• Extensão da linguagem C, ainda não padronizada

Curiosidade:

• Sintaxe é a mesma de ponteiro de função (“*” vira “^”)


• Resolvendo (possíveis) ciclos de retenção:

(ViewController.m)

typeof(self) __weak weakSelf = self;

pickerViewController.cancelBlock = ^(MYPickerViewController *pickerViewController) { [weakSelf dismissViewControllerAnimated:YES completion:nil]; }; pickerViewController.successBlock = ^(MYPickerViewController *pickerViewController, NSInteger itemIndex) { NSLog(@"Item selecionado: %ld", (unsigned long)itemIndex);

[weakSelf dismissViewControllerAnimated:YES completion:nil]; };

DICAS

• Procure entender o conceito (callback...?)

•Observe as APIs e como elas utilizam o padrão

•Na dúvida, implemente com protocolos (tradicional)

• APIs novas usam cada vez mais blocos - tendência

OBRIGADO!

slideshare.net/osnipso/ios-delegates-mobile-conf-rio-2014

github.com/osnipso/mobileconf2014

[email protected]

@osnipso



Software

iOS Delegates - Mobile Conf Rio 2014