ViennaNET: набор от библиотеки за бекенда

Здравейте на всички!

Ние сме общност от .NET разработчици в Райфайзенбанк и искаме да говорим за набор от инфраструктурни библиотеки, базирани на .NET Core за бързо създаване на микроуслуги с единна екосистема. Доведоха го до Open Source!

Малко история

Имало едно време имахме голям монолитен проект, който постепенно се превърна в набор от микроуслуги (можете да прочетете за характеристиките на този процес в тази статия). В процеса се сблъскахме с проблема, че при създаването на нови микроуслуги често се налагаше да копираме различни инфраструктурни решения – като настройка на логване, работа с база данни, WCF и др. Един екип работеше по този проект и всички вече бяха свикнали с някакъв установен подход за работа с инфраструктурата. Затова отделихме общия код в отделно хранилище, опаковахме събраните библиотеки в пакети на Nuget и ги поставихме в нашето вътрешно хранилище на Nuget.

Времето минаваше, проектът постепенно се фрагментира и имаше желание да се създадат нови модули от страна на клиента върху модерна JS рамка и да се стартират в браузъра. Започнахме да преминаваме от WCF/SOAP към REST/HTTP, така че имахме нужда от нови библиотеки за бързо стартиране на услуги, базирани на AspNet WebApi. Първата версия на .Net Framework 4.5 беше направена от нашия архитект почти на колене в свободното му време, но извън кутията направи възможно стартирането на услуга с три реда в Program.cs, които съдържаха оторизация (NTLM), регистриране, Swagger, IoC/DI на базата на Castle Windsor, персонализирани HTTP клиенти, които препращат различни заглавки, за да осигурят регистриране от край до край в целия проект. И цялото това нещо може да бъде допълнително конфигурирано директно в конфигурационния файл на услугата.

Не всичко обаче беше гладко: тази библиотека се оказа изключително негъвкава по отношение на въвеждането на нови модули. Например, ако трябваше да добавите някакъв специален междинен софтуер, трябваше да създадете нов сбор и да наследите от базовия клас, който изпълнява услугата, което беше изключително неудобно. За щастие нямаше много такива случаи.

Ерата на Docker и Kubernetes

Дойде времето, когато вълната от Docker и Kubernetes достигна до нас, която наблюдавахме отблизо: в края на краищата това беше страхотен шанс да започнем да се движим по-нататък по технологиите, в .Net Core. Това означава, че ще се нуждаем от нова инфраструктура за изпълнение на услуги: някои библиотеки са мигрирали от .Net Framework към .Net Standard и .Net Core практически без промени, някои с незначителни подобрения. Но най-вече исках да преработя функционалността, свързана със стартирането на услуги на AspNet Core.

Първото нещо, което обмислихме, беше концепция, която ще премахне основния недостатък на предишната версия: липсата на гъвкавост. Затова беше решено да се направи цялата библиотечна система възможно най-независима и модулна и да събере услугите, необходими за функционалност като конструктор.

Основната цел е да се създаде единен подход, който описва как да взаимодействате с бази данни, автобуси и други услуги. Опитахме се да направим интеграциите бързи и безболезнени и разработчиците можеха да се концентрират върху писането на бизнес логика, а не върху инфраструктура - тя вече е готова. Общото хранилище спомага за подобряване на изживяването при взаимодействие в рамките на екипи: когато се използват много сходни вътрешни инфраструктури, е по-лесно да се присъедините към процеса на разработка на друг екип и да обмените опит.

И защо имаме нужда от отворен код?

Искаме да покажем зрелостта на нашия опит и да получим висококачествена обратна връзка: човек извън банката ще може да донесе нещо от себе си. Ние също се интересуваме от развитието на практики за работа с микроуслуги и DDD на .NET в индустрията, може би някой ще иска да поеме определени части от рамката.

Всъщност ViennaNET

Сега нека погледнем по-отблизо. Пълният изходен код е публикуван тук.

ViennaNET.WebApi.*

Този набор от библиотеки се състои от „основния“ ViennaNET.WebApi, съдържащ класа за изграждане на услугата CompanyHostBuilder, и набор от конфигуратори ViennaNET.WebApi.Configurators.*, всеки от които ви позволява да добавяте и конфигурирате някои функции към създадения обслужване. Сред конфигураторите можете да намерите връзки за регистриране, диагностика, типове удостоверяване и оторизация, swagger и др.

ViennaNET.WebApi.Runners.* също съдържа предварително конфигурирани създатели на услуги. Тези пакети ви позволяват да не помните всеки път, когато създавате нова услуга, кои конфигуратори трябва да бъдат свързани. Те обаче не ограничават по никакъв начин функционалността на създателя на услуги.

ViennaNET.Mediator.*

Библиотеки, които ви позволяват да създадете вътрешна междинна шина за команди и заявки в рамките на услуга. Този подход ви позволява да намалите броя на DI инжекциите до едно, например в контролерите. Благодарение на това можете да добавяте различни декоратори към заявките, което унифицира тяхната обработка и намалява количеството код.

ViennaNET.Валидиране

Сглобка, съдържаща набор от класове за създаване на валидиращи правила и последователности от тях. Той е много удобен за внедряване на валидиране на домейн, тъй като ви позволява да опишете всяко бизнес условие под формата на просто и отделно правило.

ViennaNET.Redis

Библиотека с обвивки за удобна работа с Redis като кеш в паметта.

ViennaNET.Спецификации

Сглобяване, съдържащо класове, които имплементират модела на спецификацията.

Това не е всичко, което е в нашия комплект. Можете да видите останалото в хранилището на GitHub. Планираме скоро да пуснем нашите библиотеки за работа с бази данни в OpenSource.

Благодарим ви за вниманието, очакваме вашите коментари и заявки за изтегляне.

Източник: www.habr.com