Migrating the .NET library to version 6

Integrating via

This article is for integrators who use eKasa as a .NET library and are upgrading from version 5 to version 6. Version 6 brought breaking changes: it unified the namespaces, renamed some classes and methods, made classes not intended for public use internal and changed the composition of the NuGet packages.

Overview of changes

What to change

When upgrading to version 6, change in your code:

What to change Version 5 Version 6
using directives NineDigit.eKasa.Core.*, NineDigit.eKasa.Core.Data the single namespace NineDigit.eKasa
token class NineDigit.eKasa.Core.Printing.Models.Token NineDigit.eKasa.PrintToken
paths class NineDigit.eKasa.Helpers.EKasaPathHelper NineDigit.eKasa.EKasaPath
creating a certificate CertificateHelper.Create Certificate.FromXml
creating an identity IdentityHelper.Create Identity.FromXml

The other renamed classes and methods are listed in the tables below.

Name and namespace changes

All namespaces are unified into NineDigit.eKasa, so you no longer need several using directives. All renamed classes and changed namespaces are listed in the tables below, grouped by kind of change. The names reflect the state in version 6.

Merged namespaces

Whole namespaces moved into NineDigit.eKasa or one of its sub-namespaces.

Original namespace (v5) New namespace (v6)
NineDigit.eKasa.Core.Constants.PPEKK.* NineDigit.eKasa.Constants.PPEKK.*
NineDigit.eKasa.Core.Data.* NineDigit.eKasa
NineDigit.eKasa.Core.Data.Queries.* NineDigit.eKasa.*
NineDigit.eKasa.Core.Data.Records.* NineDigit.eKasa.*
NineDigit.eKasa.Core.Data.Validation.* NineDigit.eKasa.Validation.*
NineDigit.eKasa.Core.Exceptions.* NineDigit.eKasa.*
NineDigit.eKasa.Core.Extensions.* NineDigit.eKasa.*
NineDigit.eKasa.Core.Printing.* NineDigit.eKasa.*
NineDigit.eKasa.Core.Services.* NineDigit.eKasa.*
NineDigit.eKasa.Core.Validation.* NineDigit.eKasa.Validation.*

Renamed and moved classes

These classes have a new name or a namespace of their own.

Original name (v5) New name (v6)
NineDigit.eKasa.Core.Data.Helpers.TimeZoneHelper NineDigit.eKasa.TimeZoneHelper
NineDigit.eKasa.Core.Data.ORPCodeEqualityComparer NineDigit.eKasa.ORPCode.EqualityComparer
NineDigit.eKasa.Core.Helpers.DecimalHelper NineDigit.eKasa.DecimalExtensions
NineDigit.eKasa.Core.Helpers.IAsyncLock NineDigit.eKasa.Threading.IAsyncLock
NineDigit.eKasa.Core.Helpers.SecureStringHelper NineDigit.eKasa.SecureStringHelper
NineDigit.eKasa.Core.Helpers.ValidationHelper NineDigit.eKasa.Validation.ValidationHelper
NineDigit.eKasa.Core.Helpers.WaitHandleHelper NineDigit.eKasa.Threading.WaitHandleHelper
NineDigit.eKasa.Core.Printing.Models.Token NineDigit.eKasa.PrintToken
NineDigit.eKasa.Core.Printing.PrinterNameEqualityComparer NineDigit.eKasa.Printing.PrinterName.EqualityComparer
NineDigit.eKasa.Core.Resources.ValidationMessages NineDigit.eKasa.Resources.ValidationMessages
NineDigit.eKasa.Core.Services.IStorageEnumerator NineDigit.eKasa.Storage.IStorageEnumerator
NineDigit.eKasa.Core.Validation.Extensions.IValidatorExtensions NineDigit.eKasa.Validation.IValidatorExtensions
NineDigit.eKasa.Core.Validation.Helpers.Validator NineDigit.eKasa.Validation.Validator
NineDigit.eKasa.Helpers.EKasaPathHelper NineDigit.eKasa.EKasaPath

Replaced methods

The methods for working with a secure string (SecureString) and for creating a certificate and an identity have new names.

Original method (v5) New method (v6)
NineDigit.eKasa.Core.Helpers.SecureStringHelper.Create(string) NineDigit.eKasa.SecureStringHelper.FromString(string)
NineDigit.eKasa.Core.Helpers.SecureStringHelper.Decrypt(SecureString) NineDigit.eKasa.SecureStringHelper.ToString(SecureString)
NineDigit.eKasa.Factories.CertificateHelper.Create(Stream, SecureString) NineDigit.eKasa.Certificate.FromXml(Stream, SecureString)
NineDigit.eKasa.Factories.CertificateHelper.Create(string, SecureString) NineDigit.eKasa.Certificate.FromXml(string, SecureString)
NineDigit.eKasa.Factories.IdentityHelper.Create(Stream, bool) NineDigit.eKasa.Identity.FromXml(Stream, bool)
NineDigit.eKasa.Factories.IdentityHelper.Create(string, bool) NineDigit.eKasa.Identity.FromXml(string, bool)

Exceptions

These exceptions have a new namespace.

Original name (v5) New name (v6)
Microsoft.EntityFrameworkCore.ForeignKeyConstraintException NineDigit.eKasa.ForeignKeyConstraintException
Microsoft.EntityFrameworkCore.UniqueConstraintException NineDigit.eKasa.UniqueConstraintException
NineDigit.eKasa.Infrastructure.Storage.Verification.Exceptions.StorageVerificationException NineDigit.eKasa.Storage.Verification.StorageVerificationException
NineDigit.eKasa.Storage.Indexing.Exceptions.IndexTableIntegrityException NineDigit.eKasa.Storage.Indexing.IndexTableIntegrityException
NineDigit.eKasaClient.Exceptions.EKasaFaultException NineDigit.eKasaClient.EKasaFaultException
NineDigit.eKasaClient.Exceptions.EKasaRegistrationException NineDigit.eKasaClient.EKasaRegistrationException

