Возможность ServiceStack + Swagger по-разному группировать ресурсы

Позвольте мне начать с того, что ServiceStack как фреймворк превзошел все мои ожидания. Удивительно, что удалось сделать.

В настоящее время я использую плагин пользовательского интерфейса Swagger с ServiceStack, и мне было интересно, есть ли способ группировать ресурсы отдельно, чем они появляются сейчас? Похоже, группировка продиктована корнем.

Текущая группировка делает что-то вроде этого:

/clients
    /clients/{clientId}/locations/{id} 
    /clients/{clientId}/locations/{locationId}/reports
    /clients/{clientId}/locations/{locationId}/reports/{id}

Я бы предпочел, чтобы пользовательский интерфейс swagger вывел что-то вроде этого:

Clients
    /clients/{id}
Locations
    /clients/{clientId}/locations
Reports
    /clients/{clientId}/locations/{locationId}/reports

Было бы здорово, если бы вы могли сделать что-то вроде показанного выше, используя группировку, как показано ниже.

[Route("/hello/{Name}", "GET", 
Summary = @"Says ""Hello"" to provided Name with GET.", 
  Notes = "Longer description of the GET method which says 'Hello'", 
  // like this!
  SwaggerGroup="Clients")]

Это может быть скорее ограничение Swagger, а не ограничение ServiceStack, но я подумал, что спрошу.


person Khalid Abuhakmeh    schedule 25.05.2013    source источник


Ответы (1)


ServiceStack не вносит никаких изменений в Интерфейс Swagger. Если этой функции нет в Swagger, она не будет доступна и в ServiceStack.

Тем не менее, пользовательский интерфейс Swagger создается с помощью статического JavaScript и HTML в /папка swagger-ui, чтобы вы могли изменить пользовательский интерфейс и добавить любые необходимые настройки в свою локальную копию.

person mythz    schedule 25.05.2013
comment
да, я этого боялся :(. BackboneJs не дружественный фреймворк (имхо). Хотелось бы, чтобы была версия Swagger для KnockoutJs или Angular. Спасибо, Демис. - person Khalid Abuhakmeh; 26.05.2013