Clean Architecture & Design Patterns in Practice · Leçon

Gérer les préoccupations transversales

Mettez en œuvre des stratégies de journalisation, d'authentification et d'autorisation sans enfreindre la règle des dépendances ni polluer la logique centrale.

Leçon 1 sur 411 étapes

Gérer les préoccupations transversales est une leçon Clean Architecture & Design Patterns in Practice gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Clean Architecture & Design Patterns in Practice, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Clean Architecture & Design Patterns in Practice comprend 4 leçons au total.

Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.

What are Cross-Cutting Concerns?

In software development, cross-cutting concerns are aspects of a system that affect many parts of the application but are not part of its core business logic. Think of them as system-wide services.

Logging: Recording events for debugging or auditing.
Authentication: Verifying a user's identity.
Authorization: Determining what an authenticated user can do.
Caching: Storing frequently accessed data for faster retrieval.
Transaction Management: Ensuring data consistency across multiple operations.

The Clean Architecture Dilemma

Clean Architecture emphasizes keeping your core business logic (Entities and Use Cases) independent of external frameworks and delivery mechanisms. This is enforced by the Dependency Rule: dependencies must only flow inwards.

The challenge arises because cross-cutting concerns often rely on specific external frameworks (e.g., a logging library, a security framework). How can we implement these concerns without violating the Dependency Rule and coupling our core logic to external details?

Logging Without Pollution

Let's take logging as an example. If a CreateUserUseCase directly calls a logging framework like Log4j or SLF4J, it creates a dependency on that specific framework.

CreateUserUseCase → Log4j

This violates the Dependency Rule because the inner layer (Use Case) would depend on an outer layer (Frameworks/Drivers). Our core logic should not care how logs are written, only that they need to be written.

Defining a Logging Port

To solve this, we introduce an interface in our inner (Use Case) layer. This interface, often called an Output Port, defines the contract for logging. The Use Case depends on this abstraction, not a concrete implementation.

package application.ports;

public interface ILogger {
    void info(String message);
    void error(String message, Throwable t);
}

Implementing the Logger Adapter

The actual logging framework implementation lives in an outer layer (e.g., Infrastructure). This concrete class acts as an Adapter, implementing our ILogger port and delegating to the specific logging library.

Notice how ConsoleLogger depends on ILogger (an inner layer abstraction), respecting the Dependency Rule.

package infrastructure.logging;

import application.ports.ILogger; // Depends on inner layer

public class ConsoleLogger implements ILogger {
    @Override
    public void info(String message) {
        System.out.println("[INFO] " + message);
    }

    @Override
    public void error(String message, Throwable t) {
        System.err.println("[ERROR] " + message + " - " + t.getMessage());
    }
}

Logger in a Use Case

Now, our CreateUserUseCase can depend on the ILogger interface. The concrete ConsoleLogger is injected at runtime, typically by a Dependency Injection (DI) container, but we'll do it manually here for clarity.

package application.usecases;

import application.ports.ILogger;
import infrastructure.logging.ConsoleLogger;

public class CreateUserUseCase {
    private final ILogger logger;

    public CreateUserUseCase(ILogger logger) {
        this.logger = logger;
    }

    public void execute(String username) {
        logger.info("Attempting to create user: " + username);
        // ... business logic to create user ...
        logger.info("User created successfully: " + username);
    }
}

public class Main {
    public static void main(String[] args) {
        // Manual Dependency Injection for demonstration
        ILogger consoleLogger = new ConsoleLogger();
        CreateUserUseCase useCase = new CreateUserUseCase(consoleLogger);
        useCase.execute("Alice");
    }
}

Handling Authentication

Authentication (verifying who a user is) should occur at the application's entry points, not within the core Use Cases. The Use Case should only receive already authenticated user information.

Middleware/Filters: In web applications, these intercept requests before they reach controllers.
Input Port Decorators: You can wrap a Use Case with a decorator that handles authentication before delegating to the actual Use Case.

This ensures the Use Case remains focused on business logic, free from security framework details.

Authorization with Policies

Authorization (what an authenticated user can do) is often more complex. While basic authorization can also be handled at the entry point, more granular checks might involve the Use Case.

Authorization Policies: Define separate objects or services that encapsulate authorization rules.
Interceptors/Aspects: Apply these policies around Use Case execution, checking permissions before the core logic runs.
The Use Case might depend on an IAuthorizationService interface (another Port) to query specific permissions.

DI for Cross-Cutting Concerns

The overarching principle for handling cross-cutting concerns in Clean Architecture is the Dependency Inversion Principle (DIP).

High-level modules (Use Cases) should not depend on low-level modules (frameworks).
Both should depend on abstractions (interfaces).
Abstractions are defined in the inner layers, and their concrete implementations reside in the outer layers, injected at runtime.

This keeps your core logic clean, testable, and independent of external technologies.

Applying Clean Concerns

Consider a ProcessOrderUseCase that needs to log critical steps. Which approach aligns best with Clean Architecture's Dependency Rule?

Réponds-y dans la leçon interactive

Recap: Keeping Core Clean

We've explored strategies to handle cross-cutting concerns like logging, authentication, and authorization within Clean Architecture:

Abstract Concerns: Define interfaces (Ports) in inner layers for concerns like logging.
Implement Adapters: Provide concrete implementations of these interfaces in outer layers (Adapters).
Boundary Handling: Use middleware, decorators, or interceptors at application boundaries for authentication and authorization.
Dependency Inversion: This principle is crucial for ensuring your core business logic remains clean, independent, and free from external framework details.

Gratuit pour commencer

Apprends Clean Architecture & Design Patterns in Practice avec un tuteur IA — gratuit

Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.

Cours: 12
Leçons: 48

Commencer gratuitement Voir le cours complet

Questions Fréquemment Posées

La leçon « Gérer les préoccupations transversales » est-elle gratuite ?

Oui — le texte complet de « Gérer les préoccupations transversales » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Clean Architecture & Design Patterns in Practice, passe à CoddyKit PRO. Le cours Clean Architecture & Design Patterns in Practice comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Gérer les préoccupations transversales » ?

Mettez en œuvre des stratégies de journalisation, d'authentification et d'autorisation sans enfreindre la règle des dépendances ni polluer la logique centrale. Tu pratiques Clean Architecture & Design Patterns in Practice avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Clean Architecture & Design Patterns in Practice ?

Aucune expérience préalable n'est requise. Clean Architecture & Design Patterns in Practice sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.

Combien de temps prend la leçon « Gérer les préoccupations transversales » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Clean Architecture & Design Patterns in Practice ?

Oui. Chaque leçon Clean Architecture & Design Patterns in Practice inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

Gérer les préoccupations transversales
Architecture propre pilotée par les événements
Architecture propre dans les microservices
CQRS au sein d’une architecture propre

← Retour à Clean Architecture & Design Patterns in Practice