/** */ /**
     * 输入一个map ,原封不动的输出来
     *  @param  arg
     *  @return  Map
      */
     public  Map object(Map arg)  {
               return  arg;
    }

在客户端我们有 这样的 js 代码 ：

< script language = " javascript " >
var buffalo  =   new  Buffalo(endPoint)

function sendObject()  {
    var a  =   {} ;
    a[Buffalo.BOCLASS]  =   " java.util.Map " ;
    a[ " a " ]  =   " A " ;
    a[ " b " ]  =   true ;
    a[ " c " ]  =   123.4 ;
    var u  =   {} ;
    u[Buffalo.BOCLASS]  =   " net.buffalo.demo.simple.User " ;
    u.id  =   234 ;
    u.name  =   " <xml here>& " ;
    u.age  =   17 ;
    u.sex  =   false ;
    u.memo  =   " very beautiful " ;
    a[ " u " ]  =  u;
    buffalo.remoteCall( " simpleService.object " ,[a], function(reply)  {
        alert( " return user memo: "   +  reply.getResult()[ " u " ].memo);
    } );
}
</ script >

a[Buffalo.BOCLASS] = "java.util.Map";

u[Buffalo.BOCLASS] = "net.buffalo.demo.simple.User";

public class User {
    private int id;
    private String name;
    private int age;
    private boolean sex;
    private String memo;
    
    public User() {
    }



}

<script language="javascript">
var buffalo = new Buffalo(endPoint);

function doAnotherSubmit() {
    var userObj = Buffalo.Form.formToBean("form1", "net.buffalo.demo.form.User");
    buffalo.remoteCall("userService.createUser", [userObj], function(reply){
        $("form_infomsg").innerHTML="Form has been submited, username is: " + reply.getResult().username;
    })
}
</script>

var userObj = Buffalo.Form.formToBean("form1", "net.buffalo.demo.form.User");

$("form_infomsg")

<div id="form_infomsg" style="color:blue"></div>

表示的位置。


三 ：数据绑定

  首先 我们在服务器端有 这样一个变量 ：

    public static List employees() {
        if (employees.size() > 0) return employees;
        employees.add(new EmployeeBean("1", "Greg", "Murray"));
        employees.add(new EmployeeBean("2", "Greg", "Murphy"));
        employees.add(new EmployeeBean("3", "George", "Murphy"));
        employees.add(new EmployeeBean("4", "George", "Murray"));
        employees.add(new EmployeeBean("5", "Peter", "Jones"));
        employees.add(new EmployeeBean("6", "Amber", "Jones"));
        employees.add(new EmployeeBean("7", "Amy", "Jones"));
        employees.add(new EmployeeBean("8", "Bee", "Jones"));
        employees.add(new EmployeeBean("9", "Beth", "Johnson"));
        employees.add(new EmployeeBean("10", "Cindy", "Johnson"));
        employees.add(new EmployeeBean("11", "Cindy", "Murphy"));
        employees.add(new EmployeeBean("12", "Duke", "Hazerd"));
        return employees;
    }

在客户端我们有 这样的代码 ：

var buffalo = new Buffalo(endPoint);
function doCompletion() {
    buffalo.bindReply("ajaxService.filterEmployees",[target.value], "names");
}

同时我们在页面中有 ：

<TABLE id="names" border="1" jheight="0">

结果 ：

还有一种形式是 ：

    buffalo.remoteCall("simpleService.allLocales", [], function(reply) {
        /** *//**Buffalo.bind("area", reply.getSource());*/
        Buffalo.bind(tableId, reply.getResult());
    })

Buffalo.bind(tableId, reply.getResult());

    用DTO [(data transfer object) 数据传递对象]直接代替domain对象

    大多数ORM工具带给我们便利，尤其在处理对象关系上。在一个传统的java项目中，我们可以定义一个可用在多个层之间相容的domain对象。这即使在一个集群的应用中也是优良的，因为它们在同一个JVM中而且对象的内部状态能被保存。但在buffalo应用中，因为buffalo是真正地远程调用，所以你最好不这样做。你应该思量一下带宽的问题。

    让我们示例说明：userService.listUser，这个方法将返回一个user列表，同时User对象有AddressInfo、Roles和User属于的Department。在传统的JSP编写方式下，这是很好的。但在buffalo,这是很糟糕的。如果你不处理这个状况下任何部分，buffalo将尝试序列化user对象所连接的"每一个"属性，甚至是一对多、多对多的引用数据。这就像我们不需要显示太多数据一样，是对时间和带宽的巨大浪费。

    所以在设计buffalo服务时，请用DTO（或是 ViewHelper）来减少对用户的页面输出。

    慎重定义远程服务接口

    请针对远程调用设计真正的远程服务方法。如果一个客户端开始了一次远程调用，那么服务应该一次性回应足够的信息。客户端不需要调用其它的方法。

    采用浏览器前进/后退特征

    在一个web应用不能使用浏览器的前进/后退按钮来导航页面视图时，包括我在内的许多未端用户都会感到困惑。在这方面做得好的例如google，而做得糟糕是...MSN Live Mail。从1.2版开始，buffalo引入了这个特征。请考虑采用这个特征来提高用户体验吧。

    设计更多与用户接口的交互

    这是对所有ajax产品的普遍要求。当用户点击按钮或链接时，你应该提供一个有意义的提示使用户注意正在发生什么。在传统的web开发中，那些action会引起页面刷新或是页面切换。而在ajax中，你应该提供更多。

    在中小规模应用中，采用OPOA

    OPOA（OnePageOneApplication的简称）定义了一个web应用的类型。小型的基于应用的操作总是页面很少，而需要更佳的交互，例如邮件应用、系统监控等。对于这些应用来讲，你能使用OPOA简化开发和提供更丰富的用户体验。

    对于中大型应用，慎用OPOA

    由于浏览器能力所限，采用OPOA的大型应用（具有上百个视图） 在运行一会儿后会出现CPU或者内存的高消耗。对于这种情况，如果你仍然坚持使用OPOA的话，那么需要把整个系统分解为模块。这样当用户切换模块时，系统将重新定位到一个新页面以使浏览器有机会清理内存并休息一下。

---------------------------------------------------------------------------------------------------
补充 ：

ref

   <ref>表示对另一个对象的引用。这个标记对于处理循环引用的场合非常有用，而其它场合会抛出StackOverflowException异常。来让我们看一下示例：

/**//*People类定义*/
class People{
  
  People getFriend() 
  // Other fields ommited
}

/**//*People类对象的使用*/
People john = new People("John");
People michael = new People("Michael");
//这里演示了循环引用
john.setFriend(michael);
michael.setFriend(josh);

List friends = new ArrayList();
friends.add(john);
friends.add(smith);


friends被序列化为下面的xml片断：

<list>
  <type>java.util.ArrayList</type>
  <length>2</length>
  <map>
    <type>domain.People</type>
    <string>friend</string>
    <map>
      <type>domain.People</type>
      <string>friend</friend>
      <ref>1</ref>
    </map>
  </map>
</list>

   其中ref=1表示对对象#1的引用作为它的值。xml片断中的每个<list>、<map>将被看作对象并具有一个引用id。

caucho

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(...) 进行排除