module Restforce::Concerns::Connection
def adapter
def adapter options[:adapter] end
def connection
def connection @connection ||= Faraday.new(options[:instance_url], connection_options) do |builder| # Parses JSON into Hashie::Mash structures. unless options[:mashify] == false builder.use Restforce::Middleware::Mashify, self, options end # Handles multipart file uploads for blobs. builder.use Restforce::Middleware::Multipart # Converts the request into JSON. builder.request :json # Handles reauthentication for 403 responses. if authentication_middleware builder.use authentication_middleware, self, options end # Sets the oauth token in the headers. builder.use Restforce::Middleware::Authorization, self, options # Ensures the instance url is set. builder.use Restforce::Middleware::InstanceURL, self, options # Caches GET requests. builder.use Restforce::Middleware::Caching, cache, options if cache # Follows 30x redirects. builder.use FaradayMiddleware::FollowRedirects # Raises errors for 40x responses. builder.use Restforce::Middleware::RaiseError # Parses returned JSON response into a hash. builder.response :json, content_type: /\bjson$/ # Compress/Decompress the request/response unless adapter == :httpclient builder.use Restforce::Middleware::Gzip, self, options end # Inject custom headers into requests builder.use Restforce::Middleware::CustomHeaders, self, options # Log request/responses if Restforce.log? builder.use Restforce::Middleware::Logger, Restforce.configuration.logger, options end builder.adapter adapter end end
def connection_options
def connection_options { request: { timeout: options[:timeout], open_timeout: options[:timeout] proxy: options[:proxy_uri], ssl: options[:ssl] } end
def mashify?
Internal: Returns true if the middlware stack includes the
def mashify? middleware.handlers.index(Restforce::Middleware::Mashify) end
def middleware
client.middleware.use FaradayMiddleware::Instrumentation
# Add the instrumentation middleware for Rails.
Examples
can be used to insert an custom middleware.
Public: The Faraday::Builder instance used for the middleware stack. This
def middleware connection.builder end