iOS-Contacts( TableView)

  • [ ] 准备阶段:数据层model

请求数据-ContactsService

  • 写一个mock网络请求获取JSON数据的方法:

+ (void)getContactsCompleteBlock:(void (^)(ContactsListEntity *contactsListEntity, NSError *error))completeBlock;
​

提示:此方法不需要传入参数

  • 方法的实现:使用<ServiceProvider/ServiceProvider> 中network的方法:
-(NSURLSessionDataTask *)requestAPI:(NSString *)apiName nameSpace:(NSString *)nameSpace parameters:(NSDictionary *)parameters options:(SPNetworkOptions)options complete:(void (^)(NSURLResponse *, SPNetworkResponseObject *, NSError *))complete {
    return [self fetchMockByAPIName:apiName parameters:parameters complete:complete];
}

提示:这里请求的API即为请求的JSON文件的前缀:@"getContactList"

  • complete block的实现:
    获得的返回的responseObject的entity,并用它初始化contactsListEntity
ContactsListEntity *contactsListEntity = [[ContactsListEntity alloc] initWithDictionary:responseObject.entity];


没有出错的情况下,即error为nil,completeBlock返回contactsListEntity完成回调。

解析数据

1、JSON数据

在工程中对应的mock文件夹中创建getContactList-alimockapi.json文件

  • 设计JSON格式
  1. 一层:array contactList
  2. 二层:contactList中元素为一个个cell的信息(dictionary)
    这里包含信息是,key:contactName、contactId、contactAdd、contactNumber
    提示:value都是string类型的。

2、ContactsListEntity

  • property:
@property (nonatomic, strong) NSArray *contacts;
​
  • method:重写AliEntity中的映射方法,这里面解析方法都已经写好,可以理解为这里是调用一个接口,只需要告诉它名称的对应关系即可。
 +(NSDictionary *)arrayItemMap;
​
 +(NSDictionary *)propertyMap;
  1. propertyItemMap 自定义映射关系。这里把JSON中的某数据结构(例如这里是数组:contactList)赋值给ContactsListEntity中名为contacts的成员变量。
return @{@"contactList" : @"contacts"};
  1. arrayItemMap 定义数组中的item都应该是什么类型。这里是指JSON中对应的数组contactList应该由ContactsInfoEntity组成。

3、ContactsInfoEntity

  • property:
@property (nonatomic, copy) NSString *contactName;
@property (nonatomic, copy) NSString *contactId;
@property (nonatomic, copy) NSString *contactNumber;
@property (nonatomic, copy) NSString *contactAddress;

  • method:重写Entity中的映射方法。道理同listEntity。
    提示:此Entity中的属性名如果与JSON中相同,则可以省去映射步骤。若不同,则需要单独处理。
 + (NSDictionary *)propertyMap {
    return @{@"contactAdd" : @"contactAddress"};
}






  • [ ] 准备阶段:视图层view

数据绑定-ContactsTableViewCell


1、自动调用UITableViewCell初始化方法:

 - (instancetype)initWithStyle:(UITableViewCellStyle)style reuseIdentifier:(nullable NSString *)reuseIdentifier NS_AVAILABLE_IOS(3_0) NS_DESIGNATED_INITIALIZER;

2、cell初始化函数commonInit:
初始化子view,并将其添加到父视图

     _checkContainerView = [UIView new];
    [self.contentView addSubview:_checkContainerView];


3、设计布局,使用Masonry 添加约束

使用mas_maekConstraints设置约束条件:mas_equalTo
示例:

[textView mas_makeConstraints:^(MASConstraintMaker *make) {
        make.left.mas_equalTo(StyleSpacing2);
        make.top.mas_equalTo(StyleSpacing4);
        make.bottom.mas_equalTo(StyleSpacing4);
        make.right.mas_equalTo(StyleSpacing2);
    }];

注意添加约束要在addSubview之后。


4、public method:实现数据绑定

 - (void)configWithContactsInfoEntity:(ContactsInfoEntity *)entity;
​

