protected override void Render(HtmlTextWriter output)
{
var links = OperationNames?.ToDictionary(p => new KeyValuePair <string, string>("?op=" + p, p));
var operationsPart = new ListTemplate
{
Title = MetadataFeature.Operations,
ListItemsMap = links,
ListItemTemplate = @"<li><a href=""{0}"">{1}</a></li>"
}.ToString();
var renderedTemplate = HtmlTemplates.Format(
HtmlTemplates.GetFormatOperationsTemplate(),
Title,
Format,
operationsPart,
Env.VersionString
);
output.Write(renderedTemplate);
}
public static RestApiRootItemViewModel FromSwaggerModel(SwaggerModel swagger)
{
var uid = GetUid(swagger);
var vm = new RestApiRootItemViewModel
{
Name = swagger.Info.Title,
Uid = uid,
HtmlId = GetHtmlId(uid),
Metadata = swagger.Metadata,
Description = swagger.Description,
Summary = swagger.Summary,
Children = new List <RestApiChildItemViewModel>(),
Raw = swagger.Raw,
Tags = new List <RestApiTagViewModel>()
};
if (swagger.Tags != null)
{
foreach (var tag in swagger.Tags)
{
vm.Tags.Add(new RestApiTagViewModel
{
Name = tag.Name,
Description = tag.Description,
HtmlId = string.IsNullOrEmpty(tag.BookmarkId) ? GetHtmlId(tag.Name) : tag.BookmarkId, // Fall back to tag name's html id
Metadata = tag.Metadata,
Uid = GetUidForTag(uid, tag)
});
}
}
if (swagger.Paths != null)
{
foreach (var path in swagger.Paths)
{
var commonParameters = path.Value.Parameters;
foreach (var op in path.Value.Metadata)
{
// fetch operations from metadata
if (OperationNames.Contains(op.Key, StringComparer.OrdinalIgnoreCase))
{
var opJObject = op.Value as JObject;
if (opJObject == null)
{
throw new InvalidOperationException($"Value of {op.Key} should be JObject");
}
// convert operation from JObject to OperationObject
var operation = opJObject.ToObject <OperationObject>();
var parameters = GetParametersForOperation(operation.Parameters, commonParameters);
var itemUid = GetUidForOperation(uid, operation);
var itemVm = new RestApiChildItemViewModel
{
Path = path.Key,
OperationName = op.Key,
Tags = operation.Tags,
OperationId = operation.OperationId,
HtmlId = GetHtmlId(itemUid),
Uid = itemUid,
Metadata = operation.Metadata,
Description = operation.Description,
Summary = operation.Summary,
Parameters = parameters?.Select(s => new RestApiParameterViewModel
{
Description = s.Description,
Name = s.Name,
Metadata = s.Metadata
}).ToList(),
Responses = operation.Responses?.Select(s => new RestApiResponseViewModel
{
Metadata = s.Value.Metadata,
Description = s.Value.Description,
Summary = s.Value.Summary,
HttpStatusCode = s.Key,
Examples = s.Value.Examples?.Select(example => new RestApiResponseExampleViewModel
{
MimeType = example.Key,
Content = example.Value != null ? JsonUtility.Serialize(example.Value) : null,
}).ToList(),
}).ToList(),
};
// TODO: line number
if (swagger.Metadata.TryGetValue(Constants.PropertyName.Source, out object value))
{
itemVm.Metadata[Constants.PropertyName.Source] = value;
}
else
{
itemVm.Metadata[Constants.PropertyName.Source] = null;
}
vm.Children.Add(itemVm);
}
}
}
}
return(vm);
}
