《iOS编程（第四版）》Demo：Needfeed

点击TableView列表展示WebView

注：本文参考 IOS编程（第四版） 第21章 web服务与UIwebView 相关内容开发一款名为Nerdfeed的应用。展示 UITableView 与 UIWebView 相关知识内容，以为整理记录，作为日后开发过程中参考并使用。

Needfeed 的作用是读取并通过 UITableView 显示 Big Nerd Ranch 提供的在线课程，选择某项课程会打开相应课程的网页。Demo如下：

Needfeed

要实现以上Demo所示的Needfeed应用，需要完成两项任务：

连接指定的web服务并获取数据，然后根据得到的数据创建模型对象。
用UIWebView显示Web内容。

1.创建HQLCoursesViewController类，并将其父类设置为UITableViewController

@interface HQLCoursesViewController : UITableViewController

遵守UITableViewDataSource协议的类需要实现数据源方法

API文档描述
The UITableViewDataSource protocol is adopted by an object that mediates the application’s data model for a UITableView object. The data source provides the table-view object with the information it needs to construct and modify a table view.

翻译：当一个对象需要为应用程序的UITableView对象提供数据源模型时，采用UITableViewDataSource协议。数据源则为table-view对象提供它需要建立和修改列表视图的信息。

UITableViewDataSource协议必须（@requored）实现的2个方法：

