本文介绍如何使用 java servlet 读取 `.tpl` 模板文件，解析 url 参数（如 `id`），查询数据对象（如 pet），执行简单占位符替换（如 `{pet.name}`），并返回渲染后的 html 响应。无需第三方模板引擎，适合初学者快速上手。
要实现基于 .tpl 文件的轻量级服务端模板渲染，核心思路是：读取静态模板 → 提取请求参数 → 加载业务数据 → 替换占位符 → 输出 HTML 响应。下面以 index.tpl 为例，逐步构建一个完整、可运行的 Servlet 示例。
✅ 步骤一：准备模板文件与项目结构
将 index.tpl 放置于 Web 应用的 WEB-INF/templates/ 目录下（推荐，确保不被直接访问）：
<!-- WEB-INF/templates/index.tpl -->
<html>
<body>
<h1>Pet profile - {pet.name}</h1>
<p>Age: {pet.age}</p>
<p>Type: {pet.type}</p>
</body>
</html>⚠️ 注意：切勿将模板放在 webapp/ 根目录下（如 webapp/index.tpl），否则用户可绕过 Servlet 直接访问原始模板，造成信息泄露或 XSS 风险。
✅ 步骤二：编写 Servlet（支持路径匹配与占位符替换）
假设你使用注解方式映射 /index.tpl 请求（Servlet 3.0+）：
@WebServlet("/index.tpl")
public class TemplateServlet extends HttpServlet {
private static final String TEMPLATE_BASE_PATH = "/WEB-INF/templates/";
@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
// 1. 解析请求参数
String idParam = request.getParameter("id");
if (idParam == null || idParam.trim().isEmpty()) {
response.sendError(HttpServletResponse.SC_BAD_REQUEST, "Missing 'id' parameter");
return;
}
long petId;
try {
petId = Long.parseLong(idParam.trim());
} catch (NumberFormatException e) {
response.sendError(HttpServletResponse.SC_BAD_REQUEST, "Invalid 'id'");
return;
}
// 2. 查询宠物数据（此处模拟数据库查询）
Pet pet = findPetById(petId);
if (pet == null) {
response.sendError(HttpServletResponse.SC_NOT_FOUND, "Pet not found");
return;
}
// 3. 读取模板内容（使用 ServletContext 获取资源流，更安全可靠）
ServletContext ctx = getServletContext();
InputStream is = ctx.getResourceAsStream(TEMPLATE_BASE_PATH + "index.tpl");
if (is == null) {
throw new ServletException("Template not found: index.tpl");
}
String templateContent;
try (Reader reader = new InputStreamReader(is, StandardCharsets.UTF_8)) {
templateContent = IOUtils.toString(reader); // 使用 Apache Commons IO（推荐）
// 若不用第三方库，可用 StringBuilder + BufferedReader 手动读取
}
// 4. 占位符替换（注意：生产环境建议用正则或专用模板引擎）
String renderedHtml = templateContent
.replace("{pet.name}", escapeHtml(pet.getName()))
.replace("{pet.age}", String.valueOf(pet.getAge()))
.replace("{pet.type}", escapeHtml(pet.getType()));
// 5. 设置响应头并输出
response.setContentType("text/html;charset=UTF-8");
response.setCharacterEncoding("UTF-8");
response.setStatus(HttpServletResponse.SC_OK);
response.getWriter().write(renderedHtml);
response.getWriter().flush();
}
// 模拟数据查询（实际中应调用 DAO 或 Service）
private Pet findPetById(long id) {
// 示例：返回硬编码数据，可根据需要对接数据库
if (id == 1) return new Pet("Buddy", 3, "Dog");
if (id == 2) return new Pet("Luna", 2, "Cat");
return null;
}
// 简单 HTML 转义（防御 XSS）
private String escapeHtml(String input) {
if (input == null) return "";
return input.replace("&", "&")
.replace("<", "<")
.replace(">", ">")
.replace("\"", """)
.replace("'", "'");
}
}? 关键说明：
立即学习“Java免费学习笔记（深入）”；
- 使用 ServletContext.getResourceAsStream() 比 Files.readAllBytes(Paths.get(...)) 更规范，能正确处理 WAR 包内路径；
- IOUtils.toString() 来自 commons-io（Maven 依赖 <groupId>commons-io</groupId><artifactId>commons-io</artifactId><version>2.11.0</version>），若不想引入依赖，可用标准 BufferedReader 替代；
- 所有动态插入的字段必须进行 HTML 转义（如 escapeHtml()），否则用户输入 <script>alert(1)</script> 将导致 XSS 漏洞；
- 当前为线性字符串替换，仅适用于简单场景；复杂逻辑（条件、循环）请升级至 Thymeleaf、Freemarker 或 JSP。
✅ 步骤三：定义 Pet 模型类（Java Bean）
public class Pet {
private final String name;
private final int age;
private final String type;
public Pet(String name, int age, String type) {
this.name = name;
this.age = age;
this.type = type;
}
// getters only
public String getName() { return name; }
public int getAge() { return age; }
public String getType() { return type; }
}✅ 最终效果
访问：http://localhost:8080/your-app/index.tpl?id=1
→ Servlet 加载 index.tpl，查得 Pet("Buddy", 3, "Dog")，渲染后返回：
<html>
<body>
<h1>Pet profile - Buddy</h1>
<p>Age: 3</p>
<p>Type: Dog</p>
</body>
</html>✅ 总结：本方案以最小依赖实现模板驱动的动态页面，兼顾安全性（路径隔离 + HTML 转义）与可维护性。随着业务增长，建议平滑迁移至成熟模板引擎——但对学习 Servlet 生命周期与基础 I/O 处理而言，这是极佳的入门实践。
