manpagez: man pages & more
man Mojo::Message::Response(3)
Home | html | info | man
Mojo::Message::Response(3)



NAME

       Mojo::Message::Response - HTTP response


SYNOPSIS

         use Mojo::Message::Response;

         # Parse
         my $res = Mojo::Message::Response->new;
         $res->parse("HTTP/1.0 200 OK\x0d\x0a");
         $res->parse("Content-Length: 12\x0d\x0a");
         $res->parse("Content-Type: text/plain\x0d\x0a\x0d\x0a");
         $res->parse('Hello World!');
         say $res->code;
         say $res->headers->content_type;
         say $res->body;

         # Build
         my $res = Mojo::Message::Response->new;
         $res->code(200);
         $res->headers->content_type('text/plain');
         $res->body('Hello World!');
         say $res->to_string;


DESCRIPTION

       Mojo::Message::Response is a container for HTTP responses, based on RFC
       7230 <https://tools.ietf.org/html/rfc7230> and RFC 7231
       <https://tools.ietf.org/html/rfc7231>.


EVENTS

       Mojo::Message::Response inherits all events from Mojo::Message.


ATTRIBUTES

       Mojo::Message::Response inherits all attributes from Mojo::Message and
       implements the following new ones.

   code
         my $code = $res->code;
         $res     = $res->code(200);

       HTTP response status code.

   max_message_size
         my $size = $res->max_message_size;
         $res     = $res->max_message_size(1024);

       Maximum message size in bytes, defaults to the value of the
       "MOJO_MAX_MESSAGE_SIZE" environment variable or 2147483648 (2GiB).
       Setting the value to 0 will allow messages of indefinite size.

   message
         my $msg = $res->message;
         $res    = $res->message('OK');

       HTTP response status message.


METHODS

       Mojo::Message::Response inherits all methods from Mojo::Message and
       implements the following new ones.

   cookies
         my $cookies = $res->cookies;
         $res        = $res->cookies(Mojo::Cookie::Response->new);
         $res        = $res->cookies({name => 'foo', value => 'bar'});

       Access response cookies, usually Mojo::Cookie::Response objects.

         # Names of all cookies
         say $_->name for @{$res->cookies};

   default_message
         my $msg = $res->default_message;
         my $msg = $res->default_message(418);

       Generate default response message for status code, defaults to using
       "code".

   extract_start_line
         my $bool = $res->extract_start_line(\$str);

       Extract status-line from string.

   fix_headers
         $res = $res->fix_headers;

       Make sure response has all required headers.

   get_start_line_chunk
         my $bytes = $res->get_start_line_chunk($offset);

       Get a chunk of status-line data starting from a specific position. Note
       that this method finalizes the response.

   is_client_error
         my $bool = $res->is_client_error;

       Check if this response has a "4xx" status "code".

   is_empty
         my $bool = $res->is_empty;

       Check if this response has a "1xx", 204 or 304 status "code".

   is_error
         my $bool = $res->is_error;

       Check if this response has a "4xx" or "5xx" status "code".

   is_info
         my $bool = $res->is_info;

       Check if this response has a "1xx" status "code".

   is_redirect
         my $bool = $res->is_redirect;

       Check if this response has a "3x" status "code".

   is_server_error
         my $bool = $res->is_server_error;

       Check if this response has a "5xx" status "code".

   is_success
         my $bool = $res->is_success;

       Check if this response has a "2xx" status "code".

   start_line_size
         my $size = $req->start_line_size;

       Size of the status-line in bytes. Note that this method finalizes the
       response.


SEE ALSO

       Mojolicious(3), Mojolicious::Guides(3), <https://mojolicious.org>.



perl v5.32.1                      2021-12-08        Mojo::Message::Response(3)

mojolicious 9.260.0 - Generated Thu May 26 08:19:56 CDT 2022
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.