S3Request Class

Attributes of S3Request

The following attributes are set during initialisation of an S3Request object, no further call is required.

Environment

request	the original web2py request (Storage)
session	the current session (Storage)
response	the web2py response (Storage)

Request Attributes

representation	the current representation of this request (string, lowercase)
http	the HTTP method of this request (string, always uppercase!)
extension	the extension found in the original request (string, lowercase)
method	the method of the request if not HTTP (string, always lowercase)
custom_action	the custom method handler for the request (function or lambda)

Primary Resource Attributes

resource	the target resource of the request (S3Resource)
prefix	the prefix (=module name) of the requested resource (string)
name	the name of the requested resource, without prefix (string)
tablename	the name of the primary table (string)
table	the primary table (Table)
id	the ID of the primary record (int)
record	the primary record (Row)

Component Resource Attributes

component	the requested component, if any (!S3ResourceComponent)
pkey	the primary key of the Resource/Component join (string)
fkey	the foreign key of the Resource/Component join (string)
component_name	the name of the component without prefix (string)
component_id	the ID of the component record as of the request, if any (int)
multiple	Flag indicating that multiple component records are allowed (boolean)

!S3ResourceComponent contains:

• prefix, name, tablename, table and attr of the component
• attr contains:
  • multiple Multiple-flag
• methods: set_attr() and get_attr()

Methods of the S3Request

Magic URLs

here(representation=None)

• returns the URL of the current request

there(representation=None)

• returns the URL of a HTTP GET request for the same resource

same(representation=None)

• returns the URL of the current request with the primary record ID replaced by the string literal '[id]'

other(method=None, record_id=None, representation=None)

• returns the URL of a request with another method and record ID, but for the same resource

Other functions

target()

• returns the target table of the current request as tuple of (prefix, name, table, tablename)