Skip to content

Commit c1ae2fb

Browse files
fredericDelaportefredericDelaporte
committed
NH-4000 - Release notes.
1 parent 7833eb2 commit c1ae2fb

File tree

1 file changed

+249
-3
lines changed

1 file changed

+249
-3
lines changed

‎releasenotes.txt

Lines changed: 249 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,249 @@
1+
Build 5.0.0
2+
=============================
3+
4+
** Highlights
5+
* IO bound methods have gained an async counterpart. Not intended for parallelism, make sure to await each
6+
call before further interacting with a session and its queries.
7+
* Strongly typed DML operation (insert/update/delete) are now available as Linq extensions on queryables.
8+
* Entities collections can be queried with .AsQueryable() Linq extension without being fully loaded.
9+
* Reference documentation has been curated and completed, notably with a Linq section.
10+
http://nhibernate.info/doc/nhibernate-reference/index.html
11+
12+
** Known BREAKING CHANGES from NH4.1.1.GA to 5.0.0
13+
14+
NHibernate now targets .Net 4.6.1.
15+
16+
Remotion.Linq and Antlr3 libraries are no more merged in the NHibernate library,
17+
and must be deployed along NHibernate library. (NuGet will reference them.)
18+
19+
Classes and members which were flagged as obsolete in the NHibernate 4.x series have been dropped.
20+
Prior to upgrading, fix any obsolete warning according to its message. See NH-4075 and NH-3684 for a list.
21+
22+
##### Possible Breaking Changes #####
23+
* All members exposing some System.Data types have been changed for the corresponding System.Data.Common
24+
types. (IDbCommand => DbCommand, ...)
25+
* The Date NHibernate type will no more replace by null values below its base value (which was year 1753).
26+
Its base value is now DateTime.MinValue. Its configuration parameter is obsolete.
27+
* NHibernate type DateTimeType, which is the default for a .Net DateTime, does no longer cut fractional
28+
seconds. Use DateTimeNoMsType if you wish to have fractional seconds cut. It applies to its Local/Utc
29+
counterparts too.
30+
* LocalDateTimeType and UtcDateTimeType do no more accept being set with a value having a non-matching kind,
31+
they throw instead.
32+
* DbTimestamp will now round the retrieved value according to Dialect.TimestampResolutionInTicks.
33+
* When an object typed property is mapped to a NHibernate timestamp, setting an invalid object in the
34+
property will now throw at flush instead of replacing it with DateTime.Now.
35+
* Transaction scopes handling has undergone a major rework. See NH-4011 for full details.
36+
** More transaction promotion to distributed may occur if you use the "flush on commit" feature with
37+
transaction scopes. Explicitly flush your session instead. Ensure it does not occur by disabling
38+
transaction.use_connection_on_system_events setting.
39+
** After transaction events no more allow using the connection when they are raised from a scope
40+
completion.
41+
** Connection enlistment in an ambient transaction is now enforced by NHibernate by default.
42+
** The connection releasing is no more directly triggered by a scope completion, but by later
43+
interactions with the session.
44+
* AdoNetWithDistributedTransactionFactory has been renamed AdoNetWithSystemTransactionFactory.
45+
* Subcriteria.UniqueResult<T> for value types now return default(T) when result is null, as was
46+
already doing CriteriaImpl.UniqueResult<T>.
47+
* AliasToBeanResultTransformer property/field resolution logic has changed for supporting members
48+
which names differ only by case. See NH-3693 last comments for details.
49+
* Linq extension methods marked with attribute LinqExtensionMethod will no more be evaluated
50+
in-memory prior to query execution when they do not depend on query results, but will always be
51+
translated to their corresponding SQL call. This can be changed with a parameter of the attribute.
52+
* Linq Query methods are now native members of ISession and IStatelessSession instead of being
53+
extension methods.
54+
* Linq provider now use Remotion.Linq v2, which may break Linq provider extensions, mainly due to names
55+
changes. See https://github.com/nhibernate/nhibernate-core/pull/568 changes to test files for examples.
56+
* NHibernate Linq internals have undergone some minor changes which may break custom Linq providers due
57+
to method signature changes and additional methods to implement.
58+
* IMapping interface has an additional Dialect member. ISessionFactoryImplementor has lost it, since it
59+
gains it back through IMapping.
60+
* IDriver.ExpandQueryParameters and DriverBase.CloneParameter take an additional argument.
61+
* NullableType, its descendent (notably all PrimitiveType) and IUserType value getters and setters now
62+
take the session as an argument. This should mainly impact custom types implementors.
63+
* EmitUtil is now internal and has been cleaned of unused members.
64+
* ContraintOrderedTableKeyColumnClosure has been renamed ConstraintOrderedTableKeyColumnClosure.
65+
* enabledFilter parameter has been removed from IProjection.ToSqlString and ICriterion.ToSqlString methods.
66+
* Proxy factory and proxy cache now use TypeInfo instead of System.Type. This should be transparent for
67+
most users.
68+
* Exceptions which were based on ApplicationException are now based on Exception: HibernateException,
69+
ParserException and AssertionFailure. The logger factory which could throw a bare ApplicationException
70+
now throws an InstantiationException instead.
71+
* ThreadSafeDictionary class has been removed. Use System.Collections.Concurrent.ConcurrentDictionary
72+
instead.
73+
* Entity mode switching capability, which had never been fully implemented, is dropped.
74+
* BytecodeProviderImpl, intended for .Net Framework 1 and broken, is dropped.
75+
* Sessions concrete classes constructors have been changed. (It is not expected for them to be used
76+
directly.)
77+
* Obsolete setting interceptors.beforetransactioncompletion_ignore_exceptions is dropped.
78+
* SQL Server 2008+ dialects now use datetime2 instead of datetime for all date-time types, including
79+
timestamp. This can be reverted with sql_types.keep_datetime setting.
80+
* SQL Server 2008+ timestamp resolution is now 100ns in accordance with datetime2 capabilities, down from
81+
10ms previously. This can be reverted with sql_types.keep_datetime setting.
82+
* Oracle 9g+ dialects now use timestamp(7) for all date time types, instead of timestamp(4).
83+
* Oracle 9g+ timestamp resolution is now 100ns in accordance with timestamp(7) capabilities, down from
84+
100µs previously.
85+
* Oracle: Hbm2dll will no-more choose N- prefixed types for typing Unicode string columns by default.
86+
This can be changed with oracle.use_n_prefixed_types_for_unicode setting, which will furthermore
87+
control DbCommand parameters typing accordingly. See NH-4062.
88+
* SqlServerCe: the id generator "native" will now resolve as table-hilo instead of identity.
89+
* Firebird: timestamp resolution is now 1ms.
90+
* PostgreSQL: if Npgsql v3 or later is used, time DbParameters will be fetched as TimeSpan instead of
91+
DateTime.
92+
* ODBC: String parameter length will no more be specified by the OdbcDriver.
93+
94+
** Sub-task
95+
* [NH-3956] - Native SQL query plan may get wrong plan
96+
* [NH-3957] - Second level query cache may yields wrong cache entry
97+
* [NH-4001] - Remove ThreadSafeDictionary
98+
99+
** Bug
100+
* [NH-926] - Identity insert fails with SQL Ce dialect and aggressive connection release mode.
101+
* [NH-1752] - NHibernate Date type converts to NULL
102+
* [NH-1904] - Protected properties and public properties cannot have the same name with different case
103+
* [NH-2029] - filter-def's use-many-to-one=false should take ON into consideration
104+
* [NH-2145] - AssertionFailure exception at ISession.Save
105+
* [NH-2176] - Consecutive TransactionScopes cannot be used in same NHibernate session
106+
* [NH-2238] - "DTC transaction prepare phase failed" when UPDATE:ing in a promoted TransactionScope
107+
* [NH-2241] - Batch Insert using stateless session when using second level cache throws exception when unable to determine transient status
108+
* [NH-2928] - Connections can only be closed after the Transaction is completed
109+
* [NH-3023] - Deadlocks may cause connection pool corruption when in a distributed transaction
110+
* [NH-3078] - TimeAsTimeSpanType issue when using Sybase Advantage Database
111+
* [NH-3100] - Problem in use if condition for nullable boolean in linq to NHibernate
112+
* [NH-3114] - Collection inside Component cannot be mapped to a different table
113+
* [NH-3227] - InvalidOperationException in AbstractBatcher when distributed transaction is aborted
114+
* [NH-3247] - Char value gets 'cached' in Where-queries
115+
* [NH-3374] - Session.Merge throws InvalidCastException when using a Lazy bytes[] property
116+
* [NH-3600] - ISession.Save returns wrong Id
117+
* [NH-3665] - FirstOrDefault() broken since 3.3.4 and 3.4.0
118+
* [NH-3693] - AliasToBeanResultTransformerFixture fails under Firebird
119+
* [NH-3755] - Proxy exception for multiple joined-subclass
120+
* [NH-3757] - Dynamic entity mapped with entity-name cannot have a component of a fixed class
121+
* [NH-3793] - Attribute entity-name on <key-many-to-one> is ignored, causing mapping exception
122+
* [NH-3845] - OfType fails with polymorphism
123+
* [NH-3850] - .Count(), .Any() and other aggregates return only first result on polymorphic queries
124+
* [NH-3885] - ThreadSafeDictionary is not threadsafe
125+
* [NH-3889] - Coalesce on entity in sub-select causes incorrect SQL
126+
* [NH-3895] - Problem with DateTime fractional seconds on ODBC for MS SQL Server
127+
* [NH-3911] - Reflection Optimizer tries to cast values to getter type in setter
128+
* [NH-3913] - Component has bag of child components. Child property mapping ignored
129+
* [NH-3931] - Invalid order of child inserts when using TPH inheritance
130+
* [NH-3946] - Linq where "is base class" doesn't get subclasses
131+
* [NH-3948] - CheckAndUpdateSessionStatus() called twice in CreateFilter method inside SessionImpl class
132+
* [NH-3950] - FutureValue fails on Linq queries defining a PostExecuteTransformer
133+
* [NH-3954] - Dynamic proxy cache may yield a wrong proxy
134+
* [NH-3955] - Unreliable Equals implementation
135+
* [NH-3961] - Invalid date parameter format with nullables and MappedAs
136+
* [NH-3966] - Missing command set dispose in batchers
137+
* [NH-3968] - Distributed transaction cannot be committed because AdoNetWithDistributedTransactionFactory tries to write data by using locked sqlConnection
138+
* [NH-3969] - Firebird: TimestampResolutionInTicks should be 1ms
139+
* [NH-3977] - Thread safety weaknesses of MapBasedSessionContext
140+
* [NH-3981] - CollectionHelper.DictionaryEquals throws
141+
* [NH-3985] - ObjectDisposedException is thrown when using a child session after having previously disposed of another child session.
142+
* [NH-3998] - SqlServer CE: "The column aliases must be unique" exception is thrown in some tests
143+
* [NH-4013] - SqlClientBatchingBatcher CloseCommands contract violated
144+
* [NH-4022] - MsSql2012Dialect: Invalid drop sequence statement
145+
* [NH-4024] - ODBC failures with time
146+
* [NH-4027] - Missing disposals of enumerators
147+
* [NH-4035] - Teardown failure should not prevent cleanup
148+
* [NH-4038] - Mapping a TimeSpan in a collection component mapping maps as a BIGINT
149+
* [NH-4046] - Default length too short for variable length types with SAP Anywhere / ASE
150+
* [NH-4077] - Possible race condition in ActionQueue.ExecuteActions
151+
* [NH-4083] - ODBC nvarchar parameter corruption
152+
* [NH-4084] - DbTimestamp cause stale update exception
153+
* [NH-4086] - TimeType may lose fractional seconds
154+
155+
** New Feature
156+
* [NH-1530] - Add support for XmlDocType and XDocType for Oracle
157+
* [NH-2319] - IQueryable support for persistent collections
158+
* [NH-3488] - Strongly Typed Updates and Deletes
159+
* [NH-3771] - Implement setting to enable Batch Update with Optimistic Locking control
160+
* [NH-3905] - Support async: Blocking IO leads to ThreadPool starvation and limits scalability
161+
* [NH-3934] - Add methods WhereNot(ICriterion) and AndNot(ICriterion) in QueryOver
162+
* [NH-3951] - Support .All() result operator
163+
* [NH-3996] - Postgres: add support for XmlDocType and XDocType
164+
* [NH-4009] - Allow marking a Linq extension as db only
165+
* [NH-4017] - Handle Time parameter conversion for newer Npgsql
166+
* [NH-4018] - Port AutoJoinTransaction feature
167+
* [NH-4028] - Support inconclusive tests in result comparison
168+
* [NH-4031] - Add an AsyncLocalSessionContext
169+
* [NH-4032] - Supports multiple factories with ThreadStaticSessionContext
170+
* [NH-4062] - Properly handle Oracle Unicode support dual model
171+
172+
** Task
173+
* [NH-3683] - Fix Compilation Warnings
174+
* [NH-3958] - Reference documentation: missing types
175+
* [NH-3959] - Fix documentation typos
176+
* [NH-3999] - Document effect of quoted identifier on case sensitivity
177+
* [NH-4000] - Release 5.0
178+
* [NH-4004] - Restrict tests running on SQL CE
179+
* [NH-4051] - Replace System.Linq.Dynamic with System.Linq.Dynamic.Core in tests
180+
* [NH-4057] - Fix tests for MySql
181+
* [NH-4058] - Fix Oracle managed failing tests
182+
* [NH-4063] - Fix ODBC failing tests
183+
184+
** Improvement
185+
* [NH-1851] - Mapping a TimeSpan as TimeAsTimeSpan for MySQL
186+
* [NH-2444] - Document linq provider
187+
* [NH-3094] - Linq does not support unary plus and unary minus operators
188+
* [NH-3370] - Remove warning about "NHibernate.Type.CustomType -- the custom type * is not serializable"
189+
* [NH-3386] - Linq OrderBy NewID()
190+
* [NH-3431] - Replace System.Data with System.Data.Common
191+
* [NH-3578] - Subcriteria.UniqueResult<T> for value types should return default(T), same as CriteriaImpl.UniqueResult<T> when result is null
192+
* [NH-3669] - Query should be instance method of ISession
193+
* [NH-3723] - Some tests are failing when log level set to DEBUG
194+
* [NH-3744] - Fixed spelling of ContraintOrderedTableKeyColumnClosure method
195+
* [NH-3750] - Use NuGet to refer to Remotion.Linq (unmerge ReMotion.Linq)
196+
* [NH-3877] - Target .NET 4.6.1
197+
* [NH-3900] - Upgrade to Nunit 3.x
198+
* [NH-3919] - Clean up and harmonize datetime types with regards to different dialects
199+
* [NH-3927] - Switch to SemVer version scheme
200+
* [NH-3932] - Merge() may fire unnecessary updates if collection and version mapping exists
201+
* [NH-3943] - Use NuGet to reference packages instead of local copies
202+
* [NH-3944] - Upgrade to ReLinq 2
203+
* [NH-3945] - Update to Antlr 3.5.1
204+
* [NH-3952] - Cleanup EnumerableHelper usage
205+
* [NH-3962] - Build with MSBuild Tools 2017 (15)
206+
* [NH-3963] - More explicit error on MappedAs invalid usage.
207+
* [NH-3964] - Refactor reflection patterns
208+
* [NH-3970] - TestCase base class: avoid hiding test failure on tear-down
209+
* [NH-3973] - Remove enabledFilter parameter from IProjection.ToSqlString and ICriterion.ToSqlString methods
210+
* [NH-3975] - Synchronize some features dialect support properties
211+
* [NH-3978] - Extract IDatabaseMetadata from DatabaseMetadata
212+
* [NH-3987] - Re-implement NhQueryable options
213+
* [NH-3988] - Replace ApplicationException base class with just Exception
214+
* [NH-3990] - Upgrade to VS2017 Project structure
215+
* [NH-3993] - Component Element Customizer Missing ability to map non-public parents and composite element relations
216+
* [NH-3997] - SqlServer CE: Make native generator to be TableHiLoGenerator
217+
* [NH-4003] - Refactor session constructor
218+
* [NH-4010] - Visual Studio launcher still launches 2015
219+
* [NH-4014] - Update SQLite assembly for tests
220+
* [NH-4015] - Update Npgsql driver and enable DTC for it in tests
221+
* [NH-4019] - Pass assembly into log4net functions
222+
* [NH-4020] - Use TypeBuilder.CreateTypeInfo()
223+
* [NH-4021] - Track all opened session in tests
224+
* [NH-4023] - Pass ISessionImplementor to all value setters and getters of nullable types
225+
* [NH-4026] - Update Firebird driver and use server in tests
226+
* [NH-4030] - Cleanup and xml doc of Linq Future extension
227+
* [NH-4033] - Update MySql connector used in tests
228+
* [NH-4034] - Flush all sessions participating in a transaction
229+
* [NH-4043] - Complete keyword registration needs done in dialects.
230+
* [NH-4049] - EmitUtil can be cleaned up
231+
* [NH-4050] - Use Task.Run instead of BeginInvoke in tests
232+
* [NH-4052] - Collect schema validation exceptions
233+
* [NH-4064] - Unmerge Antrl3.Runtime
234+
* [NH-4073] - Replace NHibernate.Web.Example with modern version
235+
* [NH-4076] - Do not resurrect session
236+
237+
** Remove Feature
238+
* [NH-3684] - Remove <Time>Part Extension Methods of QueryOver
239+
* [NH-3700] - Remove CodeDom BytecodeProviderImpl
240+
* [NH-3722] - Remove entity mode switching capability
241+
* [NH-4075] - Remove code obsolete in 4.x
242+
243+
** Meta Issue
244+
* [NH-4011] - Fix transaction scopes handling
245+
246+
1247
Build 4.1.1.GA
2248
=============================
3249

