Contents

# frozen_string_literal: true
require_relative 'parameters'

module Meta
  class Metadata
    attr_reader :title, :description, :tags, :parameters, :request_body, :responses

    def initialize(title: nil, description: nil, tags: [], parameters: {}, request_body: nil, responses: nil)
      @title = title
      @description = description
      @tags = tags
      @parameters = parameters.is_a?(Parameters) ? parameters : Parameters.new(parameters)
      @request_body = request_body
      @responses = responses || { 204 => nil }
    end

    def [](key)
      send(key)
    end

    def generate_operation_doc(schemas)
      operation_object = {}

      operation_object[:summary] = title if title
      operation_object[:tags] = tags unless tags.empty?
      operation_object[:description] = description if description

      operation_object[:parameters] = parameters.to_swagger_doc

      if request_body
        schema = request_body.to_schema_doc(stage: :param, schemas: schemas)
        if schema || true
          operation_object[:requestBody] = {
            content: {
              'application/json' => {
                schema: schema
              }
            }
          }
        end
      end

      operation_object[:responses] = responses.transform_values do |schema|
        {
          description: '', # description 属性必须存在
          content: schema ? {
            'application/json' => {
              schema: schema.to_schema_doc(stage: :render, schemas: schemas)
            }
          } : nil
        }.compact
      end unless responses.empty?

      operation_object.compact
    end

    def self.new(meta = {})
      meta.is_a?(Metadata) ? meta : super(**meta)
    end
  end
end

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
meta-api-0.0.6	lib/meta/application/metadata.rb
meta-api-0.0.5	lib/meta/application/metadata.rb