DS.Foundation.NHibernate
8.4.4
dotnet add package DS.Foundation.NHibernate --version 8.4.4
NuGet\Install-Package DS.Foundation.NHibernate -Version 8.4.4
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="DS.Foundation.NHibernate" Version="8.4.4" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="DS.Foundation.NHibernate" Version="8.4.4" />
<PackageReference Include="DS.Foundation.NHibernate" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add DS.Foundation.NHibernate --version 8.4.4
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: DS.Foundation.NHibernate, 8.4.4"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package DS.Foundation.NHibernate@8.4.4
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=DS.Foundation.NHibernate&version=8.4.4
#tool nuget:?package=DS.Foundation.NHibernate&version=8.4.4
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
DS.Foundation.NHibernate
Registra una ISessionFactory y una ISession de NHibernate en el contenedor de DI a partir de un DatabaseAccessPointOptions, y ofrece una clase base para lógica de negocio que trabaja con una sesión.
- Target framework:
netstandard2.0. - Dependencias:
DS.Foundation,DS.Foundation.Data,NHibernate5.6.
Instalación
<PackageReference Include="DS.Foundation.NHibernate" Version="8.4.0" />
Registro
using DS.Foundation.Configuration;
using DS.Foundation.Configuration.Options;
using DS.Foundation.NHibernate;
builder.Services.AddNHibernate(new DatabaseAccessPointOptions
{
Engine = DbEngine.PostgreSQL,
ConnectionString = connectionString,
});
AddNHibernate registra:
| Servicio | Ciclo de vida |
|---|---|
ISessionFactory |
singleton (se construye al llamar a AddNHibernate) |
ISession |
scoped (OpenSession() por scope) |
SessionWrapper |
scoped |
SessionFactoryWrapper y NHibernateBusinessLogicManager no se registran: créelos o regístrelos usted.
Configuración
Propiedad de DatabaseAccessPointOptions |
Uso |
|---|---|
Engine |
SqlServer (dialecto MsSql2008Dialect) o PostgreSQL (PostgreSQLDialect). Otros motores no configuran dialecto ni conexión. |
ConnectionString |
Cadena de conexión de ADO.NET. |
Con PostgreSQL, el SQL generado se escribe en la consola (LogSqlInConsole).
Uso
public class PedidosManager : NHibernateBusinessLogicManager
{
public PedidosManager(ISession session, ILogger<PedidosManager> logger) : base(session, logger) { }
public void Guardar(Pedido pedido)
{
using (var tx = BeginTransaction())
{
GetSession().SaveOrUpdate(pedido);
tx.Commit();
}
}
}
Errores frecuentes
| Síntoma | Causa | Solución |
|---|---|---|
MappingException: No persister for: … |
AddNHibernate solo agrega los mapeos del ensamblado DS.Foundation.NHibernate, no los de su aplicación |
Construir su propia Configuration con sus mapeos y registrar la ISessionFactory manualmente |
Error al construir la ISessionFactory con MySQL u otro motor |
Solo SQL Server y PostgreSQL configuran dialecto y conexión | Usar uno de esos motores o configurar NHibernate manualmente |
Qué no hacer
- No inyectar
ISessionen servicios singleton: la sesión es scoped. - No dejar
LogSqlInConsoleactivo en producción con PostgreSQL si el SQL contiene datos sensibles; hoy no se puede desactivar desde opciones.
Cambios
Ver CHANGELOG.md.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
.NETStandard 2.0
- DS.Foundation (>= 8.4.4)
- DS.Foundation.Data (>= 8.4.4)
- NHibernate (>= 5.6.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.