react-native RCTImage源码初解析(iOS)

简单时序图

注:为了便于理解,把 RCTImageLoader 的几个方法当做独立对象对待了(用方框框出来的是三个 RCTImageLoader 对象方法)。

RCTImage_Sequence_Diagram.jpg

本文是基于 react-native 0.37.0 版本进行分析的。

RCTImageView

  • 1、初始化
- (instancetype)initWithBridge:(RCTBridge *)bridge NS_DESIGNATED_INITIALIZER;
  • 2、通过 setProps(这个 props 就是我们在 JS 里为 <Image> 标签设定的属性值,其中就包括 URI) 调到了setResizeMode:
- (void)setResizeMode:(RCTResizeMode)resizeMode
  • 3、setResizeMode: 调到了 reloadImage
- (void)reloadImage
  • 4、reloadImage 先做了两件事:1、cancelImageLoad。2、imageSourceForSize。
- (void)cancelImageLoad
  • cancelImageLoad里如果有之前保存的 _reloadImageCancellationBlock,则执行该 block,并且置为 nil,同时将 _pendingImageSource 置为 nil。
  • imageSourceForSize,如果传进来的 size 是(0,0),直接返回 nil,如果不是,则找一个最合适的 RCTImageSource。
  • 然后 reloadImage 如果获取到了合适的 RCTImageSource 则进入下载流程,否则 clearImage。
if (source && self.frame.size.width > 0 && self.frame.size.height > 0) {
    // 篇幅原因隐藏了接下来要讲的代码
}
  • 定义了三个回调:progressHandler、partialLoadHandler、completionHandler,用于下载进度、部分下载、下载完成调用。将三个 block 作为参数和 source、size、resizeMode 一起通过 imageLoader 的 loadImageVithURLRequest:传递给 imageLoader。并且用 _reloadImageCancellationBlock 接收该方法的返回值(上面提到的 cancelImageLoad 里调用的就是这个 block)
RCTImageLoaderProgressBlock progressHandler
RCTImageLoaderPartialLoadBlock partialLoadHandler
RCTImageLoaderCompletionBlock completionHandler
_reloadImageCancellationBlock =
    [_bridge.imageLoader loadImageWithURLRequest:source.request
                                            size:imageSize
                                           scale:imageScale
                                         clipped:NO
                                      resizeMode:_resizeMode
                                   progressBlock:progressHandler
                                partialLoadBlock:partialLoadHandler
                                 completionBlock:completionHandler];

注:这里还不知道我们要加载的图片是来自网络还是来自本地(这里是 RN 所有图片的入口)。

RCTImageLoader

  • 5、loadImageWithURLRequest:先定义一个 cancelLoad 回调用于接收 _loadImageOrDataWithURLRequest: 或 decodeImageData: 的返回值。 cancellationBlock 返回给调用方,再定义一个 completionHandler 传递给 _loadImageOrDataWithURLRequest:
__block dispatch_block_t cancelLoad
dispatch_block_t cancellationBlock
void (^completionHandler)(NSError *, id, BOOL, NSString *)
  • cancellationBlock 里调用了上面定义的 cancelLoad 回调,并且在线程锁内修改表示变量 cancelled 的值。
  • completionHandler 里先判断是否被取消或者 self 有没有被释放,然后判断如果 imageData为nil 或者 imageData 已经是 UIImage 类型就直接回调给调用方并且return。completionHandler 接受 4 个参数:

^(NSError *error, id imageOrData, BOOL cacheResult, NSString *fetchDate) {}

  • cacheResult 是 _loadImageOrDataWithURLRequest: 回传过来的表示图片(本地图片)是否有缓存,如果有则查找缓存并对调给调用方并且return,没有则定义一个 decodeCompletionHandler 并且执行 decodeImageData(后文再讲),用刚才定义的 cancelLoad 接收返回值。
