مثال للهندسة السداسية في جافا

مقدمة في العمارة السداسية

• المجال . تحتوي الطبقة على منطق الأعمال الأساسي. لا يحتاج إلى معرفة تفاصيل تنفيذ الطبقات الخارجية.
• التطبيق . تعمل الطبقة كجسر بين طبقات المجال والبنية التحتية.
• البنية التحتية . تنفيذ تفاعل المجال مع العالم الخارجي. تبدو الطبقات الداخلية مثل صندوق أسود له.

مثال

public interface IUserInput {
    public void handleUserInput(Object userCommand);
}

public interface IFetchMovieReviews {
    public List<MovieReview> fetchMovieReviews(MovieSearchRequest movieSearchRequest);
}

public interface IPrintMovieReviews {
    public void writeMovieReviews(List<MovieReview> movieReviewList);
}

public class ConsolePrinter implements IPrintMovieReviews {
    @Override
    public void writeMovieReviews(List<MovieReview> movieReviewList) {
        movieReviewList.forEach(movieReview -> {
            System.out.println(movieReview.toString());
        });
    }
}

public class MovieReviewsRepo implements IFetchMovieReviews {
    private Map<String, List<MovieReview>> movieReviewMap;

    public MovieReviewsRepo() {
        initialize();
    }

    public List<MovieReview> fetchMovieReviews(MovieSearchRequest movieSearchRequest) {

        return Optional.ofNullable(movieReviewMap.get(movieSearchRequest.getMovieName()))
            .orElse(new ArrayList<>());
    }

    private void initialize() {
        this.movieReviewMap = new HashMap<>();
        movieReviewMap.put("StarWars", Collections.singletonList(new MovieReview("1", 7.5, "Good")));
        movieReviewMap.put("StarTreck", Arrays.asList(new MovieReview("1", 9.5, "Excellent"), new MovieReview("1", 8.5, "Good")));
    }
}

نطاق

public class MovieApp implements Consumer<MovieSearchRequest> {
    private IFetchMovieReviews fetchMovieReviews;
    private IPrintMovieReviews printMovieReviews;
    private static Random rand = new Random();

    public MovieApp(IFetchMovieReviews fetchMovieReviews, IPrintMovieReviews printMovieReviews) {
        this.fetchMovieReviews = fetchMovieReviews;
        this.printMovieReviews = printMovieReviews;
    }

    private List<MovieReview> filterRandomReviews(List<MovieReview> movieReviewList) {
        List<MovieReview> result = new ArrayList<MovieReview>();
        // logic to return random reviews
        for (int index = 0; index < 5; ++index) {
            if (movieReviewList.size() < 1)
                break;
            int randomIndex = getRandomElement(movieReviewList.size());
            MovieReview movieReview = movieReviewList.get(randomIndex);
            movieReviewList.remove(movieReview);
            result.add(movieReview);
        }
        return result;
    }

    private int getRandomElement(int size) {
        return rand.nextInt(size);
    }

    public void accept(MovieSearchRequest movieSearchRequest) {
        List<MovieReview> movieReviewList = fetchMovieReviews.fetchMovieReviews(movieSearchRequest);
        List<MovieReview> randomReviews = filterRandomReviews(new ArrayList<>(movieReviewList));
        printMovieReviews.writeMovieReviews(randomReviews);
    }
}

public class CommandMapperModel {
    private static final Class<MovieSearchRequest> searchMovies = MovieSearchRequest.class;

    public static Model build(Consumer<MovieSearchRequest> displayMovies) {
        Model model = Model.builder()
            .user(searchMovies)
            .system(displayMovies)
            .build();

        return model;
    }
}

محولات منفذ التحكم

public class UserCommandBoundary implements IUserInput {
    private Model model;

    public UserCommandBoundary(IFetchMovieReviews fetchMovieReviews, IPrintMovieReviews printMovieReviews) {
        MovieApp movieApp = new MovieApp(fetchMovieReviews, printMovieReviews);
        model = CommandMapperModel.build(movieApp);
    }

    public void handleUserInput(Object userCommand) {
        new ModelRunner().run(model)
            .reactTo(userCommand);
    }
}

public class MovieUser {
    private IUserInput userInputDriverPort;

    public MovieUser(IUserInput userInputDriverPort) {
        this.userInputDriverPort = userInputDriverPort;
    }

    public void processInput(MovieSearchRequest movieSearchRequest) {
        userInputDriverPort.handleUserInput(movieSearchRequest);
    }
}

تطبيق

public class Main {

    public static void main(String[] args) {
        IFetchMovieReviews fetchMovieReviews = new MovieReviewsRepo();
        IPrintMovieReviews printMovieReviews = new ConsolePrinter();
        IUserInput userCommandBoundary = new UserCommandBoundary(fetchMovieReviews, printMovieReviews);
        MovieUser movieUser = new MovieUser(userCommandBoundary);
        MovieSearchRequest starWarsRequest = new MovieSearchRequest("StarWars");
        MovieSearchRequest starTreckRequest = new MovieSearchRequest("StarTreck");

        System.out.println("Displaying reviews for movie " + starTreckRequest.getMovieName());
        movieUser.processInput(starTreckRequest);
        System.out.println("Displaying reviews for movie " + starWarsRequest.getMovieName());
        movieUser.processInput(starWarsRequest);
    }

}

ما يمكن تحسينه وتغييره

• في تنفيذنا ، يمكنك التبديل بسهولة من مخزن بيانات إلى آخر. يمكن إدخال تطبيق التخزين في الشفرة دون تغيير منطق الأعمال. على سبيل المثال ، يمكنك نقل البيانات من الذاكرة إلى قاعدة بيانات عن طريق كتابة محول قاعدة بيانات.
• بدلاً من الإخراج إلى وحدة التحكم ، يمكنك تنفيذ "طابعة" ، والتي ستكتب البيانات إلى ملف. في مثل هذا التطبيق متعدد الطبقات ، يصبح من الأسهل إضافة وظائف وإصلاح الأخطاء.
• لاختبار منطق الأعمال ، يمكنك كتابة اختبارات معقدة. يمكن اختبار المحولات في عزلة. وبالتالي ، من الممكن زيادة تغطية الاختبار الإجمالية.

استنتاج

• المرافقة - الطبقات المقترنة بشكل فضفاض ومستقلة. يصبح من السهل إضافة ميزات جديدة إلى طبقة واحدة دون التأثير على طبقات أخرى.
• قابلية الاختبار - تتم كتابة اختبارات الوحدة ببساطة وبسرعة. يمكنك كتابة اختبارات لكل طبقة باستخدام كائنات كعب تحاكي التبعيات. على سبيل المثال ، يمكننا إزالة التبعية لقاعدة البيانات عن طريق إنشاء مستودع بيانات في الذاكرة.
• القدرة على التكيف - يصبح منطق العمل الرئيسي مستقلاً عن التغييرات في الكائنات الخارجية. على سبيل المثال ، إذا كنت بحاجة إلى الترحيل إلى قاعدة بيانات أخرى ، فلن نحتاج إلى إجراء تغييرات على المجال. يمكننا عمل محول مناسب لقاعدة البيانات.

المراجع

• العمارة السداسية (أليستير كوكبيرن)
• العمارة السداسية - ويكي
• هندسة الموانئ والمحولات
• Giphy