17370845950

新闻动态
JavaScript 数据数组列级非空一致性校验教程

本教程旨在解决javascript中复杂对象数组的列级数据一致性校验问题。当数据中存在多行（对象）和多列（属性）时，需要确保某一列（如p1）如果任意行有值，则所有行在该列上都必须有值。文章将提供一种高效、可扩展的解决方案，避免冗余循环，并通过示例代码演示如何实现这种“列级非空一致性”的验证逻辑。

引言：数据一致性校验的挑战

在前端或后端数据处理中，我们经常会遇到需要对结构化数据进行复杂校验的场景。其中一种常见的需求是“列级非空一致性”校验：对于一个由多个对象组成的数组，每个对象代表一行数据，其属性代表列。如果某一列（例如 P1）在数组中的任何一个对象里被填充了值，那么这一列在所有其他对象中也必须被填充值（即不能是空字符串、null、undefined等“假值”）。如果存在不一致的情况，则应触发错误提示。

传统的做法可能会采用多层嵌套循环来逐一检查每个属性，但这通常会导致代码冗长、难以维护，并且可能效率低下，尤其是在处理具有大量属性和记录的数据时。

问题描述与数据结构

假设我们有一个包含校准数据的对象数组，其基本结构如下：

[
    {
        "Axis": "Profile",
        "P1": 12,
        "P2": "",
        "P3": "",
        "P4": "",
        "P5": "",
        "P6": "",
        "P7": "",
        "P8": "",
        "P9": "",
        "P10": "",
        "year": ""
    },
    {
        "Axis": "Symmetry",
        "P1": 23,
        "P2": "",
        "P3": "",
        "P4": "",
        "P5": "",
        "P6": "",
        "P7": "",
        "P8": "",
        "P9": "",
        "P10": "",
        "year": ""
    },
    {
        "Axis": "Error (%)",
        "P1": "",
        "P2": 1,
        "P3": "",
        "P4": "",
        "P5": "",
        "P6": "",
        "P7": "",
        "P8": "",
        "P9": "",
        "P10": "",
        "year": ""
    },
    {
        "Axis": "Velocity (m/s)",
        "P1": 22,
        "P2": "",
        "P3": "",
        "P4": "",
        "P5": "",
        "P6": "",
        "P7": "",
        "P8": "",
        "P9": "",
        "P10": "",
        "year": ""
    }
]

我们的校验规则是：对于 P1 到 P10 这些属性，如果某个 P 属性在任意一个 Axis（行）中存在非空值，那么它在所有 Axis（行）中都必须存在非空值。例如，在上述数据中：

  • P1 在 "Profile", "Symmetry", "Velocity (m/s)" 中有值，但在 "Error (%)" 中为空。这违反了规则。
  • P2 在 "Error (%)" 中有值，但在其他三行中为空。这也违反了规则。

优化校验逻辑：列优先策略

为了高效地实现这种校验，我们可以采用“列优先”的策略，而不是传统的“行优先”嵌套循环。具体步骤如下：

  1. 识别所有待校验的列（键）：从数据中的任意一个对象（例如第一个对象）获取其所有属性键。
  2. 遍历每个列键：对于每一个 P 属性（如 P1, P2 等），执行以下操作。
  3. 提取列值：将该列键对应的所有值从数组中的每个对象中提取出来，形成一个新的值数组。
  4. 确定基准“真值性”：检查该列的第一个值是否为“真值”（即非空、非null、非undefined等）。
  5. 进行一致性校验：检查该列的所有其他值是否与基准值的“真值性”保持一致。如果基准值是真值，则所有值都必须是真值；如果基准值是假值，则所有值都必须是假值。
  6. 记录校验结果：将每个列的校验结果（通过或失败）存储起来。

示例代码实现

下面是使用 JavaScript 实现上述逻辑的示例代码：

/**
 * 校验对象数组中指定列的数据一致性。
 * 规则：如果某一列（键）在任意一个对象中有值，则所有对象在该列上都必须有值。
 * 否则，所有对象在该列上都必须无值。
 *
 * @param {Array} dataArr - 待校验的对象数组。
 * @returns {Object} 一个对象，键为列名，值为布尔类型，表示该列是否通过校验。
 */
