Reader开发（二）增加PDF阅读功能

最近任务很多很忙，所以更新博客的速度很慢。

大概上周就为Reader加了一个PDF阅读的功能，但是一直没时间写上来。昨晚找一下文件发现扩展了功能的Demo居然在文件目录下看不到任何文件，但是却显示有文件大小，而且删除的时候还显示已锁定，应该不是文件被隐藏了的问题。没有办法之下，今天下午又重新把该功能在原来未修改过的Demo上写了回来，又花了一些时间。文件备份太重要了。

PDF文件和RTF，TXT这些格式的文件不同，这种文件中显示出的是图像而不是单纯的文字（就我肤浅的看法来看），这样Text Kit这个强大的文字处理引擎似乎就派不上用场了，不过可以使用官方给出的CGPDFDocumentRef和CGPDFPageRef类以及UIView的drawRect:方法来创建PDF文件和呈现PDF视图。

跟着之前Reader开发的思路，由于PDF的阅读视图是draw出来的，而RTF和TXT的阅读视图是直接使用AttributedString的，两者思路完全不同，如果将其阅读视图塞进一个ViewController中似乎会显得很乱，所以我新建了一个PDFViewController和一个PDFView类来专门管理PDF文件的阅读。

首先是在BookList表格中如果选中了PDF文件，那么跳转的目的视图控制器不是之前的ReadingViewController，而是新的PDFViewController，代码如下：

else if (indexPath.section == 2) { // pdf
        name = sPdfArray_[indexPath.row];
        PDFViewController *pdfVC = [[PDFViewController alloc] initWithPDFName:name];
        [self.navigationController pushViewController:pdfVC animated:YES];
        return;
    }

在这里使用导航控制器push了一个PDFViewController进栈，而不是present视图控制器了。

首先给出PDFViewController的接口部分，了解一下PDFViewController的成员结构：

#import <UIKit/UIKit.h>
#import "PDFView.h"

@interface PDFViewController : UIViewController
@property (strong, nonatomic) PDFView *curView;  // 当前PDF页面视图
@property (strong, nonatomic) PDFView *addView;  // 新的PDF页面视图
@property (strong, nonatomic) PDFView *backView; // 用于制造翻页效果的视图
@property (strong, nonatomic) UIScrollView *scrollView; // 滚动视图，用于显示完整的PDF页面
@property (retain, nonatomic) CAGradientLayer *shadow;  // 用于制造阴影效果的Layer
@property (retain, nonatomic) CAGradientLayer *margin;  // 用于制造页边效果的Layer
-(id)initWithPDFName:(NSString *)name; // 通过PDF文件名初始化
@end

以及匿名接口部分，里面包括一些私有的成员：

@interface PDFViewController ()
{
    BOOL next_;     // 是否翻向下一页
    BOOL enlarged_; // pdf视图是否被放大
    NSUInteger currentPage_; // 当前页号
    NSUInteger totalPages_;  // 总页数
    CGFloat startX_;    // 翻页手势起点的x值
    CGFloat curoffset_; // 翻页手势的位移值
    CGFloat minoffset_; // 翻页手势有效的最小位移值
    CGRect pdfRect_; // 完整的PDF页面的框架矩形
    CGRect fitRect_; // 适配后的PDF页面的框架矩形
    CGPDFDocumentRef pdfRef_;  // pdf文件
    CGPDFPageRef     pdfPage_; // pdf页面
}
@property (strong, nonatomic) UITapGestureRecognizer *doubleTap_; // 双击手势，用于查看完整的PDF页面
@property (strong, nonatomic) UIView *viewForPDF; // self.view中用于放置pdf阅读视图的子视图
@end

来看看PDFViewController的初始化方法：

#pragma mark -
#pragma mark Initialize

