Class: ActiveResource::HttpMock

Inherits:
Object
  • Object
show all
Defined in:
activeresource/lib/active_resource/http_mock.rb

Overview

One thing that has always been a pain with remote web services is testing. The HttpMock class makes it easy to test your Active Resource models by creating a set of mock responses to specific requests.

To test your Active Resource model, you simply call the ActiveResource::HttpMock.respond_to method with an attached block. The block declares a set of URIs with expected input, and the output each request should return. The passed in block has any number of entries in the following generalized format:

mock.http_method(path, request_headers = {}, body = nil, status = 200, response_headers = {})
  • http_method - The HTTP method to listen for. This can be get, post, put, delete or head.

  • path - A string, starting with a “/”, defining the URI that is expected to be called.

  • request_headers - Headers that are expected along with the request. This argument uses a hash format, such as { "Content-Type" => "application/xml" }. This mock will only trigger if your tests sends a request with identical headers.

  • body - The data to be returned. This should be a string of Active Resource parseable content, such as XML.

  • status - The HTTP response code, as an integer, to return with the response.

  • response_headers - Headers to be returned with the response. Uses the same hash format as request_headers listed above.

In order for a mock to deliver its content, the incoming request must match by the http_method, path and request_headers. If no match is found an InvalidRequestError exception will be raised letting you know you need to create a new mock for that request.

Example

def setup
  @matz  = { :id => 1, :name => "Matz" }.to_xml(:root => "person")
  ActiveResource::HttpMock.respond_to do |mock|
    mock.post   "/people.xml",   {}, @matz, 201, "Location" => "/people/1.xml"
    mock.get    "/people/1.xml", {}, @matz
    mock.put    "/people/1.xml", {}, nil, 204
    mock.delete "/people/1.xml", {}, nil, 200
  end
end

def test_get_matz
  person = Person.find(1)
  assert_equal "Matz", person.name
end

Defined Under Namespace

Classes: Responder

Class Method Summary (collapse)

Instance Method Summary (collapse)

Constructor Details

- (HttpMock) initialize(site)

:nodoc:



138
139
140
# File 'activeresource/lib/active_resource/http_mock.rb', line 138

def initialize(site) #:nodoc:
  @site = site
end

Class Method Details

+ (Object) requests

Returns an array of all request objects that have been sent to the mock. You can use this to check if your model actually sent an HTTP request.

Example

def setup
  @matz  = { :id => 1, :name => "Matz" }.to_xml(:root => "person")
  ActiveResource::HttpMock.respond_to do |mock|
    mock.get "/people/1.xml", {}, @matz
  end
end

def test_should_request_remote_service
  person = Person.find(1)  # Call the remote service

  # This request object has the same HTTP method and path as declared by the mock
  expected_request = ActiveResource::Request.new(:get, "/people/1.xml")

  # Assert that the mock received, and responded to, the expected request from the model
  assert ActiveResource::HttpMock.requests.include?(expected_request)
end


90
91
92
# File 'activeresource/lib/active_resource/http_mock.rb', line 90

def requests
  @@requests ||= []
end

+ (Object) reset!

Deletes all logged requests and responses.



113
114
115
116
# File 'activeresource/lib/active_resource/http_mock.rb', line 113

def reset!
  requests.clear
  responses.clear
end

+ (Object) respond_to(pairs = {})

Accepts a block which declares a set of requests and responses for the HttpMock to respond to. See the main ActiveResource::HttpMock description for a more detailed explanation.



102
103
104
105
106
107
108
109
110
# File 'activeresource/lib/active_resource/http_mock.rb', line 102

def respond_to(pairs = {}) #:yields: mock
  reset!
  responses.concat pairs.to_a
  if block_given?
    yield Responder.new(responses)
  else
    Responder.new(responses)
  end
end

+ (Object) responses

Returns the list of requests and their mocked responses. Look up a response for a request using responses.assoc(request).



96
97
98
# File 'activeresource/lib/active_resource/http_mock.rb', line 96

def responses
  @@responses ||= []
end