Lines Matching refs:Request
5 // HTTP Request reading and parsing.
32 // is either not present in the request or not a file field.
35 // HTTP request parsing errors.
48 ErrNotMultipart = &ProtocolError{"request Content-Type isn't multipart/form-data"}
59 // Headers that Request.Write handles itself and should be skipped.
68 // A Request represents an HTTP request received by a server
73 // documentation for Request.Write and RoundTripper.
74 type Request struct {
83 // supplied on the Request-Line as stored in RequestURI. For
88 // connect to, while the Request's Host field optionally
90 // request.
99 // A header maps request lines to their values.
115 // The request parser implements this by canonicalizing the
122 // See the documentation for the Request.Write method.
125 // Body is the request's body.
127 // For client requests a nil body means the request has no
128 // body, such as a GET request. The HTTP Client's Transport
131 // For server requests the Request Body is always non-nil
133 // The Server will close the request body. The ServeHTTP
152 // replying to this request (for servers) or after sending
153 // the request (for clients).
162 // header to send. If empty, the Request.Write method uses
184 // Trailer specifies additional headers that are sent after the request
196 // values. The ContentLength must be 0 or -1, to send a chunked request.
197 // After the HTTP request is sent the map values can be updated while
198 // the request body is read. Once the body returns EOF, the caller must
205 // the network address that sent the request, usually for
213 // RequestURI is the unmodified Request-URI of the
214 // Request-Line (RFC 2616, Section 5.1) as sent by the client
216 // It is an error to set this field in an HTTP client request.
220 // information about the TLS connection on which the request
229 // request should be regarded as canceled. Not all implementations of
237 // in the request is at least major.minor.
238 func (r *Request) ProtoAtLeast(major, minor int) bool {
243 // UserAgent returns the client's User-Agent, if sent in the request.
244 func (r *Request) UserAgent() string {
248 // Cookies parses and returns the HTTP cookies sent with the request.
249 func (r *Request) Cookies() []*Cookie {
253 // ErrNoCookie is returned by Request's Cookie method when a cookie is not found.
256 // Cookie returns the named cookie provided in the request or
258 func (r *Request) Cookie(name string) (*Cookie, error) {
265 // AddCookie adds a cookie to the request. Per RFC 6265 section 5.4,
269 func (r *Request) AddCookie(c *Cookie) {
278 // Referer returns the referring URL, if sent in the request.
280 // Referer is misspelled as in the request itself, a mistake from the
286 func (r *Request) Referer() string {
291 // Its presence in Request.MultipartForm indicates that parsing of the request
299 // multipart/form-data POST request, else returns nil and an error.
301 // process the request body as a stream.
302 func (r *Request) MultipartReader() (*multipart.Reader, error) {
313 func (r *Request) multipartReader() (*multipart.Reader, error) {
343 // Write writes an HTTP/1.1 request, which is the header and body, in wire format.
344 // This method consults the following fields of the request:
356 func (r *Request) Write(w io.Writer) error {
360 // WriteProxy is like Write but writes the request in the form
362 // initial Request-URI line of the request with an absolute URI, per
366 func (r *Request) WriteProxy(w io.Writer) error {
371 func (req *Request) write(w io.Writer, usingProxy bool, extraHeaders Header) error {
373 // is not given, use the host from the request URL.
379 return errors.New("http: Request.Write on Request with no Host or URL set")
480 // would create a bad request. So it is enough to just truncate at the
534 // NewRequest returns a new Request given a method, URL, and optional body.
537 // Request.Body is set to body and will be closed by the Client
540 // NewRequest returns a Request suitable for use with Client.Do or
542 // To create a request for use with testing a Server Handler use either
543 // ReadRequest or manually update the Request fields. See the Request
545 // request fields.
546 func NewRequest(method, urlStr string, body io.Reader) (*Request, error) {
555 req := &Request{
579 // BasicAuth returns the username and password provided in the request's
580 // Authorization header, if the request uses HTTP Basic Authentication.
582 func (r *Request) BasicAuth() (username, password string, ok bool) {
609 // SetBasicAuth sets the request's Authorization header to use HTTP
614 func (r *Request) SetBasicAuth(username, password string) {
645 // ReadRequest reads and parses an incoming request from b.
646 func ReadRequest(b *bufio.Reader) (req *Request, err error) {
649 req = new(Request)
666 return nil, &badStringError{"malformed HTTP request", s}
729 // limiting the size of incoming request bodies. In contrast to
735 // sending a large request and wasting server resources.
755 return 0, errors.New("http: request body too large")
806 func parsePostForm(r *Request) (vs url.Values, err error) {
854 // For POST or PUT requests, it also parses the request body as a form and
859 // If the request Body's size has not already been limited by MaxBytesReader,
864 func (r *Request) ParseForm() error {
899 // ParseMultipartForm parses a request body as multipart/form-data.
900 // The whole request body is parsed and up to a total of maxMemory bytes of
905 func (r *Request) ParseMultipartForm(maxMemory int64) error {
942 // then inspect Request.Form directly.
943 func (r *Request) FormValue(key string) string {
954 // or PUT request body. URL query parameters are ignored.
958 func (r *Request) PostFormValue(key string) string {
970 func (r *Request) FormFile(key string) (multipart.File, *multipart.FileHeader, error) {
989 func (r *Request) expectsContinue() bool {
993 func (r *Request) wantsHttp10KeepAlive() bool {
1000 func (r *Request) wantsClose() bool {
1004 func (r *Request) closeBody() {
