buffalo 特征列表

在Buffalo2.0之前，Buffalo使用caucho的burlap协议。从2.0开始，Buffalo有了一个全新的协议定义和适合web的、更快速的实现。Buffalo采用这个基于xml的轻量级协议来序列化java对象。而javascript客户端把xml反序列化为javascript对象。当进行一次远程调用时，Buffalo客户端会把这个远程调用序列化为xml，然后java端（服务器端）进行反序列化。


ajax正开始大行其道，Sun的Blueprints中已经开始包括ajax的支持。但是直接使用XMLHTTP在大多数情况下编程并不容易。Buffalo使得这一过程更加容易。Buffalo首先是burlap协议的JavaScript实现，但是他为Amowa(面向异步消息的Web应用)/Ajax提供了更多的支持。开发者可以使用Buffalo为web应用更加容易的添加Amowa/Ajax特性；另外，随着开发者的要求，Buffalo开始逐渐加入了Web元素，使得Buffalo逐渐向一个全功能的、新型的Web框架逐渐靠近。

Burlap协议的JavaScript实现

事实上，burlap协议应该是目前最适合使用用作web remoting的通信协议，全面，简洁，适用。Buffalo实现了burlap协议中绝大部分数据类型的javascript序列化/反序列化。

Java对象到JavaScript对象的双向序列化全面支持

java端任意一个方法调用产生的结果，都可以被透明的序列化到javascript端，无论是这个对象多么复杂；无论是简单的原子类型（String, int, long, boolean）还是复杂的对象（List, Map），甚至你自己定义的业务对象，buffalo可以完整的将其序列化到javascript端，你可以用javascript与其交互。buffalo的这项特性久经考验，成为它最富特色的功能。例如，userService.listAll()返回所有用户列表(java.util.List):

客户端调用方式：

buffalo.remoteCall( " userService.listAll " ,[],function(reply) {
         //  不用担心，reply.getResult会从聪明的判断服务器端远程调用的结果类型。
        var userList  =  reply.getResult(); 
        var firstUserFamilyName  =  userList[ 0 ].name.familyName;
    }
);

异步回调的编程模型

在buffalo 1.1之前，每一个方法调用都是异步的，在1.1版本之后，Buffalo支持同步调用（尽管不推荐这么做）。两者编程模型完全相同，你可能这样使用系统的登录功能：

//  var buffalo = new Buffalo("/bfapp/buffalo");  //  1.2版本的写法
buffalo.remoteCall( " userService.login " ,[ " username " , " password " ], function(reply)  {
    var success  =  reply.getResult();
     if  (success)  {
        alert( " You login successfully " );
    }   else   {
        alert( " user name or password incorrect! " );
    }
} );

支持异步事件

喜欢像gmail一样，在加载系统时出现小小的loading条，而不是切换页面？Buffalo给你支持。

onLoading
onFinish
onError

 你可以定义这些事件，使之符合自己应用的需要。

例如 修改等待效果 ：

var buffalo  =   new  Buffalo(endPoint);
buffalo.events[ " onLoading " ]  =  function(state)  {
     if  (state)  {
        window.status  =   " Loading " ;
    }   else   {
        window.status  =   " Loading complete " ;
    }
}

简单，直观，易于使用

Buffalo开发者尽最大努力将API设计的易于使用，无论是客户端还是服务器端，尽可能不让开发者了解buffalo细节。

服务器端 ，使用buffalo的开发者，几乎不需要了解buffalo的java代码结构。任何POJO都可以成为Buffalo的服务被暴露出来。
客户端 ，开发者只需要与一个对象交互：Buffalo, 并且只需要与为数不多的方法进行交互即可。任何一个初学者，可以在半小时之内熟悉buffalo并开始开发。
 

集成Prototype Library

参考Ruby 简单 的思想，Prototype为真正的web开发提供了简便直接的支持。Buffalo 1.2版本开始用Prototype语法重写，并直接构建在其之上，这是因为Prototype是可以直接使用，几乎不需学习就可以为web开发带来巨大好处的。

Spring集成

Spring是当前最流行的轻量级容器，Buffalo对它进行了支持。Spring中任意一个配置过的bean, 都可以通过简单的配置被暴露为buffalo服务。

浏览器兼容

Buffalo目前支持IE6/Firefox 1.0+浏览器。

支持浏览器前进/后退按钮

许多大面积使用Ajax的web应用常常陷入一个浏览器前进后退功能失效的困境。Buffalo 1.2版本中解决了这一问题。

只要在主页面中加入buffalo - blank.html的引用
并采用buffalo.switchView的方法

你会发现浏览器的前进后退按钮可用，并且能正确地进行导航。

支持数据绑定

对于一般的数据返回值，buffalo提供了绑定的功能，能够迅速的将javascript对象的值绑定到html元素上。绑定的元素支持

text
checkbox
radio
textarea
select
span / div
table. 

如何。。。。

将表单序列化为一个dto对象？

在1.2.1版本中，提供了Buffalo.Form.formToBean方法，可以将表单直接序列化为对象。使用方法可见demo应用中的Form demo. 简单用法如下，将表单中的信息转化为一个net.buffalo.demo.form.User对象。

var userObj  =  Buffalo.Form.formToBean( " form1 " ,  " net.buffalo.demo.form.User " );
buffalo.remoteCall( " userService.createUser " , [userObj], function(reply) {
    alert(reply.getResult().username);
} )

转换原则：
对于普通text,password,radio,select-one, 直接转化为(name=value)的一个属性；
对于select-many, checkbox, 转化为一个String?或者String的List。

Spring集成?

保证Spring正常加载（采用config servlet或者context listener的方式，此处不赘述）
在任一个spring配置文件中加入BuffaloConfigurer bean:

< bean name = " buffaloConfigBean "   class = " net.buffalo.service.BuffaloServiceConfigurer " >
     < property name = " services " >
     < map >
         < entry key = " testSpringService1 " >< ref bean = " yourBeanId " /></ entry >
         <!--  oterh entries…  -->
     </ map >
     </ property >
</ bean >

Buffalo会在启动时自动加载这个bean, 并加载所有的service. 前台使用方式没有任何不同，buffalo一致对待来自于buffalo-service.properties中的服务和来自spring中的服务。

自定义事件?

buffalo.events["onLoading"] = function(state) {...}
事件包括：onLoading, onFinished, onError, onException

数据绑定?

buffalo.bindReply(service, params, elementId)
或者直接使用
Buffalo.Bind.bind(elementId, bindValue)

浏览器前进后退?
加入buffalo-blank.html的iframe引用，id="buffalo-view-history-iframe":

 

切换视图的时候，采用buffalo.switchView(viewName), buffalo会自动记录视图切换历史
对于不需要纪录的视图，采用buffalo.switchPart(...) 进行排除