Не так давно мне понадобилось добавить в андроид-приложение валидаторы для полей ввода (EditText), но ничего подходящего в сети не нашлось: пришлось писать свои собственные. Теперь, когда все готово, можно раздать результаты всем желающим под Apache лицензией и немного рассказать, как все устроено. Тех, кому интересно, прошу под кат.
Так как писалось все с нуля, то можно было делать архитектуру под себя, поэтому была выбрана следующая схема:
- Одному полю ввода назначается один валидатор (можно больше, но в этом нет смысла)
- Каждому валидатору назначается несколько чекеров, на различные условия (длину текста, соответствие маске и т.п.)
- Чекеры выполняют проверки в том порядке, в котором были добавлены, первый «провалившийся» показывает сообщение.
Для удобства сделал пару кастомизаций:
- Можно выбрать проверку как по изменению текста в поле, так и вручную
- Можно показывать сообщение как в отдельном TextView, так и встроенным в андроид механизмом (красная иконка со всплывающим сообщением).
- Можно объединить валидаторы в группу и инициировать проверку для всей группы, а также показать отдельное сообщение, если хоть один валидатор в группе обнаружил ошибку.
У валидаторов и чекеров есть базовые абстрактные классы, реализовав которые, вы можете получить валидаторы для своих контролов и свои особые проверки.
Сейчас есть проверки:
- На пустоту строки
- На длину строки
- На соответствие регэкспу
- На принадлежность диапазону (для полей ввода целочисленных значений)
- На совпадение с текстом в другом поле ввода (полезно для подтверждения паролей)
В коде все это выглядит примерно так:
//Создали группирующий валидатор ValidationSummary summaryValidator_ = new ValidationSummary(getString(R.string.common_error_message), headerErrorMessage); //Создали валидатор для поля ввода имени EditTextValidator firstnameValidator = new EditTextValidator(); //Назначили ему EditText для валидации, выбрав ручной режим проверки (не будет валидации, когда пользователь начнет вводить текст) firstnameValidator.setViewToValidate(firstnameEdit, ValidationMode.Manual); //Установили TextView для отображения сообщений об ошибках в нем, а не в штатном всплывающем окне firstnameValidator.setExternalErrorView( (TextView) findViewById(R.id.firstname_error_text)); //Добавили проверки на пустоту строки firstnameValidator.addConditionChecker(new NotEmptyChecker( getString(R.string.name_required_error_message) )); //и ее длину firstnameValidator.addConditionChecker(new LengthChecker(1, 50, getString(R.string.firstname_error_message) )); //Добавили валидатор в группу summaryValidator_.addValidator(firstnameValidator); ... //Аналогично для поля подтверждения пароля EditTextValidator confirmPasswordValidator = new EditTextValidator(); confirmPasswordValidator.setViewToValidate(confirmPasswordEdit, ValidationMode.Manual); confirmPasswordValidator.setExternalErrorView( (TextView) findViewById(R.id.confirm_password_error_text)); //Только проверка на соответствие текста, содержимому другого поля - passwordEdit confirmPasswordValidator.addConditionChecker(new TextMatchChecker(getString(R.string.confirm_password_error_message), passwordEdit)); summaryValidator_.addValidator(confirmPasswordValidator);
Инициировать проверку всех валидаторов в группе можно вызовом:
summaryValidator_.performCheck();
Всех, кого заинтересовали валидаторы, приглашаю взять проект с ГитХаба компании Rus Wizards, в стенах которой и был написан этот код.
И, конечно же, любые пожелания, предложение, советы приветствуются!