function validateColumnConsistency(dataArr) {
    if (!dataArr || dataArr.length === 0) {
        return {}; // 空数组无需校验
    }

    const validationResults = {};
    // 获取第一个对象的键作为所有待校验的列
    // 排除 'Axis' 和 'year' 等非P属性，根据实际需求调整
    const keysToValidate = Object.keys(dataArr[0]).filter(key => key.startsWith('P') && key !== 'year');

    keysToValidate.forEach(key => {
        // 1. 提取当前列的所有值
        const columnValues = dataArr.map(item => item[key]);

        // 2. 确定基准“真值性”：检查第一个元素是否为真值（非空）
        // !!value 将任何值转换为其布尔等价形式（truthy或falsy）
        const baseTruthiness = !!columnValues[0];

        // 3. 检查所有值是否与基准“真值性”一致
        // every() 方法测试数组的所有元素是否都通过了指定函数的测试。
        const isConsistent = columnValues.every(value => !!value === baseTruthiness);

        validationResults[key] = isConsistent;
    });

    return validationResults;
}

// 示例数据
const calibrationData = [
    { Axis: "Profile", P1: 12, P2: "", P3: "", P4: "", P5: "", P6: "", P7: "", P8: "", P9: "", P10: "", year: "" },
    { Axis: "Symmetry", P1: 23, P2: "", P3: "", P4: "", P5: "", P6: "", P7: "", P8: "", P9: "", P10: "", year: "" },
    { Axis: "Error (%)", P1: "", P2: 1, P3: "", P4: "", P5: "", P6: "", P7: "", P8: "", P9: "", P10: "", year: "" },
    { Axis: "Velocity (m/s)", P1: 22, P2: "", P3: "", P4: "", P5: "", P6: "", P7: "", P8: "", P9: "", P10: "", year: "" }
];

const results = validateColumnConsistency(calibrationData);
console.log("校验结果：", results);

// 如何根据结果触发错误
const failedColumns = Object.keys(results).filter(key => !results[key]);

if (failedColumns.length > 0) {
    const errorMessage = `以下列存在数据不一致问题：${failedColumns.join(', ')}。请确保所有数据行在这些列上都填充或都为空。`;
    // 假设使用 swal 弹出提示
    // swal("校验失败", errorMessage, "error");
    console.error("校验失败", errorMessage);
} else {
    // swal("校验成功", "所有数据列均符合一致性要求！", "success");
    console.log("校验成功", "所有数据列均符合一致性要求！");
}

// 另一个示例：P1完全一致，P2不一致
const consistentP1Data = [
    { Axis: "A", P1: 1, P2: "", P3: "" },
    { Axis: "B", P1: 2, P2: "", P3: "" },
    { Axis: "C", P1: 3, P2: 10, P3: "" } // P2在此处不一致
];
const consistentResults = validateColumnConsistency(consistentP1Data);
console.log("\n另一个校验结果：", consistentResults);
代码解释：


    

  • validateColumnConsistency(dataArr) 函数接收一个对象数组作为参数。
    • 

  • keysToValidate 筛选出所有以 P 开头且不是 year 的键，确保我们只校验相关的列。你可以根据实际需求调整这个过滤条件。
    • 

  • dataArr.map(item => item[key]) 用于从原始数组中“提取”出当前 key 对应的所有值，形成一个新数组 columnValues。
    • 

  • !!columnValues[0] 将第一个元素的值强制转换为布尔值，作为该列的“真值性”基准。例如，""、null、undefined 会变成 false，任何非空字符串或数字会变成 true。
    • 

  • columnValues.every(value => !!value === baseTruthiness) 是核心逻辑。它遍历 columnValues 数组中的每个值，检查其布尔等价形式是否与 baseTruthiness 相同。如果所有值都符合，则 isConsistent 为 true，否则为 false。
    • 

  • 最后，函数返回一个包含所有列校验结果的对象。
    • 



处理更复杂的嵌套数据结构


