Package TWiki::Response

Class to encapsulate response data.

Fields: * status - response status * headers - hashref to response headers * body - response body * cookies - hashref to response cookies

ClassMethod new () -> $response

Constructs a TWiki::Response object.

ObjectMethod status ($status) -> $status

Gets/Sets response status.

  • $status is a three digit code, optionally followed by a status string

ObjectMethod charset ([$charset]) -> $charset

Gets/Sets response charset. If not defined, defaults to ISO-8859-1, just like CGI.pm

ObjectMethod header (-type=>$type,

-status => $status, -cookie => $cookie || \@cookies, -attachment => $attachName, -charset => $charset, -expires => $expires, -HeaderN => ValueN )

Sets response header. Resonably compatible with CGI. Doesn't support -nph, -target and -p3p.

ObjectMethod _header (-type=>$type,

-status => $status, -cookie => $cookie || \@cookies, -attachment => $attachName, -charset => $charset, -expires => $expires, -HeaderN => ValueN )

Private method to set response header like above that doesn't include fix for Item6602. Resonably compatible with CGI. Doesn't support -nph, -target and -p3p.

ObjectMethod headers ({...}) -> $headersHashRef

Gets/Sets all response headers. Keys are headers name and values are scalars for single-valued headers or arrayref for multivalued ones.

ObjectMethod getHeader ([$name]) -> $value

If called without parameters returns all present header names, otherwise returns a list (maybe with a single element) of values associated with $name.

ObjectMethod deleteHeader ($h1,$h2,...)

Deletes headers whose names are passed.

ObjectMethod pushHeader ($name,$value)

Adds $value to list of values associated with header $name.

ObjectMethod cookies ([\@cookies]) -> @cookies

Gets/Sets response cookies. Parameter, if passed, must be an arrayref.

Elements may be CGI::Cookie objects or raw cookie strings.

ObjectMethod body ([$body]) -> $body

Gets/Sets response body.

ObjectMethod redirect ($uri,$status,$cookies|

-Location => $uri, -Status => $status, -Cookies => $cookies )

Populate object with redirect response headers.

$uri must be passed. Others are optional.

CGI Compatibility Note: It doesn't support -target or -nph

ObjectMethod setDefaultHeaders ({$name=>$value,...})

Sets the header, this does not modify the existing key=>value from $this->{headers}. Sets only new values.

r3 - 14 Oct 2013 - 08:02:47 - TWikiContributor
 
Linux & Open Source for AT91 Microchip Microprocessors

Copyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.

Linux® is the registered trademark of Linus Torvalds in the U.S. and other countries.

Microchip® and others, are registered trademarks or trademarks of Microchip Technology Inc. and its subsidiaries. This site is powered by the TWiki collaboration platform

Arm® and others are registered trademarks or trademarks of Arm Limited (or its affiliates). Other terms and product names may be trademarks of others.

Ideas, requests, contributions ? Connect to LinksToCommunities page.

Syndicate this siteRSS ATOM