将ContactsInfoEntity中属性值赋值给cell中的lable.text
示例:

self.contactName.text = entity.contactName;

提示:cell这里容易出错,详见Contacts报错总结。



  • [ ] 开始“动工”:控制层controller

控制层-ContactsViewController

viewController生命周期:

viewDidLoad:

  • 初始化tableView
self.tableView = [[UITableView alloc] initWithFrame:self.view.bounds style:UITableViewStylePlain];
  • 设置tableView的其他属性(背景颜色、分割样式等等)
  • 给tableView绑定delegate、datasource
self.tableView.delegate = self;
    self.tableView.dataSource = self;
  • 将tableView添加到父视图
[self.view addSubview:self.tableView];

  • 调用加载数据方法reloadData

viewDidAppear:

 - (void)viewDidAppear:(BOOL)animated {
    [super viewDidAppear:animated];
}


其他生命周期过程省略。

加载数据-reloadData


这个方法是用来加载数据的,数据就是从mock网络请求获取而来的,既然如此,那么之前精心准备的ContactsService就华丽登场啦:

[ContactsService getContactsCompleteBlock:^(ContactsListEntity *contactsListEntity, NSError *error) {
        if (!error) {
            
            NSLog(@"contacts : %@", contactsListEntity);
            self.contactsListEntity = contactsListEntity;
            [self.tableView reloadData];
            
        } else {
            
            NSLog(@"error : %@", error.localizedDescription);
            
        }
    }];


请求数据成功之后,在无错误的情况下completeBlock执行:把成功返回的contactsListEntity传给本地的contactsListEntity。

TableView Delegate&Datasource

  • delegate:
 - (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath;


因为暂无特殊要求,这里高度直接设置为了固定值。

  • datasource:
    1、列表行数
 - (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section;
​


列表行数返回的是加载数据成功后的contactListEntity中数组contacts的元素数。

return self.contactsListEntity.contacts.count;
}


2、cell

 - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath;


此时,就要用到之前准备的ASCContactsTableViewCell啦。
先实例化一个它的对象cell:

 ContactsTableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"ContactsTableViewCell" forIndexPath:indexPath];


然后用加载数据成功后的contactListEntity中数组contacts的某个元素内容去构造这个cell,调用ASCContactsTableViewCell类的方法:

[cell configWithContactsInfoEntity:self.contactsListEntity.contacts[indexPath.row]];


最后返回这个cell,工程主体就大功告成啦!



  • [ ] 用起来~

功能入口-AliMyAlibaba

修改view

在页面内添加一个新的headerButton,与原有的三个button:“Favorite Companies、Favorite Products、Browsing History” 并列放置。


DingTalk20170719140008.png
DingTalk20170719140008.png



添加响应事件

为新设置的按钮添加响应方法actContacts

 - (void)actContacts {//跳转联系人页面
    [UT ctrlClicked:@"MyContacts" page:self args:nil];
    [AccountHelper executeUserRequiredAction:^{
        ContactsViewController *cc= [[ContactsViewController alloc] initWithNibName:nil bundle:nil];
        [self.navigationController pushViewController:cc animated:YES];
    }];
}

这里就实例化了ContactsViewController类的对象,并通过push的方法显示出来。那么这个功能的入口就写好了,可以用起来啦~


DingTalk20170719145934.png
DingTalk20170719145934.png


加个联系人头像美化一下:


DingTalk20170719201748.png
DingTalk20170719201748.png


再添加一个下拉翻页功能,好啦~任务完成了~
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 151,688评论 1 330
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 64,559评论 1 273
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 101,749评论 0 226
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 42,581评论 0 191
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 50,741评论 3 271
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 39,684评论 1 192
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,122评论 2 292
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 29,847评论 0 182
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,441评论 0 228
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 29,939评论 2 232
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,333评论 1 242
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 27,783评论 2 236
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,275评论 3 220
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,830评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,444评论 0 180
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 34,553评论 2 249
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 34,618评论 2 249

推荐阅读更多精彩内容