Express.js中表单渲染与处理的控制器函数命名方案问询

在Express.js Web应用开发中，常会遇到这样的场景：同一个URL对应两个控制器函数——一个负责渲染供用户填写的表单视图，另一个负责处理表单提交后的业务操作。以车辆数据导入功能为例：

• 服务器收到GET /car/import请求时，返回包含导入表单的HTML页面；
• 用户填写表单并提交后，发送POST /car/import请求；
• 服务器收到POST请求后，执行数据导入操作并返回结果。

目前的实现是给控制器函数加上_get和_post后缀来区分，但这种方式略显生硬，下面提供几种更优雅、符合开发规范的命名方案：

方案1：按核心职责直接命名 #

直接用函数的实际职责作为名称，比后缀更直观易懂，可读性更强：

修改后的路由文件（myapp/routes/Router.js） #

const Express = require('express');
const CarController = require('../controllers/CarController');

const router = module.exports = Express.Router();

router.get('/car/import', CarController.showImportForm);
router.post('/car/import', CarController.processImport);

修改后的控制器文件（myapp/controllers/CarController.js） #

/**
 * @summary 渲染车辆数据导入表单页面
 */
exports.showImportForm = function (request, response, next) {
  var data = { /* 视图所需的初始化数据 */ };
  response.render('car_import_page', data);
};

/**
 * @summary 处理车辆数据导入操作
 */
exports.processImport = async function (request, response, next) {
  // 从request.body获取表单提交的数据
  /* 执行具体的导入逻辑 */
  
  response.status(200).json({
    message: '车辆数据导入成功'
  });
};

方案2：贴合REST风格语义命名 #

如果项目遵循RESTful设计思路，可以参考REST中对资源操作的命名习惯：

• GET请求对应展示表单的操作，可命名为newImport（REST里new通常用于展示创建资源的表单）
• POST请求对应执行导入的操作，可命名为createImport

这种命名方式能让熟悉REST规范的开发者快速理解函数作用，同时保持语义一致性。

方案3：分组封装（适合复杂场景） #

如果控制器中同类型操作较多，可以把同一URL下的不同请求方法函数封装成一个对象，让代码结构更模块化：

修改后的控制器文件 #

const importHandlers = {
  /**
   * @summary 渲染导入表单
   */
  show(request, response, next) {
    var data = { /* 视图所需初始化数据 */ };
    response.render('car_import_page', data);
  },
  
  /**
   * @summary 执行导入操作
   */
  async process(request, response, next) {
    /* 执行具体的导入逻辑 */
    response.status(200).json({ message: '车辆数据导入成功' });
  }
};

exports.import = importHandlers;

修改后的路由文件 #

const Express = require('express');
const CarController = require('../controllers/CarController');

const router = module.exports = Express.Router();

router.get('/car/import', CarController.import.show);
router.post('/car/import', CarController.import.process);

这种方式能避免控制器中出现大量零散的函数，让相关操作的关联性更清晰。

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