消息/事件机制是几乎所有开发语言都有的机制,并不是deviceone的独创,在某些语言称之为消息(Event),有些地方称之为(Message). 其实原理是类似的,只不过有些实现的方式要复杂一点。我们deviceone统一就叫消息.
消息基础概念
还有一些初学者不太熟悉这个机制,我们先简单介绍一些基础概念,如果熟悉的人可以跳过这个部分。
一个/条消息可以理解为是一个数据结构,包含以下几个基本部分:
消息源 :就是消息的来源,发出这个消息的对象
消息名 :就是消息的唯一标示
消息数据:消息发出后附带的数据,有可能数据是空
消息从种类上又可以分为2种:
系统消息 :由操作系统或deviceone系统发送出来的消息,消息的名称是固定的。
自定义消息:由开发者自己定义,自己发送出来的消息,消息的名字是随意的,可以任意定义。
举例说明:
比如用户点击一个do_Button按钮,就会触发一个系统消息,包含3个部分:
消息源:用户点中的button对象
消息名:touch
消息数据:这个消息没有附带数据
比如用户通过do_Button按钮触发一个自定义事件,包含3个部分:
消息源: button对象
消息名:用户随便定义,叫aaa,bbb,ccc都可以
消息数据:附带的数据由触发消息的时候设定
发布/订阅模式
发布/订阅模式是最常用的设计模式之一,是消息机制的核心,其特点就是降低耦合度,让二个独立的对象不互相依赖。简单介绍一下,熟悉的同学可以跳过。
我们先从现实的一个简单例子来说明这个问题,参考下图:
从这个图我们可以看出
消费者和出版社互相不认识,消费者不需要了解他想要的杂志是具体哪家出版社出的;出版社也不需要了解具体是哪个人定了他们出版社发行的书。
消费者和出版社必须都认识邮局。
消费者需要告诉邮局消费者的名字地址以及想要订阅的杂志名字
可以多个消费者订阅同一本杂志
邮局拿到杂志后,会一一通知消费者,通知的时候同时把杂志送到消费者手里。
看完上面现实例子,我们再来看抽象的描述会更清晰一点,看下图:
和上面的实际例子描述一一对应:
系统/开发者和函数对象互相不依赖,系统/开发者只管触发一个消息,并不关心谁去接受
系统/开发者和函数对象必须能获取到消息源对象
函数对象订阅消息的时候需要标示消息的名称和函数对象的引用
可以多个函数对象订阅同一个消息源同一名字的消息
消息源触发消息会一一通知所有订阅者,并把data数据传递到回调函数对象
看完抽象的描述,我们最后来看实际的deviceone开发的例子,还是以do_Button为例子。
1. 当用户点击一个button,触摸到的时候,系统会获取到button这个对象作为消息源,fire一个”touch”消息,任何订阅了”touch”消息的函数对象都会接收到这个消息并引起函数的执行。
//获取button对象
var btn_hello = ui("btn_hello");
//定义函数对象
function f1(){
//当btn_hello这个按钮接收到手指点击就会执行下面的代码
deviceone.print("f1 函数接收到点击触发消息")
}
function f2(){
//当btn_hello这个按钮接收到手指点击就会执行下面的代码
deviceone.print("f2 函数接收到点击触发消息")
}
//f1,f2订阅button的touch消息
btn_hello.on("touch",f1);
btn_hello.on("touch",f2);
2. 我们可以为button对象定义2个自定义的消息”message1”和”message2”,分别有2个函数对象订阅这2个消息。但是最后要触发这个消息必须是开发者通过调用fire函数才能触发,这就是和系统消息的区别。
//获取button对象
var btn_hello = ui("btn_hello");
//定义函数对象
function f1(d){
//当btn_hello这个按钮接收到开发者触发的消息message1就会执行下面的代码
deviceone.print("f1 函数接收到message1消息,消息的数据是:"+d)
}
function f2(d){
//当btn_hello这个按钮接收到开发者触发的消息message2就会执行下面的代码
deviceone.print("f2 函数接收到message2消息,消息的数据是:"+d)
}
//f1,f2订阅button的touch消息
btn_hello.on("message1",f1);
btn_hello.on("message2",f2);
//触发消息
btn_hello.fire("message1","data1");
btn_hello.fire("message2","data2");
看到这里,你肯定会奇怪,为什么我们要在button上自定义对象?这有神马意义?其实确实没有意义也没有必要,这里只是拿button举例子,在常规的开发中,基本不会这么用。
消息的使用
前面讲了这么多,现在才是deviceone消息的使用。使用其实很简单,上面的例子基本说明的了系统事件和自定义事件的使用方法。
有几个概念再说明一下
1.deviceone的所有对象,包括UI,MM,SM对象都可以是消息源
// SM对象可以是消息源
var page = sm("do_Page");
page.on("loaded",function()){
// 这个是page对象的系统消息,这个消息不需要手动触发,系统会自动触发
}
page.on("message1",function(d)){
// 这个是page对象的自定义消息
}
page.fire("message1","data1");
// MM对象可以是消息源
var http = mm("do_Http");
http.on("result",function()){
// 这个是http对象的系统消息,这个消息不需要手动触发,接受到http服务端的反馈后会自动触发
}
http.on("message1",function(d)){
// 这个是http对象的自定义消息
}
http.fire("message1","data1");
//UI对象可以是消息源
var alayout = ui("alayout_id1");
alayout.on("touch",function()){
// 这个是alayout对象的系统消息,这个消息不需要手动触发,手机点击就会触发
}
alayout.on("message1",function(d)){
// 这个是alayout对象的自定义消息
}
alayout.fire("message1","data1");
2.消息源对象有作用域,所以订阅和触发的消息源必须是是一个作用域的同一个对象。这里结合数据分享和数据传递文档来理解。
看以下的例子,test1.ui和test2.ui有可能在一个page作用域,也有可能不在一个作业域,只有在一个作用域fire的消息才能正确送达回调函数。
判断是否一样,可以通过打印page的地址 page.getAddress()
.
//在test1.ui.js里订阅消息
var page = sm("do_Page");
deviceone.print(page.getAddress());
page.on("message1",function(d)){
deviceone.print(d);
}
//在test2.ui.js触发消息
var page = sm("do_Page");
deviceone.print(page.getAddress());
page.fire("message1","data1");
如果不在同一page作用域,则可以把消息订阅在2个page都能共享到的app作用域
上面的代码改成:
//在test1.ui.js里订阅消息
var app = sm("do_App");
app.on("message1",function(d)){
deviceone.print(d);
}
//在test2.ui.js触发消息
var app = sm("do_App");
app.fire("message1","data1");
3.同样的函数对象可以重复订阅一个对象源的消息,触发消息的时候会使函数执行多次,这是初学者经常犯的错误。
var page = sm("do_Page");
var count = 0;
function f(){
deviceone.print("执行次数"+(count++));
}
page.on("message1",f);
page.on("message1",f);
page.fire("message1");
看上面的例子,如果执行的话,会打印2此,因为订阅了2次,或许你会说谁会写这样的代码?实际情况肯定没有这么容易看出来执行了重复的on函数,实际情况经常是比如在点击事件里执行on函数,每点击一下按钮,就重复订阅一次。
4.消息的订阅一定要在消息的触发之前,这是初学者经常犯的错误。
var page = sm("do_Page");
var count = 0;
function f(){
deviceone.print("执行次数"+(count++));
}
page.fire("message1");
page.on("message1",f);
看上面的例子,如果执行的话,会没有效果,或许你会说谁会写这样的代码?实际情况肯定没有这么容易看出来顺序反了,实际情况经常是比如on函数执行在某一个函数的回调函数里,你无法确定回调函数啥时候执行,是否是在fire之前执行。一般碰到这种情况可以加几个deviceone.print打印一下看看是on先执行还是fire先执行。
5.有订阅就有取消订阅,取消订阅是off函数,之所以很少用,是因为closePage的时候会自动把当前page作用域订阅的消息全部释放。但是如果消息订阅在app作用域,就要注意,可能需要手动去取消订阅。否则就会出现触发消息的时候会使函数执行多次的问题。
var page = sm("do_Page");
var count = 0;
function f(){
deviceone.print("执行次数"+(count++));
}
page.on("message1",f);
page.fire("message1");
page.off("message1");
page.fire("message1");
看上面的例子,打印只会执行一次,因为fire一次后就取消订阅了。