Spec-Zone.ru › Symfony 2.8

DataTransformerInterface

интерфейс DataTransformerInterface

Преобразует значение между различными представлениями.

Методы

смешанный transform(смешанный $value)

Преобразует значение из исходного представления в преобразованное представление.

смешанный reverseTransform(смешанный $value)

Преобразует значение из преобразованного представления в исходное представление.

Подробности

смешанный transform(смешанный $value)

Преобразует значение из исходного представления в преобразованное представление.

Этот метод вызывается дважды внутри поля формы:

  1. Когда поле формы инициализируется данными, прикрепленными из источника данных (объект или массив).
  2. Когда данные из запроса отправляются с помощью {@link Form::submit()}, чтобы преобразовать новые входные данные обратно в формат, пригодный для отображения. Например, если у вас есть поле даты и вы отправляете '2009-10-10', вы можете принять это значение, потому что его легко разобрать, но преобразователь все равно запишет обратно "2009/10/10" в поле формы (для дальнейшего отображения или других целей).

Этот метод должен уметь обрабатывать пустые значения. Обычно это будет NULL, но в зависимости от вашей реализации возможны и другие пустые значения (например, пустые строки). Причина в том, что преобразователи значений должны быть цепными. Если метод transform() первого преобразователя значений возвращает NULL, второй преобразователь значений должен уметь обработать это значение.

Согласно соглашению, transform() должен возвращать пустую строку, если передан NULL.

Параметры

смешанный $value Значение в исходном представлении

Возвращаемое значение

смешанный Значение в преобразованном представлении

Исключения

TransformationFailedException при ошибке преобразования

смешанный reverseTransform(смешанный $value)

Преобразует значение из преобразованного представления в исходное представление.

Этот метод вызывается, когда вызывается {@link Form::submit()}, чтобы преобразовать данные запроса в приемлемый формат для обработки данных/модели.

Этот метод должен уметь обрабатывать пустые значения. Обычно это будет пустая строка, но в зависимости от вашей реализации возможны и другие пустые значения (например, NULL). Причина в том, что преобразователи значений должны быть цепными. Если метод reverseTransform() первого преобразователя значений возвращает пустую строку, второй преобразователь значений должен уметь обработать это значение.

Согласно соглашению, reverseTransform() должен возвращать NULL, если передана пустая строка.

Параметры

смешанный $value Значение в преобразованном представлении

Возвращаемое значение

смешанный Значение в исходном представлении

Исключения

TransformationFailedException при ошибке преобразования

© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/2.7/Symfony/Component/Form/DataTransformerInterface.html

Spec-Zone.ru

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