Swiftのバリデーション設計を完全ガイド！入力検証とドメインエラーの分離を初心者向けに解説

Swift バリデーション設計｜入力検証・ドメインエラーの分離

先生と生徒の会話形式で理解しよう

生徒

「先生、アプリでユーザーが入力したデータをそのまま使っても大丈夫なんですか？」

先生

「いいえ、そのまま使うのは危険です。例えばメールアドレスの欄に『abc』とだけ入力されたら、正しく処理できませんよね。こういうときに必要なのが“バリデーション”です。」

生徒

「なるほど！じゃあバリデーションって入力をチェックする仕組みなんですね。でも“ドメインエラー”っていう言葉も聞いたことがあります。これは何ですか？」

先生

「ドメインエラーとは、アプリのビジネスルールに違反するエラーのことです。入力チェックとは分けて扱うのが設計のポイントなんです。」

1. バリデーションとは？

バリデーションとは、ユーザーからの入力や外部から渡されるデータが正しい形式かどうかを確認する処理です。例えば、次のようなケースが代表例です。

メールアドレスに「@」が含まれているか
パスワードが8文字以上か
年齢の入力が数字かつ0以上か

バリデーションを行わないと、アプリが異常終了したり、意図しない動きをしてしまう可能性があります。

2. ドメインエラーとは？

ドメインエラーとは、アプリのルールやビジネス上の制約に違反するエラーのことです。例えば、銀行アプリで残高以上の金額を引き出そうとした場合などです。これは入力が正しくても、ビジネスルールとして許されないためエラーになります。

つまり、入力エラー＝形式的に間違っている、ドメインエラー＝ルールに反していると整理すると分かりやすいです。

3. Swiftでの入力検証の基本

Swiftでは、条件を確認する際にguardやifを使ってバリデーションを行います。例えばメールアドレスの簡単なチェックは次のように書けます。


func validateEmail(_ email: String) -> Bool {
    return email.contains("@")
}

print(validateEmail("test@example.com")) // true
print(validateEmail("invalid")) // false

このようにシンプルなチェックでも、アプリの安全性を大きく高められます。

4. 入力エラーとドメインエラーを分離する

設計上大切なのは、入力エラーとドメインエラーを明確に分けることです。同じ「エラー」でも意味が違うので、区別しないとコードが複雑になります。


enum InputError: Error {
    case invalidEmail
    case shortPassword
}

enum DomainError: Error {
    case insufficientBalance
}

func registerUser(email: String, password: String) throws {
    guard email.contains("@") else {
        throw InputError.invalidEmail
    }
    guard password.count >= 8 else {
        throw InputError.shortPassword
    }
    // 登録処理…
}

こうすることで「入力が間違っているのか」「ルールに違反しているのか」を分けて処理できます。

5. 実践的なエラーメッセージ設計

初心者が見落としがちなのが「ユーザーにどう伝えるか」です。バリデーションエラーの場合は「メールアドレスの形式が正しくありません」、ドメインエラーの場合は「残高が不足しています」といった具体的なメッセージを返すことで、ユーザーに優しいアプリになります。

また、開発者がデバッグしやすいようにログを残すことも重要です。

Swiftを基礎から実践レベルまで学びたい人や、 iOSアプリ開発を本格的に始めたい人には、定番の入門＋実践書がこちらです。

Swift実践入門をAmazonで見る

※ Amazon広告リンク

6. ベストプラクティス

Swiftでバリデーションとドメインエラーを設計する際のベストプラクティスを整理します。

入力検証とドメインエラーを別々のenumで管理する
guardを活用して読みやすいバリデーションを書く
ユーザーに伝わるメッセージを設計する
ログを残してエラー原因を追跡できるようにする

こうすることで、エラー処理が明確になり、堅牢でメンテナンスしやすいSwiftアプリを作ることができます。

Windowsで始めるiPhoneアプリ開発入門｜Swiftの基本と仕組みを1時間で攻略

「iPhoneアプリを作りたいけれど、Macを持っていないから諦めている」そんな方のための画期的な入門講座です。実は、プログラミングの本質を学ぶのに高価な機材は必要ありません。本講座では、Windowsパソコンを使用し、クラウド環境を活用してAppleの最新言語Swift（スウィフト）の基礎を最短距離でマスターします。