OpenAMF 配置文件 详解

OpenAMF openamf-config.xml 配置

第一个标签

<amf-serializer>
                        <force-lower-case-keys>false</force-lower-case-keys>
</amf-serializer>

这个标签的存在的意义在于当openamf发送传递给Flash 客户端的AMF消息时，是否把用来返回自定义类的Hashmap里面的key转换成小写。
一边情况下，当我们发送一个hashmap给客户端时，客户端把它当作一个custom class的object来对待。

比如你有一个java方法返回一个hashmap

public Hashmap getValue(){

Hashmap resultObj=new Hashmap();
result.put("nameSpace","com.flashseer.org");
return resultObj;
}


在actionscript中你可以用

resultObj.nameSpace

的写法来引用java里面hashmap中的一个值。

当你把这个标签的属性设置为true的时候，返回给Flash client的object中，所有的key都被转换成小写。

所以，如果你使用Actionscript2.0的时候，因为AS2区分大小写。你就不可能用resultObj.nameSpace来引用了。
因为，nameSpace已经被转换为小写了。你必须使用namespace来引用。

这里，官方的example里面注释说了，
如果你用actionscrpt2.0的话，把这个设置为false。否则，如果你用了大写的字母作为key，在客户端就会出问题。
如果你用as1的话，可以设置为true


第二个标签


        <invoker>
                <name>Java</name>
                <class>org.openamf.invoker.JavaServiceInvoker</class>
        </invoker>
       
这个标签是用来调用java端的服务的。
这里，提供了许多的invoker供你使用。
放在这里的是最常用的一个invoker。这个invoker的作用就是根据service的位置在classpath里面找到这个class，并且调用其中的方法。

另外，还可以使用其他的invoker，
比如EJB，Spring，WebService都是非常实用的invoker.
按照需要，放置这些invoker.
可以在example的配置文件里找到所有的invoker

       
       
       
第三个标签：自定义类的映射
       
        <custom-class-mapping>
                <java-class>org.openamf.examples.Person</java-class>
                <custom-class>org.openamf.examples.Person</custom-class>
        </custom-class-mapping>

这个映射的作用是让你的FlashClient接收到正确的类型。
比如，在flashclient端，你调用一个方法后，接收到一个resultObj

如果你不进行类型映射，那么，这个resultObj是没有类型的。他就是一个object.你无法使用这个object的方法，只能通过引用属性的方法引用到属性。
但是，如果你在这里做了映射，在flash里面就可以得到一个具有类型的object。
用 trace(resultObj instanceof org.openamf.examples.Person) 就可以看到效果。


这个标签可以重复，映射多个自定义class


       
第四个标签：命名你的service（注意，这个部分需要使用advancedGateway）
        <service>
                <!--name这个 node定义一下你的service的名字，这样，你就不用在flash里面把你的整个class都写在里面了，而只需要用这个name来代替-->
                <name>Directory</name>
                <!--这个标签的作用其实就是让你指定你上面定义的那个name对应哪个class。-->
    <service-location>org.flashseer.Example</service-location>
                <!---这个标签 同上面的invoker标签对应，这样，一旦advancedGateway发现了你定义的这个service，就不用遍历所有的invoker来查找相应的服务。
                注意如果你没有定义这个的话，默认情况下，openamf会给所有可能的class打一个分，取分最高的来调用--->
    <invoker-ref>Java</invoker-ref>
               
                <!--这里定义一下需要call的方法-->
                <method>
                        <!-- 方法名 -->
                        <name>addPerson</name>
                        <!--参数定义，这里的参数可以使用一个class的名字或者使用通配符，
                        *就代表许多个参数，?代表一个参数-->
                        <parameter>
                                <type>*</type>
                        </parameter>
               
       
                        <!-- 这个result-filter实际上是可以自己来写实现的。实现org.openamf.filter.ResultFilter即可
                        其中，class标签中，是你需要使用的filter。 你可以使用两个由openamf提供的filter,也可以自己来实现。
                        其中parameter的两个标签其实就是一个自定义的object,你可以自己随便定义然后，在实现filter的时候来使用。
                         -->
                        <result-filter>
                                <class>org.openamf.filter.BeanListToRecordSet</class>
                                <parameter>
                                        <name>ignore</name>
                                        <value>extraInfo</value>
                                </parameter>
                        </result-filter>
                </method>
        </service>
       
        这个标签的意义在于它可以帮助你更快，更方便的找到flash remoting说调用的service.前面也提到了，如果你不指定的话，可能会导致每次openamf都要去做match,计算匹配值，然后取高的。