Jifty::Request::Mapper(3)

NAME
Jifty::Request::Mapper - Maps response values into arbitrary query parameters

DESCRIPTION
"Jifty::Request::Mapper" is used to insert values into parameters that you can't know when you originally constructed the request. The prime example of this is a Create action to a View page -- where you can't know what ID to supply to the View page until after the Create action has run. This problem can be fixed by establishing a mapping between some part of the Jifty::Result of the Create action, and the ID query parameter.

METHODS

  query_parameters HASH
Extended syntax for generating query parameters. This is used by Jifty::Web::Form::Clickable for its "parameters" argument, as well as for "results" of continuations.

Possible formats for each key => value pair in the "HASH" are:

"KEY => STRING"
    The simplest form -- the "KEY" will have the literal value of the "STRING" supplied

"KEY => { result => ACTION }"
    The "KEY" will take on the value of the content named "KEY" from the result of the "ACTION". "ACTION" may either be a Jifty::Action object, or a moniker thereof.

"KEY => { result => ACTION, name => STRING }"
    The "KEY" will take on the value of the content named "STRING" from the result of the "ACTION". "ACTION" may either be a Jifty::Action object, or a moniker thereof.

"KEY => { request_argument => STRING }"
    The "KEY" will take on the value of the argument named "STRING" from the request.

"KEY => { argument => ACTION }"
    The "KEY" will take on the value of the argument named "KEY" from the "ACTION". "ACTION" may either be a Jifty::Action object, or a moniker thereof.

"KEY => { argument => ACTION. name => STRING }"
    The "KEY" will take on the value of the argument named "STRING" from the "ACTION". "ACTION" may either be a Jifty::Action object, or a moniker thereof.

"result_of" and "argument_to" are valid synonyms for "result" and "argument", above.

  map PARAMHASH
Responsible for doing the actual mapping that "query_parameters" above sets up. That is, takes magical query parameters and extracts the values they were meant to have.

destination
    The "key" from a query parameter

source
    The "value" of a query parameter

request
    The Jifty::Request object to pull action arguments from. Defaults to the current request.

response
    The Jifty::Response object to pull results from. Defaults to the current response.

Returns a key => value pair.