Java上級

上級 Javaで学ぶクリーンアーキテクチャ｜アンチパターン編

 

導入

クリーンアーキテクチャは、ソフトウェア開発における柔軟性や保守性を高めるための設計原則です。しかし、実際のプロジェクトでは、理想的な構造を維持することが難しい場合があります。特に、現場で遭遇するアンチパターンは、開発者が意図せずにクリーンアーキテクチャの原則から逸脱させる原因となります。本記事では、上級Javaプログラマーが直面しやすい具体的なアンチパターンを取り上げ、その問題点と改善策を提案します。

教科書レベルの解説（クリーンアーキテクチャ）

重要な概念の整理

クリーンアーキテクチャは、アプリケーションの依存関係を整理し、ビジネスロジックを外部の影響から保護することを目的としています。特に、以下の4つの層が重要です：

  • エンティティ層：ビジネスルールを定義し、アプリケーション全体で再利用可能なオブジェクトを含む。
  • ユースケース層：アプリケーションの具体的な機能を実現するためのビジネスロジックを含む。
  • インターフェース層：ユーザーインターフェースや外部サービスとのやり取りを担当。
  • フレームワーク層：データベースやWebフレームワークなど、外部ライブラリとの連携を管理。

コード例（Java）


public class User {
    private String username;
    private String password;

    public User(String username, String password) {
        this.username = username;
        this.password = password;
    }

    public String getUsername() {
        return username;
    }

    public String getPassword() {
        return password;
    }
}

public class UserService {
    private UserRepository userRepository;

    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    public void registerUser(String username, String password) {
        User user = new User(username, password);
        userRepository.save(user);
    }
}

public interface UserRepository {
    void save(User user);
}

コードの行ごとの解説

  1. クラス User は、ユーザー情報を保持するエンティティ層の一部です。ユーザー名とパスワードをフィールドとして持ち、コンストラクタで初期化します。

  2. UserService はユースケース層に位置し、ユーザー登録機能を実装しています。依存性注入を利用して UserRepository を受け取ります。

  3. UserRepository はデータの保存処理を抽象化したインターフェースであり、実際のデータベース操作はこのインターフェースを実装することで行います。

アンチパターン編

クリーンアーキテクチャを実践する際にしばしば見られるアンチパターンの一つに、ビジネスロジックの漏れがあります。以下のようなケースを考えてみましょう。

ユーザー登録機能において、バリデーションやエラーハンドリングが UserService に組み込まれていない場合、ビジネスルールが適切に適用されず、データの整合性が損なわれる可能性があります。このような設計は、後のメンテナンスや機能追加の際に大きな問題を引き起こします。

改善策としては、バリデーションロジックを専用のクラスに分離し、ユースケース層で呼び出す形にすることが考えられます。以下のように実装を見直します：


public class UserValidator {
    public void validate(User user) {
        if (user.getUsername() == null || user.getPassword() == null) {
            throw new IllegalArgumentException("Username and password cannot be null");
        }
    }
}

public class UserService {
    private UserRepository userRepository;
    private UserValidator userValidator;

    public UserService(UserRepository userRepository, UserValidator userValidator) {
        this.userRepository = userRepository;
        this.userValidator = userValidator;
    }

    public void registerUser(String username, String password) {
        User user = new User(username, password);
        userValidator.validate(user);
        userRepository.save(user);
    }
}

この修正により、ビジネスロジックが一元化され、再利用性とテストの容易さが向上します。

まとめ

  • クリーンアーキテクチャでは、ビジネスロジックの漏れが大きな問題となる。
  • バリデーションやエラーハンドリングは専用のクラスに分けて、ユースケース層から呼び出す設計が望ましい。
  • 依存性注入を活用することで、テストやメンテナンスが容易になる。
RELATED POST