Skip to content

Wissance.WebApiToolkit wiki

Jump to bottom
Ushakov Michael edited this page Sep 18, 2025 · 32 revisions

Introduction

Wissance.WebApiToolkit is a set of libraries that helps to build WebAPI faster with a standardized manner and approach. We told WebAPI therefore we mean not only REST but also gRPC and SignalR too. Wissance.WebApiToolkit is well structured and contains reusable parts that allow you to combine them and extend default behavior. Core interfaces of Wissance.WebApiToolkit are independent from any specific technology and could be easily implemented with different techologies.

Solution structure (libraries)

Solution contains multiple projects, the most important are:

  1. Wissance.WebApiToolkit.Core core interfaces and classes that minimally depend on libs and frameworks that are not part of FCL.
  2. Wissance.WebApiToolkit.Ef implementations of base Core interfaces based on EntityFramework for managing persistent data
  3. Wissance.WebApiToolkit.AWS.S3 implementation of the IFileManager and other utils for working with files and directories with different S3 Cloud services (AWS, Cloudflare R2, Yandex and many others compatible by API with Amazon)

Wissance.WebApiToolkit structure and components

Wissance.WebApiToolkit structure is shown in the picture below:

WebApiToolkitStructure

There are following main concepts:

  1. The system is split on 3 main levels: DTO/Message, Controller/Service, and Manager
  2. All controller base operations are related to a specific TObj class (same for all operations).
  3. The result of the operation is represented with a DTO/Message object except for the Delete operation.
  4. There is an additional branch (file management) that does not yet have a generic controller (maybe in the future)
  5. Translation from TObj to TRes and back is performed by Factory classes

Therefore the main algorithm to create Application with WebApiToolkit:

  1. Create a set of entity classes (TObj/TData) that implements IModelIdentifiable interface
  2. Create a set of entity representation as TRes (DTO) like TRes Create(TObj entity)
  3. Create a set of manager classes for pairs (TRes, TObj)
  4. Create Controllers that derives from BasicReadController, BasicCrudController, or BasicBulkCrudController or service corresponding to these Controllers classes

Key Features

...tbd

Clone this wiki locally