在原始问题中，数据结构可能更为复杂，例如：
[
    {
        "ChartId": "1",
        "CalibrationData": [
            {
                "CalibrationYear": "2012",
                "CalibrationData": [ /* 这里才是我们实际要校验的数组 */ ]
            },
            {
                "CalibrationYear": "3022",
                "CalibrationData": [ /* 这里也是 */ ]
            }
        ]
    }
]
如果数据是这种嵌套结构，我们需要先遍历外层结构，找到实际包含 Axis 和 P 属性的数组。
function validateNestedCalibrationData(gblCalibrationData) {
    let allValid = true;
    const errorMessages = [];

    gblCalibrationData.forEach((chartItem, chartIndex) => {
        chartItem.CalibrationData.forEach((calibrationYearItem, yearIndex) => {
            const dataToValidate = calibrationYearItem.CalibrationData;
            if (dataToValidate && dataToValidate.length > 0) {
                const results = validateColumnConsistency(dataToValidate);
                const failedColumns = Object.keys(results).filter(key => !results[key]);

                if (failedColumns.length > 0) {
                    allValid = false;
                    errorMessages.push(
                        `图表 ${chartItem.ChartId} (年份 ${calibrationYearItem.CalibrationYear}) 中，以下列存在数据不一致问题：${failedColumns.join(', ')}。`
                    );
                }
            }
        });
    });

    if (!allValid) {
        const fullErrorMessage = errorMessages.join('\n');
        // swal("校验失败", fullErrorMessage, "error");
        console.error("校验失败", fullErrorMessage);
        return false;
    } else {
        // swal("校验成功", "所有校准数据均符合一致性要求！", "success");
        console.log("校验成功", "所有校准数据均符合一致性要求！");
        return true;
    }
}

// 假设 gbl_ClibrationData 是你的嵌套数据
// const gbl_ClibrationData = [ /* ... 你的嵌套数据 ... */ ];
// validateNestedCalibrationData(gbl_ClibrationData);
在 validateNestedCalibrationData 函数中，我们首先遍历 gblCalibrationData，然后进入 CalibrationData 数组，最终提取出每个 CalibrationData 数组（即包含 Axis 和 P 属性的实际数据）并调用之前定义的 validateColumnConsistency 函数进行校验。


注意事项与最佳实践


    

  1. 
“空”的定义：本教程中的“空”值特指 JavaScript 中的“假值”（falsy values），包括 "" (空字符串), 0, null, undefined, NaN, false。如果你的业务逻辑对“空”有更严格的定义（例如，0 应该被视为有效值），则需要调整 !!value 的判断逻辑。例如，只检查 value === "" || value === null || value === undefined。
    2. 

  2. 
键的筛选：在 keysToValidate 的获取中，我们使用了 filter 方法来排除不需要校验的键（如 Axis, year）。这使得校验逻辑更具针对性。根据实际需求，你可能需要更精确地定义哪些键需要进行列级一致性校验。
    3. 

  3. 
错误提示：在实际应用中，错误提示应该尽可能地具体，指明是哪一部分数据、哪个列出现了问题，以便用户快速定位并修正。
    4. 

  4. 
性能考量：map 和 every 方法是现代 JavaScript 中处理数组的强大工具，它们通常比手动编写的 for 循环更简洁、更具可读性，并且在大多数情况下性能表现良好。对于极大规模的数据集，可以考虑更底层的优化，但对于一般的前端应用场景，当前方案已经足够高效。
    5. 

  5. 
可重用性：将校验逻辑封装成独立的函数，可以提高代码的可重用性和模块化程度。
    6. 



总结


通过采用“列优先”的校验策略，并结合 JavaScript 数组的 map 和 every 方法，我们可以高效且优雅地解决对象数组的列级数据非空一致性校验问题。这种方法不仅代码简洁、易于理解，而且具有良好的可扩展性，能够适应不同复杂程度的数据结构。在实际开发中，理解并应用这种模式，将有助于提升数据校验的质量和效率。
 
	









            
            

              
              
            

          
        
      
      


  
赣ICP备2024031479号