文档章节

学习 kityminder (十五) save

刘军兴
 刘军兴
发布于 2015/12/15 11:06
字数 778
阅读 110
收藏 0

本次学习 kityminder save 功能.

回顾 core/data.js:

// 注册一个(用于导入/导出的)协议.
exports.registerProtocol = function(name, protocol) {
  _protocols[name] = protocol;  // 放到一个集合中.
}

extend class Minder {
  exportJson(): // 导出当前脑图数据为 JSON 对象.
    // 方法是从根节点开始递归所有节点, 每个节点导出为一个 json 对象, 子节点组成一个数组.
  importNode(node, json): // 根据 json 数据转换成脑图节点.
  exportData(protocol_name, option): // 使用指定协议导出, 一会研究细节.
  importData(protocol_name, data, option):  // 使用指定协议导入.
}

协议的注册/获取比较简单. 由于 json 格式比较容易, 我们不如先研究 json 格式的 protocol.

找到 protocol/json.js 查看, 果然十分简单:

// 注册名为 'json' 的导入/导出协议.
data.registerProtocol('json', {
  fileDescription: 'KityMinder 格式', // 格式名.
  fileExtension: '.km',  // 文件后缀.
  ... dataType, mineType (应是 mime 拼写错?) 略...

  
  encode(json): // 编码函数, 对象->字符串. 使用内建 JSON 对象实现.
  decode(local): // 解码函数, 字符串->对象.
});

这里重点是提供了 encode(), decode() 两个函数, 分别对应导出, 导入. 如果未提供 decode(), 就表示不支持导入.

现在再细看 exportData(protocol-name, option) 方法, 步骤大致是:

Minder.prototype.exportData = function(protocol_name, option) {
  // 第一步先导出为 json 格式.
  var json = this.exportJson();

  // 如果指定了 protocol_name, 则检查该协议, 及是否支持导出.
  if (protocol_name) ... // 不支持则抛出异常.

  // 发布 'before-export' 事件.
  this.fire('beforeexport', ...);

  // 导出为指定格式数据.
  var encoded_data = protocol.encode(json, ...);
  return Promise.resolve(encoded_data); // 此调用暂时不明
}

 

如果忽略掉 Promise, 则其它都简单易解. 我们在 console 中试着使用此函数, 可看到结果:

 

这样, 如果我们要开发将数据存到 localStorage 或服务器上的功能, 只需使用 exportJson() 或 exportData()
将数据导出为 json 格式即可. 其它格式可选.

 

以前曾经忽略的 promise 不弄明白是不行啊, 总是跳出来挡路, 那今天就去查查它是做什么的.
打开 core/promise.js, 里面注释写着 Thenable - Embedded Minimum Strictly-Compliant Promises.
源码位于 http://github.com/rse/thenable, 让我们去找找有没有文档. 顺便找到一个不错的中文介绍:http://www.csdn.net/article/2014-05-28/2819979-JavaScript-Promise

看起来是为了解决多个回调(callback) 组成的金字塔(层层回调)问题.

认识一下 Promise/A+ 规范:

1. 一个 promise 可能有三种状态: 等待 (pending), 已完成 (fulfilled), 已拒绝(rejected)
2. 状态只能从 pending->fulfilled|rejected, 不能其它转换, 也不能逆向转换.
3. promise 必须实现 then 方法, 而且 then 必须返回一个 promise ...
4. then 方法接受两个参数: on_success, on_error: 成功时回调, 失败时回调.

使用示例:

function run() {
  getData('abc.json')
    .then(handle_json) // 返回一个 thenable 的对象
    .then(sleep(300))
    .then(show_next);
}

 

后面看到重点, 现今流行的各大 js 库, 几乎都不同程度的实现了 Promise, 只是暴露出来的大都是 Deferred 对象.
原来 Promise 是 Deferred 换了个名字么?

优点: Promise 用法很简单, 组织的代码很清晰, 从此不用再受 callback 的折磨了.

看来有空要多看类库源码......

 

© 著作权归作者所有

共有 人打赏支持
刘军兴
粉丝 54
博文 184
码字总数 226359
作品 0
昌平
百度脑图解析:如何进行web复杂应用的渐进式开发

内容来源:2017 年 4 月 8 日,张博在“HTML5梦工场 & 微软开发者沙龙第05期—持续集成”进行《Web复杂应用的 「渐进式」开发》演讲分享。IT 大咖说(微信id:itdakashuo)作为独家视频合作方...

06/04
0
0
学习 kityminder 笔记(五)

接着学习 kityminder, 前面其实没看完 kity, 大致了解之后, 我们先看看 minder 部分, 两者结合起来学更好些. 下载 kityminder-core (按文档说只含核心部分), 从 git-hub, 建立起开发/构造环境...

刘军兴
2015/11/19
0
0
学习 kityminder 笔记(六)

接上篇, 接着学习 kityminder. == core/keyreceiver.js == extend class Minder { init-hook(): 构造时设置选项, 侦听 'paperrender' 事件, 以调用 _initKeyReceiver() _initKeyReceiver():......

刘军兴
2015/11/19
0
0
学习 kityminder 笔记(七)

接上篇继续学习. 本段都是 seajs require(module/*.js) 的, 看起来是按照字母顺序 a-z 排列的, 所以应没什么互相依赖性. 考虑到前面有很多细节都略过, 或不懂, 在学习过程中可能还要不断回顾...

刘军兴
2015/11/20
0
0
再学习 Kity 笔记(五) 初步

在过去两周左右, 一直在学习 kity, kityminder, nodejs, seajs 等一系列项目. 有些认识经过一段时间学习, 已经发生了 变化, 使得原有笔记过时. 兹为深入学习, 有必要回顾复习重新看一遍. Kit...

刘军兴
2015/12/04
68
0

没有更多内容

加载失败,请刷新页面

加载更多

Sql语言与MySql数据库

1. 数据库简介 1. 数据库,就是存储数据的仓库,只能通过sql语言来访问,数据库也是一个文件系统。通常,MySQL、Oracle等数据库,也被称为关系型数据库,其保存的不仅仅只是数据,还包括数据...

江左煤郎
12分钟前
0
0
IDEA 取消自动import .*

打开设置 > Editor > Code Style > Java > Scheme Default > Imports ① 将 Class count to use import with "*" 改为 99 (导入同一个包的类超过这个数值自动变为 * ) ② 将 Names count ......

乔老哥
14分钟前
1
0
PostGIS学习笔记(开篇)

PostGIS事实上算是笔者开始写博客的第一篇内容。而事实上那篇博文的内容并不丰富,笔者对PostGIS的了解仍然不多,然而17年在OSGeo课程学习时对PostGIS又有了进一步了解,并逐步发现它的强大。...

胖胖雕
14分钟前
1
0
【Centos】在nginx服务器中配置php和mysql

接上一章《【Centos】利用Vultr服务器和namesilo布网》(https://my.oschina.net/u/3776619/blog/2051986),在Centos中配置好nginx,并在iptables中开启了80端口,和为了远程mysql操作方便开...

yongh701
38分钟前
2
0
flume -- fileChannel简要分析其过程

flume之event写入FileChannel doPut(event)-->获取共享锁后[log.lockShared();]-->FlumeEventPointer ptr = log.put(transactionID, event); 此处的log.put即将transactionID及event进行后续......

-九天-
50分钟前
2
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部