// Admin.NET 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。使用本项目应遵守相关法律法规和许可证的要求。
//
// 本项目主要遵循 MIT 许可证和 Apache 许可证(版本 2.0)进行分发和使用。许可证位于源代码树根目录中的 LICENSE-MIT 和 LICENSE-APACHE 文件。
//
// 不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动!任何基于本项目二次开发而产生的一切法律纠纷和责任,我们不承担任何责任!
namespace Admin.NET.Core.Service;
///
/// 翻译服务 🧩
///
[ApiDescriptionSettings(Order = 100, Description = "翻译服务")]
public partial class SysLangTextService : IDynamicApiController, ITransient
{
private readonly SqlSugarRepository _sysLangTextRep;
private readonly ISqlSugarClient _sqlSugarClient;
public SysLangTextService(SqlSugarRepository sysLangTextRep, ISqlSugarClient sqlSugarClient)
{
_sysLangTextRep = sysLangTextRep;
_sqlSugarClient = sqlSugarClient;
}
///
/// 分页查询翻译表 🔖
///
///
///
[DisplayName("分页查询翻译表")]
[ApiDescriptionSettings(Name = "Page"), HttpPost]
public async Task> Page(PageSysLangTextInput input)
{
input.Keyword = input.Keyword?.Trim();
var query = _sysLangTextRep.AsQueryable()
.WhereIF(!string.IsNullOrWhiteSpace(input.Keyword), u => u.EntityName.Contains(input.Keyword) || u.FieldName.Contains(input.Keyword) || u.LangCode.Contains(input.Keyword) || u.Content.Contains(input.Keyword))
.WhereIF(!string.IsNullOrWhiteSpace(input.EntityName), u => u.EntityName.Contains(input.EntityName.Trim()))
.WhereIF(!string.IsNullOrWhiteSpace(input.FieldName), u => u.FieldName.Contains(input.FieldName.Trim()))
.WhereIF(!string.IsNullOrWhiteSpace(input.LangCode), u => u.LangCode.Contains(input.LangCode.Trim()))
.WhereIF(!string.IsNullOrWhiteSpace(input.Content), u => u.Content.Contains(input.Content.Trim()))
.WhereIF(input.EntityId != null, u => u.EntityId == input.EntityId)
.Select();
return await query.OrderBuilder(input).ToPagedListAsync(input.Page, input.PageSize);
}
[DisplayName("获取翻译表")]
[ApiDescriptionSettings(Name = "List"), HttpPost]
public async Task> List(ListSysLangTextInput input)
{
var query = _sysLangTextRep.AsQueryable()
.Where(u => u.EntityName == input.EntityName.Trim() && u.FieldName == input.FieldName.Trim() && u.EntityId == input.EntityId)
.WhereIF(!string.IsNullOrWhiteSpace(input.LangCode), u => u.LangCode == input.LangCode.Trim())
.Select();
return await query.ToListAsync();
}
///
/// 获取翻译表详情 ℹ️
///
///
///
[DisplayName("获取翻译表详情")]
[ApiDescriptionSettings(Name = "Detail"), HttpGet]
public async Task Detail([FromQuery] QueryByIdSysLangTextInput input)
{
return await _sysLangTextRep.GetFirstAsync(u => u.Id == input.Id);
}
///
/// 增加翻译表 ➕
///
///
///
[DisplayName("增加翻译表")]
[ApiDescriptionSettings(Name = "Add"), HttpPost]
public async Task Add(AddSysLangTextInput input)
{
var entity = input.Adapt();
return await _sysLangTextRep.InsertAsync(entity) ? entity.Id : 0;
}
///
/// 更新翻译表 ✏️
///
///
///
[DisplayName("更新翻译表")]
[ApiDescriptionSettings(Name = "Update"), HttpPost]
public async Task Update(UpdateSysLangTextInput input)
{
var entity = input.Adapt();
await _sysLangTextRep.AsUpdateable(entity)
.ExecuteCommandAsync();
}
///
/// 删除翻译表 ❌
///
///
///
[DisplayName("删除翻译表")]
[ApiDescriptionSettings(Name = "Delete"), HttpPost]
public async Task Delete(DeleteSysLangTextInput input)
{
var entity = await _sysLangTextRep.GetFirstAsync(u => u.Id == input.Id) ?? throw Oops.Oh(ErrorCodeEnum.D1002);
await _sysLangTextRep.DeleteAsync(entity); //真删除
}
///
/// 批量删除翻译表 ❌
///
///
///
[DisplayName("批量删除翻译表")]
[ApiDescriptionSettings(Name = "BatchDelete"), HttpPost]
public async Task BatchDelete([Required(ErrorMessage = "主键列表不能为空")] List input)
{
var exp = Expressionable.Create();
foreach (var row in input) exp = exp.Or(it => it.Id == row.Id);
var list = await _sysLangTextRep.AsQueryable().Where(exp.ToExpression()).ToListAsync();
await _sysLangTextRep.DeleteAsync(list); //真删除
}
private static readonly object _sysLangTextBatchSaveLock = new object();
///
/// 批量保存翻译表 ✏️
///
///
///
[DisplayName("批量保存翻译表")]
[ApiDescriptionSettings(Name = "BatchSave"), HttpPost]
public void BatchSave([Required(ErrorMessage = "列表不能为空")] List input)
{
lock (_sysLangTextBatchSaveLock)
{
// 校验并过滤必填基本类型为null的字段
var rows = input.Where(x =>
{
if (!string.IsNullOrWhiteSpace(x.Error)) return false;
if (x.EntityId == null)
{
x.Error = "所属实体ID不能为空";
return false;
}
return true;
}).Adapt>();
var storageable = _sysLangTextRep.Context.Storageable(rows)
.SplitError(it => string.IsNullOrWhiteSpace(it.Item.EntityName), "所属实体名不能为空")
.SplitError(it => it.Item.EntityName?.Length > 255, "所属实体名长度不能超过255个字符")
.SplitError(it => string.IsNullOrWhiteSpace(it.Item.FieldName), "字段名不能为空")
.SplitError(it => it.Item.FieldName?.Length > 255, "字段名长度不能超过255个字符")
.SplitError(it => string.IsNullOrWhiteSpace(it.Item.LangCode), "语言代码不能为空")
.SplitError(it => it.Item.LangCode?.Length > 255, "语言代码长度不能超过255个字符")
.SplitError(it => string.IsNullOrWhiteSpace(it.Item.Content), "翻译内容不能为空")
.WhereColumns(it => new { it.EntityId, it.EntityName, it.FieldName, it.LangCode })
.SplitInsert(it => it.NotAny())
.SplitUpdate(it => it.Any())
.ToStorage();
storageable.AsInsertable.ExecuteCommand();// 不存在插入
storageable.AsUpdateable.UpdateColumns(it => new
{
it.EntityName,
it.EntityId,
it.FieldName,
it.LangCode,
it.Content,
}).ExecuteCommand();// 存在更新
if (storageable.ErrorList.Any())
{
throw Oops.Oh($"处理过程中出现以下错误:{string.Join(";", storageable.ErrorList.Distinct())}");
}
}
}
///
/// 导出翻译表记录 🔖
///
///
///
[DisplayName("导出翻译表记录")]
[ApiDescriptionSettings(Name = "Export"), HttpPost, NonUnify]
public async Task Export(PageSysLangTextInput input)
{
var list = (await Page(input)).Items?.Adapt>() ?? new();
if (input.SelectKeyList?.Count > 0) list = list.Where(x => input.SelectKeyList.Contains(x.Id)).ToList();
return ExcelHelper.ExportTemplate(list, "翻译表导出记录");
}
///
/// 下载翻译表数据导入模板 ⬇️
///
///
[DisplayName("下载翻译表数据导入模板")]
[ApiDescriptionSettings(Name = "Import"), HttpGet, NonUnify]
public IActionResult DownloadTemplate()
{
return ExcelHelper.ExportTemplate(new List(), "翻译表导入模板");
}
private static readonly object _sysLangTextImportLock = new object();
///
/// 导入翻译表记录 💾
///
///
[DisplayName("导入翻译表记录")]
[ApiDescriptionSettings(Name = "Import"), HttpPost, NonUnify, UnitOfWork]
public IActionResult ImportData([Required] IFormFile file)
{
lock (_sysLangTextImportLock)
{
var stream = ExcelHelper.ImportData(file, (list, markerErrorAction) =>
{
_sqlSugarClient.Utilities.PageEach(list, 2048, pageItems =>
{
// 校验并过滤必填基本类型为null的字段
var rows = pageItems.Where(x =>
{
if (!string.IsNullOrWhiteSpace(x.Error)) return false;
if (x.EntityId == null)
{
x.Error = "所属实体ID不能为空";
return false;
}
return true;
}).Adapt>();
var storageable = _sysLangTextRep.Context.Storageable(rows)
.SplitError(it => string.IsNullOrWhiteSpace(it.Item.EntityName), "所属实体名不能为空")
.SplitError(it => it.Item.EntityName?.Length > 255, "所属实体名长度不能超过255个字符")
.SplitError(it => string.IsNullOrWhiteSpace(it.Item.FieldName), "字段名不能为空")
.SplitError(it => it.Item.FieldName?.Length > 255, "字段名长度不能超过255个字符")
.SplitError(it => string.IsNullOrWhiteSpace(it.Item.LangCode), "语言代码不能为空")
.SplitError(it => it.Item.LangCode?.Length > 255, "语言代码长度不能超过255个字符")
.SplitError(it => string.IsNullOrWhiteSpace(it.Item.Content), "翻译内容不能为空")
.SplitError(it => it.Item.Content?.Length > 255, "翻译内容长度不能超过255个字符")
.WhereColumns(it => new { it.EntityId, it.EntityName, it.FieldName, it.LangCode })
.SplitInsert(it => it.NotAny())
.SplitUpdate(it => it.Any())
.ToStorage();
storageable.AsInsertable.ExecuteCommand();// 不存在插入
storageable.AsUpdateable.UpdateColumns(it => new
{
it.EntityName,
it.EntityId,
it.FieldName,
it.LangCode,
it.Content,
}).ExecuteCommand();// 存在更新
// 标记错误信息
markerErrorAction.Invoke(storageable, pageItems, rows);
});
});
return stream;
}
}
}