React Awesome Query Builder中自定义逻辑连接符的配置问题解析

在使用React Awesome Query Builder构建复杂查询时，开发者可能会遇到一个关于自定义逻辑连接符(conjunctions)的配置问题。本文将深入分析该问题的成因、影响范围以及解决方案。

问题背景

当开发者仅配置自定义逻辑连接符而移除所有默认连接符时，系统在生成JSON逻辑格式时会抛出错误。这种情况通常发生在开发者希望完全自定义查询逻辑表达方式时。

问题重现

以下是一个典型的问题配置示例：

const config = {
  conjunctions: {
    add: {
      label: '+',
      formatConj: (children, _conj, not) => (not ? 'NOT ' : '') + '(' + children.join(' + ') + ')',
      mongoConj: '$add',
      sqlFormatConj: (children, _conj, not) => (not ? 'NOT ' : '') + '(' + children.join(' + ') + ')',
      spelFormatConj: (children, _conj, not) => (not ? 'NOT ' : '') + '(' + children.join(' + ') + ')',
    },
  },
};

当在这种配置下创建查询组并调用jsonLogicFormat()方法时，系统会抛出错误。

问题根源分析

该问题的根本原因在于系统默认组连接符(defaultGroupConjunction)的确定逻辑。当配置中只包含自定义连接符时，系统无法正确确定应该使用哪个连接符作为默认值。

解决方案

开发者可以采用以下两种方式解决此问题：

显式指定默认连接符

const config = {
  settings: {
    defaultConjunction: "add"  // 明确指定使用自定义的"add"连接符
  },
  conjunctions: {
    add: { /* 配置内容 */ }
  }
};

修改默认连接符确定逻辑

另一种方案是修改defaultGroupConjunction函数的内部实现，使其在遇到仅包含自定义连接符的情况时，自动选择第一个可用的连接符作为默认值。

function defaultGroupConjunction(config, groupFieldConfig) {
  groupFieldConfig = getFieldConfig(config, groupFieldConfig);
  const conjs = groupFieldConfig?.conjunctions || Object.keys(config.conjunctions);
  
  if (conjs.length === 1) return conjs[0];
  
  // 新增逻辑：当默认连接符不在可用列表中时，选择第一个可用连接符
  if (conjs.length !== 0 && !conjs.includes(config.settings.defaultConjunction)) {
    return conjs[0];
  }
  
  return config.settings.defaultConjunction || conjs[0];
}

最佳实践建议

1. 始终明确指定默认连接符：在自定义连接符配置中，建议总是通过defaultConjunction设置明确指定要使用的默认连接符。

2. 保持向后兼容：如果修改库代码，确保修改不会影响现有功能的正常使用。

3. 全面测试：在自定义配置后，应对各种查询组合进行充分测试，确保生成的逻辑表达式符合预期。

总结

React Awesome Query Builder提供了强大的自定义能力，但在完全替换默认实现时需要特别注意配置的完整性。通过理解连接符的确定逻辑和正确配置默认值，开发者可以充分利用这一功能构建符合特定需求的查询构建器。