Facilitating the Spread of Knowledge and Innovation in Professional Software Development

Write for InfoQ


Choose your language

InfoQ Homepage News Fluent NHibernate Has Been Released as 1.0 RC

Fluent NHibernate Has Been Released as 1.0 RC

Leia em Português

This item in japanese


James Gregory, the owner of the Fluent NHibernate project, has announced his project has reached the 1.0 milestone and it is currently a Release Candidate.

The Release Notes mention the following features and improvements in the mapping section: 

  • Cleaned up method names - Removed a lot of noise in method names, such as WithLengthOf is now just Length; ColumnName to Column, WithTableName to Table etc...
  • Removed SetAttribute - SetAttribute was a stop-gap measure to allow people to use Fluent NHibernate when we didn't support the attributes they needed. We've now gone to a great length to support all of the main attributes in the fluent interface, so you shouldn't need this anymore. If there are any attributes you need that we've missed, let us know (or even better, send us a pull request/patch)
  • Separated subclass mapping - Subclasses can (and should be) defined separately from their parent mapping. Use SubclassMap<T> the same way as you would ClassMap<T>; if the top-most mapping (ClassMap) contains a DiscriminateSubclassesOnColumn call, the subclasses will be mapped as table-per-class-hierarchy, otherwise (by default) they'll be mapped as table-per-subclass.
    See subclasses for more info.
  • Renamed the static entry point - AutoPersistenceModel.MapEntitiesFromAssemblyOf<Product> was always a bitwordy, it's been renamed to AutoMap.AssemblyOf<Product>
  • Components - Improved support for components in automapping. They still work the same as before but now have support for all the collections and things they should have.
    See components for more info.
  • IgnoreProperty for all types - You can now use IgnoreProperty against multiple types, instead of on a per-entity basis.
    See ignoring properties for more info.

In the conventions section we find:

  • Always applied first - They're now applied before any of your explicit settings in your ClassMap. This means that there's no accidently overwriting your mappings.
  • Always apply by default - Conventions used to have an Accept method that most people just either returned true, which meant apply to everything, or checked if a value had been set in the ClassMap; considering the above change, this meant Accept was mostly redundant. Conventions now always apply to everything. If you don't want that, there's an IClassAcceptance (and equivilant for other conventions) interface to add this behavior
  • Acceptance Criteria - For when you do need an Accept defined, there's a new criteria API for defining it in a much more consistent manner.
    See acceptance criteria for more info.
  • ForeignKeyConvention - Base-class provided for setting the foreign-key naming consistently across the whole of your mappings.
    See ForeignKeyConvention for more info.
  • ManyToManyTableNameConvention - Base-class (and defaults) for setting the table name of many-to-many's. This is much smarter than it was before, no overwriting explicit settings, support for bi-directional relationships.
    See ManyToManyTableNameConvention for more info.

Gregory hopes the project won’t stay long as RC considering the amount of testing already put into it.

Fluent NHibernate offers an alternative to using XML by providing fluent mappings through C# code. It also provides auto-mapping which uses a mechanism creating the mappings directly from entities. A quick introduction to Fluent NHibernate can be found on InfoQ/Fluent NHibernate. More details are available on Fluent NHibernate Wiki page. The Downloads page contain both the sources and the binaries for those who want to try it out.

Rate this Article


Hello stranger!

You need to Register an InfoQ account or or login to post comments. But there's so much more behind being registered.

Get the most out of the InfoQ experience.

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Community comments

  • Does it support multiple mappings per table or per class?

    by peter lin,

    Your message is awaiting moderation. Thank you for participating in the discussion.

    Having used both Hibernate and NHibernate, one common practice in the enterprise space is mapping a class to multiple views and multiple classes to 1 view. Using attributes to declare the mapping is nice, but it forces users to 1-to-1 relationship.


Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p