cornerstone系列 - 预加载和request pool(请求池)

先说说需求场景,由于界面上可以显示n*n(n最大4)布局区域的图像序列,每个序列可能有上百张图像,首先肯定是把每个序列的第一张图像加载出来,剩下的image就慢慢整,所以需要做一个预加载的策略。

理一下思路

首先需要一个请求池,放所有准备加载的图像,然后在操作过程中肯定会带来一些顺序的变动(比如对第四个序列滚动到了第20张图像,那肯定这张图像就最优先加载)所以需要有权重。检查可能会切换,所以需要重置请求池的方法。还需要可配置并发数量,因为某些影像会很大,就一张一张加载比较高效。原本获取image的地方,都是调用 loadAndCacheImage 方法,现在要统一管理所有请求,需要改成调用loadAndCacheImagePlus。最后由于还有个进度条的功能(预加载的进度条,每个序列的缩略图上显示),所以成功后需要有回调,也放在配置里。所以需要提供 捋一下大概:

  • 请求池(初始化、添加、重置、轮训、并发数)
  • 权重(排序)
  • 初始化的配置(并发数,成功的回调)
  • 提供一个 loadAndCacheImagePlus 方法来代替 loadAndCacheImage 获取图像数据

cornerstoneTools源码里有个 requestPoolManager 文件,看了一下就是请求池的管理,大体思路是一样的,不过它这儿没有真正的权重,它的权重是靠 loadImage 时的 priority 配置,去看了下具体的实现,这个权重是计算层面的,不是请求层面的,请求还是发出去了,所以不好直接使用人家的这个请求管理。

实现

请求池是一个大的概念,囊括了各种请求的统一调度,定义为TaskHelper 。目前这边只有图像的加载,所以再专门新建 cornerstone-image-request 来写图像请求的逻辑。

task-helper

1.请求池
taskPool存放请求,每个请求是一个对象,包含唯一标识的key、execute执行函数、priority权重等,execute执行函数需要是个promise,因为调用的地方需要等待请求池执行结果。

2.轮训
请求池需要有轮训机制,初始化后就开始轮训检查taskPool中是否有需要处理的请求,有的话就停止轮训,执行完剩余并发数量的请求,然后再重新开始轮训。

3.cachedTask
比如序列的第一张图像和它的缩略图都要加载,此时都在加载队列中等待,所以此时有两个promise在等待结果,所以需要一个对象来记录每个task的额外属性(比如subscribe、extra,以免新的task进来后丢失了原来的数据)

4.权重
轮训检测到有内容则开始执行executeTask,每次执行前先按权重排序,因为addTask时有可能会塞进来高权重的,就要在执行的时候换到前面来。

剩下的逻辑都比较清晰就不赘述了....(大体代码如下)

// task-helper.js
let taskPool = []; // 请求池
let numRequest = 0; // 正在执行数量
let maxRequest = 4; // 可配置
let taskTimer; // 轮训的定时器
let cachedTask = {}; // 存放的任务数据

// 预加载池的添加
function addTaskIntoPool(task) {
    return new Promise((resolve, reject) => {
        const cache = cachedTask[task.key];
        const subscribe = (executeRes) => {
            if (executeRes.success) {
                resolve(executeRes.res)
            } else {
                reject(executeRes.err)
            }
        };
        const priority = (task.priority || task.priority === 0) || 999;
        if (cache) {
            cache.priority = priority;
            const callbacks = cache.callbacks || [];
            callbacks.push(subscribe)
        } else {
            task.callbacks = [subscribe]
            cachedTask[task.key] = task;
            taskPool.push(task);
        }
    })
}
// 执行下载
function executeTask() {
    if (taskPool.length > 0) {
        sortTaskPool();
        const executeRequest = maxRequest - numRequest;
        if (executeRequest > 0) {
            for ( let i = 0; i < executeRequest; i++ ) {
                const task = taskPool.shift();
                if (!task) {
                    return
                }
                numRequest++;
                task.execute().then((res) => {
                    numRequest--;
                    task.callbacks && task.callbacks.map(callback => {
                        callback({success: true, res})
                    });
                    executeTask();
                }, (err) => {
                    numRequest--;
                    task.callbacks && task.callbacks.map(callback => {
                        callback({success: false, err})
                    });
                    delete cachedTask[task.key];
                    executeTask();
                })
            }
        }
    } else {
        startTaskTimer();
    }
}
// 轮训检查请求池中是否有请求需要执行
function startTaskTimer() {
    taskTimer = setInterval(() => {
        if (taskPool.length > 0) {
            stopTaskTimer();
            executeTask();
        }
    }, 500)
}
// 停止轮训
function stopTaskTimer() {
    clearInterval(taskTimer);
    taskTimer = null;
}
....
2.cornerstone-image-request

拿到序列数据后调用初始化task-helper的请求池,携带什么额外的配置都是自由逻辑,对于task-helper来说都是黑的,比如下面的extra,就是希望在成功回调时知道这个图像是哪个序列的,方便做进度条。

import { addTaskIntoPool } from './task-helper';
function addTaskPool(series) {
    lodash.forEach(series, (item) => {
        if (item && item.imageIds) {
            lodash.forEach(item.imageIds, (imageId) => {
                const imageTask = buildImageRequestTask(imageId, {
                    extra: { series: item.seriesInstanceUID }
                });
                addTaskIntoPool(imageTask)
            })
        }
    });
}

这儿主要的是提供 loadAndCacheImagePlus 方法出来,先看下cornerstone的imageCache中有没有,有的话直接用,没有就调用task-helper的 addTaskIntoPool 把任务添加到请求池中。

priority=999是因为这个方法是用来代替loadAndCacheImage的,调用这方法的地方都是要直接获取数据,所以优先级是最高的。

由于cornerstone.loadAndCacheImage是个promise,直接当做execute就执行了(虽然promise是pending),所以要再包一层,最终还是个promise就行。

function loadAndCacheImagePlus(imageId, priority = 999) {
    return new Promise((resolve, reject) => {
        const imageLoadObject = cornerstone.imageCache.getImageLoadObject(imageId);
        if (imageLoadObject) {
            imageLoadObject.promise.then((image) => {
                resolve(image);
            }, (err) => {
                reject(err);
            })
        } else {
            const imageTask = buildImageRequestTask(imageId, { priority })
            addTaskIntoPool(imageTask).then((res) => {
                resolve(res)
            }).catch(e => {
                reject(e)
            })
        }
    });
}

function buildImageRequestTask(imageId, config = {}) {
    return {
        key: imageId,
        ...config,
        execute: () => {
            return cornerstone.loadAndCacheImage(imageId)
        }
    };
}

最后

简单的可控制的请求池就这样子了,可以满足我们目前的需求,需要改进的是错误的机制和重试机制,还有别的请求的兼容等,需要细细考虑完善。

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

推荐阅读更多精彩内容