Changes between Version 80 and Version 81 of S3/S3REST/s3_rest_controller

Timestamp:

06/04/13 21:31:57 (11 years ago)

Author:

hardik juneja

Comment:

--

S3/S3REST/s3_rest_controller

@@ -503 +503 @@
 === Method Handlers ===
 
+The s3_rest_controller has multiple hooks,Look at how s3_rest_controller is actually defined in models/00_utils.py:
+
+{{{
+def s3_rest_controller(prefix=None, resourcename=None, **attr):
+
+    set_handler = r.set_handler
+    set_handler("barchart", s3_barchart)
+    set_handler("compose", s3base.S3Compose)
+    set_handler("copy", lambda r, **attr: \
+                               redirect(URL(args="create",
+                                            vars={"from_record":r.id})))
+    set_handler("deduplicate", s3base.S3Merge)
+    set_handler("filter", s3base.S3Filter)
+    set_handler("import", s3base.S3Importer)
+    set_handler("map", s3base.S3Map)
+    set_handler("profile", s3base.S3Profile)
+    set_handler("report", s3base.S3Report)
+    set_handler("import", S3PDF(),
+                    http = ["GET", "POST"],
+                    representation="pdf")
+
+
+    # Execute the request and apply crud functionality or execute other method handler
+    output = r(**attr) 
+    return output
+}}}
+
+This is nothing else than a wrapper for the global r object (an instance of S3Request).
+You don't have to use s3_rest_controller to have a RESTful API, you can make your own handler configuration and call r directly.
+
+But even when using s3_rest_controller, you can take control over what actually happens. A very comfortable (and recommended) way to get control over s3rest when using s3_rest_controller is to hook in prep and postp functions. Look above to find out when prep and postp hooks are invoked.
+
 === Custom Methods ===