在web开发中，尤其是在jsp（javaserver pages）环境中，我们经常需要处理键值对形式的数据，这类似于python中的字典或javascript中的json对象。java标准库提供了java.util.hashmap类来满足这一需求。本教程将指导您如何在jsp页面中创建、初始化并访问一个hashmap，使其行为类似于您所熟悉的字典结构。
理解JSP中的键值对结构
在Java生态中，java.util.HashMap是实现映射（Map）接口的常用类，它以键值对的形式存储数据，并允许通过键快速检索对应的值。在JSP页面中，我们可以直接使用Java代码（通过脚本元素或表达式元素）来操作HashMap。
假设我们有以下日期映射数据，其中键是“年份-周数”，值是对应的日期时间字符串：
{
"2025-37" : "2025-09-17 00:00:00.0",
"2025-38" : "2025-09-24 00:00:00.0",
"2025-39" : "2025-10-01 00:00:00.0",
"2025-40" : "2025-10-08 00:00:00.0"
}
"2025-40" : "2025-10-08 00:00:00.0"
}我们的目标是在JSP中以类似Python字典的方式来处理这些数据。
使用java.util.HashMap进行初始化
在JSP脚本中，我们可以利用HashMap的匿名内部类和实例初始化块（通常称为“双大括号初始化”）来简洁地初始化一个HashMap。这种方法允许您在声明HashMap的同时填充数据，而无需多次调用put()方法。
以下是具体的初始化示例：
<%@ page import="java.util.HashMap" %>
<%
// 声明并初始化一个HashMap，键和值均为String类型
var weekToDateMap = new java.util.HashMap() {
{
put("2025-37", "2025-09-17 00:00:00.0");
put("2025-38", "2025-09-24 00:00:00.0");
put("2025-39", "2025-10-01 00:00:00.0");
put("2025-40", "2025-10-08 00:00:00.0");
}
};
%> 代码解析：
- : 导入HashMap类，这样在JSP脚本中可以直接使用HashMap而无需写完整的包名java.util.HashMap。
- var weekToDateMap = new java.util.HashMap
(): 声明一个名为weekToDateMap的HashMap实例。我们指定了泛型参数 ，表示键和值都将是String类型，这有助于编译时类型检查和代码可读性。 - { { ... } }: 这是“双大括号初始化”的关键部分。外层大括号定义了一个匿名内部类，它继承自HashMap。内层大括号是一个实例初始化块，其中的代码会在匿名内部类的构造函数执行之后立即执行。在这里，我们使用put()方法将键值对添加到HashMap中。
访问HashMap中的数据
在JSP中，访问HashMap中的数据有两种主要方式：使用JSP脚本表达式和使用JSP表达式语言（EL）。
-
使用JSP脚本表达式 () 您可以直接在脚本表达式中使用get()方法来获取特定键的值。
<%-- 通过脚本表达式访问 --%>
2025-37 对应的日期（脚本表达式）：<%= weekToDateMap.get("2022-37") %>
-
使用JSP表达式语言 (EL) JSP表达式语言（EL）是访问JSP页面中各种对象属性的推荐方式，它更加简洁、安全，并且会自动处理空值。EL允许您使用类似数组或字典的方括号语法来访问Map中的元素。
<%-- 通过EL表达式访问 --%>
2025-38 对应的日期（EL表达式）：${weekToDateMap["2025-38"]}
2025-39 对应的日期（EL表达式）：${weekToDateMap['2025-39']}
2025-40 对应的日期（EL表达式）：${weekToDateMap.get('2025-40')}
<%-- EL也支持get()方法 --%>注意： EL表达式中的weekToDateMap["2025-38"]会自动被解析为weekToDateMap.get("2025-38")。这是EL的一个强大特性，使得访问Map数据如同访问字典一般直观。
完整示例代码
将初始化和访问结合起来，一个完整的JSP页面可能如下所示：
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="java.util.HashMap" %>
JSP HashMap 示例
JSP中的键值对数据结构
<%
// 声明并初始化一个HashMap
var weekToDateMap = new java.util.HashMap() {
{
put("2025-37", "2025-09-17 00:00:00.0");
put("2025-38", "2025-09-24 00:00:00.0");
put("2025-39", "2025-10-01 00:00:00.0");
put("2025-40", "2025-10-08 00:00:00.0");
}
};
%>
访问数据：
- 2025-37 对应的日期：<%= weekToDateMap.get("2022-37") %>
- 2025-38 对应的日期：${weekToDateMap["2025-38"]}
- 2025-39 对应的日期：${weekToDateMap['2025-39']}
- 2025-40 对应的日期：${weekToDateMap.get("2025-40")}
遍历HashMap：
<%-- 遍历HashMap，显示所有键值对 --%>
<% for (java.util.Map.Entry entry : weekToDateMap.entrySet()) { %>
- <%= entry.getKey() %> : <%= entry.getValue() %>
<% } %>
注意事项与最佳实践
双大括号初始化 (Double-Brace Initialization) 的使用场景： 这种初始化方式虽然简洁，但它会创建一个匿名内部类，这可能带来轻微的性能开销和内存占用。在普通的Java代码中，通常更推荐使用Map.of()（Java 9+）或流API来创建不可变或可变的Map。但在JSP脚本中，对于少量数据的快速初始化，双大括号初始化仍然是一个方便的选择。对于大量数据或动态数据，应避免在JSP中硬编码。
-
数据来源与职责分离： 在实际的企业级应用中，不建议在JSP页面中直接硬编码或进行复杂的HashMap初始化。数据通常应该由后端Java代码（如Servlet、Spring Controller或业务逻辑层）准备好，然后作为请求属性（request.setAttribute()）、会话属性（session.setAttribute()）或模型属性（在MVC框架中）传递给JSP页面。这样可以实现更好的职责分离，使JSP专注于视图展示。
示例 (Servlet中准备数据并传递给JSP):
// In a Servlet or Controller public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { java.util.Map然后，在yourPage.jsp中，您可以直接使用EL访问：
2025-37 对应的日期：${weekToDateMap["2025-37"]}
JSP表达式语言 (EL) 优先： 始终优先使用EL表达式${...}来访问JSP页面中的数据。EL代码更简洁、可读性更高，并且能更好地处理空值（不会抛出NullPointerException，而是显示为空字符串）。避免过度使用脚本元素，因为它会使JSP页面更难以维护和调试。
JSON数据的处理： 如果您的数据源本身就是JSON格式，并且需要在客户端JavaScript中处理，通常的做法是在后端将数据序列化为JSON字符串，然后将其作为JavaScript变量嵌入到JSP页面中，或者通过AJAX请求获取。如果只是在JSP服务器端作为字典使用，HashMap是合适的选择。
总结
在JSP中创建和初始化类似字典或JSON的键值对数据结构，最直接的方法是使用java.util.HashMap。通过双大括号初始化可以方便地填充少量静态数据，而JSP表达式语言（EL）则提供了简洁高效的数据访问方式。然而，为了保持代码的清晰性、可维护性和职责分离，建议在后端Java代码中准备数据并将其传递给JSP页面，让JSP专注于数据的展示。遵循这些最佳实践，您将能够更有效地在JSP应用中处理键值对数据。
