专注于Flash RIA与网络游戏开发 - Flash/Flex框架

Cinnamon基于AS3项目的例子

sujun10@21cn.com(弃天笑) — Sun,22 Mar 2009 07:47:55 +0800

有些朋友会说Cinnamon的测试例子有点难搭起，过程遇到的问题比较多。所以在我就放上一个基于AS3项目工程的例子，过一阵再把后台基于Spring的例子放出来。
大家做例子前，建议先仔细看看官方的说明，非常详细。我也是看它做的，这里我就简单说了
现在先简单说说，基本上，客户端的remoting服务类，是采用ant根据服务端的接口生成的。下面是配置文件

现在我的服务器有一个接口CounterService和他的实现类CounterServiceImpl
那么根据这个配置文件则会生成同样的as：CounterService.as和CounterServiceImpl.as
（要注意一点的是，需要把generatorTemplates目录复制到项目里面，或者自己去配置路径，增加了模板才能够生成客户端文件的）
CounterServiceImpl.java比较简单

程序代码

package example;

public class CounterServiceImpl implements CounterService
{
    private int counter = 0;
    public int getNextValue ()
    {
        System.out.println("调用了getNextValue方法");
        return ++counter;
    }
    public void reset ()
    {
        System.out.println("清楚原有数据eset");
        counter = 0;
    }
    public TestVo sendVo(TestVo vo)
    {
        vo.setName("服务器返回:" + vo.getName());
        vo.setName("服务器返回:" + vo.getPath());
        return vo;
    }
}

客户端使用就比较简单了，建立一个ServiceInitializer来初始化services

程序代码

public function createService (url:String, errorHandler:Function) : CounterService
    {
        var channel:ServiceChannel = new NetConnectionServiceChannel();
        channel.serviceUrl = url;
        channel.timeout = 5000;
        //实例化一个网络服务器，如果有多种服务，就需要实例多个
        var counter:CounterService = new CounterServiceImpl();
        //这里是的服务名称是和要服务器对应的
        channel.createProxy("counter", counter);
        channel.addEventListener(ServiceEvent.ERROR, errorHandler);
        return counter;
    }

再来就是主类调用了

程序代码

package {
    import example.CounterService;
    import example.ServiceInitializer;
    import example.TestVo;

    import flash.display.Sprite;
    import flash.net.registerClassAlias;

    import org.spicefactory.cinnamon.client.ErrorMessage;
    import org.spicefactory.cinnamon.client.ServiceEvent;

    /**
     * 基于as项目测试Cinnamon
     * @author Soda.Chen
     * @link www.sodaChen.com
     *
     */
    public class Cinnamon extends Sprite
    {
        private var service:CounterService;

        public function Cinnamon()
        {
            registerClassAlias("model::TestVo",TestVo);
            var si:ServiceInitializer = new ServiceInitializer();
            var url:String = "http://localhost:8080/Cinnamon/service/";
            service = si.createService(url, errorHandler);
            //测试服务器的getNextValue方法
            service.getNextValue().addResultHandler(onNextValue);
            //发送一个VO到服务器
            var vo:TestVo = new TestVo();
            vo.name = "soda";
            vo.path = "www.sodaChen.com";
            service.sendVo(vo).addResultHandler(onSendVo);

        }
        private function onSendVo(vo:TestVo):void
        {
            trace("vo.name:" + vo.name);
            trace("vo.name:" + vo.path);
        }
        private function onNextValue (nextValue:uint) : void
        {
            trace("-------nextValue------:" + nextValue);
        }
        private function errorHandler (event:ServiceEvent) : void
        {
            var error:ErrorMessage = event.response.result as ErrorMessage;
            trace("-----ERROR----:" + error.message);
        }
}

最后输出结果是:
-------nextValue------:1
vo.name:服务器返回:www.sodaChen.com
vo.name:www.sodaChen.com

最后奉上客户端和服务端的源代码。把服务端的web放到tomcat目录下，再启动客户端工程连接，就OK啦
（包含了jar，所以文件比较打，有5.2MB）
点击下载此文件

在Cinnamon传输自定义的对象（VO/Bean）

sujun10@21cn.com(弃天笑) — Sun,28 Dec 2008 21:40:36 +0800

在使用Cinnamon中传输自定义对象的话，是需要另外配置cinnamon-config.xml文件的。（注意，本文所说的配置不是基于spring的，cinnamon-config.xml的配置文件有两种配置方式，一种是基于spring，另外一种就是基本它本身的解析程序了）
我当初用的时候，也是一时大意，以为它是像Adobe的Remoting一样，直接在VO的名字是上面用[RemoteClass(alias="soda.SodaVo)]一样绑定，或者采用registerClassAlias("soda.SodaVo",SodaVo);
这样的注册方式，只要服务器有对应的soda.SodaVo就可以解析出来。
事实上，Cinnamon传输自定义的VO，需要额外的配置，查看了他的文档，才知道class Mapping。下面是他的配置信息:

然后在客户端这样对应：
[RemoteClass(alias="model::SodaVo)]
或者
registerClassAlias("model::SodaVo",SodaVo);
就可以了

[AS3]开源的Remoting框架：Cinnamon

sujun10@21cn.com(弃天笑) — Sun,28 Dec 2008 19:43:53 +0800

目前在做一个后台管理系统的项目中，因为不想使用Adobe自带的remoting组件，所以采用了Cinnamon这个开源的项目。
Cinnamon是http://www.spicefactory.org/中的一个基于flash remoting技术的开源框架（具体想要了解的人可以到网站去了解http://www.spicefactory.org/cinnamon/，一进去就有它的详细介绍：Full support for AMF3）：下面是官方介绍，我就不翻译啦
Cinnamon is a remoting framework based on the AMF3 protocol connecting clients written in AS3 with Java EE server applications. It can be deployed in every servlet container or Java EE application server. It contains the following features:
    *  Full support for AMF3.
    * Comes with its own Client API and does not build on top of the RemoteObject API of Flex, so it can be used with or without Flex.
    * Client Proxies of remote services implement business interfaces so you don't lose type safetey for remote method invocations like with RemoteObject.
    * Flexible server configuration: XML, annotations, custom Spring configuration namespace, programmatic configuration.
    * Many options how to map ActionScript classes to Java classes.
    * Extensible automatic type conversion for method parameters and bean properties.
    * Currently supports Spring Beans and plain Java classes as services.
    * Automatic source generation of AS3 service interfaces and proxies with Cinnamons Ant task.
    * Integration with JPA/Hibernate when used with Pimento Data Services.

根据个人的使用感觉来说，还是非常不错的，使用也很方便。它在服务端声明了远程服务接口以及实现类，然后通过他自带的工具包配合Ant工具，就可以生成对应的客户端接口和实现类。然后在使用过程中，只需要使用这个接口就可以了，非常方便。这种把整个服务端的接口搬下来的思想还是非常不错的。
希望有兴趣的人可以去了解一下，里面有详细API以及说明文档。建议要使用的人应该去了解，他本身带有简单的使用教程。

程序代码

//进行连接网络,并进行数据返回
loginService.userLogin(username,password).addResultHandler(loginResult);

其中userLogin为远程的一个服务端方法，loginResult为接受远程方法返回的结果