(部分为个人理解,未必准确,以官方教程为准)
1. 准备工作:
操作系统是Windows XP SP3。
首先下载Cairngorm示例工程:
http://sourceforge.net/adobe/cairngorm/wiki/SimpleSampleApplicationExplained/
点击Server-side component下的Download链接
安装JDK(必需),Flex Builder 3(必需)。
下载SocketSniff(可选,数据分析用),
下载xampp-portcheck(可选,在xampp的安装包中,用于tomcat的8009端口占用检查)
2. 启动hsqldb和tomcat
这两个东西都是在下载的flex-frameworks-max.zip压缩包中自带的。
根据Getting Started.pdf的方法安装,
由于我的windows下的JDK6是拷贝而非安装,所以需要修改bat文件,
让它直接指向我硬盘内的java.exe。
tomcat则是新建一个bat文件,以服务的形式运行,内容如下:
@echo off
set JAVA_HOME=D:\ugame\bin\jdk1.6
call service install
net start tomcat6
set JAVA_HOME=
@echo on
关闭服务的bat内容如下:
@echo off
service uninstall
@echo on
数据库hsqldb是以窗口模式启动,用Ctrl+C可以直接关闭。
3. 用Flex Builder 3导入Cairngorm的InsyncPlain工程,然后按工具栏上的“Run”按钮。
(因为我IE中的Flash不是Debug版,所以按“Debug”按钮会弹出警告框)
弹出IE窗口,在右上角随便键入一个字符,将在右方显示出一个用户列表。
双击其中一条用户数据,左方以标签页形式显示该用户的详细信息(包括照片等)。
可以使用多个浏览器浏览这些信息。
4. 用SocketSniff嗅探iexplore.exe和java.exe进程(tomcat6.exe不可以,会崩溃)。
发现如下现象:
1) 浏览器(IE8)进程连接的远程端口为TCP 8400(即tomcat监听的对外端口)
2) 浏览器可以使用相同的连接传输多个POST的HTTP请求,如下:
Send: Return Code: 0x00000000
POST /messagebroker/amf;jsessionid=0FF3E870FB12FED4F8AA43735BAAC715 HTTP/1.1
Accept: */*
Accept-Language: zh-CN
x-flash-version: 10,1,102,64
Content-Type: application/x-amf
Content-Length: 327
UA-CPU: x86
Accept-Encoding: gzip, deflate
User-Agent: Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; .NET CLR 2.0.50727; .NET CLR 3.0.4506.2152; .NET CLR 3.5.30729; .NET4.0C; .NET4.0E)
Host: localhost:8400
Connection: Keep-Alive
Cache-Control: no-cache
Cookie: uchome_loginuser=root; uchome_auth=e2593kVJbk%2BKWFdiyFuFk7Nxba8t7QITZudKljKUqgwgR7u%2BMCvlxgpRCVfwHL63N%2BJEyChq%2Fj1G%2FEfPF5gA; JSESSIONID=0FF3E870FB12FED4F8AA43735BAAC715
而接受的是amf格式的数据
Receive: Return Code: 0x00000000
HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Cache-Control: no-cache
Expires: Sat, 25 Dec 1999 00:00:00 GMT
Pragma: no-cache
Content-Type: application/x-amf
Content-Length: 59112
Date: Thu, 09 Dec 2010 06:17:13 GMT
...(以下为未解码二进制数据,略)
也就是说,浏览器可以复用一个连接来处理频繁发出的POST包。
3) 当客户端(Flash)的输入隔了较长的一段时间,浏览器会自动断开连接,
直至用户界面有输入时才开启新的连接。
4) 数据库监听9002端口,接受的数据是明文(摘自SocketSniff的拦截)
................
....SELECT * FRO
M contact WHERE
UPPER(first_name
+ ' ' + last_na
me) LIKE ? OR UP
PER(last_name +
' ' + first_name
) LIKE ? ORDER B
Y last_name, fir
st_name
整理一下就是
SELECT * FROM contact
WHERE
UPPER(first_name + ' ' + last_name) LIKE ? OR
UPPER(last_name + ' ' + first_name) LIKE ?
ORDER BY last_name, first_name
Java中常见的question-mark风格的SQL语句。
发送的则是编码后的二进制数据。
另外,hsqldb在发送完毕后自动关闭TCP连接。
5) hsqldb在启动时显示如下信息:
[Server@6ca1c]: [Thread[main,5,main]]: checkRunning(false) entered
[Server@6ca1c]: [Thread[main,5,main]]: checkRunning(false) exited
[Server@6ca1c]: Startup sequence initiated from main() method
[Server@6ca1c]: Loaded properties from [D:\ugame\bin\flex-frameworks\sampledb\se
rver.properties]
[Server@6ca1c]: Initiating startup sequence...
[Server@6ca1c]: Server socket opened successfully in 0 ms.
[Server@6ca1c]: Database [index=0, id=0, db=file:insync/insync, alias=insync] op
ened sucessfully in 359 ms.
[Server@6ca1c]: Startup sequence completed in 375 ms.
[Server@6ca1c]: 2010-12-09 14:09:54.140 HSQLDB server 1.8.0 is online
[Server@6ca1c]: To close normally, connect and execute SHUTDOWN SQL
[Server@6ca1c]: From command line, use [Ctrl]+[C] to abort abruptly
可以看到hsqldb的进程读取server.properties文件,
然后打开insync数据库。
6) 如果关闭tomcat,会弹出以下错误窗口
Send failed
faultCode:Client.Error.MessageSend faultString:'Send failed' faultDetail:'Channel.Connect.Failed error NetConnection.Call.Failed: HTTP: Failed: url: 'http://localhost:8400/messagebroker/amf''
7) 如果关闭hsqldb,会弹出以下错误窗口
java.lang.RuntimeException : java.sql.SQLException: socket creation error -- Make sure that you successfully started the database.
faultCode:Server.Processing faultString:'java.lang.RuntimeException : java.sql.SQLException: socket creation error -- Make sure that you successfully started the database.' faultDetail:'null'
5. 阅读文档。
详细请看
http://sourceforge.net/adobe/cairngorm/wiki/SimpleSampleApplicationExplained/
那里阐述了这些问题(以insync-cairngorm-basic工程为例)
1) 无脚本块函数(mxml文件)
Toolbar视图以形式存在
这里是presentation/Toolbar.mxml
<fx:Script>
<![CDATA[
[Inject]
[Bindable]
public var model:ToolbarPM;
]]>
</fx:Script>
[Inject]的作用是把ToolbarPM注入到Toolbar视图中。
2) 表示模型(PM)(as文件)
每个重要的MXML都拥有各自独立的PM。
它是以类形式存在的as文件,这里是
presentation/ToolbarPM.as
这里ToolbarPM把用户输入的字符串去掉前后的空白符,
然后发出搜索事件。(简单来说就是事件派发器)
[Event(name="add", type="insync.application.ContactEvent")]
[Event(name="search", type="insync.application.SearchEvent")]
[ManagedEvents(names="add,search")]
public class ToolbarPM extends EventDispatcher
{
public function addContact():void
{
dispatchEvent(ContactEvent.newAddContactEvent());
}
public function search(keywords:String):void
{
if (keywords == null)
return;
keywords = StringUtil.trim(keywords);
dispatchEvent(new SearchEvent(keywords));
}
}
PM的作用是从界面中分离出逻辑部分以降低单元测试的难度。
3) 数据绑定(mxml文件)
presentation/ContactList.mxml中
<mx:Script>
<![CDATA[
import insync.domain.Contact;
[Inject]
[Bindable]
public var model:ContactsListPM;
]]>
</mx:Script>
<mx:DataGrid id="list"
width="100%" height="100%"
dataProvider="{ model.contacts.items }" doubleClickEnabled="true"
itemDoubleClick="model.editContact(Contact(list.selectedItem))">
<mx:columns>
<mx:DataGridColumn dataField="firstName" headerText="First Name"/>
<mx:DataGridColumn dataField="lastName" headerText="Last Name"/>
<mx:DataGridColumn dataField="phone" headerText="Phone"/>
</mx:columns>
</mx:DataGrid>
...
model这个Bindable的变量被下面的DataGrid引用了。
4) 部件间通信(as文件)
使用消息派发,例如ToolbarPM.as中
dispatchEvent(ContactEvent.newAddContactEvent());
dispatchEvent(new SearchEvent(keywords));
5) 命令类(as文件)
见application/SearchContactsCommand.as
package insync.application
{
import com.adobe.cairngorm.integration.data.IDataCache;
import insync.domain.Contacts;
import mx.collections.IList;
import mx.rpc.AsyncToken;
import mx.rpc.remoting.RemoteObject;
public class SearchContactsCommand
{
[Inject]
public var contacts:Contacts;
[Inject]
public var cache:IDataCache;
[Inject]
public var service:RemoteObject;
[Command]
public function execute(event:SearchEvent):AsyncToken
{
return service.getContactsByName(event.keywords) as AsyncToken;
}
[CommandResult]
public function onResult(items:IList):void
{
contacts.addContacts(cache.synchronize(items));
}
}
}
这里execute函数调用RemoteObject对象执行RPC操作,
onResult把结果保存到Contacts对象中
(Contact描述每个联系人的字段,Contacts则是Contact的复数)
其中execute和onResult是命名约定。
在src/InsyncContext.mxml中插入SearchContactsCommand这个命令类
<!-- Application -->
<app:SearchContactsCommand />
<app:SaveContactCommand />
<app:RemoveContactCommand />
6) 集成库。
SearchContactsCommand中的cache使用了集成库中的IDataCache
7) 一个操作触发另一个操作。
由于保存数据后需要刷新搜索结果,所以需要写一个控制器
package insync.application
{
import flash.events.EventDispatcher;
[Event(name="search", type="insync.application.SearchEvent")]
[ManagedEvents(names="search")]
public class RefreshSearchAfterSaveController extends EventDispatcher
{
private var lastSearch:String = "";
[MessageHandler(selector="search")]
public function onSearch(event:SearchEvent):void
{
lastSearch = event.keywords;
}
[CommandResult(selector="save")]
public function onSaveComplete(request:ContactEvent):void
{
dispatchEvent(new SearchEvent(lastSearch));
}
}
}
在保存操作后立刻执行搜索操作,使用最后输入的关键字。
Task库可以定义操作的顺序。
8) SRP(单一职责原则)
SRP(Single responsibility principle)用于职责驱动设计方法,
定义为:a reason for change(改变类的原因不应该多于一个)。
简单来说,一种变化改变同一个模块。
例如打印程序中表面变化(打印格式)和本质变化(打印内容)属于两个不同的职责,必须把代码分割(使用接口),而通信数据的接收和发送虽然是两个不同的功能,但因为被一种变化(增加新的协议)所改变,所以可以放在同一个模块中处理。
总而言之,模块越小越好。
上面的RefreshSearchAfterSaveController控制器就是SRP的例子。
参考:
http://sourceforge.net/adobe/cairngorm/wiki/SimpleSampleApplicationExplained/