Action Controller API

API 控制器是 ActionController::Base 的轻量级版本，专为不需要完整 Rails 控制器提供的所有功能的应用程序而创建，允许您只使用 API 应用程序所需的功能来创建控制器。

API 控制器与普通控制器的区别在于，默认情况下它不包括浏览器访问通常需要的一些功能：布局和模板渲染、闪存、资产等等。这使得整个控制器堆栈更薄，适合 API 应用程序。但这并不意味着如果您需要这些功能，您就无法使用它们：它们都可以包含在您的应用程序中，只是不是默认 API 控制器堆栈的一部分。

通常，ApplicationController 是唯一继承自 ActionController::API 的控制器。所有其他控制器依次继承自 ApplicationController。

一个示例控制器可能如下所示

class PostsController < ApplicationController
  def index
    posts = Post.all
    render json: posts
  end
end

请求、响应和参数对象的工作方式与 ActionController::Base 完全相同。

渲染

默认的 API 控制器堆栈包含所有渲染器，这意味着您可以在控制器中自由使用 render :json 及其同类。请记住，模板不会被渲染，因此您需要确保您的控制器在所有操作中都调用 render 或 redirect_to，否则它将返回 204 No Content。

def show
  post = Post.find(params[:id])
  render json: post
end

重定向

重定向用于从一个操作移动到另一个操作。您可以在控制器中使用 redirect_to 方法，就像在 ActionController::Base 中一样。例如

def create
  redirect_to root_url and return if not_authorized?
  # do stuff here
end

添加新行为

在某些情况下，您可能希望添加回由 ActionController::Base 提供的某些功能，而这些功能在 ActionController::API 中默认不存在，例如 MimeResponds。此模块为您提供了 respond_to 方法。添加它非常简单，您只需在特定控制器或 ApplicationController 中包含该模块，如果您希望它在整个应用程序中可用。

class ApplicationController < ActionController::API
  include ActionController::MimeResponds
end

class PostsController < ApplicationController
  def index
    posts = Post.all

    respond_to do |format|
      format.json { render json: posts }
      format.xml  { render xml: posts }
    end
  end
end

如果您想使用 ActionController::API 未提供的任何其他功能，请务必检查 ActionController::Base 中包含的模块。