Velocity中构建Highcharts地图数据结构报错求助

错误原因分析 #

1. 首次尝试错误 #

• Velocity中数组初始化必须用方括号[]，你用大括号{}会被解析为语法错误，服务器提示期望[就是这个原因
• 字符串无需转义"，直接使用双引号即可，转义字符会导致前端解析出<等非法字符，触发Unexpected token '<'

2. 第二次尝试错误 #

• #set($queries)不符合Velocity语法，#set指令必须遵循#set($变量 = 值)的格式，缺少=和初始值会触发语法错误
• 直接通过$queries.Map赋值的方式不成立，必须先初始化Map对象再操作

3. 第三次尝试错误 #

• $objectFactory.newMap不是标准Velocity创建Map的方法，正确方法应为$objectFactory.createMap()（或$velocityContext.createMap()，取决于项目配置）
• Map.put()方法需要键和值两个参数，仅传单个参数会导致语法错误
• 如果$objectFactory未在Velocity上下文中配置，会导致变量未定义，前端出现$queryMap is not defined报错

正确实现方案 #

方案1：使用Velocity 1.7+支持的字面量语法（推荐） #

直接初始化数组包含多个Map结构，语法简洁，适合生成Highcharts所需数据：

#set($queryArray = [
    {"name": "Approved", "query": "test"},
    {"name": "Proposed", "query": "test"},
    {"name": "Draft", "query": "test"},
    {"name": "Blank", "query": "test"}
])

方案2：兼容旧版本Velocity的工厂方法 #

如果你的Velocity版本低于1.7，不支持字面量，使用上下文提供的工厂方法创建数组和Map：

# 初始化数组
#set($queryArray = $objectFactory.createList())

# 创建第一个Map并添加到数组
#set($approvedMap = $objectFactory.createMap())
$approvedMap.put("name", "Approved")
$approvedMap.put("query", "test")
$queryArray.add($approvedMap)

# 创建第二个Map并添加到数组
#set($proposedMap = $objectFactory.createMap())
$proposedMap.put("name", "Proposed")
$proposedMap.put("query", "test")
$queryArray.add($proposedMap)

# 添加Draft的Map
#set($draftMap = $objectFactory.createMap())
$draftMap.put("name", "Draft")
$draftMap.put("query", "test")
$queryArray.add($draftMap)

# 添加Blank的Map
#set($blankMap = $objectFactory.createMap())
$blankMap.put("name", "Blank")
$blankMap.put("query", "test")
$queryArray.add($blankMap)

注意事项 #

• 确保Velocity上下文已正确配置$objectFactory（或$velocityContext），如果没有配置，需要联系后端开发添加
• 生成前端可用的JSON时，可使用Velocity的工具类将对象序列化为JSON字符串，避免手动拼接出错

内容的提问来源于stack exchange，提问作者throwaway2908457