Validateとは何か、入力フィールドの検証とAndroidでの実装

Androidにおけるフィールド検証とは？

フィールド検証とは、指定されたルールに従ってユーザーが入力した単一の値をチェックすることです。各フィールドには独自のデータ型（メール、数値、電話、パスワード、テキスト）があります。各型には独自の基準（形式、長さ、値の範囲、必須）があります。フィールド検証は「このフィールドの入力は正しいか？」という質問に答えます。

フィールド検証とフォーム検証の違いは、フィールドが他のフィールドから独立してチェックされることです。メールはメールパターンに対して検証され、電話は電話パターンに対して検証されます。フィールドが無効な場合、ユーザーはその特定のフィールドのエラーを表示します。1つのフィールドが検証に失敗しても、フォームは未送信のままになる可能性があります。フィールド検証は、完全なフォーム検証の構成要素です。

UX調査によると、ユーザーは入力完了から1〜2秒以内に検証エラーを表示されることを期待しています。3秒以上の遅延はアプリケーションの問題として認識されます。そのため、TextWatcherによるリアルタイム検証は、送信ボタンが押されたときだけチェックするよりも望ましいです。

フィールド検証の主要な方法

Androidでのフィールド検証には3つの主要なアプローチがあります。1つ目は、条件演算子（if、when）を使用した手動チェックです。開発者は文字列を受け取りBooleanまたはエラーメッセージを返す関数を作成します。このアプローチはロジックを完全に制御できますが、各フィールドと各条件に対してコードを記述する必要があります。

2つ目のアプローチは、Androidの組み込みクラスを使用することです。たとえば、Patterns.EMAIL_ADDRESS.matcher(email).matches()は標準パターンに対してメールを検証します。Patterns.PHONE.matcher(phone).matches()は電話番号を検証します。TextUtils.isEmpty()は空をチェックします。これらのメソッドは外部依存関係を追加せずに基本的なシナリオをカバーします。

3つ目のアプローチは検証ライブラリです。InputValidator、AndroidValidator、Commons Validatorなどのライブラリは、既製のアノテーションと検証チェーンを提供します。開発者はルールを宣言的に記述します：@Email、@NotEmpty、@MinLength(6)。ライブラリ自体が検証を実行し、エラーのリストを返します。これにより開発が高速化されますが、依存関係が追加されます。

メール、電話、パスワードの検証

メールの標準検証には、@記号の存在、ドメイン部分、スペースとキリル文字の不在のチェックが含まれます。AndroidはPatterns.EMAIL_ADDRESSを提供しており、これはほとんどの正当なメールアドレスをカバーします。ただし、特定の検証（企業ドメインのみなど）が必要な場合は、カスタム正規表現を作成する必要があります。メールは各文字の後ではなく、入力完了後に検証されます。

電話番号は国または地域のマスクに対して検証されます。国際番号にはE.164形式（+国コード、事業者コード、番号）が使用されます。Googleのlibphonenumberライブラリは電話検証の業界標準です。コードで国を特定し、番号の長さと形式をチェックします。Androidでは、基本的な検証にPhoneNumberUtils.isGlobalPhoneNumberを使用できます。

パスワードには複数の複雑さの基準があります：最小長、大文字と小文字、数字、特殊文字の存在。Androidにはパスワード検証のための組み込みクラスはありません — 各プロジェクトが独自の要件を定義します。通常、パスワードは正規表現または一連の条件を通じて検証されます。エラーメッセージで正確な要件を明らかにしないことが重要です：「パスワードが単純すぎます」は「大文字と数字が必要です」よりも優れています。

data class ValidationResult(
    val isValid: Boolean,
    val errorMessage: String? = null
)

fun validatePassword(password: String): ValidationResult {
    if (password.length < 6)
        return ValidationResult(false, "Minimum 6 characters")
    if (!password.any { it.isUpperCase() })
        return ValidationResult(false, "Uppercase letter required")
    return ValidationResult(true)
}

