Code moderniseren met behoud van afgesproken interfaces
Een vernieuwde component werkt intern, maar een andere applicatie begrijpt het antwoord niet meer. Code moderniseren in Nijmegen neemt bestaande afnemers mee in de wijziging. Radorfa onderzoekt het gebruikte interfacecontract: welke invoer, uitvoer en fouten zijn afgesproken? We vernieuwen de code en testen de relevante koppelingen met herkenbare voorbeelden.
1Onderzoek wat afnemers verwachten
We inventariseren API-routes, gegevensvelden, versies en gebruikte clients. Radorfa kijkt ook naar lege waarden, sortering en foutcodes. Een technische beschrijving vertelt niet altijd hoe een afnemer het resultaat werkelijk gebruikt. Daarom vergelijken we documentatie met een gecontroleerd gebruiksvoorbeeld en leggen verschillen voor aan de eigenaar van de koppeling.
2Begrens de verandering
Radorfa bepaalt welke codewijziging binnen het bestaande contract past en welke verandering een aparte versie vraagt. Interne componenten krijgen duidelijke aansluitpunten. Nieuwe velden of standaardwaarden worden beoordeeld op gevolgen voor bestaande afnemers. Een extra veld is niet in iedere omgeving vanzelf onschadelijk; de daadwerkelijke verwerking blijft onderdeel van de compatibiliteitsproef.
3Test met een bestaande afnemer
De proef gebruikt normale aanvragen, ontbrekende velden en een afgesproken foutgeval. Radorfa vergelijkt berichten en verwerking in de ontvangende applicatie. We testen waar relevant een oudere ondersteunde client. Het resultaat maakt zichtbaar welke combinatie is gecontroleerd en voor welke afnemer nog aanvullende afstemming nodig is vóór ingebruikname van de nieuwe codeversie.
Bestaande werking aantoonbaar controleren
We bewaren aanvraagvoorbeeld, verwachte reactie, clientversie en codeversie. Radorfa controleert gegevensformaat én betekenis van foutuitkomsten. Een antwoord met een succesvolle HTTP-status kan nog onbruikbare gegevens bevatten. De acceptatie bevat daarom ook het resultaat dat de ontvangende applicatie met het bericht daadwerkelijk heeft verwerkt.
Onderhoud na de wijziging
Radorfa legt ondersteunde combinaties en wijzigingsafspraken vast. Nieuwe afnemers krijgen eigen controlevoorbeelden. Wanneer een oude interface moet verdwijnen, wordt dat als aparte beslissing met betrokken partijen behandeld. De beheerroute bevat logreferenties en versie-informatie, zodat een probleem niet alleen als algemene fout in de koppeling blijft liggen.
Code en technische controlepunten
API, bronapplicatie, clientversie, berichtschema, componentinterface, foutcode en contracttest.
Welke wijziging blijft nu liggen?
Welke koppeling mag door een codewijziging niet onverwacht veranderen? Radorfa helpt afspraken en afnemers in de modernisering meenemen.
Bespreek uw bestaande code