如何在iOS上展现Web Service数据

在iOS开发中，需要和WEB服务器进行交互，如将一批来自WEB SERVICE的数据展现在表格上。数据交互格式是XML，使用的协议是SOAP。请求的数据中有图片，通常图片都会是一个URL重连接，需要再得到这个URL后下载到终端才展现出来。

如果你使用的是浏览器，那么这一切它都做好了。但如果你要更灵活的展现和处理这些数据，这需要开发一个应用。

1.实现过程

我建立一个简单的基于视图控制器的应用。新建的视图控制器类XYViewController。

在该类中手工添加UITableView对象resultTableView，用于展现WEB Service中请求来的数据。WEB SERVICE使用SOAP协议交互。建一个数据请求类XYQueryHotel，使用它的delegate将数据以数组的形式回调回来。

在这个数据请求类中，使用异步请求数据，将收到的XML格式的数据使用NSXMLParser类进行分析。

在视图控制器类XYViewController请求数据过程中，不可避免地会有一个等待出现，但UI可以继续，因为是异步请求操作。这个上面可以设置一些用于杀时间的有趣味的小图片，避免枯燥的等待，提升UI友好度。

在数据请求类操作完成后，通过delegate方式返回了数据给视图控制器类XYViewController中一个属性resultHotels。视图控制器类XYViewController将该属性的数据展现在UITableView对象resultTableView中。

对于resultTableView，通过的datasource方法(UITableViewCell*)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath*)indexPath，将能显示在屏幕上的cell设置好数据。

在resultTableView中，还有一个图片信息需要展现，这个需要通过resultHotels中图片URL去二次请求web service。

这个过程也需要异步去实现，包括请求到图片uiimage数据，请求到的数据的优化，请求到的数据展现等操作，反正不能影响到UI。这是整个实现过程中的关键点，也是难点。

这个请求操作是数据一开始加载时就发出。(UITableViewCell *)tableView:(UITableView *)tableViewcellForRowAtIndexPath:(NSIndexPath *)indexPath，这个方法中在cell填充时使用多线程发出请求。它的实现代码如下：

 

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

    static NSString *CellIdentifier =@"resultCell";

    //初始化cell并指定其类型，也可自定义cell

    hotelCell = (XYHotelCell*)[tableView dequeueReusableCellWithIdentifier:CellIdentifier];

    if(hotelCell == nil)

    {

        //将Custom.xib中的所有对象载入

        NSArray *nib = [[NSBundle mainBundle]loadNibNamed:@"KaiFangTableViewCell" owner:nil options:nil];

        //第一个对象就是CustomCell了

        hotelCell = [nib objectAtIndex:0];

    }   

    switch (indexPath.section) {

        case 0://对应各自的分区

            //修改CustomCell的控件

            hotelInfo=[resultHotelsobjectAtIndex:indexPath.row];

            hotelCell.name.text = [hotelInfoname];

            hotelCell.addr.text = [hotelInfoaddr];

            hotelCell.distance.text = [NSStringstringWithFormat:@"%@,%@",[hotelInfo lat],[hotelInfo lng]];

           

            if(hotelInfo.hasLogoImage)

            {

               hotelCell.logo.image=hotelInfo.logo;

            }

            else

            {

                hotelCell.logo.image = [UIImageimageNamed:@"Placeholder.png"];

                if (!resultTableView.dragging&& !resultTableView.decelerating) {

                    [selfstartOperationsForHotelLogo:hotelInfo atIndexPath:indexPath];

                }

            }

            //返回CustomCell

            return hotelCell;

            break;

    }

    return hotelCell;//返回cell

}

 

数组resultHotels中保存类HotelInfo的对象的记录。类HotelInfo是一个单独定义的数据类，属于MVC中MODE范畴。

方法tableView:cellForRowAtIndexPath:，根据在屏幕上显示的cell行号，得到该数组中去动态取对应行的记录。然后将得到的记录信息填写到cell中，用于展现，并将得到的记录，通过一个方法  [self startOperationsForHotelLogo:hotelInfoatIndexPath:indexPath];去多线程请求展现图片。

 

这个方法  [self startOperationsForHotelLogo:hotelInfoatIndexPath:indexPath]中包括了图片从WEB SERVICE上下载操作，图片美化操作，图片展示到对应的CELL中的操作，并修改提交的记录中信息，再二次展现时如上下滚动时不需要再二次请求该方法了。

 

如果用户退出这个视图控制器类，那么该数组resultHotels如何缓存，怎不能再将WEB SERVICE交互再做一次把。

 

继续实现[selfstartOperationsForHotelLogo:hotelInfo atIndexPath:indexPath]方法，

 

