Atom中的序列化
当一个窗口被刷新,或者从上一次会话恢复的时候,视图和它相关的对象会从JSON表达式中反序列化,它们在窗口上一次关闭时储存。要使你自己的视图和对象兼容刷新,你需要让它们很好地执行序列化和反序列化。
包的序列化钩子
你的包的主模块可以选择包含一个serialize
方法,它在你的包反激活之前被调用。你应该返回JSON,它会交还给你作为下次调用activate
的参数。在下面的例子中,这个包将一个MyObject
的实例在刷新过程中保持相同的状态。
module.exports =
activate: (state) ->
@myObject =
if state
atom.deserializers.deserialize(state)
else
new MyObject("Hello")
serialize: ->
@myObject.serialize()
序列化方法
代码语言:javascript复制class MyObject
atom.deserializers.add(this)
@deserialize: ({data}) -> new MyObject(data)
constructor: (@data) ->
serialize: -> { deserializer: 'MyObject', data: @data }
.serialize()
你想要序列化的对象需要实现.serialize()
,这个方法需要返回一个序列化的对象。而且它必须包含一个叫做deserializer
的键,它的值为一个已注册的反序列化器的名字,它能够转换对象剩余的数据。它通常是类的名称本身。
@deserialize(data)
另一方面是deserialize
方法,它通常是个类级的方法,位于实现serialize
方法相同的类中。它的作用是将一个上一次serialize
调用返回的状态对象转化为一个真正的对象。
atom.deserializers.add(class)
你需要在你的类中调用atom.deserializers.add
方法来使它对反序列化系统可见。现在你可以带着serialize
返回的状态调用全局的deserialize
方法,你的类中的deserialize
会自动被选择。
版本控制
代码语言:javascript复制class MyObject
atom.deserializers.add(this)
@version: 2
@deserialize: (state) -> ...
serialize: -> { version: @constructor.version, ... }
你的可序列化类可以带有一个可选的@version
类级属性,并且在序列化的状态中持有version
键。反序列化的时候,Atom只在版本匹配的时候尝试对其反序列化,否则返回undefined
。我们计划在未来实现一个迁移系统,但是现在至少能防止你对旧的状态反序列化。