{"id":278,"date":"2026-03-10T15:04:17","date_gmt":"2026-03-10T14:04:17","guid":{"rendered":"https:\/\/test.craftcode.be\/repetitieve-code-wegwerken-met-een-vaak-vergeten-annotatie\/"},"modified":"2026-06-04T12:04:40","modified_gmt":"2026-06-04T10:04:40","slug":"repetitieve-code-wegwerken-met-een-vaak-vergeten-annotatie","status":"publish","type":"post","link":"https:\/\/craftcode.be\/nl\/repetitieve-code-wegwerken-met-een-vaak-vergeten-annotatie\/","title":{"rendered":"Repetitieve code wegwerken met een vaak vergeten annotatie"},"content":{"rendered":"\n

In deze blog focussen we op exception handling binnen Spring-applicaties en hoe een vaak vergeten annotatie helpt om repetitieve code drastisch te verminderen. <\/p>\n\n

Repetitie verwijderen<\/h2>\n\n

Om exceptions af te handelen, wordt vaak gebruikgemaakt van een try\/catch in de controller zodat gebruikers ge\u00efnformeerd worden wanneer de API een probleem tegenkomt. Dat werkt prima, maar zodra applicaties groeien en er meer exceptions bijkomen, raken controllers snel overvol.Onderstaande aanpak toont een basisimplementatie van exception handling. Wanneer er iets fout loopt tijdens het ophalen van berichten, voorziet het Spring Framework standaard al een mechanisme om een response terug te sturen. Je kan hiervoor de standaardboodschap gebruiken via e.getMessage(), of zelf een aangepaste boodschap voorzien.Belangrijk om op te merken: bij deze aanpak moet voor elk endpoint een gelijkaardige catch geschreven worden. <\/p>\n\n

\"\"<\/figure>\n\n

Zoals eerder aangehaald, kost repetitieve code in grotere applicaties met veel controllers en CRUD-operaties enorm veel tijd. Daarom voorziet Spring een meer centrale manier van exception handling. Er bestaat al veel documentatie over dit <\/span>onderwerp<\/a>, maar onderstaande aanpak is gebaseerd op een combinatie van verschillende technieken en tutorials. Uiteraard zijn verdere optimalisaties altijd mogelijk.<\/span><\/p>\n\n

ExceptionHandler<\/h2>\n\n

De eerste stap is het voorzien van een klasse die exceptions afhandelt. Naast een constructor die een dictionary initialiseert, bevat deze klasse methodes die specifieke exceptions verwerken.In dit voorbeeld wordt een MessageBusinessException afgehandeld, maar andere exceptions kunnen eenvoudig toegevoegd worden.De belangrijkste component hier is de annotatie @ControllerAdvice.Met @ControllerAdvice kan globale code toegepast worden op meerdere controllers tegelijk. Exceptions worden centraal afgehandeld over de volledige applicatie heen via \u00e9\u00e9n globale handling component. Op basis van de business exception wordt vervolgens een foutresponse teruggestuurd. <\/p>\n\n

\"\"<\/figure>\n\n

In dit voorbeeld wordt enkel een MessageBusinessException gebruikt, maar in complexere applicaties kunnen uiteraard meerdere exceptiontypes toegevoegd worden. In de controller zelf hoeft bijna niets meer te gebeuren – behalve mogelijk het verwijderen van alle try\/catch-constructies die vervangen worden door deze centrale aanpak. <\/span><\/p>\n\n

Exceptions beheren met key-value pairs<\/h2>\n\n

Voor het opbouwen van foutmeldingen kan gebruikgemaakt worden van een helpermethode zoals createErrorResponse. Deze methode geeft de HttpStatus en response terug. De status en response worden opgehaald uit de ApiErrorDictionar<\/a>y, wat in essentie een onveranderbare map (unmodifiable map) is. Daarbij wordt gebruikgemaakt van een ApiError-model dat in dit voorbeeld enkel een string bevat om een foutboodschap terug te sturen. Het voordeel van deze dictionary is het standaardiseren van responses die op meerdere plaatsen binnen de applicatie terugkomen. In plaats van een onveranderbare map te gebruiken, zouden deze key-value pairs ook uit een database gehaald kunnen worden. Het doel blijft hetzelfde: repetitieve code zoveel mogelijk elimineren – iets wat in complexe applicaties snel kan oplopen <\/p>\n\n

\"\"<\/figure>\n\n

MessageBusinessException<\/h2>\n\n

Er is nog \u00e9\u00e9n extra klasse nodig.Een exception wordt vaak in de service gegooid en reist vervolgens via de controller door naar de gebruiker. Om custom exceptions te kunnen gebruiken, moet een eigen klasse geschreven worden die RuntimeException uitbreidt.Vaak wordt zo\u2019n business exceptionklasse per feature voorzien.In de demo-code maakt deze deel uit van het service package, maar het is evengoed mogelijk om de code per feature te structureren en per feature een eigen business exceptionklasse te voorzien.De MessageBusinessException ziet er ongeveer als volgt uit. <\/p>\n\n

\"\"<\/figure>\n\n

Flow<\/h2>\n\n

Met deze structuur wordt het eenvoudig om nieuwe exceptions toe te voegen.Daarvoor zijn slechts enkele stappen nodig:\u00b7 de business exceptionklasse uitbreiden of aanpassen, \u00b7 een nieuwe key\/value-pair toevoegen aan de ApiErrorDictionary, \u00b7 en de exception gooien vanuit de juiste service. Een eenvoudige aanpak die op termijn heel wat repetitief werk vermijdt. <\/p>\n\n

Git<\/h2>\n\n

Deze tutorial is misschien wat kort, maar de volledige code is terug te vinden op het GitHub-account<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"

Leesbare code blijft \u00e9\u00e9n van de grootste uitdagingen binnen softwareontwikkeling. Functionaliteit snel opleveren krijgt vaak prioriteit, terwijl structuur en onderhoudbaarheid pas later aandacht krijgen. Begrijpelijk – werkende software is belangrijk. Maar hoe groter een applicatie wordt, hoe belangrijker duidelijke en onderhoudbare code wordt.<\/p>\n

Gelukkig bestaan er technieken en tools die helpen om tot clean en schaalbare Java-code te komen. <\/p>\n","protected":false},"author":1,"featured_media":277,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[55],"tags":[56],"class_list":["post-278","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-blog","tag-technologie"],"acf":[],"_links":{"self":[{"href":"https:\/\/craftcode.be\/nl\/wp-json\/wp\/v2\/posts\/278","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/craftcode.be\/nl\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/craftcode.be\/nl\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/craftcode.be\/nl\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/craftcode.be\/nl\/wp-json\/wp\/v2\/comments?post=278"}],"version-history":[{"count":1,"href":"https:\/\/craftcode.be\/nl\/wp-json\/wp\/v2\/posts\/278\/revisions"}],"predecessor-version":[{"id":279,"href":"https:\/\/craftcode.be\/nl\/wp-json\/wp\/v2\/posts\/278\/revisions\/279"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/craftcode.be\/nl\/wp-json\/wp\/v2\/media\/277"}],"wp:attachment":[{"href":"https:\/\/craftcode.be\/nl\/wp-json\/wp\/v2\/media?parent=278"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/craftcode.be\/nl\/wp-json\/wp\/v2\/categories?post=278"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/craftcode.be\/nl\/wp-json\/wp\/v2\/tags?post=278"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}