-(void)startOperationsForHotelLogo:(HotelInfo *)hotel atIndexPath:(NSIndexPath*)indexPath {

    if (!hotel.hasLogoImage) {

        [selfstartImageDownloadingForHotelLogo:hotel atIndexPath:indexPath];

    }

     if (!record.isFiltered) {

     [self startImageFiltrationForRecord:recordatIndexPath:indexPath];

     }

}

根据传入的hotel对象中hasLogoImage来决定是否下载，再根据isFiltered来决定是否美化它。

 

继续实现(void)startImageDownloadingForHotelLogo:(HotelInfo*)hotel atIndexPath:(NSIndexPath *)indexPathWithLogo方法。

 

-(void)startImageDownloadingForHotelLogo:(HotelInfo *)hotelatIndexPath:(NSIndexPath *)indexPathWithLogo {

    if (self.pendingOperations==nil)

    {

       self.pendingOperations=[[PendingOperationsalloc] init];

        NSLog(@"pendingOperationsinitial");

    }

      

    if(![self.pendingOperations.downloadsInProgress.allKeys containsObject:indexPathWithLogo]){

      

     HotelImageDownloader *imageDownloader = [[HotelImageDownloader alloc]initWithHotel:hotel atIndexPath:indexPathWithLogo delegate:self];

 

       [self.pendingOperations.downloadsInProgress setObject:imageDownloaderforKey:indexPathWithLogo];

        [self.pendingOperations.downloadQueueaddOperation:imageDownloader];

        NSLog(@"operation count is%d",[self.pendingOperations.downloadQueue operationCount]);

    }

}

 

首先，分配并初始化一个对象pendingOperations，用于保存操作队列的NSMutableDictionary对象和操作的NSOperationQueue对象。前者保存了哪些操作在操作队列中，然后多线程运行该操作。如果多线程操作取消了，那么也需要在操作队列中删除该操作。

 

接着，判断这个indexPath对应的记录在不在下载队列中，如果在，就不再二次操作了。如果不在，执行下载操作。

 

而这个下载操作的实现是一个非常关键的点。它需要多线程实现，并在完成后反馈到主线程中。多线程的实现方法有很多种，就我知道的有三种方式，分别是NSThread，NSOperation，Grand Central Dispatch (GCD)。

 

GCD的实现方法用来实现比较简单的逻辑，我不知道怎么调用delegate。

 

    dispatch_queue_timageQueue=dispatch_queue_create("hotelInfo.logo.imageQueue", NULL);

    

     dispatch_async(imageQueue, ^{

     NSData *imageData = [NSDatadataWithContentsOfURL:[hotel logoURL]];

    

     dispatch_async(dispatch_get_main_queue(),^{

    

    [hotelInfo setLogo:[UIImageimageWithData:imageData]];

    

     [resultTableView reloadRowsAtIndexPaths:[NSArrayarrayWithObject:indexPathWithLogo]withRowAnimation:UITableViewRowAnimationNone]; });

    

     });

 

NSOperation是在GCD基础上封装，使用更简单些。如果实现简单的逻辑，只需要用block;如果实现复杂的逻辑，也只需要以NSOperation为父类，重写main()方法即可。 NSOperation是一个抽象类。（我现在也不明白啥叫抽象类）

 

NSThread的实现方法，我没用过，不介绍了，自己gogole把。

 

在这里使用NSOperation的子类HotelImageDownloader来实现下载操作，再将这个HotelImageDownloader类定义对象加到NSOperationQueue中，实现后台下载操作。

将hotelInfo,indexPath和delegate传到该对象中去，这些是需要实现的操作的必备条件，并使用delegate回调到主线程，以更新UI。

 

HotelImageDownloader*imageDownloader = [[HotelImageDownloader alloc] initWithHotel:hotelatIndexPath:indexPathWithLogo delegate:self];

 

HotelImageDownloader的主要函数定义如下：

#pragmamark -

#pragmamark - Life Cycle

 

-(id)initWithHotel:(HotelInfo *)hotel atIndexPath:(NSIndexPath *)indexPathdelegate:(id<HotelImageDownloaderDelegate>)theDelegate

{

    if (self = [super init]) {

        // Set the properties.

        self.delegate = theDelegate;

        self.indexPathInTableView = indexPath;

        self.hotelInfo = hotel;

    }

    return self;

}

 

#pragmamark -

#pragmamark - Downloading image

 

// 3:Regularly check for isCancelled, to make sure the operation terminates as soonas possible.

