NHibernate.AspNet.Identity 使用指南

NHibernate.AspNet.Identity 使用指南

NHibernate.AspNet.Identity ASP.NET Identity Provider for NHibernate 项目地址: https://gitcode.com/gh_mirrors/nh/NHibernate.AspNet.Identity

项目概述

NHibernate.AspNet.Identity 是一个开源项目，旨在提供一个使用 NHibernate 作为存储引擎的 ASP.NET Identity 提供器替代方案。这个项目允许开发者在他们的应用中集成 NHibernate 的强大持久化能力来管理用户身份验证和授权信息，而不是依赖于默认的 Entity Framework。

1. 目录结构及介绍

本节将概述项目的主要目录及其内容，但请注意，实际的项目结构可能会随着版本更新而变化。以下是一个典型的项目结构示例：

NHibernate.AspNet.Identity
├── src                   # 源代码主目录
│   ├── NHibernate.AspNet.Identity     # 主要的实现代码
│       ├── Models           # 包含 Identity 相关的数据模型，如 IdentityUser
│       ├── Repositories    # 用户存储等接口和实现
│       ├── Config           # 配置相关的类或文件
│       └── ...               # 其他相关类
├── samples               # 示例应用（如果存在）
│   └── YourSampleApp     # 展示如何使用本库的应用示例
├── tests                 # 测试目录，包含单元测试或集成测试（如果项目包括）
├── .gitignore            # Git 忽略文件列表
├── README.md             # 项目说明文档
└── LICENSE               # 许可证文件

注意: 实际开发时，您可能需要将自己的项目结构与此进行适配，确保与您的应用程序框架相匹配。

2. 项目的启动文件介绍

在 ASP.NET 应用中，并没有特定的“启动文件”直接属于 NHibernate.AspNet.Identity，而是通过一系列步骤在您的应用中集成。主要的集成点通常是在 ASP.NET 应用的 Startup.cs 文件中，或者如果您遵循基本的 ASP.NET Core 模板，则是在 Program.cs 和 Startup.cs 中配置服务的地方。您需执行以下操作来集成该库:

• 在 ConfigureServices(IServiceCollection services) 方法中注册 NHibernate 以及 Identity 的 NHibernate 版本。

services.AddScoped<UserManager<ApplicationUser>, UserManager<ApplicationUser>>();
services.AddScoped<IUserStore<ApplicationUser>, UserStore<ApplicationUser>>();

其中，ApplicationUser 是你的用户模型，UserStore 应继承自 NHibernate.AspNet.Identity 中提供的 UserStore<TUser> 类。

3. 项目的配置文件介绍

NHibernate 配置

NHibernate 的配置既可以通过 XML 文件也可以使用代码配置。XML 方式配置通常位于项目的 App_Config 或类似的目录下，例如 nhibernate.config.xml。

示例 XML 配置:

<?xml version="1.0"?>
<hibernate-configuration xmlns="urn:nhibernate@Configuration/2.0">
  <session-factory>
    <!-- 数据源配置 -->
    <property name="connection.provider">NHibernate.Connection.DriverConnectionProvider</property>
    <property name="dialect">NHibernate.Dialect.SQLiteDialect</property>
    <property name="connection.driver_class">NHibernate.Driver.SQLite20Driver</property>
    <property name="connection.connection_string">Data Source=your_database.db;Version=3;</property>
    <!-- 映射文件路径 -->
    <mapping assembly="YourAssemblyWithMappings"/>
  </session-factory>
</hibernate-configuration>

ASP.NET Identity 配置集成

项目中的配置不仅限于 NHibernate 的连接字符串，还要确保 Identity 的实体正确映射到 NHibernate。这通常在初始化 NHibernate 会话工厂时完成，确保使用了正确的实体映射。

// 示例代码配置 NHibernate
var config = new Configuration();
config.Configure("path_to_your_nhibernate_config.xml");
config.AddDeserializedMapping(MappingHelper.GetIdentityMappings(new[] {typeof(ApplicationUser)}), null);
var sessionFactory = config.BuildSessionFactory();

请根据实际使用的框架版本和具体需求调整上述配置和步骤。集成过程可能涉及更多细节，比如依赖注入设置和实体模型的设计，这些都需要参考项目的最新文档和你的应用上下文。

NHibernate.AspNet.Identity ASP.NET Identity Provider for NHibernate 项目地址: https://gitcode.com/gh_mirrors/nh/NHibernate.AspNet.Identity