Ruby on Rails - 控制器


Rails 控制器是应用程序的逻辑中心。它协调用户、视图和模型之间的交互。该控制器也是许多重要辅助服务的所在地。

  • 它负责将外部请求路由到内部操作。它可以很好地处理人性化的 URL。

  • 它管理缓存,可以使应用程序的性能得到数个数量级的提升。

  • 它管理帮助程序模块,这些模块扩展了视图模板的功能,而无需增加代码量。

  • 它管理会话,给用户留下与我们的应用程序持续交互的印象。

创建控制器的过程非常简单,它与我们已经用于创建模型的过程类似。我们将在这里创建一个控制器 -

library\> rails generate controller Book

请注意,您将 Book 大写并使用单数形式。这是每次创建控制器时都应该遵循的 Rails 范例。

该命令完成多项任务,其中以下内容与此处相关 -

  • 它创建一个名为app/controllers/book_controller.rb的文件

如果你查看 book_controller.rb,你会发现它如下 -

class BookController < ApplicationController
end

控制器类继承自ApplicationController,它是控制器文件夹中的另一个文件:application.rb

ApplicationController包含可以在所有控制器中运行的代码,它继承自 Rails ActionController ::Base类。

目前您还不需要担心 ApplicationController ,因此我们只需在book_controller.rb中定义一些方法存根即可。根据您的要求,您可以在此文件中定义任意数量的函数。

修改文件如下所示并保存更改。请注意,您想为这些方法指定什么名称取决于您,但最好指定相关名称。

class BookController < ApplicationController
   def list
   end
   
   def show
   end
   
   def new
   end
   
   def create
   end
   
   def edit
   end
   
   def update
   end
   
   def delete
   end
   
end

现在让我们一一实现所有的方法。

实现列表方法

list 方法为您提供数据库中所有书籍的列表。该功能将通过以下代码行来实现。在 book_controller.rb 文件中编辑以下行。

def list
   @books = Book.all
end

list 方法中的@books = Book.all行告诉 Rails 搜索 books 表并将找到的每一行存储在 @books 实例对象中。

实现show方法

show 方法仅显示单本书的更多详细信息。该功能将通过以下代码行来实现。

def show
   @book = Book.find(params[:id])
end

show 方法的@book = Book.find(params[:id])行告诉 Rails 仅查找具有 params[:id] 中定义的 id 的书。

params 对象是一个容器,使您能够在方法调用之间传递值。例如,当您在 list 方法调用的页面上时,您可以单击特定书籍的链接,它会通过 params 对象传递该书籍的 id,以便 show 可以找到特定书籍。

实施新方法

新方法让 Rails 知道您将创建一个新对象。所以只需在这个方法中添加如下代码即可。

def new
   @book = Book.new
   @subjects = Subject.all
end

当您向用户显示页面以接受用户输入时,将调用上述方法。第二行从数据库中获取所有主题并将它们放入名为 @subjects 的数组中。

实现创建方法

使用 HTML 表单获取用户输入后,就可以在数据库中创建记录了。为此,请编辑 book_controller.rb 中的创建方法以匹配以下内容 -

def create
   @book = Book.new(book_params)
	
   if @book.save
      redirect_to :action => 'list'
   else
      @subjects = Subject.all
      render :action => 'new'
   end
   
end

def book_params
   params.require(:books).permit(:title, :price, :subject_id, :description)
end

第一行创建一个名为 @book 的新实例变量,它保存根据用户提交的数据构建的 Book 对象。book_params方法用于收集对象:books中所有字段。数据是从新方法传递来使用 params 对象创建的。

下一行是条件语句,如果对象正确保存到数据库,则将用户重定向到列表方法。如果不保存,用户将被发送回新方法。redirect_to 方法类似于在网页上执行元刷新:它会自动将您转发到目的地,无需任何用户交互。

然后@subjects = subject.all是必需的,以防它没有成功保存数据并且它变得与新选项类似的情况。

实现编辑方法

edit 方法看起来与 show 方法几乎相同。这两种方法都用于根据 id 检索单个对象并将其显示在页面上。唯一的区别是 show 方法不可编辑。

def edit
   @book = Book.find(params[:id])
   @subjects = Subject.all
end

将调用该方法将数据显示在屏幕上以供用户修改。第二行从数据库中获取所有主题并将它们放入名为@subjects 的数组中。

实现更新方法

当用户修改数据并希望将更改更新到数据库中时,将在编辑方法之后调用此方法。update方法与create方法类似,将用于更新数据库中现有的书籍。

def update
   @book = Book.find(params[:id])
	
   if @book.update_attributes(book_param)
      redirect_to :action => 'show', :id => @book
   else
      @subjects = Subject.all
      render :action => 'edit'
   end
   
end

def book_param
   params.require(:book).permit(:title, :price, :subject_id, :description)
end

update_attributes 方法与 create 使用的 save 方法类似,但它不是在数据库中创建新行,而是覆盖现有行的属性。

然后@subjects = subject.all行是必需的,以防它没有成功保存数据,然后它变得类似于编辑选项。

实现删除方法

如果您想从数据库中删除一条记录,那么您将使用此方法。按如下方式实现该方法。

def delete
   Book.find(params[:id]).destroy
   redirect_to :action => 'list'
end

第一行根据通过 params 对象传递的参数找到分类,然后使用 destroy 方法将其删除。第二行使用redirect_to 调用将用户重定向到列表方法。

显示主题的其他方法

假设您想为用户提供一种工具来浏览基于给定主题的所有书籍。因此,您可以在 book_controller.rb 中创建一个方法来显示所有主题。假设方法名称是show_subjects -

def show_subjects
   @subject = Subject.find(params[:id])
end

最后你的book_controller.rb文件将如下所示 -

class BooksController < ApplicationController

   def list
      @books = Book.all
   end

   def show
      @book = Book.find(params[:id])
   end
  
   def new
      @book = Book.new
      @subjects = Subject.all
   end

   def book_params
      params.require(:books).permit(:title, :price, :subject_id, :description)
   end

   def create
      @book = Book.new(book_params)

      if @book.save
         redirect_to :action => 'list'
      else
         @subjects = Subject.all
         render :action => 'new'
      end
   end
   
   def edit
      @book = Book.find(params[:id])
      @subjects = Subject.all
   end
   
   def book_param
      params.require(:book).permit(:title, :price, :subject_id, :description)
   end
   
   def update
      @book = Book.find(params[:id])
      
      if @book.update_attributes(book_param)
         redirect_to :action => 'show', :id => @book
      else
         @subjects = Subject.all
         render :action => 'edit'
      end
   end
   
   def delete
      Book.find(params[:id]).destroy
      redirect_to :action => 'list'
   end
   
   def show_subjects
      @subject = Subject.find(params[:id])
   end

end

现在保存您的控制器文件。

下一步是什么?

您已经创建了几乎所有可在后端运行的方法。接下来我们将为操作定义路由(URL)。