|
|
// ============================================================================
|
|
|
// 【文件说明】HwWeb1Service.cs - 网页内容服务类
|
|
|
// ============================================================================
|
|
|
// 这个服务类负责处理网页内容的业务逻辑，包括：
|
|
|
// - 网页内容的 CRUD 操作
|
|
|
// - 多维度查询（网站代码、设备ID、类型ID）
|
|
|
// - 搜索索引重建
|
|
|
//
|
|
|
// 【业务背景】
|
|
|
// 网页内容模块用于管理网站的页面内容，支持按网站代码、设备类型、页面类型等多维度管理。
|
|
|
//
|
|
|
// 【与 Java Spring Boot 的对比】
|
|
|
// Java Spring Boot:
|
|
|
// @Service
|
|
|
// public class HwWeb1ServiceImpl implements HwWeb1Service { ... }
|
|
|
//
|
|
|
// ASP.NET Core + Furion:
|
|
|
// public class HwWeb1Service : ITransient { ... }
|
|
|
// ============================================================================
|
|
|
|
|
|
namespace Admin.NET.Plugin.HwPortal;
|
|
|
|
|
|
/// <summary>
|
|
|
/// 网页内容服务类。
|
|
|
/// <para>
|
|
|
/// 【服务职责】
|
|
|
/// 1. 管理网页内容的增删改查
|
|
|
/// 2. 支持多维度查询（网站代码、设备ID、类型ID）
|
|
|
/// 3. 网页内容变更时自动重建搜索索引
|
|
|
/// </para>
|
|
|
/// <para>
|
|
|
/// 【更新策略】
|
|
|
/// 更新操作采用"先删除后插入"的策略：
|
|
|
/// 先删除符合条件的旧记录，然后插入新记录。
|
|
|
/// 这种策略简化了更新逻辑，但会改变记录的ID。
|
|
|
/// </para>
|
|
|
/// </summary>
|
|
|
public class HwWeb1Service : ITransient
|
|
|
{
|
|
|
/// <summary>
|
|
|
/// MyBatis 映射器名称（保留用于回滚）。
|
|
|
/// </summary>
|
|
|
private const string Mapper = "HwWebMapper1";
|
|
|
|
|
|
/// <summary>
|
|
|
/// MyBatis 执行器（保留用于回滚）。
|
|
|
/// </summary>
|
|
|
private readonly HwPortalMyBatisExecutor _executor;
|
|
|
|
|
|
/// <summary>
|
|
|
/// SqlSugar 数据访问对象。
|
|
|
/// </summary>
|
|
|
private readonly ISqlSugarClient _db;
|
|
|
|
|
|
/// <summary>
|
|
|
/// 搜索索引重建服务。
|
|
|
/// </summary>
|
|
|
private readonly IHwSearchRebuildService _searchRebuildService;
|
|
|
|
|
|
/// <summary>
|
|
|
/// 日志记录器。
|
|
|
/// </summary>
|
|
|
private readonly ILogger<HwWeb1Service> _logger;
|
|
|
|
|
|
/// <summary>
|
|
|
/// 构造函数（依赖注入）。
|
|
|
/// </summary>
|
|
|
/// <param name="executor">MyBatis 执行器</param>
|
|
|
/// <param name="db">SqlSugar 数据访问对象</param>
|
|
|
/// <param name="searchRebuildService">搜索索引重建服务</param>
|
|
|
/// <param name="logger">日志记录器</param>
|
|
|
public HwWeb1Service(HwPortalMyBatisExecutor executor, ISqlSugarClient db, IHwSearchRebuildService searchRebuildService, ILogger<HwWeb1Service> logger)
|
|
|
{
|
|
|
_executor = executor;
|
|
|
_db = db;
|
|
|
_searchRebuildService = searchRebuildService;
|
|
|
_logger = logger;
|
|
|
}
|
|
|
|
|
|
/// <summary>
|
|
|
/// 根据网站代码查询网页内容。
|
|
|
/// <para>
|
|
|
/// 【软删除过滤】
|
|
|
/// 查询时自动过滤已删除的记录（IsDelete == "0"）。
|
|
|
/// </para>
|
|
|
/// </summary>
|
|
|
/// <param name="webCode">网站代码</param>
|
|
|
/// <returns>网页内容实体</returns>
|
|
|
public async Task<HwWeb1> SelectHwWebByWebcode(long webCode)
|
|
|
{
|
|
|
// 回滚到 XML 方案时可直接恢复：
|
|
|
// return await _executor.QuerySingleAsync<HwWeb1>(Mapper, "selectHwWebByWebcode", new { webCode });
|
|
|
return await _db.Queryable<HwWeb1>()
|
|
|
.Where(item => item.IsDelete == "0" && item.WebCode == webCode)
|
|
|
.FirstAsync();
|
|
|
}
|
|
|
|
|
|
/// <summary>
|
|
|
/// 查询单个网页内容（多维度匹配）。
|
|
|
/// <para>
|
|
|
/// 【多维度匹配】
|
|
|
/// 按网站代码、设备ID、类型ID三个维度精确匹配。
|
|
|
/// </para>
|
|
|
/// </summary>
|
|
|
/// <param name="input">查询条件</param>
|
|
|
/// <returns>网页内容实体</returns>
|
|
|
public async Task<HwWeb1> SelectHwWebOne(HwWeb1 input)
|
|
|
{
|
|
|
HwWeb1 query = input ?? new HwWeb1();
|
|
|
// 回滚到 XML 方案时可直接恢复：
|
|
|
// return await _executor.QuerySingleAsync<HwWeb1>(Mapper, "selectHwWebOne", query);
|
|
|
return await _db.Queryable<HwWeb1>()
|
|
|
.Where(item => item.IsDelete == "0" && item.WebCode == query.WebCode && item.DeviceId == query.DeviceId && item.TypeId == query.TypeId)
|
|
|
.FirstAsync();
|
|
|
}
|
|
|
|
|
|
/// <summary>
|
|
|
/// 查询网页内容列表。
|
|
|
/// <para>
|
|
|
/// 【动态查询条件】
|
|
|
/// 支持按网页ID、JSON内容、网站代码、设备ID、类型ID、英文JSON等条件筛选。
|
|
|
/// </para>
|
|
|
/// </summary>
|
|
|
/// <param name="input">查询条件</param>
|
|
|
/// <returns>网页内容列表</returns>
|
|
|
public async Task<List<HwWeb1>> SelectHwWebList(HwWeb1 input)
|
|
|
{
|
|
|
HwWeb1 query = input ?? new HwWeb1();
|
|
|
// 回滚到 XML 方案时可直接恢复：
|
|
|
// return await _executor.QueryListAsync<HwWeb1>(Mapper, "selectHwWebList", query);
|
|
|
return await _db.Queryable<HwWeb1>()
|
|
|
.Where(item => item.IsDelete == "0")
|
|
|
.WhereIF(query.WebId.HasValue, item => item.WebId == query.WebId)
|
|
|
.WhereIF(query.WebJson != null && query.WebJson != string.Empty, item => item.WebJson == query.WebJson)
|
|
|
.WhereIF(query.WebJsonString != null && query.WebJsonString != string.Empty, item => item.WebJsonString == query.WebJsonString)
|
|
|
.WhereIF(query.WebCode.HasValue, item => item.WebCode == query.WebCode)
|
|
|
.WhereIF(query.DeviceId.HasValue, item => item.DeviceId == query.DeviceId)
|
|
|
.WhereIF(query.TypeId.HasValue, item => item.TypeId == query.TypeId)
|
|
|
.WhereIF(query.WebJsonEnglish != null, item => item.WebJsonEnglish == query.WebJsonEnglish)
|
|
|
.ToListAsync();
|
|
|
}
|
|
|
|
|
|
/// <summary>
|
|
|
/// 新增网页内容。
|
|
|
/// <para>
|
|
|
/// 【搜索索引重建】
|
|
|
/// 网页内容新增后，自动触发搜索索引重建。
|
|
|
/// </para>
|
|
|
/// </summary>
|
|
|
/// <param name="input">网页内容数据</param>
|
|
|
/// <returns>影响行数</returns>
|
|
|
public async Task<int> InsertHwWeb(HwWeb1 input)
|
|
|
{
|
|
|
// 【软删除标记初始化】
|
|
|
input.IsDelete = string.IsNullOrWhiteSpace(input.IsDelete) ? "0" : input.IsDelete;
|
|
|
|
|
|
// 回滚到 XML 方案时可直接恢复：
|
|
|
// long identity = await _executor.InsertReturnIdentityAsync(Mapper, "insertHwWeb", input);
|
|
|
HwWeb1 entity = await _db.Insertable(input).ExecuteReturnEntityAsync();
|
|
|
input.WebId = entity.WebId;
|
|
|
|
|
|
// 【搜索索引重建】
|
|
|
if (input.WebId > 0)
|
|
|
{
|
|
|
await RebuildSearchIndexQuietly("hw_web1");
|
|
|
}
|
|
|
|
|
|
return input.WebId > 0 ? 1 : 0;
|
|
|
}
|
|
|
|
|
|
/// <summary>
|
|
|
/// 更新网页内容。
|
|
|
/// <para>
|
|
|
/// 【更新策略】
|
|
|
/// 采用"先删除后插入"的策略：
|
|
|
/// 1. 先查询并删除符合条件的旧记录（软删除）
|
|
|
/// 2. 设置新记录的 IsDelete = "0"
|
|
|
/// 3. 插入新记录
|
|
|
///
|
|
|
/// 这种策略简化了更新逻辑，但会改变记录的ID。
|
|
|
/// </para>
|
|
|
/// <para>
|
|
|
/// 【搜索索引重建】
|
|
|
/// 网页内容更新后，自动触发搜索索引重建。
|
|
|
/// </para>
|
|
|
/// </summary>
|
|
|
/// <param name="input">更新的数据</param>
|
|
|
/// <returns>影响行数</returns>
|
|
|
public async Task<int> UpdateHwWeb(HwWeb1 input)
|
|
|
{
|
|
|
// 【查询旧记录】
|
|
|
HwWeb1 query = new()
|
|
|
{
|
|
|
WebCode = input.WebCode,
|
|
|
TypeId = input.TypeId,
|
|
|
DeviceId = input.DeviceId
|
|
|
};
|
|
|
List<HwWeb1> exists = await SelectHwWebList(query);
|
|
|
|
|
|
// 【删除旧记录】
|
|
|
if (exists.Count > 0)
|
|
|
{
|
|
|
await DeleteHwWebByWebIds(exists.Where(u => u.WebId.HasValue).Select(u => u.WebId!.Value).ToArray(), false);
|
|
|
}
|
|
|
|
|
|
// 【设置新记录】
|
|
|
input.IsDelete = "0";
|
|
|
|
|
|
// 回滚到 XML 方案时可直接恢复：
|
|
|
// long identity = await _executor.InsertReturnIdentityAsync(Mapper, "insertHwWeb", input);
|
|
|
HwWeb1 entity = await _db.Insertable(input).ExecuteReturnEntityAsync();
|
|
|
input.WebId = entity.WebId;
|
|
|
|
|
|
// 【搜索索引重建】
|
|
|
if (input.WebId > 0)
|
|
|
{
|
|
|
await RebuildSearchIndexQuietly("hw_web1");
|
|
|
}
|
|
|
|
|
|
return input.WebId > 0 ? 1 : 0;
|
|
|
}
|
|
|
|
|
|
/// <summary>
|
|
|
/// 批量删除网页内容（软删除）。
|
|
|
/// </summary>
|
|
|
/// <param name="webIds">网页ID数组</param>
|
|
|
/// <returns>影响行数</returns>
|
|
|
public Task<int> DeleteHwWebByWebIds(long[] webIds)
|
|
|
{
|
|
|
return DeleteHwWebByWebIds(webIds, true);
|
|
|
}
|
|
|
|
|
|
/// <summary>
|
|
|
/// 批量删除网页内容（软删除）。
|
|
|
/// <para>
|
|
|
/// 【软删除实现】
|
|
|
/// 将 IsDelete 字段更新为"1"，而不是物理删除。
|
|
|
/// </para>
|
|
|
/// <para>
|
|
|
/// 【搜索索引重建】
|
|
|
/// 网页内容删除后，自动触发搜索索引重建。
|
|
|
/// </para>
|
|
|
/// </summary>
|
|
|
/// <param name="webIds">网页ID数组</param>
|
|
|
/// <param name="rebuild">是否重建搜索索引</param>
|
|
|
/// <returns>影响行数</returns>
|
|
|
private async Task<int> DeleteHwWebByWebIds(long[] webIds, bool rebuild)
|
|
|
{
|
|
|
// 回滚到 XML 方案时可直接恢复：
|
|
|
// int rows = await _executor.ExecuteAsync(Mapper, "deleteHwWebByWebIds", new { array = webIds });
|
|
|
|
|
|
// 【查询待删除的网页】
|
|
|
List<HwWeb1> pages = await _db.Queryable<HwWeb1>()
|
|
|
.Where(item => item.WebId.HasValue && webIds.Contains(item.WebId.Value))
|
|
|
.ToListAsync();
|
|
|
|
|
|
// 【软删除标记】
|
|
|
foreach (HwWeb1 page in pages)
|
|
|
{
|
|
|
page.IsDelete = "1";
|
|
|
}
|
|
|
|
|
|
// 【批量更新】
|
|
|
int rows = pages.Count == 0 ? 0 : await _db.Updateable(pages)
|
|
|
.UpdateColumns(item => new { item.IsDelete })
|
|
|
.ExecuteCommandAsync();
|
|
|
|
|
|
// 【搜索索引重建】
|
|
|
if (rows > 0 && rebuild)
|
|
|
{
|
|
|
await RebuildSearchIndexQuietly("hw_web1");
|
|
|
}
|
|
|
|
|
|
return rows;
|
|
|
}
|
|
|
|
|
|
/// <summary>
|
|
|
/// 静默重建搜索索引。
|
|
|
/// </summary>
|
|
|
/// <param name="source">数据来源</param>
|
|
|
private async Task RebuildSearchIndexQuietly(string source)
|
|
|
{
|
|
|
try
|
|
|
{
|
|
|
await _searchRebuildService.RebuildAllAsync();
|
|
|
}
|
|
|
catch (Exception ex)
|
|
|
{
|
|
|
_logger.LogError(ex, "rebuild portal search index failed after {Source} changed", source);
|
|
|
}
|
|
|
}
|
|
|
}
|