-(void)main {

   

    // 4: Apple recommends using@autoreleasepool block instead of alloc and init NSAutoreleasePool, becauseblocks are more efficient. You might use NSAuoreleasePool instead and thatwould be fine.

   

    if (self.isCancelled)

        return;

   

    NSData *imageData = [[NSData alloc]initWithContentsOfURL:self.hotelInfo.logoURL];

   

    if (self.isCancelled) {

        imageData = nil;

        return;

    }

   

    if (imageData) {

        UIImage *downloadedImage = [UIImageimageWithData:imageData];

        self.hotelInfo.logo = downloadedImage;

    }

    else {

        self.hotelInfo.failed = YES;

    }

   

    imageData = nil;

   

    if (self.isCancelled)

        return;

   

    //   NSLog(@"performSelectorOnMainThread");

   

    // 5: Cast the operation to NSObject, andnotify the caller on the main thread.

    [(NSObject *)self.delegateperformSelectorOnMainThread:@selector(logoImageDownloaderDidFinish:)withObject:self waitUntilDone:NO];

   

}

 

代码[(NSObject*)self.delegate performSelectorOnMainThread:@selector(logoImageDownloaderDidFinish:)withObject:self waitUntilDone:NO];就是实现到主线程的回调，将HotelImageDownloader类的对象imageDownloader通过参数项"withObject:self"传回去，self就是imageDownloader对象，它的属性有hotelInfo信息和indexPath信息。通过这些信息实现WEB SERVICE的请求结果集hotelResults的更新和UITABLEVIEW对应的cell的更新（也就是更新uiimage）。

 

这个操作是使用delegate实现的，也有人用NSNotificationCenter实现。

 

它的大致实现过程是这样.

首先，在视图控制器类XYViewController中的viewDidLoad方法中增加一个通知。名称为@"hotelLogoDownloader.completed"。该通知在触发时，会调用一个方法"logoImageDownloaderDidFinish："。这个方法就是委托中需要实现的方法。

[[NSNotificationCenterdefaultCenter] addObserver:selfselector:@selector(logoImageDownloaderDidFinish:)name:@"hotelLogoDownloader.completed" object:nil];

其次，在HotelImageDownloader类中main()方法中，添加一个发送通知的代码，和这里调用delegate操作异曲同工。

 

NSDictionary*userInfo=[NSDictionary dictionaryWithObjectsAndKeys:[hotelobjectForKey:@"code"],@"code" ,nil];

[[NSNotificationCenterdefaultCenter] postNotificationName:@"hotelLogoDownloader.completed"object:self userInfo:userInfo];

通知提交操作的参数项"object:self"传回去，self就是imageDownloader对象，它的属性有hotelInfo信息和indexPath信息。

这样也实现了消息传递机制。

 

两个方法都是为了将消息传递到主线程，属于跨线程，跨方法的消息传递操作。

 

不管使用何种方式，在主线程的视图控制器类XYViewController中，都要实现方法"logoImageDownloaderDidFinish："的定义。

-(void)logoImageDownloaderDidFinish:(HotelImageDownloader *)downloader {

    NSLog(@"logoImageDownloaderDidFinishis executed");

 

    NSIndexPath *indexPath =downloader.indexPathInTableView;

    HotelInfo *theHotel = downloader.hotelInfo;

   

    [hotelResultsreplaceObjectAtIndex:indexPath.row withObject:theHotel];

 

    [resultTableView  reloadRowsAtIndexPaths:[NSArrayarrayWithObject:indexPath] withRowAnimation:UITableViewRowAnimationFade];

   

    [self.pendingOperations.downloadsInProgressremoveObjectForKey:indexPath];

}

这个方法就是用来实现WEB SERVICE的请求结果集hotelResults的更新和UITABLEVIEW对应的cell的更新（也就是更新uiimage），并且在最后结束将下载队列字典中该键和值删除。

该逻辑的实现代码是最后三行。

 代码[hotelResultsreplaceObjectAtIndex:indexPath.row withObject:theHotel];实现了根据行号更新数组hotelResults的对应行的记录。

 代码[resultTableView  reloadRowsAtIndexPaths:[NSArrayarrayWithObject:indexPath] withRowAnimation:UITableViewRowAnimationFade];实现uitableview的datasource方法的调用。

 这一方法会重新加载所指定indexPaths中的UITableViewCell实例，因为重新加载cell所以会请求这个UITableView实例的data source来获取新的cell;这个表会用动画效果让新的cell进入，并让旧的cell退出。会调用UITableViewDataSource协议中的所有方法来更新数据源，其中调用 (UITableViewCell *)tableView:(UITableView *)tableViewcellForRowAtIndexPath:(NSIndexPath *)indexPath ，只会调用所需更新的行数，来获取新的cell。此时该cell的-(void)setSelected:(BOOL)selected animated:(BOOL)animated将被调用，所设置的selected为NO;

 只是，不知道是只更新一个屏幕中正显示的cell还是会更新屏幕中正显示的所有的cell。

 

 如果屏幕上将hotelResults的所有的记录一屏都显示完了，那么事情到这里就结果了。但是，很遗憾，这不是PC终端，没有那么大的屏幕。就是PC终端，也有一个lazy load功能，没那么啥一下子请求所有的数据，也是一屏幕满了，你下拉才会显示剩下的内容。这是基于性能考虑的。 在iphone终端上，这种需求更强烈。应用不可能将hotelResults所有记录都先写到UI内存中，而是屏幕显示多少行，显示那些行，就写入到屏幕内存中。

 

 于是，新的问题就来了。

 

