Vytvorenie klienta

Integrujem cez

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

  1. Načítajte konfiguráciu Zo súboru nastavení aplikácie Portos eKasa Servis, pozri Konfigurácia.
  2. Pripravte logovanie Inštanciu ILoggerFactory z vášho logovacieho nástroja, pozri Logovanie.
  3. 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);
    }
}

Kam ďalej

Esc

↑↓ výberEnter otvoriťEsc zavrieť

Chýba vám niečo v dokumentácii?

Napíšte nám, s čím potrebujete pomôcť. Ozveme sa do pár hodín.

Údaje použijeme len na odpoveď. Viac v ochrane osobných údajov.