Some of the information here may be outdated, please check the book instead

The example in this page still works but it is deprecated since things are much simpler since web2py 1.61 which include decorator @service.amfrpc

by Sharriff Aina

I would explain with a very simple example how you can create Flash RPC applications using Web2py as a RPC service provider. I expect you to be familiar with the following topics as they are beyond the scope of this HowTo: Actionscript programming

  • RPC Web services
  • AMF
  • Web2PY programming

Start off by getting the latest Web2Py from the site. Next, retrieve the latest version of PyAMF from the Python CheeseShop or directly from the PyAMF site

Lets create a simple service that takes 2 numerical values, adds them together and returns the sum. We would call the service addNumbers. Create a flash file using Adobe Flash (all versions as from MX 2004), in the first frame of the file, add these lines:

import mx.remoting.Service;
import mx.rpc.RelayResponder;
import mx.rpc.FaultEvent;
import mx.rpc.ResultEvent;
import mx.remoting.PendingCall;

val1 = 23;
val2 = 86;

service = new Service("http://localhost:8000/pyamf_test/default/
gateway", null, "addNumbers", null, null);
var pc:PendingCall = service.addNumbers(val1, val2);
pc.responder = new RelayResponder(this, "onResult", "onFault");

function onResult(re:ResultEvent):Void {
    trace("Result : " + re.result);
    txt_result.text = re.result;

function onFault(fault:FaultEvent):Void {
    trace("Fault: " + fault.fault.faultstring);

The last thing to do would be to create a dynamic text field called txt_result and place it on the stage.

As you have noticed, we have imported the mx remoting classes to enable Remoting in Flash, you can get them here. I would be using the Actionscript version 2 version of the classes. Add the path of the classes to your class path in the Adobe Flash IDE or just place the mx folder next to the newly created file. Compile and export(publish) the swf flash file as pyamf_test.swf.

Lets set up the gateway in Web2Py as we defined in our Flash file, create a new appliance, pyamf_test, in the default controller, create a function called gateway and add these lines to it:

import pyamf
import pyamf.remoting.gateway

def addNumbers(val1, val2):
    return val1 + val2


def gateway():
    base_gateway = pyamf.remoting.gateway.BaseGateway(services)
    context = pyamf.get_context(pyamf.AMF0)
    pyamf_request = pyamf.remoting.decode(, context)
    pyamf_response = pyamf.remoting.Envelope(pyamf_request.amfVersion,
    for name, message in pyamf_request:
        pyamf_response[name] = base_gateway.getProcessor(message)(message)
    response.headers['Content-Type'] = pyamf.remoting.CONTENT_TYPE
    return pyamf.remoting.encode(pyamf_response, context).getvalue()

Next, place the pyamf_test.amf, pyamf_test.html, AC_RunActiveContent.js, crossdomain.xml files in the static folder of the pyamf_test controller,fireup web2py using 8000 as the server port, point your browser to http://localhost:8000/pyamf_test/static/pyamf_test.html and see the result of the addNumbers function displayed in the textfield.

© 2008-2010 by Massimo Di Pierro - All rights reserved - Powered by web2py - design derived from a theme by the earlybird
The content of this book is released under the Artistic License 2.0 - Modified content cannot be reproduced.