Handlebars与Node.js集成：实现前端表单数据到后端路由的正确传递

理解前端数据传递的挑战

在构建web应用时，从前端收集用户输入并将其发送到后端进行处理是核心功能之一。然而，对于初学者来说，如何正确地将动态的用户输入值传递给后端，尤其是在使用像handlebars这样的服务器端模板引擎时，常常会遇到困惑。

一个常见的误区是尝试将输入字段的值直接绑定到<a>标签的href属性中，并期望Handlebars能够实时更新这个值。例如，以下代码片段展示了这种尝试：

<div class="form-group">
    <label for="cedula">Cedula donante:</label>
    <input type="number" name="cedula" id="cedula" value="" placeholder="Cedula donante" autofocus>
    <!-- 尝试通过a标签传递值 -->
    <a href="/donaciones/buscar/{{cedula}}" class="btn btn-primary">Buscar</a>
</div>

以及对应的后端路由（期望通过URL参数接收）：

router.get('/buscar/:cedula', isLoggedIn ,async(req, res) =>{
    const { cedula } = req.params; // 期望从URL参数获取cedula
    const donante = await pool.query('SELECT * FROM donantes WHERE cedula = ?', [cedula]);

    if (donante.length < 1) {
        req.flash('message', 'Donante no registrado!');
        res.redirect('/donantes/ingreso_donantes');
    }else {
        res.render('donaciones/donaciones_ingreso', { donante : donante[0] });
    }
});

问题分析：

当用户在input字段中输入一个数字，然后点击<a>标签时，会发现请求的URL并不是/donaciones/buscar/用户输入的值，而是/donaciones/buscar/，或者如果Handlebars模板中没有定义cedula变量，则可能为空。这是因为：

立即学习“前端免费学习笔记（深入）”；

1. Handlebars是服务器端模板引擎： {{cedula}}变量在服务器端渲染HTML时就已经被解析和替换了。它不会在浏览器中根据用户在input字段中的输入而动态更新。一旦页面发送到浏览器，<a>标签的href属性就固定了。
2. <a>标签的用途： <a>标签主要用于导航到预定义的URL。它本身不具备将表单输入数据作为请求体发送或动态构造URL参数的能力。
3. 动态数据传递的限制： 尽管直接在浏览器地址栏中输入localhost:3000/donaciones/buscar/12345可以正常工作，那是因为浏览器直接发起了带有特定参数的GET请求。这与通过HTML元素（如<a>标签）动态获取用户输入并发送请求是两个不同的概念。

解决方案：使用HTML表单进行数据提交

解决上述问题的正确方法是利用HTML <form> 元素。表单是专门设计用于收集用户输入并将其发送到服务器的机制。通过将输入字段和提交按钮封装在一个表单中，我们可以确保用户输入的数据能够以正确的方式（通常是POST请求）发送到后端。

核心思想：

将用户输入字段（如input）和一个提交按钮（如<button type="submit">）放置在一个<form>标签内。当用户点击提交按钮时，浏览器会自动收集表单内所有带有name属性的输入字段的值，并根据表单的method（例如POST）和action属性指定的URL将数据发送到服务器。

AssemblyAI

转录和理解语音的AI模型

65

查看详情

实现步骤与代码示例

1. 前端（Handlebars模板）

修改Handlebars模板，使用<form>标签来包裹输入字段和提交按钮。

<form action="/donaciones/buscar" method="POST">
    <div class="form-group">
        <label for="cedula">Cedula donante:</label>
        <input type="number" name="cedula" id="cedula" value="" placeholder="Cedula donante" autofocus required>
        <button type="submit" class="btn btn-primary">Buscar</button>
    </div>
</form>

关键点说明：

• <form action="/donaciones/buscar" method="POST">:
  • action: 指定表单数据将被发送到的后端路由URL。这里我们将其设置为/donaciones/buscar。
  • method: 指定发送数据时使用的HTTP方法。POST是处理表单提交的常用方法，因为它将数据包含在请求体中，而不是URL中，更适合敏感或大量数据。
• <input type="number" name="cedula" ...>:
  • name="cedula": 这是至关重要的一点。后端将通过这个name属性来识别和获取输入字段的值。
  • required: (可选) HTML5属性，表示该字段是必填的，提供基本的客户端验证。
• <button type="submit" class="btn btn-primary">Buscar</button>:
  • type="submit": 明确指定这是一个提交按钮，点击后会触发表单提交。

