https://github.com/sulmar/sulmar-mon-netcore3-group2
Przykłady ze szkolenia .NET Core 3.1
https://github.com/sulmar/sulmar-mon-netcore3-group2
dotnet-core3-1 entity-framework-core fluentvalidation grpc hangfire mediatr signalr-core
Last synced: 8 months ago
JSON representation
Przykłady ze szkolenia .NET Core 3.1
- Host: GitHub
- URL: https://github.com/sulmar/sulmar-mon-netcore3-group2
- Owner: sulmar
- Created: 2020-01-20T16:07:14.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T09:36:13.000Z (almost 3 years ago)
- Last Synced: 2025-01-02T03:33:32.342Z (9 months ago)
- Topics: dotnet-core3-1, entity-framework-core, fluentvalidation, grpc, hangfire, mediatr, signalr-core
- Language: C#
- Homepage: http://www.sulmar.pl
- Size: 159 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# .NET Core
## Struktura projektu
| Projekt | Opis | Technologia |
|---|---|---|
| Resources | Usługa do zarządzania pojazdami i osobami | WebApi |
| Radio | Usługa do obsługi radionadajników | Middleware |
| Navigation | Usługa do obsługi nawigacji | OWIN |
| Messaging | Usługa do komunikacji między osobami | Signal-R |
| Tracking | Usługa do śledzenia pojazdów | gRPC |
## Przydatne komendy CLI
- ``` dotnet --list-sdks ``` - wyświetlenie listy zainstalowanych SDK
- ``` dotnet new globaljson ``` - utworzenie pliku global.json
- ``` dotnet new globaljson --sdk-version {version} ``` - utworzenie pliku global.json i ustawienie wersji SDK
- ``` dotnet new --list ``` - wyświetlenie listy dostępnych szablonów
- ``` dotnet new {template} ``` - utworzenie nowego projektu na podstawie wybranego szablonu
- ``` dotnet new {template} -o {output} ``` - utworzenie nowego projektu w podanym katalogu
- ``` dotnet restore ``` - pobranie bibliotek nuget na podstawie pliku projektu
- ``` dotnet build ``` - kompilacja projektu
- ``` dotnet run ``` - uruchomienie projektu
- ``` dotnet run {app.dll}``` - uruchomienie aplikacji
- ``` dotnet test ``` - uruchomienie testów jednostkowych
- ``` dotnet run watch``` - uruchomienie projektu w trybie śledzenia zmian
- ``` dotnet test ``` - uruchomienie testów jednostkowych w trybie śledzenia zmian
- ``` dotnet add {project.csproj} reference {library.csproj} ``` - dodanie odwołania do biblioteki
- ``` dotnet remove {project.csproj} reference {library.csproj} ``` - usunięcie odwołania do biblioteki
- ``` dotnet new sln ``` - utworzenie nowego rozwiązania
- ``` dotnet sln {solution.sln} add {project.csproj}``` - dodanie projektu do rozwiązania
- ``` dotnet sln {solution.sln} remove {project.csproj}``` - usunięcie projektu z rozwiązania
- ``` dotnet publish -c Release -r {platform}``` - publikacja aplikacji
- ``` dotnet publish -c Release -r win10-x64``` - publikacja aplikacji dla Windows
- ``` dotnet publish -c Release -r linux-x64``` - publikacja aplikacji dla Linux
- ``` dotnet publish -c Release -r osx-x64``` - publikacja aplikacji dla MacOS
- ``` dotnet add package {package-name} ``` - dodanie pakietu nuget do projektu
- ``` dotnet remove package {package-name} ``` - usunięcie pakietu nuget do projektu
## Protokół HTTP
request:
~~~
GET /customers/index.html HTTP/1.1
host: www.sulmar.pl
accept: text/html
{blank-line}
~~~
response:
~~~
200 OK
content-type: text/html
...
~~~
request:
~~~
GET api/customers HTTP/1.1
host: www.sulmar.pl
accept: application/json
{blank-line}
~~~
response:
~~~ 200 OK
content-type: application/json
{json}
~~~
request:
~~~
POST api/customers HTTP/1.1
host: www.sulmar.pl
content-type: application/xml
...
{blank-line}
~~~
response:
~~~
201 Created
~~~
## REST API
| Akcja | Opis |
|--------|-----------------------|
| GET | Pobierz |
| POST | Utwórz |
| PUT | Zamień |
| PATCH | Zmień częściowo |
| DELETE | Usuń |
| HEAD | Czy zasób istnieje |
## Konfiguracja
### Konfiguracja żródła
~~~ csharp
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureAppConfiguration((hostingContext, config) =>
{
config.AddXmlFile("appsettings.xml", optional: true, reloadOnChange: true);
config.AddJsonFile("appsettings.json", optional: false, reloadOnChange: true);
config.AddJsonFile($"appsettings.{hostingContext.HostingEnvironment.EnvironmentName}.json", optional: true, reloadOnChange: true);
})
.ConfigureWebHostDefaults(webBuilder =>
{
webBuilder.UseStartup();
});
}
~~~
### Wstrzykiwanie opcji
~~~ csharp
public class VehicleOptions
{
public int Quantity { get; set; }
}
~~~
- Plik konfiguracyjny appsettings.json
~~~ json
{
"VehicleOptions": {
"Quantity": 40
},
~~~
#### Konfiguracja z użyciem interfejsu IOptions
- Instalacja biblioteki
~~~ bash
dotnet add package Microsoft.Extensions.Options
~~~
- Wstrzykiwanie opcji
~~~ csharp
public class FakeVehicleService
{
private readonly VehicleOptions options;
public FakeCustomersService(IOptions options)
{
this.options = options.Value;
}
}
~~~
~~~ csharp
public void ConfigureServices(IServiceCollection services)
{
services.Configure(Configuration.GetSection("VehicleOptions"));
}
}
~~~
#### Konfiguracja bez interfejsu IOptions
~~~ csharp
public void ConfigureServices(IServiceCollection services)
{
var vehicleOptions = new VehicleOptions();
Configuration.GetSection("VehicleOptions").Bind(vehicleOptions);
services.AddSingleton(vehicleOptions);
services.Configure(Configuration.GetSection("VehicleOptions"));
}
~~~
~~~ csharp
public class FakeVehicleService
{
private readonly VehicleOptions options;
public FakeCustomersService(VehicleOptions options)
{
this.options = options;
}
}
~~~
## Web API
### Włączenie obsługi XML
~~~ csharp
public void ConfigureServices(IServiceCollection services)
{
services
.AddMvc(options => options.RespectBrowserAcceptHeader = true)
.AddXmlSerializerFormatters();
}
~~~
### Przekazywanie formatu poprzez adres URL
~~~ csharp
// GET api/customers/10
// GET api/customers/10.json
// GET api/customers/10.xml
[Route("api/[controller]")]
public class CustomersController : ControllerBase
{
[FormatFilter]
[HttpGet("{id:int}.{format?}")]
public IActionResult GetById(int id)
{
if (!customerRepository.IsExists(id))
return NotFound();
var customer = customerRepository.Get(id);
return Ok(customer);
}
}
~~~
## Mapowanie encji
- Mapping Generator
https://github.com/cezarypiatek/MappingGenerator
# EF Core
## Interceptors
https://docs.microsoft.com/pl-pl/ef/core/what-is-new/ef-core-3.0/#interception-of-database-operations