Knižnicu používate cez inštanciu triedy NineDigit.eKasa.Client, vstupného bodu celého riešenia. Klientovi
odovzdáte konfiguráciu a logovanie a vaša aplikácia potom používa jednu jeho inštanciu počas celého behu, pretože
s chráneným dátovým úložiskom (CHDÚ) komunikuje výhradne.
Typické nastavenie
- Načítajte konfiguráciu Zo súboru nastavení aplikácie Portos eKasa Servis, pozri Konfigurácia.
- Pripravte logovanie
Inštanciu
ILoggerFactoryz vášho logovacieho nástroja, pozri Logovanie. - Vytvorte jedného klienta Konštruktorom s konfiguráciou aj logovaním. Inštanciu používajte počas celého behu aplikácie.
Konštruktory
Trieda Client má štyri verejné konštruktory:
| Konštruktor | Konfigurácia | Logovanie |
|---|---|---|
new Client() |
predvolená | žiadne |
new Client(ILoggerFactory loggerFactory) |
predvolená | loggerFactory |
new Client(ClientConfiguration configuration) |
configuration |
žiadne |
new Client(ClientConfiguration configuration, ILoggerFactory loggerFactory) |
configuration |
loggerFactory |
Odporúčame konštruktor, ktorý prijíma konfiguráciu aj logovanie:
Client client = new Client(configuration, loggerFactory);
Ako konfiguráciu načítať, popisuje článok Konfigurácia, ako napojiť logovanie, článok Logovanie.
Životný cyklus inštancie
Vaša aplikácia má používať jednu dlhodobo žijúcu inštanciu triedy NineDigit.eKasa.Client. Táto inštancia
komunikuje s chráneným dátovým úložiskom (CHDÚ) výhradne.
Príklad celého nastavenia
Príklad spája všetky tri kroky: načíta konfiguráciu aplikácie Portos eKasa Servis, napojí Serilog (NuGet balíky
Serilog.Extensions.Logging a Serilog.Sinks.Console) a vytvorí jednu inštanciu klienta pre celú aplikáciu.
using System;
using System.IO;
using Microsoft.Extensions.Logging;
using NineDigit.eKasa;
using NineDigit.eKasa.Configuration.DataSources;
using Serilog;
using Serilog.Extensions.Logging;
static class EKasa
{
// jedna dlhodobo žijúca inštancia pre celú aplikáciu
public static Client Client { get; } = CreateClient();
static Client CreateClient()
{
// 1. konfigurácia z aplikácie Portos eKasa Servis
string configurationFilePath = Path.Combine(
Environment.GetFolderPath(Environment.SpecialFolder.CommonApplicationData),
"NineDigit", "Portos.eKasa", "settings.json");
IDataSource<ClientConfiguration> configurationDataSource =
new JsonClientConfigurationFileDataSource(configurationFilePath);
// ak súbor neexistuje, použije sa predvolená konfigurácia
ClientConfiguration configuration = configurationDataSource.Load() ?? new ClientConfiguration();
// 2. logovanie (Serilog do konzoly)
Serilog.ILogger serilogLogger = new LoggerConfiguration()
.MinimumLevel.Debug()
.WriteTo.Console()
.CreateLogger();
ILoggerFactory loggerFactory = new SerilogLoggerFactory(serilogLogger);
// 3. klient s konfiguráciou aj logovaním
return new Client(configuration, loggerFactory);
}
}