Kodningsstandarder og konventioner for programmeringssprog såsom Java er designet til at forbedre kvaliteten og pålideligheden af applikationer bygget bruge disse sprog. Java projekter er ofte store, med varierende komponenter arbejdet på en række forskellige udviklere. Under et fælles sæt af praksis betyder, at udviklere kan arbejde med alles kode mere effektivt , da koden er klarere og lettere at læse. Navngivning
Java konventioner dikterer visse regler for navngivning program elementer som variabler , klasser , objekter , pakker og grænseflader blandt andre. CamelCase bruges i de fleste tilfælde som i følgende eksempler : Hej
//Klasse Navne begynder store bogstaver
Class MinKlasse
//variabler begynder små bogstaver
Object anObject
generelt bruge meningsfulde navne , for eksempel "counter " i stedet for "c" , så folk ( inklusive dig selv) læser din kode kan forstå det lettere.
indrykning
Indrykning er et af de centrale elementer i programmering , som gør koden lettere at læse. Indrykning bør generelt afspejle de logiske strukturer i et program , og hjælper med at identificere oplysninger på et øjeblik , for eksempel omfanget af variabler. Java -konventioner også diktere , hvor pauser bør ske inden indpakkede linjer kode , med de foretrukne linjeskift opstået efter kommaer og før operatører som følger :
aMethod ( parameterOne , parameterTwo , Amerikas
parameterThree ) ;
int answer = itemOne + itemTwo
+ itemThree ; .
anden linje i disse sager bør ideelt komme efter otte pladser
< br > kommentarer
brugen af kommentarer gør hele koden nemmere at arbejde med , især hvis lange eller komplekse algoritmer er involveret. Kode kommentarer i henhold til Java -konventioner bør medtages , før erklæringer om nøglevariabler , metoder, klasser og omstændelige strukturer , såvel som inde alle disse. Brug både single og multi- line kommentarer, der indtræffer på deres egne linjer eller i slutningen af kodelinjer :
/*
* Dette er en kommentar i en blok
* /
//Dette er en enkelt linje kommentar
int counter = 0 //Dette er yderligere oplysninger om linje kode
Dokumentation < br >
Du opretter Java dokumentation primært ved hjælp af javadoc facilitet, der genererer HTML-dokumenter fleste standard Java ressourcer og applikationer forbrug, herunder selve sproget . Du opretter javadoc indhold i kildekoden ved hjælp javadoc kommentarer : Hej
/**
* Dette er en javadoc kommentar
* - bemærk den dobbelte stjerne til at begynde
< p> * /
Når udviklere arbejder med kode , der blev udviklet af en anden, deres første referencepunkt er ofte javadoc , da det giver et overblik over den ressource uden rent faktisk at læse koden selv.
Program Design
p Der er mange konventioner og standarder for gennemførelsen detaljer inden Java-programmer . Et eksempel herpå er den tilgang til at give adgang til de variable i en klasse fra en ekstern kode. (Se Referencer 4 ) Det anbefales generelt at holde klasse variabler private , og give adgang til dem ved hjælp af offentlige metoder. For eksempel, hvis en klasse har en tekststreng instansvariabel navnet " someData " kunne have en metode , der giver adgang til det fra andre steder i ansøgningen : Hej
offentlig string GetData () {return someData ;}