Разделы презентаций
- Разное
- Английский язык
- Астрономия
- Алгебра
- Биология
- География
- Геометрия
- Детские презентации
- Информатика
- История
- Литература
- Математика
- Медицина
- Менеджмент
- Музыка
- МХК
- Немецкий язык
- ОБЖ
- Обществознание
- Окружающий мир
- Педагогика
- Русский язык
- Технология
- Физика
- Философия
- Химия
- Шаблоны, картинки для презентаций
- Экология
- Экономика
- Юриспруденция
Публичные контракты, как обеспечить их согласованность
Содержание
- 1. Публичные контракты, как обеспечить их согласованность
- 2. Слайд 2
- 3. Изменение контрактов
- 4. Изменение контрактов
- 5. Нужно что-то предпринять
- 6. Нужно что-то предпринять
- 7. Как сделать так, чтобы такое больше не повторялось
- 8. Экосистема Sungero
- 9. Экосистема Sungero
- 10. Экосистема Sungero
- 11. Проблема. В каждом сервисе своя реализация клиента StorageServiceClientProxy
- 12. Проблема. В каждом сервисе своя реализация клиента StorageServiceClientProxy
- 13. Постановка задачи
- 14. Постановка задачи
- 15. Слайд 15
- 16. ИнструментыRPCREST
- 17. REST vs RPC
- 18. Слайд 18
- 19. Слайд 19
- 20. Слайд 20
- 21. Слайд 21
- 22. Слайд 22
- 23. Слайд 23
- 24. Слайд 24
- 25. Слайд 25
- 26. Слайд 26
- 27. Слайд 27
- 28. Слайд 28
- 29. Слайд 29
- 30. Слайд 30
- 31. Слайд 31
- 32. Слайд 32
- 33. Где расположить контракты? Как осуществить доступ сервисов к контрактам?
- 34. Где расположить контракты? Как осуществить доступ сервисов к контрактам?
- 35. В какой момент выполнять генерацию?
- 36. В какой момент выполнять генерацию?
- 37. Где расположить код клиента?
- 38. Где расположить код клиента?Где расположить код клиента?
- 39. Где расположили код клиента
- 40. Детали реализации
- 41. DescriptionController.cs[Route("[controller]")][ApiController]public class DescriptionController : ControllerBase {[OpenApiOperation("GetDescription")][ProducesResponseType(typeof(ConversionDescription), 200)][ProducesResponseType(401)][ProducesResponseType(403)][HttpGet("{pluginName}/{binaryDataId}")]public ActionResult GetDescription( string pluginName, Guid binaryDataId) { // код... }
- 42. FileController.cs[Route("[controller]")][ApiController]public class FileController : ControllerBase {[OpenApiOperation("SaveFile")][ProducesResponseType(401)][ProducesResponseType(403)][HttpPost("{pluginName}/{binaryDataId}/{fileName}")][FileUploadOperation]public async Task SaveFile() { // код... }
- 43. Процессор
- 44. Конфигурация Nswag.json"runtime": "NetCore22","documentGenerator": { "webApiToOpenApi": { "defaultUrlTemplate":
- 45. Как добавили поддержку JWT
- 46. Как добавили поддержку JWT
- 47. Как добавили поддержку JWT
- 48. Как добавили поддержку JWT
- 49. Вывод
- 50. Вывод
- 51. Версионирование
- 52. Изменение контрактовКоманда сервиса поставщика сама исправляет сервисы потребители. Без версионированияВарианты решения
- 53. Изменение контрактовПлохо работает:Разные репозиторииНет компетенцийВарианты решения
- 54. Изменение контрактовКоманда сервиса поставщика оставляет предыдущую версию контрактовВарианты решения
- 55. Версионирование
- 56. Версионирование
- 57. Версионирование
- 58. Версионирование
- 59. Когда вводить новую версию
- 60. Тестирование контрактов
- 61. Consumer driven contracts
- 62. Слайд 62
- 63. Слайд 63
- 64. Спасибо за внимание!Разработчик Directumв г. Уфа Романюк Антонromanyuk_aa@directum.ru
- 65. REST + gRPC
- 66. Настройка csproj
- 67. Как CDC можно встроить в CI
- 68. Процессорpublic class FileUploadOperationAttribute : OpenApiOperationProcessorAttribute {public FileUploadOperationAttribute()
- 69. WSDLLanguage, platform, and transport independent (REST requires
- 70. Версионирование
- 71. Слайд 71
- 72. https://servicesblog.redhat.com/2019/01/31/comparing-openapi-with-grpc/https://docs.microsoft.com/en-us/aspnet/core/grpc/comparison?view=aspnetcore-3.1https://blog.maddevs.io/introduction-to-grpc-6de0d9c0fe61https://github.com/Azure/openapi-diffhttps://www.davidkaya.com/with-openapi-against-breaking-changes/https://github.com/grpc/grpc-web/issues/517 не подойдет для передачи больших файловhttps://developers.google.com/protocol-buffers/docs/techniques?hl=en#large-data сообщения не больше 1 мбhttps://app.swaggerhub.com/help/integrations/api-auto-mocking
- 73. Слайд 73
- 74. PACT и OpenAPI (REST)PACT и gRPCPACT и Message Queues
- 75. Скачать презентанцию
Изменение контрактов
Слайды и текст этой презентации
Слайд 41DescriptionController.cs
[Route("[controller]")]
[ApiController]
public class DescriptionController : ControllerBase {
[OpenApiOperation("GetDescription")]
[ProducesResponseType(typeof(ConversionDescription), 200)]
[ProducesResponseType(401)]
[ProducesResponseType(403)]
[HttpGet("{pluginName}/{binaryDataId}")]
public ActionResult GetDescription(
string pluginName,
Guid binaryDataId) { // код... }
Слайд 42FileController.cs
[Route("[controller]")]
[ApiController]
public class FileController : ControllerBase {
[OpenApiOperation("SaveFile")]
[ProducesResponseType(401)]
[ProducesResponseType(403)]
[HttpPost("{pluginName}/{binaryDataId}/{fileName}")]
[FileUploadOperation]
public async Task SaveFile() {
// код... }
Слайд 44Конфигурация Nswag.json
"runtime": "NetCore22",
"documentGenerator": { "webApiToOpenApi": {
"defaultUrlTemplate": "api/{controller}/{id?}",
"infoTitle": "PreviewStorage", "infoVersion":
"1.0.0",
"documentName": "v1","allowNullableBodyParameters": true,
"output": "../../api-docs/PreviewStorage_swagger.json",
"outputType": "OpenApi3",
"assemblyPaths": [
"../../bin/$(Configuration)/PreviewStorage/netcoreapp2.2/PreviewStorage.dll“ ], } },
"codeGenerators": {
"openApiToCSharpClient": { "input": "../../api-docs/PreviewStorage_swagger.json","namespace": "PreviewStorage.WebApiProxy",
"generateClientInterfaces": true,
"useHttpRequestMessageCreationMethod": true,
“httpClientType": "System.Net.Http.HttpClient",
"additionalNamespaceUsages": [ "PreviewService.Common.Model“ ],
"output": "../PreviewStorage.WebApiProxy/PreviewStorageProxy.g.cs",
"className": "{controller}PreviewStorageProxy",
"operationGenerationMode": "SingleClientFromOperationId“ } } }
Слайд 52Изменение
контрактов
Команда сервиса поставщика сама исправляет сервисы потребители.
Без версионирования
Варианты
решения
Слайд 54Изменение
контрактов
Команда сервиса поставщика оставляет предыдущую версию контрактов
Варианты решения
Слайд 68Процессор
public class FileUploadOperationAttribute : OpenApiOperationProcessorAttribute {
public FileUploadOperationAttribute() : base(typeof(FileUploadOperationProcessor)) {
} }
public class FileUploadOperationProcessor : IOperationProcessor {
public bool Process(OperationProcessorContext context)
{var parameters = context.OperationDescription.Operation.Parameters;
parameters.Add(new OpenApiParameter() {
Name = "stream", Kind = OpenApiParameterKind.Body,
Schema = new JsonSchema { Type = JsonObjectType.String, Format = "binary" },
IsRequired = true, Description = "Файл.",
});
return true; } }
Слайд 69WSDL
Language, platform, and transport independent (REST requires use of HTTP)
Works well in distributed enterprise environments (REST assumes direct
point-to-point communication)Standardized
Provides significant pre-build extensibility in the form of the WS* standards
Built-in error handling
Automation when used with certain language products
Слайд 72https://servicesblog.redhat.com/2019/01/31/comparing-openapi-with-grpc/
https://docs.microsoft.com/en-us/aspnet/core/grpc/comparison?view=aspnetcore-3.1
https://blog.maddevs.io/introduction-to-grpc-6de0d9c0fe61
https://github.com/Azure/openapi-diff
https://www.davidkaya.com/with-openapi-against-breaking-changes/
https://github.com/grpc/grpc-web/issues/517 не подойдет для передачи больших файлов
https://developers.google.com/protocol-buffers/docs/techniques?hl=en#large-data сообщения не больше
1 мб
https://app.swaggerhub.com/help/integrations/api-auto-mocking