@@ -3062,7 +3308,7 @@ Alpha Build 0.3.0.0
30623308
- BatcherImpl and PreparerImpl were combined and code cleaned up thanks to problems found when using Ngpsql (Martijn Boland).
30633309
- ITransaction is now responsible for joining IDbCommand to IDbTransaction instead of IBatcher - if applicable.
30643310
- Modified code to help improve performance of Drivers that don't support multiple Open DataReaders on a single IDbConnection.
3065-
- Fixed bug with hbm2net and VelocityRenderer throwing Exception (Carlos Guzm�n �lvarez & Peter Smulovics).
3311+
- Fixed bug with hbm2net and VelocityRenderer throwing Exception (Carlos Guzmán Álvarez & Peter Smulovics).
30663312
- Clean up of hbm2net (Peter Smulovics).
30673313
- Modified internals of AbstractEntityPersister to help with buiding on Mono (Oliver Weichhold).
30683314
- Renamed nhibernate.build to NHibernate.build to help with building on Mono (Oliver Weichhold).
@@ -3114,10 +3360,10 @@ PreAlpha Build 0.1.0.0
31143360
- nhibernate-configuration-2.0.xsd schema was updated to .net friendly names and all cfg.xml files are now validated.
31153361
- Fixed bug with classes having dynamic-insert and dynamic-update causing IndexOutOfRangeExceptions.
31163362
- Modified length of string for CultureInfoType.
3117-
- Added Firebird fixes contributed by Carlos Guzm�n �lvarez.
3363+
- Added Firebird fixes contributed by Carlos Guzmán Álvarez.
31183364
- Changed TimestampType.Set to behaive like hibernate. Will not write a null value anymore - instead replaces it with DateTime.Now.
31193365
- Removed IVersionType interface from DecimalType.
3120-
- Add PropertyExpressions contributed by Carlos Guzm�n �lvarez.
3366+
- Add PropertyExpressions contributed by Carlos Guzmán Álvarez.
31213367
- Fixed bug with referencing joined classes properties in hql.
31223368
- Fixed IndexOutOfRangeException with NormalizedEntityPersister for versioned entities.
31233369
- Added ObjectType to TypeFactory and NHibernate.

0 commit comments

Comments
 (0)