/* 通过PDF文件名初始化 */
-(id)initWithPDFName:(NSString *)name {
    self = [super init];
    if (self) {
        /* 根据pdf文件路径初始化pdf阅读视图 */
        NSString *filePath = [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:name]; // 获取PDF文件名的完整路径
        NSLog(@"filePath = %@", filePath); // 例如：filePath = /Users/one/Library/Application Support/iPhone Simulator/7.0/Applications/5815AD09-13F2-4C77-9CAE-ADD399E85A5E/PDFReader_i7_Demo.app/CGPDFDocument.pdf
        pdfRef_ = [self createPDFFromExistFile:filePath]; // 创建pdf文件对象
        pdfPage_ = CGPDFDocumentGetPage(pdfRef_, 1); // 创建pdf首页页面
        currentPage_ = 1; // 页号，从1开始
    }
    return self;
}

/* 根据文件路径创建pdf文件 */
- (CGPDFDocumentRef)createPDFFromExistFile:(NSString *)aFilePath {
    CFStringRef path;
    CFURLRef url;
    CGPDFDocumentRef document;
    
    path = CFStringCreateWithCString(NULL, [aFilePath UTF8String], kCFStringEncodingUTF8);
    url = CFURLCreateWithFileSystemPath(NULL, path, kCFURLPOSIXPathStyle, NO);
    CFRelease(path);
    
    document = CGPDFDocumentCreateWithURL(url);
    CFRelease(url);
    
    totalPages_ = CGPDFDocumentGetNumberOfPages(document); // 设置PDF文件总页数
    NSLog(@"totalPages = %d", totalPages_);
    if (totalPages_ == 0) { // 创建出错处理
        NSLog(@"Create Error");
        return NULL;
    }
    return document;
}

其中initWithPDFName:方法通过createPDFFromeExistFile:方法初始化了CGPDFDocumentRef类的对象。PDF文件对象的创建基本完成。

由于在阅读PDF阅读时要通过手势的移动来实现翻页，所以这里我沿用了之前的Touches in view的思路和框架，在PDFViewController的self.view中动态添加PDF阅读视图来实现阅读功能，那么就涉及到了PDFView类的使用，先看看初始化方法：

/* 初始化PDFView对象 */
- (id)initWithPDFRef:(CGPDFDocumentRef)pdfr {
    pdfRef = pdfr;
    pdfPage = CGPDFDocumentGetPage(pdfRef, 1); // 创建pdf首页页面
    self.pageIndex = 1; // 要展示的页面号，从1开始
    CGRect mediaRect = CGPDFPageGetBoxRect(pdfPage, kCGPDFMediaBox);
    self = [super initWithFrame:mediaRect];
    return self;
}

PDFView负责呈现PDF文件中的内容，PDFViewController负责控制PDFView的显示和布局。

注意PDFView是UIView类的子类，所以该类自带了一个drawRect:方法，要描绘出PDF的阅读内容，就必须要实现该方法：

/* drawRect:方法，每个UIView的自带方法 */
- (void)drawRect:(CGRect)rect {
    CGContextRef context = UIGraphicsGetCurrentContext(); // 获取当前的绘图上下文
    [[UIColor whiteColor] set];
    CGContextFillRect(context, rect);
    CGContextGetCTM(context);
    CGContextScaleCTM(context, 1, -1);
    CGContextTranslateCTM(context, 0, -rect.size.height);
    pdfPage = CGPDFDocumentGetPage(pdfRef, self.pageIndex);
    CGRect mediaRect = CGPDFPageGetBoxRect(pdfPage, kCGPDFCropBox);
    CGContextScaleCTM(context, rect.size.width / mediaRect.size.width, rect.size.height / mediaRect.size.height);
    CGContextTranslateCTM(context, -mediaRect.origin.x, -mediaRect.origin.y);
    CGContextDrawPDFPage(context, pdfPage); // 绘制当前页面
}

另外在翻页时PDFView的内容必须作出更新，可以使用setNeedsDisplay方法来实现，而该方法必须被PDFViewController调用，所以可以将其写成一个接口供其它类使用：

/* 更新视图，例如翻页的时候需要更新 */
- (void)reloadView {
    [self setNeedsDisplay];
}

接口部分：