-(NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section;
向数据源获取并返回列表视图中给定section区域中的行数。
-(UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath;
在列表视图的特定单元格位置插入请求到的数据

因此，我们先在HQLCoursesViewController.m中实现空的数据源方法，之后再作修改。

//返回行数
- (NSInteger) tableView:(UITableView *)tableView
  numberOfRowsInSection:(NSInteger)section {
    
    return 0;
}

//获取用于显示第section个表格段、第row行数据的UITableViewCell对象
- (UITableViewCell *) tableView:(UITableView *)tableView
          cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    
    return nil;
}

2.在AppDelegate.m中创建视图控制器对象

需要创建UINavigationControl对象，并将其设置为UIWindow的根视图控制器

//创建coursesViewController对象 cvc
HQLCoursesViewController *cvc = [[HQLCoursesViewController alloc] initWithStyle:UITableViewStylePlain];
   
//UINavigationController对象 masterNav 是 cvc 的根视图控制器
UINavigationController *masterNav = [[UINavigationController alloc] initWithRootViewController:cvc];

self.window.rootViewController = masterNav;

NSURL、NSURLRequest、NSURLSession和NSURLSessionTask

要从web服务器获取数据，Nerdfeed需要使用NSURL、NSURLRequest、NSURLSession和NSURLSessionTask四个类。
推荐阅读：^[1]

NSURL对象负责以URL的格式保存web应用的位置。对大多数web服务，URL将包含基地址（base address）、web应用名和需要传送的参数。
NSURLRequest对象负责保存需要传送给web服务器的全部数据，这些数据包括：一个NSURL对象、缓存方法（caching policy）、等待web服务器响应的最长时间和需要通过HTTP协议传送的额外信息（NSMutableURLRequest是NSURLRequest的可变子类）。
每一个NSURLSessionTask对象都表示一个NSURLRequest的生命周期。NSURLSessionTask可以跟踪NSURLRequest的状态，还可以对NSURLRequest执行取消、暂停和继续操作。NSURLSessionTask有多种不同功能的子类，包括NSURLSessionDataTask,NSURLSessionUploadTask和NSURLSessionDownloadTask.
NSURLSession对象可以看作是一个生产NSURLSessionTask对象的工厂。可以设置其生产出来的NSURLSessionTask对象的通用属性，例如请求的内容、是否允许在蜂窝网络下发送请求等。NSURLSession对象还有一个功能强大的委托，可以跟踪NSURLSessionTask对象的状态、处理服务器的认证要求等。

3.构建URL与发送请求

NSURLSession

NSURLSession有两种不同的含义：第一种含义指NSURLSession类；第二种含义指一组用于处理网络请求的API。
此处使用第一种含义，首先在HQLCoursesViewController.m的类扩展中添加一个属性，用于保存NSURLSession对象：

@property (nonatomic) NSURLSession *session;

接下来覆盖HQLCoursesViewController.m的initWithStyle：方法，创建NSURLSession对象

    - (instancetype) initWithStyle:(UITableViewStyle)style {
    
    //创建NSURLSession对象
    self = [super initWithStyle:style];
    
    if (self) {
        
        self.navigationItem.title = @"BNRCourses";
        
        NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
        
        _session = [NSURLSession sessionWithConfiguration:config
                                            //NSURLSessionConfiguration对象
                                                 delegate:nil   //委托
                                            delegateQueue:nil]; //委托队列
    
    }
     return self;
    }

在HQLCoursesViewController.m中实现fetchFeed方法连接web服务器：
此处NSURLRequest使用默认的GET请求方法，若要使用POST方法，需要设置POST请求体。

    // 获取数据方法
     -(void) fetchFeed {
    
    //创建NSURLRequest请求对象
    NSString *requestString = @"http://bookapi.bignerdranch.com/private/courses.json";
    NSURL *url = [NSURL URLWithString:requestString];
    NSURLRequest *req = [NSURLRequest requestWithURL:url];
    
    //使用NSURLSession对象创建一个NSURLSessionDataTask对象，将NSURLRequest对象发送给服务器
    NSURLSessionDataTask *dataTask = [self.session dataTaskWithRequest:req
                                                     completionHandler://block对象
                                      ^(NSData * _Nullable data,
                                        NSURLResponse * _Nullable response,
                                        NSError * _Nullable error) {
    //接收数据    
    NSString *json = [[NSString alloc] initWithData:data
                                           encoding:NSUTF8StringEncoding];
    NSLog(@"%@",json);
        
    //NSURLSessionDataTask在刚创建的时候处于暂停状态，需要手动调用resume方法恢复,让NSURLSessionDataTask开始向服务器发送请求。
    [dataTask resume];    
    }

Nerdfeed应该在创建HQLCoursesViewController对象后就发起网络请求。修改HQLCoursesViewController.m的initWithStyle：方法，添加调用 fetchFeed的方法。
session对象创建完成后调用[self fetchFeed];

    - (instancetype) initWithStyle:(UITableViewStyle)style {
    
    //创建NSURLSession对象
    self = [super initWithStyle:style];
    
    if (self) {
        
        self.navigationItem.title = @"BNRCourses";
        
        NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
        
        _session = [NSURLSession sessionWithConfiguration:config
                                            //NSURLSessionConfiguration对象
                                                 delegate:nil   //委托
                                            delegateQueue:nil]; //委托队列
        [self fetchFeed];
    }
    
     return self;
}

JSON数据

JSON数据只包含有限的几种基础对象，用于表示来自服务器的模型对象，例如数组、字典、字符串和数字。而每个JOSN文件是由这些基础对象嵌套组合而成的。

4.解析JSON数据

NSJSONSerialization类：用于解析JSON数据。
NSJSONSerialization可以将JSON数据转换为Object-C对象。
字典会转换为NSDictionary对象；数组会转换为NSArray对象；字符串会转换为NSString对象；数字会转换为NSNumber对象。

删除

NSString *json = [[NSString alloc] initWithData:data
encoding:NSUTF8StringEncoding];
~~NSLog(@"%@",json); ~~

修改为

NSDictionary *jsonObject = [NSJSONSerialization JSONObjectWithData:data
                                                               options:0
                                                                 error:nil];
NSLog(@"%@",jsonObject);

在HQLCoursesViewController.m的类扩展中添加一个属性用于保存在线课程数组。数组中的每一个元素都是一个NSDictionary对象，表示一项课程的详细信息。

@interface HQLCoursesViewController () 

@property (nonatomic) NSURLSession *session;

//保存在线课程数组
@property (nonatomic,copy) NSArray *courses;

@end

然后修改NSURLSessionDataTask的completionHandler：

NSURLSessionDataTask *dataTask = [self.session dataTaskWithRequest:req
                                                     completionHandler: //block对象
                                      ^(NSData * _Nullable data,
                                        NSURLResponse * _Nullable response,
                                        NSError * _Nullable error) {
        

        
        // 解析JSON数据
        NSDictionary *jsonObject = [NSJSONSerialization JSONObjectWithData:data
                                                                   options:0
                                                                     error:nil];
         //NSLog(@"%@",jsonObject)
        //将NSDictionary代表的课程存入数组
        self.courses = jsonObject[@"courses"];
        NSLog(@"%@",self.courses);
        
    }];
    
    //NSURLSessionDataTask在刚创建的时候处于暂停状态
    [dataTask resume];  //手动调用resume方法恢复
    
}

接下来修改UITableView的数据源方法，将课程的title显示在相应的UITableViewCell中。最后还需要覆盖viewDidLoad方法，向UITableView注册UITableViewCell

- (void) viewDidLoad {

[super viewDidLoad];

//重用UITableViewCell，向表视图注册应该使用的UITableViewCell
[self.tableView registerClass:[UITableViewCell class] forCellReuseIdentifier:@"UITableViewCell"];

}

//获取数据源
//UITableViewDataSource协议必须（@requored）实现的2个方法
////返回行数
- (NSInteger) tableView:(UITableView *)tableView
numberOfRowsInSection:(NSInteger)section {

//返回课程数目
return self.courses.count;
}

//获取用于显示第section个表格段、第row行数据的UITableViewCell对象
- (UITableViewCell *) tableView:(UITableView *)tableView
      cellForRowAtIndexPath:(NSIndexPath *)indexPath {

//创建或重用UITableViewCell对象
UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"UITableViewCell"
                         forIndexPath:indexPath];

NSDictionary *course = self.courses[indexPath.row];
cell.textLabel.text  = course [@"title"];//设置标题
return cell;
}

主线程

主线程有时也被称为用户界面线程（UI thread），这是由于修改用户界面的代码必须在主线程中运行。
当web服务请求成功后，HQLCoursesViewController需要重新加载UITableView对象的数据（调用UITableView对象的reloadData方法），默认情况下NSURLSessionDataTask是在后台线程中执行completionHandler:的，为了让reloadData方法在主线程中运行，可以使用dispatch_asynch函数.

...
//将NSDictionary代表的课程存入数组
        self.courses = jsonObject[@"courses"];
        NSLog(@"%@",self.courses);
        
        dispatch_async(dispatch_get_main_queue(), ^{
            //重新加载UITableView对象的数据
            [self.tableView reloadData];
...

5.UIWebView

注：官方建议，以 iOS 8 或者以后的版本运行的应用程序，使用WKWebView类而不是使用UIWebView。

可参阅对UIWebView、WKWebView官方文档翻译，点击查看：

API翻译：UIWebView 、API翻译：WKWebView 、API翻译：WebKit

课程返回的JSON数据中，每个Course对象都是一个NSDictionary对象，其中含有"url"键，值是一个URL字符串，表示对应的网址。
新建一个HQLWebViewController对象，父类是UIViewController

#import 

@interface HQLWebViewController : UIViewController 

@property (nonatomic) NSURL *URL;

@end

在HQLWebViewController.m中，加入以下代码：

@implementation HQLWebViewController

- (void) loadView {
    
    UIWebView *webView = [[UIWebView alloc] init];
    webView.scalesPageToFit = YES;
    self.view = webView ;
    
}

- (void) setURL:(NSURL *)URL
{
    _URL = URL;
    if (_URL) {
        NSURLRequest *req = [NSURLRequest requestWithURL:_URL];
        [(UIWebView *)self.view loadRequest:req];
    }
}

@end

在HQLCoursesViewController.h中，声明一个新属性，指向HQLWebViewController。

#import 
@class HQLWebViewController;

@interface HQLCoursesViewController : UITableViewController

@property (nonatomic) HQLWebViewController *webViewController;

@end

在AppDelegate.m中，创建HQLWebViewController对象并将其赋给HQLCoursesViewController对象的webViewController属性。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    
    self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
    
    HQLCoursesViewController *cvc = [[HQLCoursesViewController alloc] initWithStyle:UITableViewStylePlain];
    
    UINavigationController *masterNav = [[UINavigationController alloc] initWithRootViewController:cvc];
    
    HQLWebViewController *wvc = [[HQLWebViewController alloc] init];
    cvc.webViewController = wvc;
    
    self.window.rootViewController = masterNav;
        
    self.window.backgroundColor = [UIColor whiteColor];
    [self.window makeKeyAndVisible];
    return YES;
}

在HQLCoursesViewController.m中导入HQLWebViewController.h,然后实现UITableView对象的数据源协议，用户点击UITableView对象中的某个UITableViewCell后，NerdFeed会创建HQLWebViewController.h对象并将其压入UINavigationController栈。

//用户更改选择后调用
//创建HQLWebViewController对象并将其压入UINavigationController栈
- (void) tableView:(UITableView *)tableView
didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
    NSDictionary *course = self.courses [indexPath.row];
    NSURL *URL = [NSURL URLWithString:course [@"url"]];
    self.webViewController.title =course [@"title"];
    self.webViewController.URL = URL;
    //如果对象不属于splitViewController，则当前设备不是iPad,可以将webViewController压入navigationController栈
    if (! self.splitViewController) { 
        [self.navigationController pushViewController:self.webViewController animated:YES];
    } 
}

6.认证信息

web服务可以在返回HTTP响应时附带认证要求（authentication challenge）,只有当发起方提供相应的认证信息（比如用户名和密码），且当认证通过后，web服务才会返回真正的HTTP相应。
当应用收到认证要求时，NSURLSession的委托会收到(void)URLSession:task:didReceiveChallenge:completionHandler:消息，可以在该消息中发送用户名和密码，完成认证。

打开HQLCoursesViewController.m文件，修改fetchFeed方法中的URL地址将http改为HTTPS。

NSString *requestString = @"https://bookapi.bignerdranch.com/private/courses.json";

还需要在初始化时为NSURLSession设置委托。更新initWithStyle：方法,代码如下：

    _session = [NSURLSession sessionWithConfiguration:config
                                        //NSURLSessionConfiguration对象
                                             delegate:self   //设置委托
                                        delegateQueue:nil]; //委托队列

然后设置使HQLCoursesViewController遵守NSURLSessionDataDelegate协议：
@interface HQLCoursesViewController ()

实现-(void)URLSession:task:didReceiveChallenge:completionHandler:方法，处理认证信息。

//处理web服务认证
- (void) URLSession:(NSURLSession *)session
               task:(NSURLSessionTask *)task
didReceiveChallenge:(NSURLAuthenticationChallenge *)challenge
  completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition, NSURLCredential * _Nullable))completionHandler {
    
    //凭据
    NSURLCredential *cred = [NSURLCredential
                             credentialWithUser:@"BigNerdRanch"
                             password:@"AchieveNerdvana"
                             persistence:NSURLCredentialPersistenceForSession];//认证信息有效期，枚举值
    
    //完成处理程序 completionHandler(认证类型，认证信息)
    completionHandler (NSURLSessionAuthChallengeUseCredential,cred);
    
}

http://www.cnblogs.com/kenshincui/p/4042190.html

关系图

↩