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, query_parser: nil) ⇒ ValidatedRequest

Returns a new instance of ValidatedRequest.



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

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

Instance Attribute Details

#error ⇒ Failure? (readonly)

A Failure object if the request is invalid

Returns:



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

def error
  @error
end

#request_definition ⇒ Request? (readonly)

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

Returns:



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

def request_definition
  @request_definition
end

Instance Method Details

#invalid? ⇒ Boolean

Checks if the request is invalid.

Returns:

  • (Boolean) 


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

def invalid? = !valid?

#known? ⇒ Boolean

Returns true if the request is defined.

Returns:

  • (Boolean) 


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

def known? = request_definition != nil

#operation ⇒ Hash

Returns The raw OpenAPI 3 operation object.

Returns:

  • (Hash) —

    The raw OpenAPI 3 operation object



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

def_delegator :request_definition, :operation

#operation_id ⇒ String?

Returns The OpenAPI 3 operationId.

Returns:

  • (String, nil) —

    The OpenAPI 3 operationId



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

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) 


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

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>) 


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

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>) 


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

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>) 


75
76
77
 
# File 'lib/openapi_first/validated_request.rb', line 75

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>) 


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

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>) 


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

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

#unknown_query_parameters ⇒ Hash

Returns Query parameters and values that are not defined in the OpenAPI spec.

Returns:

  • (Hash) —

    Query parameters and values that are not defined in the OpenAPI spec.



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

def unknown_query_parameters
  @query_parser&.unknown_values(query_string)
end

#valid? ⇒ Boolean

Checks if the request is valid.

Returns:

  • (Boolean) 


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

def valid? = error.nil?