Class: OpenapiFirst::ValidatedRequest

Inherits:
SimpleDelegator
  • Object
show all
Extended by:
Forwardable
Defined in:
lib/openapi_first/validated_request.rb

Overview

A validated request. It can be valid or not.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(original_request, error:, parsed_request: nil, request_definition: nil) ⇒ ValidatedRequest

Returns a new instance of ValidatedRequest.



11
12
13
14
15
16
 
# File 'lib/openapi_first/validated_request.rb', line 11

def initialize(original_request, error:, parsed_request: nil, request_definition: nil)
  super(original_request)
  @parsed_request = parsed_request
  @error = error
  @request_definition = request_definition
end

Instance Attribute Details

#error ⇒ Failure? (readonly)

A Failure object if the request is invalid

Returns:



20
21
22
 
# File 'lib/openapi_first/validated_request.rb', line 20

def error
  @error
end

#request_definition ⇒ Request? (readonly)

The request definition if this request is defined in the API description

Returns:



24
25
26
 
# File 'lib/openapi_first/validated_request.rb', line 24

def request_definition
  @request_definition
end

Instance Method Details

#invalid? ⇒ Boolean

Checks if the request is invalid.

Returns:

  • (Boolean) 


61
 
# File 'lib/openapi_first/validated_request.rb', line 61

def invalid? = !valid?

#known? ⇒ Boolean

Returns true if the request is defined.

Returns:

  • (Boolean) 


64
 
# File 'lib/openapi_first/validated_request.rb', line 64

def known? = request_definition != nil

#operation ⇒ Hash

Returns The raw OpenAPI 3 operation object.

Returns:

  • (Hash) —

    The raw OpenAPI 3 operation object



32
 
# File 'lib/openapi_first/validated_request.rb', line 32

def_delegator :request_definition, :operation

#operation_id ⇒ String?

Returns The OpenAPI 3 operationId.

Returns:

  • (String, nil) —

    The OpenAPI 3 operationId



28
 
# File 'lib/openapi_first/validated_request.rb', line 28

def_delegator :request_definition, :operation_id

#parsed_body ⇒ Hash<String, anything>, anything

Parsed body. This parses the body according to the content type. Note that this returns the hole body, not only the fields that are defined in the OpenAPI spec. You can use JSON Schemas ‘additionalProperties` or `unevaluatedProperties` to return a validation error if the body contains unknown fields.

Returns:

  • (Hash<String, anything>, anything) 


55
 
# File 'lib/openapi_first/validated_request.rb', line 55

def parsed_body = @parsed_request&.body

#parsed_cookies ⇒ Hash<String, anything>

Parsed cookies. This only returns the query parameters that are defined in the OpenAPI spec.

Returns:

  • (Hash<String, anything>) 


48
 
# File 'lib/openapi_first/validated_request.rb', line 48

def parsed_cookies = @parsed_request&.cookies || {}

#parsed_headers ⇒ Hash<String, anything>

Parsed headers. This only returns the query parameters that are defined in the OpenAPI spec.

Returns:

  • (Hash<String, anything>) 


44
 
# File 'lib/openapi_first/validated_request.rb', line 44

def parsed_headers = @parsed_request&.headers || {}

#parsed_params ⇒ Hash<String, anything>

Merged path, query, body parameters. Here path has the highest precedence, then query, then body.

Returns:

  • (Hash<String, anything>) 


69
70
71
 
# File 'lib/openapi_first/validated_request.rb', line 69

def parsed_params
  @parsed_params ||= parsed_body.to_h.merge(parsed_query, parsed_path_parameters) || {}
end

#parsed_path_parameters ⇒ Hash<String, anything>

Parsed path parameters

Returns:

  • (Hash<String, anything>) 


36
 
# File 'lib/openapi_first/validated_request.rb', line 36

def parsed_path_parameters = @parsed_request&.path || {}

#parsed_query ⇒ Hash<String, anything>

Parsed query parameters. This only returns the query parameters that are defined in the OpenAPI spec.

Returns:

  • (Hash<String, anything>) 


40
 
# File 'lib/openapi_first/validated_request.rb', line 40

def parsed_query = @parsed_request&.query || {}

#valid? ⇒ Boolean

Checks if the request is valid.

Returns:

  • (Boolean) 


58
 
# File 'lib/openapi_first/validated_request.rb', line 58

def valid? = error.nil?