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. 実践的なエラーメッセージ設計

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

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

6. ベストプラクティス

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

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

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

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

Swift実践入門をAmazonで見る

※ Amazon広告リンク

まとめ

Swift バリデーション設計では、バリデーション設計をSwiftで扱うときの考え方を確認しました。Swiftは、書き方だけを覚えるよりも、Xcodeで動かしながら「どこで値が変わるのか」「失敗したときに何が起きるのか」を見たほうが理解しやすくなります。

Xcodeで見る場所：バリデーション設計で迷ったら、まず入力値、戻り値、Optionalの扱い、エラー時の表示、関数名や型名の読みやすさを切り分けましょう。Swiftは型やエラーがヒントになるため、Xcodeの警告と実行結果を一緒に見るのが近道です。

定着チェック

バリデーション設計で注目する場所として、入力値、戻り値、Optionalの扱い、エラー時の表示、関数名や型名の読みやすさを説明できる
サンプルの値を1つ変え、コンソール出力とエラーメッセージの変化を見る
Xcodeのエラー、警告、コンソール出力を読み、原因を1つ言葉にできる
Swift、Xcode、iOSアプリ開発の中で、この記事の知識を使う場面を想像できる

復習するときは、次のような短いコードを自分の環境で動かしてみましょう。記事のテーマに合わせて値や条件を変えると、Swiftの型安全、Optional、エラー処理、画面更新の見え方が少しずつ整理できます。

struct LearningStep {
    let title: String
    let completed: Bool
}

let steps = [
    LearningStep(title: &quot;文法を確認する&quot;, completed: true),
    LearningStep(title: &quot;サンプルを動かす&quot;, completed: false)
]

print(steps.filter { !$0.completed })

生徒

「バリデーション設計は、どこを変えて試せばいいか分かると復習しやすいですね。」

先生

「はい。まずは小さく動かし、次に失敗するケースを1つ足してみましょう。Swiftは型やエラーがヒントを出してくれるので、結果を見ながら直す練習がそのまま実務力につながります。」

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

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