Some time ago, more than a year probably, a friend recommended me the Domain Storytelling technique. At first, it looks quite simple, and you could say that watching a few pages and examples you will dominate it. Not the case for me, it wasn’t until I read the book from Stefan Hofer and Henning Schwentner that I really understood it.
But before talking about the book, I would like to explain what it is in a nutshell.
I am currently working on a pet project to refresh Java tech-stack knowledge, and I got to this class.
public class RecipesController {
private RecipesCatalog recipesCatalog;
public RecipesController(RecipesCatalog recipesCatalog) {
this.recipesCatalog = recipesCatalog;
}
public List<RecipeResponse> getRecipes(
@RequestParam(defaultValue = "1") int page,
@RequestParam(defaultValue = "10") int size) {
var recipes = recipesCatalog.getRecipes(page, size);
return recipes.stream().map(RecipesController::asRecipeResponse).toList();
}
private static RecipeResponse asRecipeResponse(Recipe recipe) {
return new RecipeResponse(recipe.id(), recipe.name(), recipe.recap());
}
}
It reminded me of the main complaint people tell me about Hexagonal Architecture, the need for boilerplate. Do you see the RecipesController::asRecipeResponse reference? Why not returning just a list of Recipe? Why using mappers all the time? Well, there are a few reasons to do that.
Release It! is a book from Michael Nygard, and everywhere you look, the ratings are very good. At this post I will tell you just one reason (or should I say chapter?) why reading it worth the price and time.