从Samples中入门IOS开发（三）------ 文档浏览

IOS提供了对各种文档（PDF, PPT, word, txt, jpg等）的浏览功能，这个非常使用，因为我们难免需要app里浏览各种文档。官方的Sample code DocInteraction展示了如何在IOS浏览各种格式的文档。

本Sample非常简单，在tableview里列出了预定的和制定目录下的文档列表，点击某个文档时，能切换view并预览文档内容：

从这个sample里能学到的关键点是：

• 从文件目录中载入文件列表
• 监控文档目录中文件的变动，并实时反馈在UI上
• 预览各种文档内容

从文件目录中载入文件列表

IOS提供了NSFileManager来访问文件系统，从以下代码能很清晰地了解到如何通过NSFileManager查询某个目录路径下所有所有文件：

- (void)directoryDidChange:(DirectoryWatcher *)folderWatcher{[self.documentURLs removeAllObjects];    // clear out the old docs and start overNSString *documentsDirectoryPath = [self applicationDocumentsDirectory];NSArray *documentsDirectoryContents = [[NSFileManager defaultManager] contentsOfDirectoryAtPath:documentsDirectoryPath error:NULL];    for (NSString* curFileName in [documentsDirectoryContents objectEnumerator]){NSString *filePath = [documentsDirectoryPath stringByAppendingPathComponent:curFileName];NSURL *fileURL = [NSURL fileURLWithPath:filePath];BOOL isDirectory;        [[NSFileManager defaultManager] fileExistsAtPath:filePath isDirectory:&isDirectory];        // proceed to add the document URL to our list (ignore the "Inbox" folder)        if (!(isDirectory && [curFileName isEqualToString: @"Inbox"]))        {            [self.documentURLs addObject:fileURL];        }}[self.tableView reloadData];}

在UI上展现文件列表就是通过tableView的datasource来完成，在上一节的分享中已分析此部分，此时只需reloadData刷新一下即可。

监控文档目录中文件的变动，并实时反馈在UI上

对文件目录的监控本例子是借助系统内核函数来完成，先看代码：

- (BOOL)startMonitoringDirectory:(NSString *)dirPath{// Double initializing is not going to work...if ((dirKQRef == NULL) && (dirFD == -1) && (kq == -1)){// Open the directory we're going to watchdirFD = open([dirPath fileSystemRepresentation], O_EVTONLY);if (dirFD >= 0){// Create a kqueue for our event messages...kq = kqueue();if (kq >= 0){struct kevent eventToAdd;eventToAdd.ident  = dirFD;eventToAdd.filter = EVFILT_VNODE;eventToAdd.flags  = EV_ADD | EV_CLEAR;eventToAdd.fflags = NOTE_WRITE;eventToAdd.data   = 0;eventToAdd.udata  = NULL;int errNum = kevent(kq, &eventToAdd, 1, NULL, 0, NULL);if (errNum == 0){CFFileDescriptorContext context = { 0, self, NULL, NULL, NULL };CFRunLoopSourceRef      rls;// Passing true in the third argument so CFFileDescriptorInvalidate will close kq.dirKQRef = CFFileDescriptorCreate(NULL, kq, true, KQCallback, &context);if (dirKQRef != NULL){rls = CFFileDescriptorCreateRunLoopSource(NULL, dirKQRef, 0);if (rls != NULL){CFRunLoopAddSource(CFRunLoopGetCurrent(), rls, kCFRunLoopDefaultMode);CFRelease(rls);CFFileDescriptorEnableCallBacks(dirKQRef, kCFFileDescriptorReadCallBack);// If everything worked, return early and bypass shutting things downreturn YES;}// Couldn't create a runloop source, invalidate and release the CFFileDescriptorRefCFFileDescriptorInvalidate(dirKQRef);                        CFRelease(dirKQRef);dirKQRef = NULL;}}// kq is active, but something failed, close the handle...close(kq);kq = -1;}// file handle is open, but something failed, close the handle...close(dirFD);dirFD = -1;}}return NO;}

这段代码基本上都是对内核c函数的使用，虽然有些晦涩，但流程还是很简单的，首先是对系统事件的监控，然后基于IOS的thread框架来callback文件目录变动后的回调，回调的具体内容实现在KQCallback中，此方法也非常简单，实际上就是基于Delegate模式调用到上一段的directoryDidChange方法，继而刷新tableview的内容。具体的c函数的用法这里就不多说，但值得我们学习的是如何在IOS的层面上调用底层BSD系统API。

预览各种文档内容

本例子中最核心的点反而是最简单的，IOS提供了QLPreviewController，通过此controller能直接得到预览各种文档的view，你只需要把view塞到navigationController中即可，代码如下：

- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath{    NSURL *fileURL;    if (indexPath.section == 0)    {        fileURL = [NSURL fileURLWithPath:[[NSBundle mainBundle] pathForResource:documents[indexPath.row] ofType:nil]];    }    else    {        fileURL = [self.documentURLs objectAtIndex:indexPath.row];    }    [self setupDocumentControllerWithURL:fileURL];    [self.docInteractionController presentPreviewAnimated:YES];        QLPreviewController *previewController = [[QLPreviewController alloc] init];    previewController.dataSource = self;    previewController.delegate = self;        // start previewing the document at the current section index    previewController.currentPreviewItemIndex = indexPath.row;    [[self navigationController] pushViewController:previewController animated:YES];    [previewController release];}

具体如何设定预览的内容和行为，是在QLPreviewControllerDelegate和QLPreviewControllerDataSource中完成的，所以这里只需要在controller中实现QLPreviewControllerDelegate和QLPreviewControllerDataSource相关方法即可：

// Returns the number of items that the preview controller should preview- (NSInteger)numberOfPreviewItemsInPreviewController:(QLPreviewController *)previewController{    NSInteger numToPreview = 0;        NSIndexPath *selectedIndexPath = [self.tableView indexPathForSelectedRow];    if (selectedIndexPath.section == 0)        numToPreview = NUM_DOCS;    else        numToPreview = self.documentURLs.count;        return numToPreview;}// returns the item that the preview controller should preview- (id)previewController:(QLPreviewController *)previewController previewItemAtIndex:(NSInteger)idx{    NSURL *fileURL = nil;        NSIndexPath *selectedIndexPath = [self.tableView indexPathForSelectedRow];    if (selectedIndexPath.section == 0)    {        fileURL = [NSURL fileURLWithPath:[[NSBundle mainBundle] pathForResource:documents[idx] ofType:nil]];    }    else    {        fileURL = [self.documentURLs objectAtIndex:idx];    }        return fileURL;}

第一个方法是设定一组文档浏览的个数，会影响到在文档预览中的上/下一页，第二个方法是指定文档预览的文件路径，由此可见在IOS中预览各种文档是件很简单的事儿，并且可预览的格式非常广，只要在mac的预览能支持的，这里都能支持，简单测试后发现基本能支持所有常规文档。