Hoppa till innehållet

Inkompatibel ändring

En ändring som gör att tidigare stödda konsumenter eller användningar inte längre fungerar enligt överenskommelsen.

Även känt somBreaking Change
Mjukvaruarkitektur

Ett befintligt löfte ändras inkompatibelt

En inkompatibel ändring förändrar ett kontrakt som stöds så att befintliga konsumenter måste anpassas eller förlorar överenskommet beteende. Det kan gälla dataformat, obligatorisk indata eller betydelsen av ett resultat.

I ett påhittat exempel tar ett uppdrags-API bort det tidigare utlovade fältet orderId. En rapport som behöver fältet kan inte längre identifiera uppdraget. Ett internt namnbyte utan effekt på det offentliga kontraktet vore inte ett sådant brott. Kontrollera berörda konsumenter, övergång och kommunikation före lansering. Ett nytt versionsnummer anpassar inte konsumenten automatiskt. Även ett oförändrat svarsformat kan innehålla en inkompatibel ändring i verksamhetsbeteendet.

Källor