242 lines
6.9 KiB
JavaScript
242 lines
6.9 KiB
JavaScript
'use strict';
|
||
|
||
const fs = require('node:fs');
|
||
const path = require('node:path');
|
||
const PrinterDataBuilder = require('./printer_data_builder');
|
||
|
||
const TEMPLATE_CACHE = new Map();
|
||
|
||
/**
|
||
* 判断是否为普通对象。
|
||
* @param {any} value 待判断值。
|
||
* @return {boolean} 判断结果。
|
||
*/
|
||
function isPlainObject(value) {
|
||
return value !== null && typeof value === 'object' && !Array.isArray(value);
|
||
}
|
||
|
||
/**
|
||
* 以 JSON 方式做深拷贝,避免污染模板缓存对象。
|
||
* @param {Object} source 原对象。
|
||
* @return {Object} 深拷贝结果。
|
||
*/
|
||
function deepClone(source) {
|
||
return JSON.parse(JSON.stringify(source));
|
||
}
|
||
|
||
/**
|
||
* 请求内 ID 生成器。
|
||
*/
|
||
class RequestScopedPrintIdGenerator {
|
||
/**
|
||
* @param {string} requestCode 前端请求参数码。
|
||
*/
|
||
constructor(requestCode) {
|
||
this.requestCode = String(requestCode || '').trim();
|
||
this.sequence = 0;
|
||
}
|
||
|
||
/**
|
||
* 生成请求 ID。
|
||
* @return {string} 唯一请求 ID。
|
||
*/
|
||
nextRequestId() {
|
||
return this.next('request');
|
||
}
|
||
|
||
/**
|
||
* 生成任务 ID。
|
||
* @return {string} 唯一任务 ID。
|
||
*/
|
||
nextTaskId() {
|
||
return this.next('task');
|
||
}
|
||
|
||
/**
|
||
* 生成文档 ID。
|
||
* @return {string} 唯一文档 ID。
|
||
*/
|
||
nextDocumentId() {
|
||
return this.next('document');
|
||
}
|
||
|
||
/**
|
||
* 生成带前缀的递增 ID。
|
||
* @param {string} prefix ID 前缀。
|
||
* @return {string} 生成结果。
|
||
*/
|
||
next(prefix) {
|
||
this.sequence += 1;
|
||
return `${this.requestCode}_${prefix}_${this.sequence}`;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 快递打印请求组装器。
|
||
*/
|
||
class ExpressPrintPayloadBuilder {
|
||
/**
|
||
* @param {Object} options 初始化参数。
|
||
* @param {string} options.baseDir 项目根目录。
|
||
*/
|
||
constructor(options = {}) {
|
||
const requestOptions = isPlainObject(options) ? options : {};
|
||
this.baseDir = String(requestOptions.baseDir || process.cwd());
|
||
this.templateDir = path.join(this.baseDir, 'printer_data_template');
|
||
}
|
||
|
||
/**
|
||
* 组装平台快递打印 payload。
|
||
* @param {Object} options 组装参数。
|
||
* @param {string} options.platform 平台编码。
|
||
* @param {string} options.printerName 打印机名称。
|
||
* @param {Array<Object>} options.orders 外部传入的订单打印数据数组。
|
||
* @param {RequestScopedPrintIdGenerator} options.idGenerator 请求内 ID 生成器。
|
||
* @return {Object} 可直接发送给打印服务的 payload。
|
||
*/
|
||
buildPayload(options = {}) {
|
||
const requestOptions = isPlainObject(options) ? options : {};
|
||
const platform = String(requestOptions.platform || '').trim();
|
||
if (!platform) {
|
||
throw new Error('快递打印缺少平台标识');
|
||
}
|
||
|
||
const idGenerator = requestOptions.idGenerator;
|
||
if (!idGenerator || typeof idGenerator.nextRequestId !== 'function') {
|
||
throw new Error('快递打印缺少请求 ID 生成器');
|
||
}
|
||
|
||
const printerName = String(requestOptions.printerName || '').trim();
|
||
if (!printerName) {
|
||
throw new Error('快递打印缺少打印机名称');
|
||
}
|
||
|
||
const orders = Array.isArray(requestOptions.orders) ? requestOptions.orders : [];
|
||
if (orders.length === 0) {
|
||
throw new Error('快递打印缺少订单数据');
|
||
}
|
||
|
||
const payload = this.loadTemplate(platform);
|
||
if (!isPlainObject(payload.task)) {
|
||
payload.task = {};
|
||
}
|
||
|
||
const requestId = idGenerator.nextRequestId();
|
||
this.applyRequestId(payload, requestId);
|
||
payload.task.taskID = idGenerator.nextTaskId();
|
||
payload.task.printer = printerName;
|
||
payload.task.documents = this.buildDocumentsFromOrders(orders, idGenerator);
|
||
|
||
return payload;
|
||
}
|
||
|
||
/**
|
||
* 将 orders 映射为 documents。
|
||
* @param {Array<Object>} orders 订单数组。
|
||
* @param {RequestScopedPrintIdGenerator} idGenerator 请求内 ID 生成器。
|
||
* @return {Array<Object>} documents 数组。
|
||
*/
|
||
buildDocumentsFromOrders(orders, idGenerator) {
|
||
return orders.map((order, index) => {
|
||
const sourceDocument = this.resolveOrderDocument(order, index);
|
||
const document = deepClone(sourceDocument);
|
||
if (!Array.isArray(document.contents)) {
|
||
document.contents = [];
|
||
}
|
||
document.documentID = idGenerator.nextDocumentId();
|
||
return document;
|
||
});
|
||
}
|
||
|
||
/**
|
||
* 解析单个订单对应的 document。
|
||
* @param {Object} order 订单对象。
|
||
* @param {number} index 订单索引。
|
||
* @return {Object} document 对象。
|
||
*/
|
||
resolveOrderDocument(order, index) {
|
||
if (!isPlainObject(order)) {
|
||
throw new Error(`orders[${index}] 必须是对象`);
|
||
}
|
||
|
||
const printData = isPlainObject(order.print_data) ? order.print_data : order;
|
||
if (!isPlainObject(printData)) {
|
||
throw new Error(`orders[${index}] 缺少 print_data`);
|
||
}
|
||
|
||
const hasDocumentShape = Object.prototype.hasOwnProperty.call(printData, 'documentID')
|
||
|| Array.isArray(printData.contents);
|
||
if (!hasDocumentShape) {
|
||
throw new Error(`orders[${index}] 的 print_data 不是有效 document 结构`);
|
||
}
|
||
|
||
return printData;
|
||
}
|
||
|
||
/**
|
||
* 写入请求 ID,兼容 requestID / requetID 两种字段。
|
||
* @param {Object} payload 请求 payload。
|
||
* @param {string} requestId 请求 ID。
|
||
*/
|
||
applyRequestId(payload, requestId) {
|
||
const hasRequestId = Object.prototype.hasOwnProperty.call(payload, 'requestID');
|
||
const hasRequetId = Object.prototype.hasOwnProperty.call(payload, 'requetID');
|
||
|
||
if (hasRequestId) {
|
||
payload.requestID = requestId;
|
||
}
|
||
if (hasRequetId) {
|
||
payload.requetID = requestId;
|
||
}
|
||
if (!hasRequestId && !hasRequetId) {
|
||
payload.requestID = requestId;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 加载并缓存平台模板,然后返回深拷贝对象。
|
||
* @param {string} platform 平台编码。
|
||
* @return {Object} 模板拷贝。
|
||
*/
|
||
loadTemplate(platform) {
|
||
const normalizedPlatform = this.normalizePlatform(platform);
|
||
const templatePath = path.join(this.templateDir, `${normalizedPlatform}.json`);
|
||
if (!TEMPLATE_CACHE.has(templatePath)) {
|
||
let templateContent = '';
|
||
try {
|
||
templateContent = fs.readFileSync(templatePath, 'utf8');
|
||
} catch (error) {
|
||
throw new Error(`未找到平台模板: ${normalizedPlatform}.json`);
|
||
}
|
||
|
||
let templateData;
|
||
try {
|
||
templateData = JSON.parse(templateContent);
|
||
} catch (error) {
|
||
throw new Error(`平台模板 JSON 解析失败: ${normalizedPlatform}.json`);
|
||
}
|
||
TEMPLATE_CACHE.set(templatePath, templateData);
|
||
}
|
||
|
||
return deepClone(TEMPLATE_CACHE.get(templatePath));
|
||
}
|
||
|
||
/**
|
||
* 规范化平台编码。
|
||
* @param {string} platform 平台编码或别名。
|
||
* @return {string} 规范化平台编码。
|
||
*/
|
||
normalizePlatform(platform) {
|
||
const normalized = PrinterDataBuilder.normalizePlatformAlias(platform);
|
||
if (normalized && normalized.platform) {
|
||
return normalized.platform;
|
||
}
|
||
return String(platform || '').trim().toLowerCase();
|
||
}
|
||
}
|
||
|
||
module.exports = {
|
||
ExpressPrintPayloadBuilder,
|
||
RequestScopedPrintIdGenerator,
|
||
};
|