NAME
App::Request - the request
SYNOPSIS
# ... official way to get a Request object ...
use App;
$context = App->context();
$request = $context->request(); # get the request
# ... alternative way (used internally) ...
use App::Request;
$request = App::Request->new();
DESCRIPTION
A Request class ...
Class Group: Request
The following classes might be a part of the Request Class Group.
Class: App::Request
Class: App::Request::CGI
Constructor Methods:
new()
The App::Request->new() method is rarely called directly. That is because the current request is usually accessed through the $context object.
* Signature: $request = App::Request->new($context, $named);
* Return: $request App::Request
* Throws: App::Exception
* Since: 0.01
Sample Usage:
$request = App::Request->new();
Protected Methods:
The following methods are intended to be called by subclasses of the current class (or environmental, "main" code).
_init()
The _init() method is called from within the standard Request constructor. The _init() method in this class does nothing. It allows subclasses of the Request to customize the behavior of the constructor by overriding the _init() method.
* Signature: $request->_init()
* Param: void
* Return: void
* Throws: App::Exception
* Since: 0.01
Sample Usage:
$request->_init();
Public Methods
user()
The user() method returns the username of the authenticated user. The special name, "guest", refers to the unauthenticated (anonymous) user.
* Signature: $username = $request->user();
* Param: void
* Return: string
* Throws: <none>
* Since: 0.01
Sample Usage:
$username = $request->user();
http_method()
Returns the HTTP method used in this request (i.e. "GET" or "POST").
* Signature: $http_method = $request->http_method();
* Param: void
* Return: string
* Throws: <none>
* Since: 0.01
Sample Usage:
$http_method = $request->http_method();
content_type()
Returns the content_type of data submitted in a POST, generally "multipart/form-data" or "application/x-www-form-urlencoded".
* Signature: $content_type = $request->content_type();
* Param: void
* Return: string
* Throws: <none>
* Since: 0.01
Sample Usage:
$content_type = $request->content_type();
get_session_id()
The get_session_id() method returns the session_id in the request.
* Signature: $session_id = $request->get_session_id();
* Param: void
* Return: $session_id string
* Throws: <none>
* Since: 0.01
Sample Usage:
$session_id = $request->get_session_id();