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