Spec-Zone.ru › Symfony 3.1

ReversedTransformer

class ReversedTransformer implements DataTransformerInterface

Обращает преобразователь.

При вызове метода transform() вызывается метод reverseTransform() обратного преобразователя и наоборот.

Методы

__construct(DataTransformerInterface $reversedTransformer)

Обращает этот преобразователь.

mixed transform(mixed $value)

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

mixed reverseTransform(mixed $value)

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

Подробности

__construct(DataTransformerInterface $reversedTransformer)

Обращает этот преобразователь.

Параметры

DataTransformerInterface $reversedTransformer

mixed transform(mixed $value)

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

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

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

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

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

Параметры

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

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

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

Исключения

TransformationFailedException Когда преобразование завершается ошибкой.

mixed reverseTransform(mixed $value)

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

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

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

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

Параметры

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

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

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

Исключения

TransformationFailedException Когда преобразование завершается ошибкой.

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

Spec-Zone.ru

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