Fluent NHibernate
Fluent, XML-less, compile-safe, convention-based mappings for NHibernate.
What is Fluent NHibernate?
Fluent NHibernate is a library that provides a fluent, XML-less, and convention-based mapping system for NHibernate, a popular .NET object-relational mapper (ORM). It allows developers to define database mappings using a strongly-typed C# API instead of traditional XML files, making the configuration process more intuitive and less error-prone. The library focuses on improving developer productivity and code safety by catching mapping errors at compile time and automating repetitive mapping tasks.
.NET developers using NHibernate for data access who want a more maintainable and type-safe way to configure their ORM mappings, especially those working on medium to large applications where XML mapping files become cumbersome.
Developers choose Fluent NHibernate over standard NHibernate XML mappings because it offers a more modern, developer-friendly workflow with compile-time safety, reduced boilerplate through conventions, and better integration with C# tooling and refactoring.
Overview
Fluent NHibernate!
Use Cases
Best For
- Replacing verbose XML mapping files in NHibernate projects
- Implementing convention-based ORM mappings to reduce repetitive configuration
- Ensuring compile-time safety for database mappings in C#
- Automating NHibernate mappings based on entity naming conventions
- Simplifying NHibernate configuration in large enterprise applications
- Creating maintainable data access layers with fluent configuration APIs
Not Ideal For
- Greenfield projects starting with modern .NET ORMs like Entity Framework Core, which have built-in fluent APIs and better tooling integration
- Teams requiring minimal configuration who prefer convention-over-configuration out of the box, as seen in some newer ORMs
- Applications where database schema is controlled externally or uses non-relational databases, limiting NHibernate's relevance
- Legacy systems deeply integrated with XML mappings, where migration to Fluent NHibernate would incur high refactoring costs
Pros & Cons
Pros
Catches mapping errors at compile time rather than runtime, reducing bugs and improving developer confidence, as highlighted in the README's 'Compile-Safe Mappings' feature.
Uses a strongly-typed, chainable API that integrates seamlessly with C# tooling and refactoring, replacing verbose XML files with intuitive code, as per the 'Fluent Interface' description.
Allows automatic application of mapping patterns based on configurable conventions, reducing repetitive code and boilerplate, evidenced by the 'Convention-Based Automation' and 'Auto Mapping' features.
Eliminates the need for fragile XML mapping files, making configuration more maintainable and less error-prone, a core value proposition stated in the README.
Cons
Ties your project to NHibernate's ecosystem and limitations, which may not be as actively developed or feature-rich as alternatives like Entity Framework Core, adding vendor lock-in.
Requires understanding both NHibernate concepts and Fluent NHibernate's API, with documentation scattered across a wiki, making onboarding complex for new users.
The project's core development peaked around 2018, so it might lack support for newer .NET features or have slower bug fixes, relying on community contributions.
Frequently Asked Questions
Related Projects
DapperDapper - a simple object mapper for .Net
Entity Framework CoreEF Core is a modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations.
SqlSugar.Net aot ORM SqlServer ORM Mongodb ORM MySql 瀚高 Postgresql ORM DB2 Hana 高斯 Duckdb C# VB.NET Sqlite ORM Oracle ORM Mysql Orm 虚谷数据库 达梦 ORM 人大金仓 ORM 神通ORM C# ORM , C# ORM .NET ORM NET9 ORM .NET8 ORM ClickHouse ORM QuestDb ,TDengine ORM,OceanBase ORM,GaussDB ORM,Tidb ORM Object/Relational Mapping
ServiceStack.OrmLiteThoughtfully architected, obscenely fast, thoroughly enjoyable web services for all
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.