SQLPage中处理SELECT组件NULL值选项的最佳实践

背景介绍

在使用SQLPage构建Web应用时，表单中的SELECT组件是一个常用元素。开发者经常需要为SELECT组件提供选项列表，其中可能包含一个NULL值选项。本文将详细介绍如何在SQLPage中正确处理SELECT组件的NULL值选项，避免常见错误。

问题现象

在SQLPage 0.17.1版本中，开发者可以通过简单的SQL查询为SELECT组件生成包含NULL值选项的列表。但在升级到0.18.2版本后，NULL值选项的标签显示出现了问题，导致用户界面不完整。

根本原因分析

问题的核心在于JSON对象构造时对列名的处理方式发生了变化。在SQL查询中，当使用json_object函数构造选项时，必须明确区分选项的"label"(显示文本)和"value"(实际值)两个属性。

常见错误做法是：

SELECT json_group_array(json_object("label", numero, "value", numero)) 
FROM (
  SELECT numero, numero FROM colonie
  UNION ALL
  SELECT NULL, 'Inconnue'
)

这种写法会导致两个问题：

1. 列名重复，SQL引擎无法区分哪个numero用于label，哪个用于value
2. 当值为NULL时，无法正确指定对应的显示文本

正确解决方案

正确的做法是为label和value分别指定不同的列名，并使用单引号包裹JSON属性名：

SELECT json_group_array(json_object('label', label, 'value', value)) as options
FROM (
  SELECT numero as label, numero as value FROM colonie
  UNION ALL
  SELECT 'Inconnue' as label, NULL as value
)

高级用法示例

开发者还可以结合字符串拼接等功能，创建更丰富的选项显示：

SELECT 'souche' AS name, 'select' as type, 4 as width,
    json_group_array(json_object('label', label, 'value', value)) as options 
FROM (
  SELECT 'colonie n°'||numero as label, numero as value FROM colonie
  UNION ALL
  SELECT origine as label, NULL as value FROM provenance 
  ORDER BY origine asc
)

注意事项

1. JSON属性名必须使用单引号('label', 'value')，而非双引号
2. 确保UNION ALL合并的查询结果具有相同的列名结构
3. NULL值必须显式指定对应的显示文本
4. 可以使用ORDER BY对最终选项进行排序

总结

正确处理SELECT组件中的NULL值选项需要注意JSON对象构造的细节。通过明确区分label和value列，并遵循正确的语法规范，开发者可以构建出功能完善、显示正确的表单组件。SQLPage的这一设计既保证了灵活性，又确保了数据处理的严谨性。