@interface PDFView : UIView
{
    CGPDFDocumentRef pdfRef; // pdf文件
    CGPDFPageRef pdfPage;    // pdf页面
}
@property (assign, nonatomic) NSUInteger pageIndex; // 页面号
- (id)initWithPDFRef:(CGPDFDocumentRef)pdfr;
- (void)reloadView;
@end

完成PDFView的任务后，我们回到PDFViewController上来，首先当然是viewDidLoad:方法了：

- (void)viewDidLoad {
    [super viewDidLoad];
    
    /* 初始化参数 */
    minoffset_ = self.view.frame.size.width / 5.;
    enlarged_ = NO; // 初始的PDF视图的放大状态为NO
    
    
    /* 初始化视图 */
    self.navigationItem.title = [NSString stringWithFormat:@"%d / %d", currentPage_, totalPages_];
    curView  = [[PDFView alloc] initWithPDFRef:pdfRef_];
    addView  = [[PDFView alloc] initWithPDFRef:pdfRef_];
    backView = [[PDFView alloc] initWithPDFRef:pdfRef_];
    backView.pageIndex = 0;
    scrollView = [[UIScrollView alloc] initWithFrame:self.view.bounds];
    viewForPDF = [[UIView alloc] initWithFrame:CGRectMake(0., 60., self.view.frame.size.width, self.view.frame.size.height - 60.0)];
    
    
    /* 设置PDF阅读视图的页面布局 */
    CGFloat w = curView.frame.size.width;
    CGFloat h = curView.frame.size.height;
    pdfRect_  = curView.frame;
    CGFloat scale = h / w; // PDF原视图高度和宽度的比例
    NSLog(@"w = %f", w);
    NSLog(@"h = %f", h);
    CGFloat href = self.view.frame.size.width * scale; // 经过页面适配后的高度
    CGFloat yref = (self.view.frame.size.height - 60.0 - href) / 2.; // 经过页面适配后的原点y值
    NSLog(@"href = %f", href);
    NSLog(@"yref = %f", yref);
    curView.frame = CGRectMake(0., yref, self.view.frame.size.width, href); // 设置适配后PDF视图的位置和大小
    fitRect_ = curView.frame; // 保存适配后的框架矩形
    [self.view addSubview:viewForPDF];
    [viewForPDF addSubview:curView]; // 添加页面适配后的PDF视图
    
    
    /* 为视图添加双击手势 */
    doubleTap_ = [[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(enlargePDFPage:)];
    doubleTap_.numberOfTapsRequired = 2;
    [self.view addGestureRecognizer:doubleTap_];
}

在这里说一下设置PDF阅读视图的页面布局这一段吧，由于PDFView的drawRect:方法没有draw出最适合页面的显示，所以看到如下显示：

也就是在没有UIScrollView来呈现PDFView的情况下，我们只能看到PDF页面的部分视图（放大后的），由于我对CGContextDraw这些方法真的一点都不熟悉，所以只能通过设置PDFView的frame来解决该问题了。

首先获取初始的PDFView的视图尺寸并将其保存起来：

CGFloat w = curView.frame.size.width;
CGFloat h = curView.frame.size.height;
pdfRect_  = curView.frame;
2013-09-13 18:02:34.210 Reader_i7_Demo[2257:a0b] w = 612.000000
2013-09-13 18:02:34.211 Reader_i7_Demo[2257:a0b] h = 792.000000

然后通过宽高比例进行适配并将其保存起来：

    CGFloat scale = h / w; // PDF原视图高度和宽度的比例
    NSLog(@"w = %f", w);
    NSLog(@"h = %f", h);
    CGFloat href = 320. * scale; // 经过页面适配后的高度
    CGFloat yref = (510. - href) / 2.; // 经过页面适配后的原点y值
    NSLog(@"href = %f", href);
    NSLog(@"yref = %f", yref);
    curView.frame = CGRectMake(0., yref, self.view.frame.size.width, href); // 设置适配后PDF视图的位置和大小
    fitRect_ = curView.frame; // 保存适配后的框架矩形

来看看适配后的页面视图：

现在另一个问题来了，文字太小，看不到完整的pdf内容（以iPhone的尺寸来看），这个时候可以在视图中添加一个双击手势来显示完整的pdf内容：

    /* 为视图添加双击手势 */
    doubleTap_ = [[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(enlargePDFPage:)];
    doubleTap_.numberOfTapsRequired = 2;
    [self.view addGestureRecognizer:doubleTap_];

看看响应的方法：

/* 双击手势的响应方法 */
-(void)enlargePDFPage:(id)sender {
    if (enlarged_ == NO) { // 如果PDF页面未被放大
        [curView removeFromSuperview];     //首先移除当前PDF页面
        [self.view addSubview:scrollView]; // 在self.view中添加scrollView
        [scrollView addSubview:curView];   // 在scrollView上重新添加curView
        curView.frame = pdfRect_; // 设置curView的框架为原始PDF视图的框架
        scrollView.contentSize = pdfRect_.size; // 设置scrollView的内容尺寸
        enlarged_ = YES; // 设置放大状态
        self.navigationController.navigationBarHidden = YES; // 隐藏导航条
    }
    else { // 如果PDF页面已经被放大
        [scrollView removeFromSuperview]; // 移除scrollView和curView
        [viewForPDF addSubview:curView]; // 在viewForPDF子视图重新添加curView
        curView.frame = fitRect_;
        enlarged_ = NO; // 取消放大状态
        self.navigationController.navigationBarHidden = NO; // 显示导航条
    }
}

这样一来，在双击视图后，就可以查看全屏状态下的pdf视图了：

在全屏状态下再次双击视图，又看到原来的PDFView了：

最后解决一下翻页的问题，这里我沿用了之前的方法：

#pragma mark -
#pragma mark Touches in view

-(void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event {
    //记录手势起点的x值
    UITouch *touch = [touches anyObject];
    startX_        = [touch locationInView:self.view].x;
}

-(void)touchesMoved:(NSSet *)touches withEvent:(UIEvent *)event {
    //将视图中已经存在的渐变或页边阴影去掉
    if (shadow) {
        [shadow removeFromSuperlayer];
    }
    if (margin) {
        [margin removeFromSuperlayer];
    }
    
    //获取当前手势触点的x值
    UITouch *touch = [touches anyObject];
    float x        = [touch locationInView:self.view].x;
    if (x - startX_ >= 0) {
        curoffset_ = x - startX_;
    }
    else {
        curoffset_ = startX_ - x;
    }
    
    // 设定翻转页面的矩形范围
    CGRect rect = self.view.bounds;
    if (x >= 160) {
        rect.size.width = (320 / x - 1) * 160;
        rect.origin.x   = x - rect.size.width;
    }
    else {
        rect.size.width = 320 - x;
        rect.origin.x   = x - rect.size.width;
    }
    int tempX           = rect.origin.x; //保存翻转页面起点的x值
    backView.frame      = rect;
    
    //rect用于设定翻页时左边页面的范围
    rect = self.view.bounds;
    rect.size.width = x;
    
    
    // 判断手势并设定页面，制造翻页效果
    if (x - startX_ > 0) { //向右划的手势，上一页
        next_ = NO;
        if (currentPage_ == 1) {
            return; // 如果是第一页则不接受手势
        }
        else {
            addView.frame = rect;
            addView.clipsToBounds = YES;
            addView.pageIndex = currentPage_ - 1;
            [addView reloadView];
            
            [viewForPDF insertSubview:addView aboveSubview:curView];
            
            [viewForPDF insertSubview:backView aboveSubview:addView];
        }
    }
    else { //向左划的手势，下一页
        next_ = YES;
        
        if (currentPage_ == totalPages_) {
            return; // 如果到达最后一页则不接受手势
        }
        else {
            curView.frame = rect;
            addView.pageIndex = currentPage_ + 1;
            addView.frame = fitRect_;
            [addView reloadView];
            
            [viewForPDF insertSubview:addView belowSubview:curView];
            
            [viewForPDF insertSubview:backView aboveSubview:curView];
        }
    }
    
    //设定翻页时backPage视图两边的渐变阴影效果
    shadow            = [[CAGradientLayer alloc] init];
    shadow.colors     = [NSArray arrayWithObjects:
                         (id)[UIColor colorWithRed:1.0 green:1.0 blue:1.0 alpha:0.1].CGColor,
                         (id)[UIColor colorWithRed:0.0 green:0.0 blue:0.0 alpha:0.2].CGColor,
                         (id)[UIColor colorWithRed:1.0 green:1.0 blue:1.0 alpha:0.1].CGColor,
                         nil];
    rect              = self.view.bounds;
    rect.size.width   = 50;
    rect.origin.x     = x - 25;
    shadow.frame      = rect;
    shadow.startPoint = CGPointMake(0.0, 0.5);
    shadow.endPoint   = CGPointMake(1.0, 0.5);
    [self.view.layer addSublayer:shadow];
    
    margin            = [[CAGradientLayer alloc] init];
    margin.colors     = [NSArray arrayWithObjects:
                         (id)[UIColor colorWithRed:1.0 green:1.0 blue:1.0 alpha:0.2].CGColor,
                         (id)[UIColor colorWithRed:0.0 green:0.0 blue:0.0 alpha:0.3].CGColor,
                         nil];
    margin.frame      = CGRectMake(tempX - 35, 0, 50, self.view.bounds.size.height);
    margin.startPoint = CGPointMake(0.0, 0.5);
    margin.endPoint   = CGPointMake(1.0, 0.5);
    [self.view.layer addSublayer:margin];
}

-(void)touchesEnded:(NSSet *)touches withEvent:(UIEvent *)event {
    // 如果是第一页并且翻向上一页
    if (currentPage_ == 1) {
        if (next_ == NO) {
            return;
        }
    }
    
    // 如果是最后一页并且翻向下一页
    if (currentPage_ == totalPages_) {
        if (next_ == YES) {
            UIAlertView *av = [[UIAlertView alloc] initWithTitle:@"注意" message:@"已经到达最后一页" delegate:nil cancelButtonTitle:@"确定" otherButtonTitles:nil, nil];
            [av show];
            return;
        }
    }
    
    if (curoffset_ < minoffset_) {
        curView.frame = fitRect_;
        curView.pageIndex = currentPage_ ;
        [curView reloadView];
        
        [addView  removeFromSuperview];
        [backView removeFromSuperview];
        
        //移除阴影效果
        [shadow removeFromSuperlayer];
        [margin removeFromSuperlayer];
        
        return;
    }
    
    if (next_ == YES) { // 下一页
        currentPage_++;
        NSLog(@"%d / %d", currentPage_, totalPages_);
        curView.frame = fitRect_;
        curView.pageIndex = currentPage_;
        [curView reloadView];
        
        self.navigationItem.title = [NSString stringWithFormat:@"%d / %d", currentPage_, totalPages_];
    }
    else { // 上一页
        currentPage_--;
        NSLog(@"%d / %d", currentPage_, totalPages_);
        curView.frame = fitRect_;
        curView.pageIndex = currentPage_;
        [curView reloadView];
        
        self.navigationItem.title = [NSString stringWithFormat:@"%d / %d", currentPage_, totalPages_];
    }
    
    [addView  removeFromSuperview];
    [backView removeFromSuperview];
    
    //移除阴影效果
    [shadow removeFromSuperlayer];
    [margin removeFromSuperlayer];
}

原理和Reader开发（一）中的翻页效果原理是一样的，最后还是上张程序运行的图：

至此，实现PDF阅读的基本功能已经实现，不需要考虑分页的问题，对于获取PDF上面的内容可能要用到Core Text，这样可能要用另一种思维来写，暂时到此为止吧，如果对于这方面有什么新想法我会继续改进并且更新博客的。

以上关于PDF文件阅读的代码参考了网上的一些文章，大家也可以参考一下：

http://blog.csdn.net/yiyaaixuexi/article/details/7645725

http://2015.iteye.com/blog/1333272

http://www.cnblogs.com/mainPage/archive/2010/10/22/1858666.html