108 lines
3.7 KiB
C#
108 lines
3.7 KiB
C#
using F9MES.Application.Print;
|
||
using Microsoft.AspNetCore.Authorization;
|
||
using Microsoft.AspNetCore.Mvc;
|
||
|
||
namespace F9MES.Api.Controllers;
|
||
|
||
/// <summary>
|
||
/// 打印对接接口（OpenPrint 后端契约，见 openprint/src/repository/*）
|
||
/// 注意：与 F9 其它接口不同，此处返回【裸 JSON】而非 ApiResult 信封：
|
||
/// - 列表：{ items, total }
|
||
/// - 详情/创建/更新：资源对象
|
||
/// - 删除：204 无 body
|
||
/// - 错误：{ code, message, detail, requestId }
|
||
/// 鉴权复用 F9 的 JWT（openprint 侧自动注入 Authorization: Bearer {token}）。
|
||
/// </summary>
|
||
[ApiController]
|
||
[Authorize]
|
||
[Route("api/print")]
|
||
public class PrintApiController : ControllerBase
|
||
{
|
||
private readonly PrintService _print;
|
||
|
||
public PrintApiController(PrintService print)
|
||
{
|
||
_print = print;
|
||
}
|
||
|
||
// ==================== 模板 ====================
|
||
|
||
/// <summary>模板列表（不含 content）</summary>
|
||
[HttpGet("templates")]
|
||
public async Task<IActionResult> GetTemplates()
|
||
{
|
||
var (items, total) = await _print.ListTemplatesAsync();
|
||
return Ok(new { items, total });
|
||
}
|
||
|
||
/// <summary>模板详情（含 content，TemplateJSON 字符串）</summary>
|
||
[HttpGet("templates/{id}")]
|
||
public async Task<IActionResult> GetTemplate(string id)
|
||
{
|
||
var row = await _print.GetTemplateAsync(id);
|
||
if (row == null) return Err(StatusCodes.Status404NotFound, "模板不存在", $"id={id}");
|
||
return Ok(row);
|
||
}
|
||
|
||
/// <summary>创建模板（201 + 含真实 id 的资源）</summary>
|
||
[HttpPost("templates")]
|
||
public async Task<IActionResult> CreateTemplate([FromBody] PrintTemplateInput input)
|
||
{
|
||
if (input == null || string.IsNullOrWhiteSpace(input.Name))
|
||
return Err(StatusCodes.Status400BadRequest, "模板名称不能为空");
|
||
var row = await _print.CreateTemplateAsync(input);
|
||
return StatusCode(StatusCodes.Status201Created, row);
|
||
}
|
||
|
||
/// <summary>更新模板（部分字段；openprint 发 name 和/或 content）</summary>
|
||
[HttpPut("templates/{id}")]
|
||
public async Task<IActionResult> UpdateTemplate(string id, [FromBody] PrintTemplateInput input)
|
||
{
|
||
if (input == null)
|
||
return Err(StatusCodes.Status400BadRequest, "请求体不能为空");
|
||
var row = await _print.UpdateTemplateAsync(id, input);
|
||
if (row == null) return Err(StatusCodes.Status404NotFound, "模板不存在", $"id={id}");
|
||
return Ok(row);
|
||
}
|
||
|
||
/// <summary>物理删除模板（204 无 body）</summary>
|
||
[HttpDelete("templates/{id}")]
|
||
public async Task<IActionResult> DeleteTemplate(string id)
|
||
{
|
||
var ok = await _print.DeleteTemplateAsync(id);
|
||
if (!ok) return Err(StatusCodes.Status404NotFound, "模板不存在", $"id={id}");
|
||
return NoContent();
|
||
}
|
||
|
||
// ==================== 数据源 ====================
|
||
|
||
/// <summary>数据源列表（含子表层级 tables）</summary>
|
||
[HttpGet("data-sources")]
|
||
public IActionResult GetDataSources()
|
||
{
|
||
var items = _print.ListDataSources();
|
||
return Ok(new { items, total = items.Count });
|
||
}
|
||
|
||
/// <summary>数据源字段定义</summary>
|
||
[HttpGet("data-sources/{id}/fields")]
|
||
public IActionResult GetFields(string id)
|
||
{
|
||
var items = _print.ListFields(id);
|
||
return Ok(new { items, total = items.Count });
|
||
}
|
||
|
||
/// <summary>统一错误信封：{ code, message, detail, requestId }</summary>
|
||
private IActionResult Err(int status, string message, string? detail = null)
|
||
{
|
||
return new JsonResult(new
|
||
{
|
||
code = status,
|
||
message,
|
||
detail,
|
||
requestId = HttpContext.TraceIdentifier,
|
||
})
|
||
{ StatusCode = status };
|
||
}
|
||
}
|