Fluent NHibernate

| by Hartmut Wilms Follow 0 Followers on Aug 13, 2008. Estimated reading time: 1 minute |

Fluent NHibernate is an API for creating NHibernate mappings programmatically instead of XML configuration files. Its goal is to reduce the difficulties faced when incorporating NHibernate in a project by providing improved readability, testing capabilities, and compile time safety.

James Gregory, project owner, introduces Fluent NHibernate and raises his concerns about NHibernate’s XML configuration files:

[…] I think we all also have a bit of a dislike for the amount of XML you need to write to get your classes mapped; not only that, but also how the mappings are distinctly separate from the rest of your application. They’re often neglected and untested. One of the core tenets of the project is that we need a more succinct, readable, and testable way of writing your mappings.

In addition, Fluent NHibernate provides a fluent interfacePiers Cawley provides a good summary and explains that “client side complexity […] is reduced by moving object construction behind a thoughtful, humane interface”.

Fluent NHibernate reduces the complexity further by adhering to the convention over configuration principle, which means that the most common setup for any part of a mapping is chosen by default.

Besides compile time checking Fluent NHibernate adds to the robustness of your mappings by providing an API for testing. “We also want to help you verify that your mappings are set up properly, not just syntactically valid”, says James Gregory.

Last but not least Fluent NHibernate features a framework, which helps to setup a reference architecture and plays well with your IoC container of choice:

Our framework is a layer that sits on-top of the API to provide an even better experience. We’re looking to integrate with your favorite container, which will reduce the code you need to write to integrate NHibernate into your system. Then we’re going to tackle extensible conventions, which will allow you to specify your own implied conventions for your application. For example, if you’re always going to call your identifier “ID”, then why should you have to specify it every time? You shouldn’t!

Bobby Johnson gives a detailed step-by-step example of using Fluent NHibernate in his article “Skinning the Cat with Fluent NHibernate”.

Rate this Article

Adoption Stage

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.

Tell us what you think

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

Email me replies to any of my messages in this thread
Community comments

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

Email me replies to any of my messages in this thread

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

Email me replies to any of my messages in this thread


Login to InfoQ to interact with what matters most to you.

Recover your password...


Follow your favorite topics and editors

Quick overview of most important highlights in the industry and on the site.


More signal, less noise

Build your own feed by choosing topics you want to read about and editors you want to hear from.


Stay up-to-date

Set up your notifications and don't miss out on content that matters to you