Class: Gem::Net::HTTPForbidden

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain: self, `HTTPClientError`, `HTTPResponse`
Instance Chain: self, `HTTPClientError`, `HTTPResponse`, `HTTPHeader`
Inherits:	Gem::Net::HTTPClientError Object Gem::Net::HTTPResponse Gem::Net::HTTPClientError Gem::Net::HTTPForbidden
Defined in:	lib/rubygems/vendor/net-http/lib/net/http/responses.rb

Overview

Response class for Forbidden responses (status code 403).

The request contained valid data and was understood by the server, but the server is refusing action.

This class also includes (indirectly) module HTTPHeader, which gives access to its methods for getting headers.

References:

Constant Summary

HAS_BODY =
# File 'lib/rubygems/vendor/net-http/lib/net/http/responses.rb', line 524
```
true
```

Class Attribute Summary

`HTTPResponse` - Inherited

.body_permitted?

true if the response has a body.

Class Method Summary

`HTTPResponse` - Inherited

.each_response_header, .read_status_line, .response_class,
.exception_type	internal use only.
.new	internal use only.
.read_new	internal use only.

Instance Attribute Summary

`HTTPResponse` - Inherited

#body	Returns the string response body; note that repeated calls for the unmodified body return a cached string:
#body=	Sets the body of the response to the given value.
#body_encoding	Returns the value set by body_encoding=, or `false` if none; see `#body_encoding=`.
#body_encoding=	Sets the encoding that should be used when reading the body:
#code	The HTTP result code string.
#decode_content	Set to true automatically when the request did not contain an Accept-Encoding header from the user.
#http_version	The HTTP version supported by the server.
#ignore_eof	Whether to ignore EOF when reading bodies with a specified Content-Length header.
#message	The HTTP result message sent by the server.
#uri	The `::Gem::URI` used to fetch this response.
#entity	Alias for HTTPResponse#body.
#msg	Alias for HTTPResponse#message.
#uri=

`HTTPHeader` - Included

#chunked?	Returns `true` if field `'Transfer-Encoding'` exists and has value `'chunked'`, `false` otherwise; see Transfer-Encoding response header:
#connection_close?	Returns whether the `HTTP` session is to be closed.
#connection_keep_alive?	Returns whether the `HTTP` session is to be kept alive.
#content_length	Returns the value of field `'Content-Length'` as an integer, or `nil` if there is no such field; see Content-Length request header:
#content_length=	Sets the value of field `'Content-Length'` to the given numeric; see Content-Length response header:

Instance Method Summary

`HTTPResponse` - Inherited

#inspect,
#read_body	Gets the entity body returned by the remote `HTTP` server.
#value	Raises an `HTTP` error if the response is not 2xx (success).
#extracting_encodings_from_meta_elements, #get_attribute, #procdest, #read_body_0, #stream_check,
#code_type	response <-> exception relationship.
#error!, #error_type, #header, #read_header,
#reading_body	body.
#response	header (for backward compatibility only; DO NOT USE).
#check_bom, #detect_encoding,
#inflater	Checks for a supported Content-Encoding header and yields an Inflate wrapper for this response’s socket when zlib is present.
#read_chunked	read_chunked reads from `@socket` for chunk-size, chunk-extension, CRLF, etc.
#scanning_meta, #sniff_encoding

`HTTPHeader` - Included

#[]	Returns the string field value for the case-insensitive field `key`, or `nil` if there is no such key; see `Fields`:
#[]=	Sets the value for the case-insensitive `key` to `val`, overwriting the previous value if the field exists; see `Fields`:
#add_field	Adds value `val` to the value array for field `key` if the field exists; creates the field with the given `key` and `val` if it does not exist.
#basic_auth	Sets header `'Authorization'` using the given `account` and `password` strings:
#canonical_each	Alias for HTTPHeader#each_capitalized.
#content_range	Returns a Range object representing the value of field `'Content-Range'`, or `nil` if no such field exists; see Content-Range response header:
#content_type	Returns the media type from the value of field `'Content-Type'`, or `nil` if no such field exists; see Content-Type response header:
#content_type=	Alias for HTTPHeader#set_content_type.
#delete	Removes the header for the given case-insensitive `key` (see `Fields`); returns the deleted value, or `nil` if no such field exists:
#each	Alias for HTTPHeader#each_header.
#each_capitalized	Like `#each_header`, but the keys are returned in capitalized form.
#each_capitalized_name	Calls the block with each capitalized field name:
#each_header	Calls the block with each key/value pair:
#each_key	Alias for HTTPHeader#each_name.
#each_name	Calls the block with each field key:
#each_value	Calls the block with each string field value:
#fetch	With a block, returns the string value for `key` if it exists; otherwise returns the value of the block; ignores the `default_val`; see `Fields`:
#form_data=	Alias for HTTPHeader#set_form_data.
#get_fields	Returns the array field value for the given `key`, or `nil` if there is no such field; see `Fields`:
#key?	Returns `true` if the field for the case-insensitive `key` exists, `false` otherwise:
#main_type	Returns the leading (‘type’) part of the media type from the value of field `'Content-Type'`, or `nil` if no such field exists; see Content-Type response header:
#proxy_basic_auth	Sets header `'Proxy-Authorization'` using the given `account` and `password` strings:
#range	Returns an array of Range objects that represent the value of field `'Range'`, or `nil` if there is no such field; see Range request header:
#range=	Alias for HTTPHeader#set_range.
#range_length	Returns the integer representing length of the value of field `'Content-Range'`, or `nil` if no such field exists; see Content-Range response header:
#set_content_type	Sets the value of field `'Content-Type'`; returns the new value; see Content-Type request header:
#set_form	Stores form data to be used in a `POST` or `PUT` request.
#set_form_data	Sets the request body to a URL-encoded string derived from argument `params`, and sets request header field `'Content-Type'` to `'application/x-www-form-urlencoded'`.
#set_range	Sets the value for field `'Range'`; see Range request header:
#sub_type	Returns the trailing (‘subtype’) part of the media type from the value of field `'Content-Type'`, or `nil` if no such field exists; see Content-Type response header:
#to_hash	Returns a hash of the key/value pairs:
#type_params	Returns the trailing (‘parameters’) part of the value of field `'Content-Type'`, or `nil` if no such field exists; see Content-Type response header:
#append_field_value, #basic_encode, #capitalize, #set_field, #initialize_http_header,
#length	Alias for HTTPHeader#size.
#size	obsolete.

Constructor Details

This class inherits a constructor from Gem::Net::HTTPResponse

Class: Gem::Net::HTTPForbidden

Overview

Constant Summary

HTTPHeader - Included

HTTPResponse - Inherited

HTTPClientError - Inherited

Class Attribute Summary

HTTPResponse - Inherited

Class Method Summary

HTTPResponse - Inherited

Instance Attribute Summary

HTTPResponse - Inherited

HTTPHeader - Included

Instance Method Summary

HTTPResponse - Inherited

HTTPHeader - Included

Constructor Details

`HTTPHeader` - Included

`HTTPResponse` - Inherited

`HTTPClientError` - Inherited

`HTTPResponse` - Inherited

`HTTPResponse` - Inherited

`HTTPResponse` - Inherited

`HTTPHeader` - Included

`HTTPResponse` - Inherited

`HTTPHeader` - Included