jbe/bsw@0: --[[--
jbe/bsw@0: request.redirect{
jbe/bsw@0:   module = module,  -- module name
jbe/bsw@0:   view   = view,    -- view name
jbe/bsw@0:   id     = id,      -- optional id for view
jbe@113:   params = params,  -- optional view parameters
jbe@113:   anchor = anchor   -- anchor in URL
jbe/bsw@0: }
jbe/bsw@0: 
jbe/bsw@0: Calling this function causes the WebMCP to do a 303 HTTP redirect after the current view or action and all filters have finished execution. If routing mode "redirect" has been chosen, then this function is called automatically after an action and all its filters have finished execution. Calling request.redirect{...} (or request.forward{...}) explicitly inside an action will cause routing information from the browser to be ignored. To preserve GET/POST parameters of an action, use request.forward{...} instead. Currently no redirects to external (absolute) URLs are possible, there will be an implementation in future though.
jbe/bsw@0: 
jbe/bsw@0: --]]--
jbe/bsw@0: 
jbe/bsw@0: function request.redirect(args)
jbe/bsw@0:   -- TODO: support redirects to external URLs too
jbe/bsw@0:   --       (needs fixes in the trace system as well)
jbe/bsw@0:   local module = args.module
jbe/bsw@0:   local view   = args.view
jbe/bsw@0:   local id     = args.id
jbe/bsw@0:   local params = args.params or {}
jbe@113:   local anchor = args.anchor or nil
jbe/bsw@0:   if type(module) ~= "string" then
jbe/bsw@0:     error("No module string passed to request.redirect{...}.")
jbe/bsw@0:   end
jbe/bsw@0:   if type(view) ~= "string" then
jbe/bsw@0:     error("No view string passed to request.redirect{...}.")
jbe/bsw@0:   end
jbe/bsw@0:   if type(params) ~= "table" then
jbe/bsw@0:     error("Params array passed to request.redirect{...} is not a table.")
jbe/bsw@0:   end
jbe@113:   if anchor and type(anchor) ~= "string" then
jbe@113:     error("Anchor passed to request.redirect{...} must be a string or nil.")
jbe@113:   end
jbe/bsw@0:   if request.is_rerouted() then
jbe/bsw@0:     error("Tried to redirect after another forward or redirect.")
jbe/bsw@0:   end
jbe/bsw@0:   request._redirect = {
jbe/bsw@0:     module = module,
jbe/bsw@0:     view   = view,
jbe/bsw@0:     id     = id,
jbe@113:     params = params,
jbe@113:     anchor = anchor
jbe/bsw@0:   }
jbe/bsw@0:   trace.redirect{ module = args.module, view = args.view }
jbe/bsw@0: end