2. 后端（Node.js/Express）

为了处理POST请求并从请求体中获取表单数据，Node.js/Express应用需要配置相应的中间件。express.urlencoded是处理application/x-www-form-urlencoded类型表单数据的标准中间件。

首先，确保你的Express应用配置了该中间件：

const express = require('express');
const app = express();
// ... 其他中间件和配置

// 配置Express以解析URL编码的表单数据
app.use(express.urlencoded({ extended: false })); 
// 如果还需要处理JSON数据，可以添加：
// app.use(express.json());

// ... 其他路由定义

然后，创建对应的POST路由来接收和处理表单数据：

// 假设你的路由文件是router.js，并且已经导入了Express和数据库连接
// const router = express.Router();
// const pool = require('../database'); // 你的数据库连接池
// const isLoggedIn = require('../lib/auth').isLoggedIn; // 你的认证中间件

router.post('/donaciones/buscar', isLoggedIn, async (req, res) => {
    // 从req.body中获取表单字段值。字段名与前端input的name属性一致。
    const { cedula } = req.body; 

    // 输入验证 (非常重要!)
    if (!cedula || isNaN(parseInt(cedula))) {
        req.flash('message', '请输入有效的捐赠者身份证号码！');
        return res.redirect('/donantes/ingreso_donantes'); // 或者渲染带有错误信息的页面
    }

    try {
        // 使用参数化查询防止SQL注入
        const donante = await pool.query('SELECT * FROM donantes WHERE cedula = ?', [cedula]);

        if (donante.length < 1) {
            req.flash('message', '捐赠者未注册！');
            res.redirect('/donantes/ingreso_donantes');
        } else {
            // 找到捐赠者后，渲染页面并传递数据
            res.render('donaciones/donaciones_ingreso', { donante: donante[0] });
        }
    } catch (error) {
        console.error("数据库查询错误:", error);
        req.flash('message', '查询捐赠者时发生错误。');
        res.redirect('/donantes/ingreso_donantes');
    }
});

关键点说明：

• router.post('/donaciones/buscar', ...): 定义一个POST请求路由，其路径与前端表单的action属性匹配。
• const { cedula } = req.body;: express.urlencoded中间件会解析请求体，并将表单数据填充到req.body对象中。cedula就是前端input字段的name属性值。
• 输入验证: 在处理任何用户输入之前，务必进行严格的验证和清理。这里简单检查了cedula是否存在且是否为数字。
• 参数化查询: 使用pool.query('...', [cedula])这样的参数化查询是防止SQL注入的最佳实践。

注意事项与最佳实践

1. 安全性：
   • 输入验证： 始终在服务器端对所有用户输入进行验证和清理，即使前端已经做了验证。这可以防止恶意数据和应用程序错误。
   • SQL注入防护： 使用参数化查询（如示例所示）是防止SQL注入的关键。
   • CSRF防护： 对于敏感操作的表单提交，考虑实现跨站请求伪造（CSRF）防护，例如使用csurf等中间件。
2. 用户体验：
   • 表单验证： 除了后端验证，也可以在前端利用HTML5的required、pattern属性或JavaScript进行实时验证，提供即时反馈。
   • 加载状态： 在表单提交后，可以禁用提交按钮或显示加载指示器，防止用户重复提交。
   • 友好的错误信息： 当发生错误时，向用户提供清晰、有帮助的错误信息。
3. 路由设计：
   • 遵循RESTful原则，尽管这里是为了解决特定问题，但对于更复杂的应用，良好的路由设计能提高可维护性。
   • GET请求通常用于获取资源，POST请求用于创建新资源或提交数据进行处理。
4. 错误处理：
   • 在后端代码中，使用try-catch块来捕获可能发生的错误，特别是数据库操作，并向用户返回适当的错误信息或重定向。

总结

通过本教程，我们了解了在Node.js与Handlebars应用中，如何正确地将前端用户输入数据传递到后端。核心在于避免使用<a>标签和服务器端渲染的Handlebars变量来处理动态用户输入，而是应该利用HTML <form>的POST方法，配合Express的express.urlencoded中间件来接收和处理数据。遵循这些最佳实践，可以构建出更健壮、安全且用户友好的Web应用程序。

以上就是Handlebars与Node.js集成：实现前端表单数据到后端路由的正确传递的详细内容，更多请关注php中文网其它相关文章！