Contoh arsitektur heksagonal di Jawa

Pengantar Arsitektur Heksagonal

• Domain . Lapisan berisi logika bisnis inti. Dia tidak perlu mengetahui detail implementasi lapisan luar.
• Aplikasi . Lapisan bertindak sebagai jembatan antara lapisan domain dan infrastruktur.
• Infrastruktur . Implementasi interaksi domain dengan dunia luar. Lapisan dalam terlihat seperti kotak hitam baginya.

Contoh

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")));
    }
}

Domain

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;
    }
}

Kontrol Port Adapters

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);
    }
}

aplikasi

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);
    }

}

Apa yang bisa diperbaiki, diubah

• Dalam implementasi kami, Anda dapat dengan mudah beralih dari satu penyimpanan data ke yang lain. Implementasi penyimpanan dapat disuntikkan ke dalam kode tanpa mengubah logika bisnis. Misalnya, Anda dapat mentransfer data dari memori ke database dengan menulis adaptor basis data.
• Alih-alih output ke konsol, Anda dapat menerapkan "printer", yang akan menulis data ke file. Dalam aplikasi multi-layer, menjadi lebih mudah untuk menambahkan fungsionalitas dan memperbaiki bug.
• Untuk menguji logika bisnis, Anda dapat menulis tes kompleks. Adaptor dapat diuji secara terpisah. Dengan demikian, dimungkinkan untuk meningkatkan cakupan tes secara keseluruhan.

Kesimpulan

• Pengiring - lapisan longgar dan independen. Menjadi mudah untuk menambahkan fitur baru ke satu lapisan tanpa mempengaruhi lapisan lainnya.
• Testability - unit test ditulis sederhana dan cepat dilakukan. Anda dapat menulis tes untuk setiap lapisan menggunakan objek rintisan yang mensimulasikan dependensi. Misalnya, kita bisa menghapus ketergantungan pada database dengan membuat data warehouse di memori.
• Kemampuan beradaptasi - logika bisnis utama menjadi independen dari perubahan objek eksternal. Misalnya, jika Anda perlu bermigrasi ke database lain, maka kami tidak perlu melakukan perubahan pada domain. Kita dapat membuat adaptor yang sesuai untuk basis data.

Referensi

• Arsitektur Heksagonal (Alistair Cockburn)
• Arsitektur Hexagonal-Wiki
• Arsitektur Ports Dan Adapters
• Giphy