Havit.Business 2.1.0

• .NETFramework 4.8

  • Havit.Data (>= 2.1.0)
  • Havit.Services (>= 2.0.53)

v2.1.0 (10/2026)
• Odstraněny členy označené [Obsolete]: BusinessObjectCollection.Sort(string, bool), FieldPropertySortItem(), enum MatchListMode a přetížení ReferenceCondition.CreateIn/CreateNotIn s parametrem MatchListMode. Generátor již negeneruje přepis Sort(string, bool) v *CollectionBase.
• BREAKING CHANGE: Přechod z System.Data.SqlClient na Microsoft.Data.SqlClient (závislost přes Havit.Data 2.1.0).
• BusinessObjectBase.Save a Delete: příznaky IsSaving a IsDeleting se vracejí zpět i po výjimce (ConstraintViolationException, chyba databáze). Dříve po neúspěšném Save každé další Save() objektu tiše nic neudělalo, po neúspěšném Delete každé další Delete(). Stav objektu po neúspěšném uložení se neobnovuje, opakování uložení po selhání se nepředpokládá.
• BusinessObjectCollection.SetItem (nastavení přes indexer) při zakázaných duplicitách již nevyhazuje výjimku pro prvek, který v kolekci není (IndexOf vrátil -1). Výjimka se vyhazuje jen pro skutečnou duplicitu na jiném indexu.
• BusinessObjectCollection.AddRange a RemoveAll respektují Freeze (InvalidOperationException u zamčené kolekce). AddRange při zakázaných duplicitách kontroluje duplicity vůči kolekci i uvnitř zdroje (ArgumentException, kolekce zůstane beze změny) a zdroj enumeruje pouze jednou (dříve dvakrát, což u líných dotazů znamenalo dvojí provedení projekce).
• BREAKING CHANGE (změna výsledku dotazu): DateRangeCondition.Create se zadanou pouze horní mezí používá horní mez včetně (<=), stejně jako při zadání obou mezí. Dříve bylo v tomto případě použito striktní <.
• BREAKING CHANGE: Odstraněna podpora SQL Server Compact Edition 3.5 a SQL Server 2005 (hodnoty SqlServerCe35 a SqlServer2005 enumu SqlServerPlatform z Havit.Data). Podmínka IN pro pole celých čísel používá vždy table-valued parametr IntTable, DateTime hodnoty se předávají vždy jako DateTime2. BL Generator: enum TargetPlatform obsahuje již jen SqlServer2008, přepínač -targetplatform akceptuje pouze tuto hodnotu a kolekce se předávají vždy přes IntTable (odstraněna generace pro CLR typ IntArray).
• Dokumentace: ActiveRecordBusinessObjectBase.Save i pro disconnected objekty (ConnectionMode.Disconnected) otevírá spojení a zakládá transakci (sdílenou celým grafem ukládaných objektů), databáze tedy musí být dostupná i při uložení disconnected objektů. Chování se nemění, je nově popsáno v dokumentaci Save a ConnectionMode.Disconnected.
• CollectionPropertyHolder: odložená inicializace kolekce se nyní provádí skutečně právě jednou (dříve vlákna čekající na zámku opakovaně přihlašovala handler CollectionChanged a přepisovala LoadedValue) a příznak odložené inicializace se shazuje až po nastavení Value i LoadedValue (a je volatile), takže jiné vlákno nemůže vidět LoadedValue == null. Initialize() zahazuje dosud nepoužitou odloženou hodnotu z předchozího Initialize(string) (první přístup k Value jinak vrátil původní hodnoty místo prázdné kolekce). LoadedValue před inicializací vyhazuje InvalidOperationException jako Value (dříve vracela null).
• NumberCondition.CreateIn: rozdíl krajních hodnot se počítá v typu long. Dříve pole s extrémními hodnotami (např. { 0, int.MinValue } nebo { int.MaxValue, -1 }) vyhodilo OverflowException z Math.Abs, případně se kvůli přetečení rozdílu rozhodovalo chybně.
• NumberCondition.CreateIn: hledání souvislé posloupnosti hodnot (pro podmínku BETWEEN) probíhá v jediném průchodu polem, O(n), místo odstranění duplicit, vytvoření seznamu a třídění, O(n log n); stejný postup jako v EF Core (QueryHelpers.TryGetConsecutiveRange). Vytvářené podmínky se nemění.
• PropertyInfo.Owner a PropertyName a ReferenceFieldPropertyInfo.TargetType a TargetObjectInfo před inicializací vyhazují InvalidOperationException jako ostatní vlastnosti property-info (dříve vracely null).
• Odstraněn zakomentovaný (nepoužívaný) kód.
• Opraveny překlepy a nepřesnosti v dokumentaci a komentářích (BusinessObjectBase, ActiveRecordBusinessObjectBase, PropertyHolderBase, FieldPropertyInfo, ReferenceFieldPropertyInfo, TernaryCondition, CommandBuilderOptions).
• Generovaný kód (Havit.Business.BLGenerator 2.1.0) používá using Microsoft.Data.SqlClient; je nutné přegenerovat business vrstvu a zvýšit verzi Havit.Business ve stejný okamžik.
• BL Generator při přegenerování v existujících souborech Entita.cs a EntitaCollection.cs vymění "using System.Data.SqlClient;" za "using Microsoft.Data.SqlClient;".
• BL Generator se k databázi připojuje s TrustServerCertificate=True (Microsoft.Data.SqlClient má výchozí Encrypt=True, vývojové servery často nemají důvěryhodný certifikát).
• Generovaný kód sdílí při načítání kolekcí jedno DataRecordSchema pro všechny řádky readeru (GetList, LoadAll, uložené procedury vracející kolekci), přínos se projeví po přegenerování.
• ValueOperand: rychlejší pojmenování parametrů dotazu (vlastní ordinální průchod místo DbParameterCollection.Contains, cache názvů), výrazný rozdíl pro stovky parametrů v jednom dotazu.
• IntTableOperand vyžaduje Microsoft.Data.SqlClient.SqlCommand (providerName "System.Data.SqlClient" je v DbConnectoru mapován na Microsoft.Data.SqlClient).
• Odebrány přímé závislosti na System.Buffers a System.Memory (nepoužívané, tranzitivně je přináší Microsoft.Data.SqlClient).