この例では、validatePasswordはisValidフィールドとオプションのエラーメッセージを持つValidationResultを返します。このアプローチは構成に便利です：複数のチェックが順次実行され、最初に見つかったエラーが返されます。メールと電話の検証も同じ原則に従います — それぞれがメッセージまたは成功とともに結果を返します。

いつ検証を実行するか？

検証のタイミングはUXに大きく影響します。3つの戦略があります：各文字の後の検証（即時）、フォーカス喪失後（onFocusLost）、フォーム送信時（onSubmit）。各戦略は異なるシナリオに適しています。即時検証は厳しい制約のあるフィールド（電話番号、PINコード）に適しています。OnFocusLostはメールと名前に適しています。OnSubmitは必須フィールドに適しています。

Material Design Guidelinesによると、戦略を組み合わせることが推奨されています：フィールドはフォーカス喪失時とフォーム送信時の両方で検証されるべきです。即時検証は制約が明らかな場合（最大フィールド長など）に適しています。メールで各文字の後にエラーを表示すると、ユーザーは入力を終える前にメッセージを見ることになります。これは煩わしく、コンバージョンを低下させます。

最初のエラーのルール：フォーム送信時は、最初の無効なフィールドのみエラーを表示します。10個のエラーのリストでユーザーを圧倒しないでください。最初のエラーを修正した後、次のエラーを表示できます。このステップバイステップのガイダンスは認知負荷を軽減し、ユーザーがより迅速にフォームを記入するのに役立ちます。

検証のためのツールとライブラリ

Android SDKはValidateの基本的なツールを提供します：メールと電話のPatterns、空チェックのTextUtils、任意のパターンの正規表現。1〜3フィールドのプロジェクトではこれで十分です。ただし、10+フィールドのフォームでは、手動検証の保守が困難になります — 新しいフィールドごとに個別の関数と更新された送信ロジックが必要です。

人気のある検証ライブラリ：Android Saripaar（@Email、@NotEmpty、@Passwordアノテーション）、Apache Commons Validator（メール、URL、クレジットカード番号の検証）、リアクティブ検証のためのRxBinding + RxJava。Saripaarを使用すると、入力フィールドに直接アノテーションを配置し、1行で検証を呼び出すことができます：validator.validate()。ライブラリはsetErrorを介して自動的にエラーを表示します。

GoogleはTextInputLayoutとともにMaterial Design Componentsを使用することを推奨しています。setError、setHelperText、setCounterEnabledによる組み込み検証は、サードパーティライブラリなしで基本的なシナリオをカバーします。複雑なプロジェクト（フィンテック、ヘルスケア）には、Material Components + Clean Architectureのドメインレイヤーのパターンを使用したカスタム検証の組み合わせを使用することをお勧めします。

フィールド検証の一般的なエラー

1つ目のエラーは入力開始前にエラーを表示することです。フィールドが必須でもユーザーが入力を開始していない場合は、「フィールドは必須です」と表示しないでください。これにより問題の誤った印象を与えます。エラーはユーザーがフィールドとやり取りした後（入力を開始した、フィールドを離れた、フォーム送信を試みた）にのみ表示されるべきです。

2つ目のエラーは不明瞭なエラーメッセージです。メッセージは具体的で、問題の修正方法を示すべきです。「無効なメール」は悪い例です。「メールには@とドメインを含める必要があります（例：user@example.com）」は良い例です。ユーザーはドキュメントを参照しなくても、何が問題でどのように修正するかを理解できる必要があります。

3つ目のエラーは説明なしに送信をブロックすることです。検証エラーのために送信ボタンが非アクティブな場合、ユーザーはどのフィールドが無効かを確認できる必要があります。メッセージのないグレーのボタンはユーザーにとって行き止まりです。常にエラーのあるフィールドを強調表示し、各無効なフィールドの横にエラーテキストを表示してください。