Фремворк Limb

Отредактируйте страницу и нажмите «Сохранить». Прочтите справочную страницу для ознакомления с синтаксисом вики. Пожалуйста, редактируйте только в том случае, если планируете улучшить содержимое. Если вы просто хотите потестировать что-либо, воспользуйтесь специальной страницей: PlayGround.

====== Валидация данных в объектах ======

===== Механизм валидации данных в Limb3 =====

Мы рекомендуем вам познакомиться с разделом [[limb3_2007_4:ru:packages:web_app:validation|"Валидация данных"]] для ознакомления с механизмом валидации в Limb3.

После прочтения этого раздела вам будет понятно, как осуществляется встроенная валидация в классе lmbActiveRecord.

Отметим сразу, что lmbActiveRecord  применяет валидатор для проверки самого себя, то есть передает $this в метод lmbValidator :: validate($datasource).

===== Валидация при сохранении =====

lmbActiveRecord содержит встроенные средства для проверки данных.

Валидация осуществляется автоматически при вызове метода lmbActiveRecord :: **save($error_list = null)**, который принимает в качестве необязательного параметра объект списка ошибок валидации **$error_list**.

lmbActiveRecord содержит 2 защищенных фабричных метода:
  * lmbActiveRecord :: **_createInsertValidator()** 
  * lmbActiveRecord :: **_createUpdateValidator()**.

Эти методы создают валидатор, который используется для проверки самого объекта перед сохранением. То, какой валидатор создается, определяется исходя из того, является ли объект новым или же уже существующим. Это касается, как валидации при сохранении, так и при непосредственном вызове метода validate().

По-умолчанию эти методы реализованы к классе lmbActiveRecord таким образом, что вызывают еще один метод - lmbActiveRecord :: **_createValidator()**. Обычно в дочернем классе перекрывается именно этот метод, например:

<code php>
class Lesson extends lmbActiveRecord
{
  function _createValidator()
  {
    $validator = new lmbValidator();
    $validator->addRequiredRule('title');
    $validator->addRequiredObjectRule('topic', 'Topic');
    $validator->addRule(new ValidLessonPeriodRule('date_start', 'date_end', $this));
    return $validator;
  }
}
</code>

Метод lmbValidator :: **addRequiredRule($field_name)** создан для удобства добавления правила для обязательных к заполнению полей.

Метод lmbActiveRecord :: save() генерирует исключение класса **lmbValidationException**, если валидация данных не прошла:
<code php>
    try  {
      $active_record->save();
    }
    catch(lmbValidationException $e){
      echo "Объект содержит неверные данные";
    }
</code>

Если в save() объект списка ошибок не передан, lmbActiveRecord создаст свой собственный, который можно получить при помощи метода lmbActiveRecord :: **getErrorList()**.

<code php>
    try  {
      $active_record->save();
    }
    catch(lmbValidationException $e){
      $error_list = $active_record->getErrorList();
      echo "Объект содержит неверные данные:\n";
      foreach($error_list as $error);
        echo $error->getErrorMessage()"\n";
    }
</code>

Также в процессе работы там показалось удобным иметь метод lmbActiveRecord :: **_onValidate()**, который дочерние классы могут перекрывать для вставки своих проверок, которые неудобно или нецелесообразно реализовывать в виде классов, например:

<code php>
  protected function _onValidate()
  {
    if($this->isValid() && $this->getDateStart()->isAfter($this->getDateEnd()))
      $this->_addError('Дата начала не может быть позже даты окончания');
  }
</code>

Здесь мы возпользовались методами lmbActiveRecord :: **isValid()** и **_addError($message, $fields = array(), $values = array())**. Первый возвращает true, если $this->_error_list не содержит ни одной ошибки, а второй - добавлять ошибку $message в $this->_error_list, которая относится к полям $fields, которые содержали значения $values.

см. также [[limb3_2007_4:ru:packages:web_app:validation|"Валидация данных в Limb3"]]

===== Отдельная валидация данных =====

Иногда необходимо валидировать данные отдельно, без вызова метода save(). В этом случае можно использовать метод lmbActiveRecord :: **validate($error_list = null)**, который также принимает $error_list в качестве необязательного параметра.

При возникновении ошибок метод lmbActiveRecord :: validate() уже не генерирует исключение, как это делает метод save().

То, какой валидатор будет использован (insert или update, см. выше), также зависит от статуса, новый ли валидируется объект ActiveRecord или уже старый (загруженный).

При использовании отдельной валидации, смысла использовать save(), который еще раз будет проверять данные уже нет, поэтому lmbActiveRecord содержит метод **saveNoValidation()**, который используется в этом случае, например:

<code php>
  $error_list = new lmbErrorList();
  $user->validate($error_list); 
  $document->validate($error_list);
  if(!$error_list->isEmpty())
    echo "Ошибки в процессе валидации данных!";
  else
  {
    $user->saveNoValidation();
    $document->saveNoValidation();
  }
</code>

Пожалуйста, введите код подтверждения, чтобы доказать, что вы не робот:

  _____  __  __   ____   ___    ___ 
 / ___/ / / / /  / __/  / _ )  / _ \
/ /__  / /_/ /  / _/   / _  | / , _/
\___/  \____/  /___/  /____/ /_/|_|

Пожалуйста, оставьте это поле пустым:

Сводка изменений

Примечание: редактируя эту страницу, вы соглашаетесь на использование своего вклада на условиях следующей лицензии: CC Attribution-Share Alike 4.0 International

Фремворк Limb

Инструменты пользователя

Инструменты сайта

Инструменты страницы