Class: HTTP::Message
- Inherits:
-
Object
- Object
- HTTP::Message
- Defined in:
- lib/httpclient/http.rb,
lib/oauthclient.rb
Overview
Represents a HTTP message. A message is for a request or a response.
Request message is generated from given parameters internally so users don’t need to care about it. Response message is the instance that methods of HTTPClient returns so users need to know how to extract HTTP response data from Message.
Some attributes are only for a request or a response, not both.
How to use HTTP response message
-
Gets response message body.
res = clnt.get(url) p res.content #=> String
-
Gets response status code.
res = clnt.get(url) p res.status #=> 200, 501, etc. (Integer)
-
Gets response header.
res = clnt.get(url) res.header['set-cookie'].each do |value| p value end assert_equal(1, res.header['last-modified'].size) p res.header['last-modified'].first
Defined Under Namespace
Constant Summary collapse
- CRLF =
"\r\n"
- @@mime_type_handler =
nil
Instance Attribute Summary collapse
-
#body ⇒ Object
- HTTP::Message::Body
-
message body.
-
#header ⇒ Object
- HTTP::Message::Headers
-
message header.
-
#oauth_params ⇒ Object
Returns the value of attribute oauth_params.
-
#peer_cert ⇒ Object
- OpenSSL::X509::Certificate
-
response only.
Class Method Summary collapse
-
.create_query_part_str(query) ⇒ Object
:nodoc:.
-
.escape(str) ⇒ Object
from CGI.escape.
-
.escape_query(query) ⇒ Object
:nodoc:.
-
.file?(obj) ⇒ Boolean
Returns true if the given object is a File.
-
.internal_mime_type(path) ⇒ Object
Default MIME type handler.
-
.keep_alive_enabled?(version) ⇒ Boolean
Returns true if the given HTTP version allows keep alive connection.
-
.mime_type(path) ⇒ Object
:nodoc:.
-
.mime_type_handler ⇒ Object
(also: get_mime_type_func)
Returns MIME type handler.
-
.mime_type_handler=(handler) ⇒ Object
(also: set_mime_type_func)
Sets MIME type handler.
-
.multiparam_query?(query) ⇒ Boolean
Returns true if the given query (or body) has a multiple parameter.
-
.new_connect_request(uri) ⇒ Object
Creates a Message instance of ‘CONNECT’ request.
-
.new_request(method, uri, query = nil, body = nil, boundary = nil) ⇒ Object
Creates a Message instance of general request.
-
.new_response(body) ⇒ Object
Creates a Message instance of response.
-
.parse(query) ⇒ Object
from CGI.parse.
-
.unescape(string) ⇒ Object
from CGI.unescape.
Instance Method Summary collapse
-
#content ⇒ Object
Returns a content of message body.
-
#contenttype ⇒ Object
Sets ‘Content-Type’ header value.
-
#contenttype=(contenttype) ⇒ Object
Returns ‘Content-Type’ header value.
-
#dump(dev = '') ⇒ Object
Dumps message (header and body) to given dev.
-
#initialize ⇒ Message
constructor
Creates a Message.
-
#reason ⇒ Object
Returns HTTP status reason phrase in response.
-
#reason=(reason) ⇒ Object
Sets HTTP status reason phrase of response.
-
#status ⇒ Object
(also: #code, #status_code)
Returns HTTP status code in response.
-
#status=(status) ⇒ Object
Sets HTTP status code of response.
-
#version ⇒ Object
Returns HTTP version in a HTTP header.
-
#version=(version) ⇒ Object
Sets HTTP version in a HTTP header.
Constructor Details
Instance Attribute Details
#body ⇒ Object
- HTTP::Message::Body
-
message body.
818 819 820 |
# File 'lib/httpclient/http.rb', line 818 def body @body end |
#header ⇒ Object
- HTTP::Message::Headers
-
message header.
815 816 817 |
# File 'lib/httpclient/http.rb', line 815 def header @header end |
#oauth_params ⇒ Object
Returns the value of attribute oauth_params.
13 14 15 |
# File 'lib/oauthclient.rb', line 13 def oauth_params @oauth_params end |
#peer_cert ⇒ Object
- OpenSSL::X509::Certificate
-
response only. server certificate which is used for retrieving the response.
822 823 824 |
# File 'lib/httpclient/http.rb', line 822 def peer_cert @peer_cert end |
Class Method Details
.create_query_part_str(query) ⇒ Object
:nodoc:
759 760 761 762 763 764 765 766 767 |
# File 'lib/httpclient/http.rb', line 759 def create_query_part_str(query) # :nodoc: if multiparam_query?(query) escape_query(query) elsif query.respond_to?(:read) query = query.read else query.to_s end end |
.escape(str) ⇒ Object
from CGI.escape
779 780 781 782 783 784 785 786 787 788 789 |
# File 'lib/httpclient/http.rb', line 779 def escape(str) # :nodoc: if str.respond_to?(:force_encoding) str.dup.force_encoding('BINARY').gsub(/([^ a-zA-Z0-9_.-]+)/) { '%' + $1.unpack('H2' * $1.bytesize).join('%').upcase }.tr(' ', '+') else str.gsub(/([^ a-zA-Z0-9_.-]+)/n) { '%' + $1.unpack('H2' * $1.bytesize).join('%').upcase }.tr(' ', '+') end end |
.escape_query(query) ⇒ Object
:nodoc:
769 770 771 772 773 774 775 776 |
# File 'lib/httpclient/http.rb', line 769 def escape_query(query) # :nodoc: query.sort_by { |attr, value| attr.to_s }.collect { |attr, value| if value.respond_to?(:read) value = value.read end escape(attr.to_s) << '=' << escape(value.to_s) }.join('&') end |
.file?(obj) ⇒ Boolean
Returns true if the given object is a File. In HTTPClient, a file is;
-
must respond to :read for retrieving String chunks.
-
must respond to :pos and :pos= to rewind for reading. Rewinding is only needed for following HTTP redirect. Some IO impl defines :pos= but raises an Exception for pos= such as StringIO but there’s no problem as far as using it for non-following methods (get/post/etc.)
754 755 756 757 |
# File 'lib/httpclient/http.rb', line 754 def file?(obj) obj.respond_to?(:read) and obj.respond_to?(:pos) and obj.respond_to?(:pos=) end |
.internal_mime_type(path) ⇒ Object
Default MIME type handler. See mime_type_handler=.
717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 |
# File 'lib/httpclient/http.rb', line 717 def internal_mime_type(path) case path when /\.txt$/i 'text/plain' when /\.(htm|html)$/i 'text/html' when /\.doc$/i 'application/msword' when /\.png$/i 'image/png' when /\.gif$/i 'image/gif' when /\.(jpg|jpeg)$/i 'image/jpeg' else 'application/octet-stream' end end |
.keep_alive_enabled?(version) ⇒ Boolean
Returns true if the given HTTP version allows keep alive connection.
- version
-
Float
738 739 740 |
# File 'lib/httpclient/http.rb', line 738 def keep_alive_enabled?(version) version >= 1.1 end |
.mime_type(path) ⇒ Object
:nodoc:
702 703 704 705 706 707 708 709 710 711 712 713 |
# File 'lib/httpclient/http.rb', line 702 def mime_type(path) # :nodoc: if @@mime_type_handler res = @@mime_type_handler.call(path) if !res || res.to_s == '' return 'application/octet-stream' else return res end else internal_mime_type(path) end end |
.mime_type_handler ⇒ Object Also known as: get_mime_type_func
Returns MIME type handler.
694 695 696 |
# File 'lib/httpclient/http.rb', line 694 def mime_type_handler @@mime_type_handler end |
.mime_type_handler=(handler) ⇒ Object Also known as: set_mime_type_func
Sets MIME type handler.
handler must respond to :call with a single argument :path and returns a MIME type String e.g. ‘text/html’. When the handler returns nil or an empty String, ‘application/octet-stream’ is used.
When you set nil to the handler, internal_mime_type is used instead. The handler is nil by default.
689 690 691 |
# File 'lib/httpclient/http.rb', line 689 def mime_type_handler=(handler) @@mime_type_handler = handler end |
.multiparam_query?(query) ⇒ Boolean
Returns true if the given query (or body) has a multiple parameter.
743 744 745 |
# File 'lib/httpclient/http.rb', line 743 def multiparam_query?(query) query.is_a?(Array) or query.is_a?(Hash) end |
.new_connect_request(uri) ⇒ Object
Creates a Message instance of ‘CONNECT’ request. ‘CONNECT’ request does not have Body.
- uri
-
an URI that need to connect. Only uri.host and uri.port are used.
633 634 635 636 637 638 |
# File 'lib/httpclient/http.rb', line 633 def new_connect_request(uri) m = new m.header.init_connect_request(uri) m.header.body_size = nil m end |
.new_request(method, uri, query = nil, body = nil, boundary = nil) ⇒ Object
Creates a Message instance of general request.
- method
-
HTTP method String.
- uri
-
an URI object which represents an URL of web resource.
- query
-
a Hash or an Array of query part of URL. e.g. { “a” => “b” } => ‘host/part?a=b’ Give an array to pass multiple value like
- [“a”, “b”], [“a”, “c”]
-
> ‘host/part?a=b&a=c’
- body
-
a Hash or an Array of body part. e.g. { “a” => “b” } => ‘a=b’. Give an array to pass multiple value like
- [“a”, “b”], [“a”, “c”]
-
> ‘a=b&a=c’.
- boundary
-
When the boundary given, it is sent as a multipart/form-data using this boundary String.
653 654 655 656 657 658 659 660 661 662 663 664 665 |
# File 'lib/httpclient/http.rb', line 653 def new_request(method, uri, query = nil, body = nil, boundary = nil) m = new m.header.init_request(method, uri, query) m.body = Body.new m.body.init_request(body || '', boundary) if body m.header.body_size = m.body.size m.header.chunked = true if m.body.size.nil? else m.header.body_size = nil end m end |
.new_response(body) ⇒ Object
Creates a Message instance of response.
- body
-
a String or an IO of response message body.
669 670 671 672 673 674 675 676 |
# File 'lib/httpclient/http.rb', line 669 def new_response(body) m = new m.header.init_response(Status::OK) m.body = Body.new m.body.init_response(body) m.header.body_size = m.body.size || 0 m end |
.parse(query) ⇒ Object
from CGI.parse
792 793 794 795 796 797 798 799 800 801 802 803 |
# File 'lib/httpclient/http.rb', line 792 def parse(query) params = Hash.new([].freeze) query.split(/[&;]/n).each do |pairs| key, value = pairs.split('=',2).collect{|v| unescape(v) } if params.has_key?(key) params[key].push(value) else params[key] = [value] end end params end |
.unescape(string) ⇒ Object
from CGI.unescape
806 807 808 809 810 |
# File 'lib/httpclient/http.rb', line 806 def unescape(string) string.tr('+', ' ').gsub(/((?:%[0-9a-fA-F]{2})+)/n) do [$1.delete('%')].pack('H*') end end |
Instance Method Details
#content ⇒ Object
Returns a content of message body. A String or an IO.
897 898 899 |
# File 'lib/httpclient/http.rb', line 897 def content @body.content end |
#contenttype ⇒ Object
Sets ‘Content-Type’ header value. Overrides if already exists.
887 888 889 |
# File 'lib/httpclient/http.rb', line 887 def contenttype @header.contenttype end |
#contenttype=(contenttype) ⇒ Object
Returns ‘Content-Type’ header value.
892 893 894 |
# File 'lib/httpclient/http.rb', line 892 def contenttype=(contenttype) @header.contenttype = contenttype end |
#dump(dev = '') ⇒ Object
Dumps message (header and body) to given dev. dev needs to respond to <<.
834 835 836 837 838 839 840 841 842 843 844 |
# File 'lib/httpclient/http.rb', line 834 def dump(dev = '') str = header.dump + CRLF if header.chunked dev = body.dump_chunked(str, dev) elsif body dev = body.dump(str, dev) else dev << str end dev end |
#reason ⇒ Object
Returns HTTP status reason phrase in response. String.
877 878 879 |
# File 'lib/httpclient/http.rb', line 877 def reason @header.reason_phrase end |
#reason=(reason) ⇒ Object
Sets HTTP status reason phrase of response. String.
882 883 884 |
# File 'lib/httpclient/http.rb', line 882 def reason=(reason) @header.reason_phrase = reason end |
#status ⇒ Object Also known as: code, status_code
Returns HTTP status code in response. Integer.
863 864 865 |
# File 'lib/httpclient/http.rb', line 863 def status @header.status_code end |
#status=(status) ⇒ Object
Sets HTTP status code of response. Integer. Reason phrase is updated, too.
872 873 874 |
# File 'lib/httpclient/http.rb', line 872 def status=(status) @header.status_code = status end |
#version ⇒ Object
Returns HTTP version in a HTTP header. Float.
853 854 855 |
# File 'lib/httpclient/http.rb', line 853 def version @header.http_version end |
#version=(version) ⇒ Object
Sets HTTP version in a HTTP header. Float.
858 859 860 |
# File 'lib/httpclient/http.rb', line 858 def version=(version) @header.http_version = version end |