因为iphone屏幕会上下滚动，这是uitableview的最基本的功能。上下滚动操作过程中，屏幕上显示的hotelResults记录会变化。

如初始显示的是1-10行记录，下拉后显示的5-15行。 那么，前5行记录的logoImg信息，我们就不要再下载了，原来的下载操作队列需要取消，再增加11-15录的下载操作。如果下载了前行记录，再reloadRowsAtIndexPaths：withRowAnimation：操作时，那么显示操作就失败了，很明显没有办法更新屏幕了。

这个滚动操作，有uiscrollview的delegate实现，我们需要做的是将delegate的方法在主视图控制器类XYViewController中实现一下。

 

#pragmamark -

#pragmamark - UIScrollView delegate

 

-(void)scrollViewWillBeginDragging:(UIScrollView *)scrollView {

    [self.pendingOperations.downloadQueuesetSuspended:YES];

}

 

-(void)scrollViewDidEndDragging:(UIScrollView *)scrollViewwillDecelerate:(BOOL)decelerate {

    if (!decelerate) {

        [self loadImagesForOnscreenCells];

        [self.pendingOperations.downloadQueuesetSuspended:NO];

    }

}

 

-(void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView {

    // 3: This delegate method tells you thattable view stopped scrolling, so you will do the same as in #2.

   

   NSLog(@"scrollViewDidEndDecelerating");

    [self loadImagesForOnscreenCells];

   

    //[downloadLogoQueue setSuspended:NO];

    [self.pendingOperations.downloadQueuesetSuspended:NO];

   

   

}

 

 

 

#pragmamark -

#pragmamark - Cancelling, suspending, resuming queues / operations

 

-(void)loadImagesForOnscreenCells {

   

    NSSet *visibleRows = [NSSetsetWithArray:[resultTableView indexPathsForVisibleRows]];//现在展现在屏幕上的如6-15行

    NSMutableSet *pendingOperations =[NSMutableSet setWithArray:[self.pendingOperations.downloadsInProgressallKeys]];//正在下载队列的1-8行。

   

    NSMutableSet *toBeCancelled =[pendingOperations mutableCopy];

  

    NSMutableSet *toBeStarted = [visibleRowsmutableCopy];

   

    [toBeStarted minusSet:pendingOperations];//现在展现在屏幕上的如6-15行，减去，正在下载队列的1-8行。得到需要加到下载队列的行。

   

    [toBeCancelled minusSet:visibleRows];////正在下载队列的1-8行 ,减去,现在展现在屏幕上的如6-15行。得到需要取消下载队列的行。

   

    for (NSIndexPath *anIndexPath intoBeCancelled) {

        HotelImageDownloader *pendingDownload =[self.pendingOperations.downloadsInProgress objectForKey:anIndexPath];

        [pendingDownload cancel];//就是调用[NSOperationcancel]; 取消该operation操作。

       [self.pendingOperations.downloadsInProgressremoveObjectForKey:anIndexPath];

    }

    toBeCancelled = nil;

   

    for (NSIndexPath *anIndexPath intoBeStarted) {

        HotelInfo *hotelToProcess = [hotelInfosobjectAtIndex:anIndexPath.row];

        [selfstartOperationsForHotelLogo:hotelToProcess atIndexPath:anIndexPath];//执行多线程下载，美化等用于图片展现的操作。

    }

    toBeStarted = nil;

   

   

}

 

方法[selfstartOperationsForHotelLogo:hotelToProcess atIndexPath:anIndexPath]也是在” (UITableViewCell*)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath*)indexPath“方法中调用的。

视图滚动操作会刷新屏幕，也就是为调用”tableView:cellForRowAtIndexPath:“。那么，这里的bestarted调用是不是有点多余了，因为在tableView:cellForRowAtIndexPath:方法中，不是会自动调用"startOperationsForHotelLogo:atIndexPath:"方法吗？虽然这里调用了，在后来的也会因为(![self.pendingOperations.downloadsInProgress.allKeyscontainsObject:indexPathWithLogo])这个条件判断而不会加载到下载队列中去。但毕竟属于二次调用了。

2.总结

在这个逻辑实现过程中，涉及到众多知识点。其中delegate，uitableview,nsoperation,nsoperationqueue,nsxmlparser,NSNotificationCenter，也数组的深度复制，字典的处理等，

本文参考了http://www.raywenderlich.com/19788/how-to-use-nsoperations-and-nsoperationqueues。