文档章节

学习 kityminder (十五) save

刘军兴
 刘军兴
发布于 2015/12/15 11:06
字数 778
阅读 162
收藏 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 的折磨了.

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

 

© 著作权归作者所有

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

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

2018/06/04
0
0
KityMinder 1.2.0 发布,脑图工具

脑图工具 KityMinder 出新版本啦! 功能增加,体验提升:) 自从KityMinder1.x版本正式上线以来,得到了广大同学的热情关注。同学们为KityMinder提出了各种好的建议。我们整个小组受到了很大...

战毅
2014/07/10
9.1K
12
Kity Minder 1.1.0 发布更新

KityMinder思维脑图,正式线上使用地址已经开放 naotu.baidu.com KityMinder Change Log v1.1.0 功能更新 添加了剪贴板操作的支持 添加了本地自动保存草稿的功能 优化了文字选中效果 改进了文...

战毅
2014/03/19
1K
5
学习 kityminder 笔记(五)

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

刘军兴
2015/11/19
0
0
Kity Minder —— 来自百度的在线思维导图工具

KityMinder 是百度FEX团队的f-cube小组(原UEditor小组)的又一力作。作为一款在线的脑图编辑工具,它有着不输给Native编辑工具(如 xMind,MindManager等)的最佳用户体验。同时,它充分发挥...

oschina
2014/03/04
4
0

没有更多内容

加载失败,请刷新页面

加载更多

HTTP 304状态码

客户端在请求一个文件的时候,发现自己缓存的文件有 Last Modified ,那么在请求中会包含 If Modified Since ,这个时间就是缓存文件的 Last Modified 。因此,如果请求中包含 If Modified ...

Jack088
7分钟前
0
0
MyBatis学习笔记(二)

mybatis执行过程架构图 1、mybatis配置 SqlMapConfig.xml,此文件作为mybatis的全局配置文件,配置了mybatis的运行环境等信息。 mapper.xml文件即sql映射文件,文件中配置了操作数据库的sql...

梦想_与_现实
11分钟前
0
0
分布式锁简单入门以及三种实现方式介绍

分布式锁简单入门以及三种实现方式介绍

zbbmaster
22分钟前
0
0
PHP接收前端传值各种情况整理

PHP接收前端传值各种情况整理 服务端代码: header('Access-Control-Allow-Origin:*');var_dump($_POST);exit; 情况 1) 传null $.post('http://xxxxx.xx/index.php', { "test": null}......

SSSWIIILLL
45分钟前
3
0
利用神器BTrace 追踪线上 Spring Boot应用运行时信息

概述 生产环境中的服务可能会出现各种问题,但总不能让服务下线来专门排查错误,这时候最好有一些手段来获取程序运行时信息,比如 接口方法参数/返回值、外部调用情况 以及 函数执行时间等信...

CodeSheep
今天
19
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部