# Vytvorenie klienta

> Ako vytvoriť inštanciu NineDigit.eKasa.Client: konštruktory, konfigurácia, logovanie a jedna inštancia počas celého behu aplikácie.

Zdroj: https://ekasa.ninedigit.sk/docs/dotnet/instantiation

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](https://ekasa.ninedigit.sk/docs/dotnet/configuration).
2. **Pripravte logovanie**
   Inštanciu `ILoggerFactory` z vášho logovacieho nástroja, pozri [Logovanie](https://ekasa.ninedigit.sk/docs/dotnet/logging).
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:

```csharp
Client client = new Client(configuration, loggerFactory);
```

Ako konfiguráciu načítať, popisuje článok [Konfigurácia](https://ekasa.ninedigit.sk/docs/dotnet/configuration), ako napojiť logovanie, článok
[Logovanie](https://ekasa.ninedigit.sk/docs/dotnet/logging).

## Ž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.

```csharp
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

- [Konfigurácia](https://ekasa.ninedigit.sk/docs/dotnet/configuration): Načítanie nastavení z aplikácie Portos eKasa Servis.
- [Logovanie](https://ekasa.ninedigit.sk/docs/dotnet/logging): Napojenie vlastného logovacieho nástroja.
