Openlaszlo调用JavaRPC和JAVA类通信

Openlaszlo调用JavaRPC和JAVA类通信

 

JavaRPC允许Laszlo客户端远程调用服务端的JAVA类和方法。在laszlo中使用<javarpc>标签来声明一个JavaRPC对象：

<javarpc classname="..."
   
   

     attributename="..."
   
   

     scope="[session|webapp|none]"
   
   

     loadoption="[loadcreate|loadonly|create]"
   
   

     createargs="..."
   
   

     objectreturntype="[pojo|javabean]"
   
   

     autoload="[true|false]"
   
   

     secure="[true|false]"
   
   

     secureport="...">
   
   

classname(String):    必需。指定需要访问的JAVA类名

attributename(String)：使用服务端对象时的关键词。当scope为session或webapp时

使用。

Scope(String):       必需。在session,webapp和none三个中选一个。

Loadoption(String)： loadcreate,loadonly和create三个中任选一个。Loadcreate：如果服务器上存在该对象时加载，如果不存在，则在加载前自动创建该对象。Loadonly:只负责加载对象，如果该对象不存在，则返回一个错误。Create:在加载对象时总是在服务器端创建该对象。默认为loadcreate。

Createargs(Array):   只有当loadoption为loadcreate或create时才有效。Createargs

                    数组包含一些变量，这些变量用来在服务端创建对象时使用。默认为

null。

Objectreturntype(String):  pojo和javabean中任选一个。如果从服务端返回一个对象，使用pojo只返回该对象中所有声明为public的成员变量。使用javabean

                      将返回含有getXXX()方法的成员变量。

Autoload(Boolean):    true或false。True:在初始化时自动加载指定的对象。False：需要在使用对象前调用load()方法。默认为true。

Secure（Boolean）:   true或false。如果选择true的话，会在服务端和客户端之间建立一个安全的连接。

Secureport(Number):  只有才secure为true时才有效。

 

如：

<javarpc name=”returnsun” scope=”none” class=”RetuenSum”>通过returnsun来建立javarpc和java之间的桥梁。其中name就是指定一个rpc的属性(attributename)。

再通过remotecall调用java类的方法：

<remotecall name=”getSun” funcname="getSun">

    <param id=”a” name=”a” value=”’’”/>

    <param id=”b” name=”b” value=”’’”/>

    <method event="ondata" args="sum"/>

</remotecall>

说明：在使用javarpc前，首先要将JAVA类定义为安全的，如下：

<security>

    <allow>

        <pattern>^com.sum.ReturnSum</pattern>

    </allow>

</security>

funcname对应java类的方法名称。

如果调用的方法带有参数，remotecall需用<param>来传递参数,这个参数对应JAVA方法中的形参。在传递时，remotecall会根据param的位置和JAVA方法形参的位置匹配。

<method event="ondata" args="sum"/>,使用args来接收JAVA方法的返回值，无需定义数据类型。

 

下面通过一个小DEMO来演示一下使用JavaRPC和JAVA进行通信。

 

TypesExample类:

 

package examples;

 

import java.util.Vector;

import java.util.Hashtable;

 

public class TypesExample {

 

    public static String passInteger(int i) {

        return "got integer parameter: " + i;

    }

 

    public static String passDouble(double d) {

        return "got double parameter: " + d;

    }

 

    public static String passBoolean(boolean b) {

        return "got boolean parameter: " + b;

    }

 

    public static String passClientArray(Vector v) {

        return "got vector parameter: " + v;

    }

 

    public static String passClientObject(Hashtable t) {

        return "got hashtable parameter: " + t;

    }

 

}

 

LZX文件 demo.lzx

 

 

< canvas  debug ="true"  height ="300"  width ="800" >
     < debug  x ="250"  y ="10"  width ="500"  height ="275"   />
     < security >
         < allow >
             < pattern > ^examples.TypesExample </ pattern >
         </ allow >
     </ security >
     <!--  See WEB-INF/classes/TypesExample.java for java source.  -->
     < javarpc  name ="types_example_rpc"  scope ="none"
        classname ="examples.TypesExample" >
         < method  event ="onload" >
             <!--  Set buttons visible only after JavaRPC object loads  -->
            canvas.buttons.setAttribute('visible', true);
         </ method >
         < method  event ="ondata"  args ="res" >
            Debug.write('(types ondata) response is:', res);
         </ method >
         < method  event ="onerror"  args ="errmsg" >
            Debug.write('(types onerror) error:', errmsg);
         </ method >
         <!--  Declaratively pass an integer.  -->
         < remotecall  funcname ="passInteger" >
             < param  value ="42"   />
         </ remotecall >
         <!--  Declaratively pass a double. Note that we name this function pd1
            because we have multiple remotecall declarations that call
            passDouble but with different parameters.  -->
         < remotecall  name ="pd1"  funcname ="passDouble" >
             < param  value ="42.1"   />
         </ remotecall >
         <!--  Declaratively pass a double with 0 decimal. The 0 decimal will
            truncate and the number will become an integer type when it reaches
            the server. This call will fail.  -->
         < remotecall  name ="pd2"  funcname ="passDouble" >
             < param  value ="42.0"   />
         </ remotecall >
         <!--  Declaratively pass a double with 0 decimal. Wrapping the double in
            DoubleWrapper will ensure the value will remain a double when
            reaching the server.  -->
         < remotecall  name ="pd3"  funcname ="passDouble" >
             < param >
                 < method  name ="getValue" >
                    return new LzRPC.DoubleWrapper(42.0);
                 </ method >
             </ param >
         </ remotecall >
     </ javarpc >
     < view  name ="buttons"  visible ="false"  layout ="spacing: 10" >
         < button  text ="pass integer"
            onclick ="types_example_rpc.passInteger.invoke()"   />
         < button  text ="pass double"
            onclick ="types_example_rpc.pd1.invoke()"   />
         < button  text ="pass double (will fail)"
            onclick ="types_example_rpc.pd2.invoke()"   />
         < button  text ="pass double w/LzRPC.DoubleWrapper"
            onclick ="types_example_rpc.pd3.invoke()"   />
         < button  text ="pass boolean"
            onclick ="this.passBoolean.invoke()" >
             <!--  This is a way to declare a remotecall closer to where it's being
                used. The remotecontext must be set.  -->
             < remotecall  funcname ="passBoolean"
                remotecontext ="$once{ types_example_rpc }" >
                 < param  value ="true"   />
             </ remotecall >
         </ button >
         < button  text ="pass array"  onclick ="this.passArray.invoke()" >
             < remotecall  name ="passArray"  funcname ="passClientArray"
                remotecontext ="$once{ types_example_rpc }" >
                 < param  value ="[1, 'a string', 4.5, false]"   />
             </ remotecall >
         </ button >
         < button  text ="pass hash"  onclick ="this.passObject.invoke()" >
             < remotecall  name ="passObject"  funcname ="passClientObject"
                remotecontext ="$once{ types_example_rpc }" >
                 < param
                     value ="{ a: 1, b: 3.14159, c: 'a string value', d: true}" >
                 </ param >
             </ remotecall >
         </ button >
     </ view >