Spring MVC迁移：如何用form:select渲染properties文件的下拉选项？

1. 修正下拉框渲染的核心问题 #

你之前仅传递key列表到视图，导致form:select只能把key同时作为选项值和显示文本。要实现选项值为properties的key、显示文本为对应value，需要将properties的键值对以Map形式传递到视图，具体步骤如下：

控制器层处理 #

在控制器中加载对应Locale的properties文件，转为Map后存入Model：

import java.util.Locale;
import java.util.Map;
import java.util.ResourceBundle;
import java.util.stream.Collectors;

@Controller
public class LabelController {

    @GetMapping("/label-select")
    public String getLabelSelect(Model model, Locale locale) {
        // 加载指定locale的properties文件（例如labels_zh_CN.properties）
        ResourceBundle labelBundle = ResourceBundle.getBundle("labels", locale);
        
        // 将键值对转为Map，key为properties的key，value为对应文本
        Map<String, String> labelMap = labelBundle.keySet().stream()
                .collect(Collectors.toMap(key -> key, labelBundle::getString));
        
        model.addAttribute("labelOptions", labelMap);
        return "your-jsp-view";
    }
}

JSP页面渲染 #

使用form:select的itemValue和itemLabel属性分别指定选项值和显示文本：

<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>

<!-- path对应表单对象中存储选中key的属性名 -->
<form:select path="selectedLabelKey" items="${labelOptions}" 
             itemValue="key" itemLabel="value" />

2. 关于Spring标签直接读取properties的问题 #

Spring的form标签无法直接遍历静态properties文件，必须通过控制器或配置类将properties数据加载到Model后，才能在视图中使用。不过可以通过以下方式简化配置：

方式一：用MessageSource统一管理多语言标签 #

配置ResourceBundleMessageSource集中管理标签文件，再在控制器中注入使用：

@Configuration
public class MessageConfig {
    @Bean
    public MessageSource messageSource() {
        ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource();
        messageSource.setBasenames("labels"); // 对应labels.properties系列文件
        messageSource.setDefaultEncoding("UTF-8");
        return messageSource;
    }
}

控制器中注入MessageSource获取键值对：

@Autowired
private MessageSource messageSource;

@GetMapping("/label-select")
public String getLabelSelect(Model model, Locale locale) {
    ResourceBundle bundle = ResourceBundle.getBundle("labels", locale);
    Map<String, String> labelMap = bundle.keySet().stream()
            .collect(Collectors.toMap(key -> key, key -> messageSource.getMessage(key, null, locale)));
    model.addAttribute("labelOptions", labelMap);
    return "your-jsp-view";
}

方式二：@PropertySource加载静态properties（无需多语言） #

如果不需要多语言支持，可通过@PropertySource加载properties到配置类，再转为Map：

@Configuration
@PropertySource("classpath:labels.properties")
public class PropertyConfig {
    @Autowired
    private Environment env;

    @Bean
    public Map<String, String> labelMap() {
        Map<String, String> map = new HashMap<>();
        map.put("0000", env.getProperty("0000"));
        map.put("0001", env.getProperty("0001"));
        // 可批量添加其他key
        return map;
    }
}

控制器中注入该Map直接传递到视图即可。

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