cancelLoad = [self _loadImageOrDataWithURLRequest:imageURLRequest
                                                 size:size
                                                scale:scale
                                           resizeMode:resizeMode
                                        progressBlock:progressBlock
                                     partialLoadBlock:partialLoadBlock
                                      completionBlock:completionHandler];
  • 6、_loadImageOrDataWithURLRequest 是一个 返回值为 RCTImageLoaderCancellationBlock 的方法。
  • _loadImageOrDataWithURLRequest,先根据 URL 通过 imageURLLoaderForURL: 查找最合适的 id<RCTImageURLLoader> loadHandler (loadHandler 为本地图片加载器,后文讲它是怎么来的),然后也定义了一个 completionHandler,这个 block 接收3个参数:error、imageOrData、fetchDate,在 completionHandler 里判断如果当前线程为主线程并且 imageData 不是 UIImage 类型则扔到全局队列里回调给调用方(即loadImageWithURLRequest:方法的 completionHandler),否则直接回调给调用方。
id<RCTImageURLLoader> loadHandler = [self imageURLLoaderForURL:request.URL];
void (^completionHandler)(NSError *, id, NSString *)
  • 7、接下来开始加载图片,如果有 loadHandler 则执行本地图片加载,否则执行网络下载。
if (loadHandler) {
    cancelLoad = [loadHandler loadImageForURL:request.URL
                                                 size:size
                                                scale:scale
                                           resizeMode:resizeMode
                                      progressHandler:progressHandler
                                   partialLoadHandler:partialLoadHandler
                                    completionHandler:^(NSError *error, UIImage *image) {
                                        completionHandler(error, image, nil);
                                    }];
} else {
    // Use networking module to load image
    cancelLoad = [strongSelf _loadURLRequest:request
                                       progressBlock:progressHandler
                                     completionBlock:completionHandler];
}
  • 8、看网络图片加载部分,先定义一个
RCTURLRequestCompletionBlock processResponse

它接收三个参数:

^(NSURLResponse *response, NSData *data, NSError *error)

processResponse 里面判断网络状态码并且把 data 回调给调用方(_loadImageOrDataWithURLRequest),然后 RCTNetworking 开始网络请求图片。下载完成后就开始了层层回调。

  • 一直回调到步骤 5 这里执行 decodeImageData:
  • 9、completionHandler,先定义一个 completionHandler 接受两个参数(error,image)并且在非主线程队列回调给调用方,然后去查找一个(本地)图片 decoder,如果没有则在 _URLRequestQueue 队列里进行解码,解码完成 completionHandler(error,image)。
  • 现在回到步骤 7,看下 loadHandler 是个什么鬼。
    // Find suitable image URL loader
    id<RCTImageURLLoader> loadHandler = [self imageURLLoaderForURL:request.URL];

可以看到 loadHandler 是这么来的,进去 imageURLLoaderForURL: 方法里发现 loadHandler 是从一个 _loaders 的数组里挑选出来的,_loaders 数组是怎么来的呢,继续看代码:

_loaders = [[_bridge modulesConformingToProtocol:@protocol(RCTImageURLLoader)] sortedArrayUsingComparator:^NSComparisonResult(id<RCTImageURLLoader> a, id<RCTImageURLLoader> b) {
            float priorityA = [a respondsToSelector:@selector(loaderPriority)] ? [a loaderPriority] : 0;
            float priorityB = [b respondsToSelector:@selector(loaderPriority)] ? [b loaderPriority] : 0;
            if (priorityA > priorityB) {
                return NSOrderedAscending;
            } else if (priorityA < priorityB) {
                return NSOrderedDescending;
            } else {
                return NSOrderedSame;
            }
        }];

关键代码:

[_bridge modulesConformingToProtocol:@protocol(RCTImageURLLoader)]

继续往里跟:

- (NSArray *)modulesConformingToProtocol:(Protocol *)protocol
{
  NSMutableArray *modules = [NSMutableArray new];
  for (Class moduleClass in self.moduleClasses) {
    if ([moduleClass conformsToProtocol:protocol]) {
      id module = [self moduleForClass:moduleClass];
      if (module) {
        [modules addObject:module];
      }
    }
  }
  return [modules copy];
}

画重点:conformsToProtocol: 方法是检查某个对象以及它的祖先有没有实现某个方法。self.moduleClasses 是个什么东西呢,它是所有遵守了 RCTBridgeModule 协议及 RCTBridgeModule 子孙协议的 Class 的集合。这个集合里面遵守了 RCTImageURLLoader 协议的有两个 RCTLocalAssetImageLoader 和 RCTPhotoLibraryImageLoader。

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

推荐阅读更多精彩内容