/// <summary>
/// Convert a REST method into a swagger method
/// </summary>
/// <returns>The swagger method.</returns>
/// <param name="method">Method.</param>
internal static SwaggerMethod ToSwaggerMethod(this MethodDefinition method)
{
var output = new SwaggerMethod {
Summary = method.Title
};
if (!string.IsNullOrEmpty(method.Description))
{
output.Description = method.Description;
}
output.Parameters.AddRange(from p in method.Parameters select p.ToSwaggerParameter());
// Make sure any path parameters are parsed since Swagger requires them
var missingPathParameters = MissingRequestParameters(method);
output.Parameters.AddRange(from p in missingPathParameters select p.ToSwaggerParameter());
if (output.Parameters.Count == 0)
{
output.Parameters = null;
}
output.Tags = null;
string statusCode;
var response = method.ToSwaggerResponse(out statusCode);
output.Responses.Add(statusCode, response);
//output.Responses.Add("200", new SwaggerResponse()
// {
// Description = "real response tbd",
// Schema = method.ExpectedResponseAsSwaggerProperty()
// });
// output.Responses = null;
return(output);
}
/// <summary>
/// Convert a REST method into a swagger method
/// </summary>
/// <returns>The swagger method.</returns>
/// <param name="method">Method.</param>
internal static SwaggerMethod ToSwaggerMethod(this MethodDefinition method)
{
var output = new SwaggerMethod { Summary = method.Title };
if (!string.IsNullOrEmpty(method.Description))
output.Description = method.Description;
output.Parameters.AddRange(from p in method.Parameters select p.ToSwaggerParameter());
// Make sure any path parameters are parsed since Swagger requires them
var missingPathParameters = MissingRequestParameters(method);
output.Parameters.AddRange(from p in missingPathParameters select p.ToSwaggerParameter());
if (output.Parameters.Count == 0)
output.Parameters = null;
output.Tags = null;
string statusCode;
var response = method.ToSwaggerResponse(out statusCode);
output.Responses.Add(statusCode, response);
//output.Responses.Add("200", new SwaggerResponse()
// {
// Description = "real response tbd",
// Schemas = method.ExpectedResponseAsSwaggerProperty()
// });
// output.Responses = null;
return output;
}