Types from the System namespace

Original name (v5) New name (v6)
System.IDeepCloneable NineDigit.eKasa.IDeepCloneable
System.IDeepCloneable<T> NineDigit.eKasa.IDeepCloneable<T>

Internal classes

Classes that are not intended for public use have the internal access modifier. The affected classes and methods are listed below, grouped by their original namespace.

NineDigit.eKasa.Core.Services

Class or interface (v5)
NineDigit.eKasa.Core.Services.DateTimeProvider
NineDigit.eKasa.Core.Services.EuropeBratislavaDateTimeProvider
NineDigit.eKasa.Core.Services.ICashDrawerService
NineDigit.eKasa.Core.Services.ICertificateRecordRepository
NineDigit.eKasa.Core.Services.IDateTimeProvider
NineDigit.eKasa.Core.Services.IIdentityRecordRepository
NineDigit.eKasa.Core.Services.IMemoryFileStreamer
NineDigit.eKasa.Core.Services.IPrinterStatusProvider
NineDigit.eKasa.Core.Services.IProductInfoProvider
NineDigit.eKasa.Core.Services.IReceiptNumberProvider
NineDigit.eKasa.Core.Services.IRecordRepository
NineDigit.eKasa.Core.Services.IRecordRepositoryConnection
NineDigit.eKasa.Core.Services.IRegisterTokenQueueProcessor
NineDigit.eKasa.Core.Services.ISwIdProvider
NineDigit.eKasa.Core.Services.MemoryRecordRepository
NineDigit.eKasa.Core.Services.OffsetStopwatch

NineDigit.eKasa.Core

Class, interface or method (v5)
NineDigit.eKasa.Core.IEKasaClient
NineDigit.eKasa.Core.IEKasaClientRequest
NineDigit.eKasa.Core.IEKasaClientRequest<TResult>
NineDigit.eKasa.Core.IEKasaClientResponse
NineDigit.eKasa.Core.IEKasaClientResponse<TResult>
NineDigit.eKasa.Core.IEKasaClientResponseExtensions
NineDigit.eKasa.Core.IEKasaClientResponseExtensions.EnsureIsSuccessful(this IEKasaClientResponse)
NineDigit.eKasa.Core.IEKasaMessage
NineDigit.eKasa.Core.RegisterStateExtensions
NineDigit.eKasa.Core.X509Certificate2Extensions

NineDigit.eKasa.Core.Printing

Class or interface (v5)
NineDigit.eKasa.Core.Printing.IPrinter
NineDigit.eKasa.Core.Printing.IPrinterProvider
NineDigit.eKasa.Core.Printing.NonfiscalReceiptPrintContext
NineDigit.eKasa.Core.Printing.ReceiptCopyPrintContext
NineDigit.eKasa.Core.Printing.ReceiptPrintContext
NineDigit.eKasa.Core.Printing.RequestsPrintContext

NineDigit.eKasa.Core.Helpers

Class or method (v5)
NineDigit.eKasa.Core.Helpers.CryptoHelper
NineDigit.eKasa.Core.Helpers.DateTimeHelper
NineDigit.eKasa.Core.Helpers.DateTimeOffsetHelper
NineDigit.eKasa.Core.Helpers.SecureStringHelper.Decrypt(SecureString, Action<string>)
NineDigit.eKasa.Core.Helpers.SecureStringHelper.Decrypt<T>(SecureString, Action<string, T>)
NineDigit.eKasa.Core.Helpers.TimeoutHelper

NineDigit.eKasa.Core.Data and NineDigit.eKasa.Core.Extensions

Class or method (v5)
NineDigit.eKasa.Core.Data.Comparers.ReferenceEqualityComparer
NineDigit.eKasa.Core.Data.Comparers.RegistrationRequestDataEqualityComparer
NineDigit.eKasa.Core.Data.RegisterReceiptResult.Create(ReceiptRegistrationRequest, IEKasaClientResponse<ReceiptRegistrationResult>)
NineDigit.eKasa.Core.Data.SubmitAsyncHandler(RegistrationRequest, CancellationToken)
NineDigit.eKasa.Core.Data.SubmitAsyncHandler<TRequest, TResult>(TRequest, CancellationToken)
NineDigit.eKasa.Core.Extensions.IInternetConnectivityMonitorExtensions
NineDigit.eKasa.Core.Extensions.ReceiptRegistrationRequestReceiptExtensions
NineDigit.eKasa.Core.Extensions.RegisterRequestStateExtensions

Other namespaces

Class, interface or method (v5)
NineDigit.eKasa.Application.Domain.IReadOnlyRegisterTokenQueue
NineDigit.eKasa.Helpers.EKasaPathHelper.GetAbsoluteFilePath(string)
NineDigit.Validation.Extensions.IValidatableObjectExtensions
System.Net.WebRequestExtensions
System.ObjectExtensions
System.ObjectExtensions.ToInvariantString(this IFormattable, string)
System.Security.Cryptography.X509Certificates.X500DistinguishedNameExtensions
System.Security.Cryptography.X509Certificates.X509CertificateCollectionExtensions
System.TimeSpanExtensions

NuGet package composition

What Change in version 6
Libraries for accessing CHDÚ storages NineDigit.ChduTech and NineDigit.ChduLite are separate NuGet packages.
NineDigit.eKasa.Core.dll Merged into NineDigit.eKasa.dll. The NineDigit.eKasa NuGet package no longer contains two DLL files.

Next steps

Esc

↑↓ selectEnter openEsc close

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.