Muidugi, ma struktureeriksin nõutud artikli C#-s aegunud koodi märkimise kohta järgmiselt:
Koodibaaside säilitamise vajadus nõuab sageli muudatusi, olgu selleks siis väikesed muudatused, suuremad tegurid või täielikud eemaldamised. Mõnikord ei pruugi mõned koodi osad tingimata kohe eemaldada, kuigi need pole enam asjakohased ega tõhusad. Need võivad siiski olla omavahel seotud koodibaasi muude osadega või kasutada mõnes pärandsüsteemis. Sellistel juhtudel saame märkida need kooditükid aegunuks.
Tuginemine kontekstis
Tuginemine on tarkvarafunktsioonidele rakendatav olek, mis näitab, et kuigi need on endiselt koodis, peaksid arendajad nende kasutamist vältima – need on väljapääsul. See on tarkvaraarenduse oluline osa, mis aitab aegunud funktsioonidest loobuda. Sisuliselt on koodi osa aegunuks märkimine nagu viitsütikuga pommi tiksumine; see võib veel toimida, kuid selle päevad on loetud ja see on vihje arendajatele, et muutused on peatsed.
[Vananenud] atribuut C#-s
C#-s millegi aegunuks märkimiseks kasutame atribuuti [Aegunud]. See täpsustab, et teatud koodiosa – olgu selleks meetod, klass või kogu liides – on aegunud. Seda atribuuti kasutades anname arendajatele hoiatuse, et on olemas tõhusam alternatiiv, või et see osa koodist eemaldatakse tulevastes versioonides, julgustades neid aegunud jaotise kasutamise järk-järgult lõpetama.
[Aegunud ("ClassName on aegunud, kasutage selle asemel NewClassi.")]
avalik klass klassinimi()
{
// Kood siin…
}
Koodeksi samm-sammult selgitus
Jagame koodi lahti:
1. Atribuut [Aegunud]: See on C#-s eelnevalt loodud atribuut, mida kasutatakse klassi või meetodi aegunuks märkimiseks.
2. Sõnum: Lihtsalt millegi aegunuks märkimisest ei piisa. Peaksime ka näitama, miks see on aegunud, või veel parem, soovitama alternatiivi. Meie teade "ClassName on aegunud, kasutage selle asemel NewClassi". teeb just seda.
Sarnased atribuudid ja teegid
C#-s on vähe muid atribuute, mis sarnanevad atribuudiga [Aegunud], näiteks [Aegunud] ja [Aegub]. Kõik need atribuudid teenivad ühte peamist eesmärki – hoiatada arendajaid koodibaasi muudatuste eest. Samuti aitavad sellised paketid nagu FxCop muu koodianalüüsi ja täiustuste hulgas leida aegunud koodi.
Kodeerimise mood
Nagu pidevalt muutuvas moemaailmas, kus liigume läbi trendide ja liigume vanalt uuele, arenevad ka koodibaasid. Tuginemine on tööriist, mis aitab meil liikuda vananenud koodilt värskema ja tõhusama koodini. See lisab oma koodibaasides toimuvate muudatuste käsitlemisele teatud täpsust. Nii nagu moes, kus liigume hooajalt hooajale sujuvalt, võimaldab aegumine meil tarkvara versioonide vahel sujuvamalt ja turvalisemalt liikuda.
