Class: Faraday::Request::UrlEncoded

Inherits:
Middleware show all
Defined in:
lib/faraday/request/url_encoded.rb

Overview

Middleware for supporting urlencoded requests.

Direct Known Subclasses

Multipart

Constant Summary collapse

CONTENT_TYPE = 
'Content-Type'

Class Attribute Summary collapse

Attributes included from DependencyLoader

#load_error

Instance Method Summary collapse

Methods inherited from Middleware

#initialize

Methods included from MiddlewareRegistry

#fetch_middleware, #load_middleware, #lookup_middleware, #middleware_mutex, #register_middleware, #unregister_middleware

Methods included from DependencyLoader

#dependency, #inherited, #loaded?, #new

Constructor Details

This class inherits a constructor from Faraday::Middleware

Class Attribute Details

.mime_type ⇒ Object

Returns the value of attribute mime_type.



10
11
12
 
# File 'lib/faraday/request/url_encoded.rb', line 10

def mime_type
  @mime_type
end

Instance Method Details

#call(env) ⇒ Object

Encodes as “application/x-www-form-urlencoded” if not already encoded or of another type.

Parameters:



18
19
20
21
22
23
24
 
# File 'lib/faraday/request/url_encoded.rb', line 18

def call(env)
  match_content_type(env) do |data|
    params = Faraday::Utils::ParamsHash[data]
    env.body = params.to_query(env.params_encoder)
  end
  @app.call env
end

#match_content_type(env) {|request_body| ... } ⇒ Object

Parameters:

Yields:

  • (request_body) —

    Body of the request



28
29
30
31
32
33
 
# File 'lib/faraday/request/url_encoded.rb', line 28

def match_content_type(env)
  return unless process_request?(env)

  env.request_headers[CONTENT_TYPE] ||= self.class.mime_type
  yield(env.body) unless env.body.respond_to?(:to_str)
end

#process_request?(env) ⇒ Boolean

Returns True if the request has a body and its Content-Type is urlencoded.

Parameters:

Returns:

  • (Boolean) —

    True if the request has a body and its Content-Type is urlencoded.



39
40
41
42
 
# File 'lib/faraday/request/url_encoded.rb', line 39

def process_request?(env)
  type = request_type(env)
  env.body && (type.empty? || (type == self.class.mime_type))
end

#request_type(env) ⇒ String

Parameters:

Returns:

  • (String) 


47
48
49
50
51
 
# File 'lib/faraday/request/url_encoded.rb', line 47

def request_type(env)
  type = env.request_headers[CONTENT_TYPE].to_s
  type = type.split(';', 2).first if type.index(';')
  type
end