登录
首页 >  文章 >  前端

针对表单对象的案例

时间:2025-01-19 12:54:56 151浏览 收藏

哈喽!大家好,很高兴又见面了,我是golang学习网的一名作者,今天由我给大家带来一篇《针对表单对象的案例》,本文主要会讲到等等知识点,希望大家一起学习进步,也欢迎大家关注、点赞、收藏、转发! 下面就一起来看看吧!

针对表单对象的案例

本文基于 Ruby on Rails 示例,但核心概念适用于其他语言和框架。

一、表单对象:定义与目的

表单对象究竟是什么?其设计初衷是什么? 根据参考文章及实践经验,表单对象的定义和用途多种多样,概括如下:

  • 是什么?做什么? 一个普通的 Ruby 对象,负责数据输入验证;代表多个模型对象的虚拟模型;替代强参数(白名单);重构模型生命周期回调的一种方式;专门用于 form_for 的对象,简化控制器参数处理,进行类型强制和验证;封装多个 ActiveRecord 模型,实现单个表单提交更新;具备 ActiveRecord 的特性,便于控制器操作;管理复杂业务逻辑的对象。

  • 为什么要用?主要目的? 从控制器和/或模型中抽离业务逻辑;提供视图辅助方法(例如:复杂选项选择);简化复杂表单(不直接映射到单个 AR 模型)的 Rails 约定实现;降低控制器、模型(包括多个模型)和视图之间的耦合度。

然而,表单对象的概念存在模糊性。在使用表单对象时,其背后的设计理念和组合方式并不统一,缺乏明确的共识。总的来说,表单对象旨在重构代码复杂性,集中处理特定模块的职责(通常是模型和/或控制器)。

二、表单对象的反面案例分析

许多表单对象的使用方式如下:

class SomethingController
  def create
    @form = MyForm.new(action_params)
    if @form.valid?
      @form.save!
      redirect_to "somewhere"
    else
      render :new
    end
  end

  def new
    @form = MyForm.new
  end
end

这种写法看似符合 Rails 约定,简洁明了。然而,通过分析其公共 API,可以发现:

  • new(params):处理请求参数,进行数据转换,使其成为处理输入数据的好地方。
  • valid?:执行验证,了解参数、类型和验证规则,包含业务逻辑和领域规则。
  • save!:对象持久化,了解参数创建和持久层机制。
  • @form:传递到视图层,可能包含视图辅助逻辑(例如:form_for 的选项、条件渲染等)。

这种设计违反了单一职责原则,导致表单对象承担过多职责,成为新的“胖控制器/模型”,吸引了本应分散的代码,造成代码耦合。 任何新增的视图辅助方法、验证规则或参数映射都可能被添加到表单对象中,使其越来越臃肿。

三、更优方案:职责分离

我们可能已经拥有负责这些职责的对象。 与其使用表单对象,不如:

  • 持久化: 模型的职责。
  • 业务逻辑: 服务对象。
  • 输入验证: 验证对象(例如:ActiveRecord::Model、Scrivener、dry-schema)。
  • 视图辅助方法: 视图模型/演示者对象。

在中等规模的应用中,这些组件可能已经存在。 盲目使用表单对象反而会增加不必要的复杂性和模糊性。 复杂的用例必然导致复杂的代码,掩盖复杂性并不能解决问题。

四、改进方案

基于以上分析,控制器代码可以重构为:

def new
  @form = SomeFormViewModel.new(default_values)
end

def create
  validation = SomeValidation.new(action_params)
  if validation.valid?
    result = SomeService.new(validation.params).call
    if result.success?
      redirect_to "somewhere", notice: "All good."
    else
      redirect_to "somewhere", alert: "Uh oh... something went missing Oops: #{result.errors}"
    end
  else
    @form = SomeFormViewModel.new
    render :new
  end
end

优点:

  • 结构清晰易懂,与 Rails 约定相近。
  • 控制器职责明确,逻辑委托给单一用途的对象。
  • 各组件职责清晰,便于测试和维护。
  • 代码结构易于扩展和维护。

五、结论

表单对象并非一无是处,其初衷是好的,通常比臃肿的模型或控制器更佳。 但需谨慎使用,避免其成为新的代码耦合点。 在使用表单对象前,需仔细权衡其利弊,并考虑是否已有更合适的组件可以承担其职责。 本文提出的方案并非唯一解,但提供了一种更清晰、更易维护的代码结构。

参考文章:

  • 重构 Fat ActiveRecord 模型的 7 种模式
  • 有纪律的 Rails:形成对象技术和模式 — 第 1 部分
  • 基本 RubyOnRails 模式 — 第 4 部分:表单对象
  • ActiveModel 表单对象
  • 如何使用表单对象保持控制器的精简
  • 在 Ruby on Rails 中使用表单对象
  • 验证表单对象
  • 使用 ActiveModel 创建表单对象
  • 使用表单对象重构您的代码

好了,本文到此结束,带大家了解了《针对表单对象的案例》,希望本文对你有所帮助!关注golang学习网公众号,给大家分享更多文章知识!

相关阅读
更多>
最新阅读
更多>
课程推荐
更多>