Cairngorm学习笔记一：简单的例子

 

（部分为个人理解，未必准确，以官方教程为准）

 

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/