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/

 

 

 

 

你可能感兴趣的:(tomcat,SQL Server,浏览器,Flex,HSQLDB)