Spec-Zone.ru › Ruby on Rails 7.1

модуль ActionController::ParameterEncoding::ClassMethods

Открытые методы экземпляра

param_encoding(action, param, encoding) Показать исходный код
# File actionpack/lib/action_controller/metal/parameter_encoding.rb, line 77
def param_encoding(action, param, encoding)
  @_parameter_encodings[action.to_s][param.to_s] = encoding
end

Укажите кодировку для параметра на действии. Если не указано, используется значение по умолчанию UTF-8.

Вы можете указать параметр в двоичной кодировке (ASCII_8BIT) следующим образом:

class RepositoryController < ActionController::Base
  # This specifies that file_path is not UTF-8 and is instead ASCII_8BIT
  param_encoding :show, :file_path, Encoding::ASCII_8BIT

  def show
    @repo = Repository.find_by_filesystem_path params[:file_path]

    # params[:repo_name] remains UTF-8 encoded
    @repo_name = params[:repo_name]
  end

  def index
    @repositories = Repository.all
  end
end

Параметр file_path на действии show будет закодирован как ASCII-8BIT, но все остальные аргументы останутся в кодировке UTF-8. Это полезно в случаях, когда приложение должно обрабатывать данные, но кодировка данных неизвестна, например, данные из файловой системы.

skip_parameter_encoding(action) Показать исходный код
# File actionpack/lib/action_controller/metal/parameter_encoding.rb, line 48
def skip_parameter_encoding(action)
  @_parameter_encodings[action.to_s] = Hash.new { Encoding::ASCII_8BIT }
end

Укажите, что параметры данного действия должны быть закодированы как ASCII-8BIT (пропускается кодировка по умолчанию UTF-8).

Например, контроллер может использовать это так:

class RepositoryController < ActionController::Base
  skip_parameter_encoding :show

  def show
    @repo = Repository.find_by_filesystem_path params[:file_path]

    # `repo_name` is guaranteed to be UTF-8, but was ASCII-8BIT, so
    # tag it as such
    @repo_name = params[:repo_name].force_encoding 'UTF-8'
  end

  def index
    @repositories = Repository.all
  end
end

Действие show в данном контроллере будет иметь все значения параметров, закодированные как ASCII-8BIT. Это полезно в случаях, когда приложение должно обрабатывать данные, но кодировка данных неизвестна, например, данные из файловой системы.

© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API