class SF::Http::Request

Overview

Define a HTTP request

Defined in:

network/obj.cr

Constructors

Instance Method Summary

Constructor Detail

def self.new(uri : String = "/", method : Http::Request::Method = Get, body : String = "") #

Default constructor

This constructor creates a GET request, with the root URI ("/") and an empty body.

  • uri - Target URI
  • method - Method to use for the request
  • body - Content of the request's body

[View source]

Instance Method Detail

def body=(body : String) #

Set the body of the request

The body of a request is optional and only makes sense for POST requests. It is ignored for all other methods. The body is empty by default.

  • body - Content of the body

[View source]
def dup : Request #
Description copied from class Reference

Returns a shallow copy of this object.

This allocates a new object and copies the contents of self into it.


[View source]
def finalize #

[View source]
def method=(method : Http::Request::Method) #

Set the request method

See the Method enumeration for a complete list of all the availale methods. The method is Http::Request::Get by default.

  • method - Method to use for the request

[View source]
def set_field(field : String, value : String) #

Set the value of a field

The field is created if it doesn't exist. The name of the field is case-insensitive. By default, a request doesn't contain any field (but the mandatory fields are added later by the HTTP client when sending the request).

  • field - Name of the field to set
  • value - Value of the field

[View source]
def set_http_version(major : Int, minor : Int) #

Set the HTTP version for the request

The HTTP version is 1.0 by default.

  • major - Major HTTP version number
  • minor - Minor HTTP version number

[View source]
def uri=(uri : String) #

Set the requested URI

The URI is the resource (usually a web page or a file) that you want to get or post. The URI is "/" (the root page) by default.

  • uri - URI to request, relative to the host

[View source]