class Excon::Connection
def request(params, &block)
(**params)
-
:scheme
(String
) -- The protocol; 'https' causes OpenSSL to be used -
:query
(Hash
) -- appended to the 'scheme://host:port/path/' in the form of '?key=value' -
:port
(Fixnum
) -- The port on which to connect, to the destination host -
:path
(String
) -- appears after 'scheme://host:port/' -
:host
(String
) -- The destination host's reachable DNS name or IP, in the form of a String -
:headers
(Hash
) -- The default headers to supply in a request -
:body
(String
) -- text to be sent over a socket
Parameters:
-
params
(Hash
) -- One or more optional params, override defaults set in Connection.new
Other tags:
- Yield: - @see Response#self.parse
def request(params, &block) begin # connection has defaults, merge in new params to override params = @connection.merge(params) params[:headers] = @connection[:headers].merge(params[:headers] || {}) params[:headers]['Host'] ||= '' << params[:host] << ':' << params[:port] # if path is empty or doesn't start with '/', insert one unless params[:path][0, 1] == '/' params[:path].insert(0, '/') end unless params[:mock] socket.params = params else for stub, response in Excon.stubs # all specified non-headers params match and no headers were specified or all specified headers match if (stub.keys - [:headers]).all? {|key| stub[key] == params[key] } && (!stub.has_key?(:headers) || stub[:headers].keys.all? {|key| stub[:headers][key] == params[:headers][key]}) response_attributes = case response when Proc response.call(params) else response end if block_given? && response_attributes.has_key?(:body) body = response_attributes.delete(:body) content_length = remaining = body.bytesize i = 0 while i < body.length yield(body[i, CHUNK_SIZE], [remaining - CHUNK_SIZE, 0].max, content_length) remaining -= CHUNK_SIZE i += CHUNK_SIZE end end return Excon::Response.new(response_attributes) end end # if we reach here no stubs matched raise(Excon::Errors::StubNotFound.new('no stubs matched ' << params.inspect)) end # start with "METHOD /path" request = params[:method].to_s.upcase << ' ' if @proxy request << params[:scheme] << '://' << params[:host] << ':' << params[:port] end request << params[:path] # add query to path, if there is one case params[:query] when String request << '?' << params[:query] when Hash request << '?' for key, values in params[:query] if values.nil? request << key.to_s << '&' else for value in [*values] request << key.to_s << '=' << CGI.escape(value.to_s) << '&' end end end request.chop! # remove trailing '&' end # finish first line with "HTTP/1.1\r\n" request << HTTP_1_1 # calculate content length and set to handle non-ascii unless params[:headers].has_key?('Content-Length') params[:headers]['Content-Length'] = case params[:body] when File params[:body].binmode File.size(params[:body]) when String if FORCE_ENC params[:body].force_encoding('BINARY') end params[:body].length else 0 end end # add headers to request for key, values in params[:headers] for value in [*values] request << key.to_s << ': ' << value.to_s << CR_NL end end # add additional "\r\n" to indicate end of headers request << CR_NL # write out the request, sans body socket.write(request) # write out the body if params[:body] if params[:body].is_a?(String) socket.write(params[:body]) else while chunk = params[:body].read(CHUNK_SIZE) socket.write(chunk) end end end # read the response response = Excon::Response.parse(socket, params, &block) if response.headers['Connection'] == 'close' reset end response rescue Excon::Errors::StubNotFound => stub_not_found raise(stub_not_found) rescue => socket_error reset raise(Excon::Errors::SocketError.new(socket_error)) end if params.has_key?(:expects) && ![*params[:expects]].include?(response.status) reset raise(Excon::Errors.status_error(params, response)) else response end rescue => request_error if params[:idempotent] && [Excon::Errors::SocketError, Excon::Errors::HTTPStatusError].any? {|ex| request_error.kind_of? ex } retries_remaining ||= retry_limit retries_remaining -= 1 if retries_remaining > 0 if params[:body].respond_to?(:pos=) params[:body].pos = 0 end retry else raise(request_error) end else raise(request_error) end ensure if params[:body] && params[:body].respond_to?(:close) params[:body].close end end