mirror of
https://github.com/ditkrg/rswag.git
synced 2026-01-22 22:06:43 +00:00
f8dbd98bbc
This will allow to describe multipart in a short way, like JSON payload:
Before:
put 'Creates a blog with thumbnail' do
consumes 'multipart/form-data'
parameter name: :title, in: :formData, type: :string, required: true
parameter name: :content, in: :formData, type: :string, required: true
parameter name: :file, in: :formData, type: :file, required: true
let(:blog) { FactoryBot.build(:blog) }
let(:title) { blog.title }
let(:content) { blog.content }
let(:file) { blog.file }
...
end
After:
put 'Creates a blog with thumbnail' do
consumes 'multipart/form-data'
parameter name: :blog, in: :formData, schema: { '$ref' => '#/definitions/blog' }
let(:blog) { FactoryBot.attributes_for(:blog) }
...
end
Your mileage may vary but you can always choose the best option.
70 lines
1.6 KiB
Ruby
70 lines
1.6 KiB
Ruby
require 'fileutils'
|
|
|
|
class BlogsController < ApplicationController
|
|
|
|
# POST /blogs
|
|
def create
|
|
@blog = Blog.create(params.require(:blog).permit(:title, :content))
|
|
respond_with @blog
|
|
end
|
|
|
|
# POST /blogs/multipart
|
|
def multipart_create
|
|
@blog = Blog.create(params.require(:blog).permit(:title, :content))
|
|
respond_with @blog
|
|
end
|
|
|
|
# POST /blogs/flexible
|
|
def flexible_create
|
|
|
|
# contrived example to play around with new anyOf and oneOf
|
|
# request body definition for 3.0
|
|
blog_params = params.require(:blog).permit(:title, :content, :headline, :text)
|
|
|
|
@blog = Blog.create(blog_params)
|
|
respond_with @blog
|
|
end
|
|
|
|
# POST /blogs/alternate
|
|
def alternate_create
|
|
|
|
# contrived example to show different :examples in the requestBody section
|
|
@blog = Blog.create(params.require(:blog).permit(:title, :content))
|
|
respond_with @blog
|
|
end
|
|
|
|
# Put /blogs/1
|
|
def upload
|
|
@blog = Blog.find_by_id(params[:id])
|
|
return head :not_found if @blog.nil?
|
|
@blog.thumbnail = save_uploaded_file params[:file]
|
|
head @blog.save ? :ok : :unprocsessible_entity
|
|
end
|
|
|
|
# GET /blogs
|
|
def index
|
|
@blogs = Blog.all
|
|
respond_with @blogs
|
|
end
|
|
|
|
# GET /blogs/1
|
|
def show
|
|
@blog = Blog.find_by_id(params[:id])
|
|
|
|
fresh_when(@blog)
|
|
return unless stale?(@blog)
|
|
|
|
respond_with @blog, status: :not_found and return unless @blog
|
|
respond_with @blog
|
|
end
|
|
|
|
private
|
|
|
|
def save_uploaded_file(field)
|
|
return if field.nil?
|
|
file = File.join('public/uploads', field.original_filename)
|
|
FileUtils.cp field.tempfile.path, file
|
|
field.original_filename
|
|
end
|
|
end
|