Difference between revisions of "Coding guideline"
(2 intermediate revisions by the same user not shown) | |||
Line 14: | Line 14: | ||
camel case + (reduced) hungarian notation = ARS coding guidline | camel case + (reduced) hungarian notation = ARS coding guidline | ||
− | example camel case: clsHeimoZeilinger (new word --> capital letter)\\ | + | *example camel case: clsHeimoZeilinger (new word --> capital letter)\\ |
− | example hungarian : mnCountOfHeimos (m for member, n typeof integer)\\ | + | *example hungarian : mnCountOfHeimos (m for member, n typeof integer)\\ |
− | + | *[[http://en.wikipedia.org/wiki/Hungarian_notation|Hungarian notation - Wikipedia]] | |
Basics in (reduced) hungarian notation: | Basics in (reduced) hungarian notation: | ||
1st letter: | 1st letter: | ||
− | + | ||
− | + | *m ... member | |
− | + | *p ... method parameter | |
− | + | *i ... interface parameter | |
− | + | *s ... static variable | |
− | + | *blank ... function scope | |
− | + | ||
− | + | ||
2nd letter: | 2nd letter: | ||
− | + | ||
− | b ... boolean | + | *b ... boolean |
− | e ... enum | + | *e ... enum |
− | n ... number (integer, long) | + | *n ... number (integer, long) |
− | r ... real (floating point, double) | + | *r ... real (floating point, double) |
− | o ... object (also string) | + | *o ... object (also string) |
− | g ... generic | + | *g ... generic |
− | + | ||
− | + | ||
===== File notation (java/eclipse) ===== | ===== File notation (java/eclipse) ===== | ||
− | clsXYZ ... Classe Files | + | *clsXYZ ... Classe Files |
− | XYZ ... Class Files that contain the method //public static main(String args[])// and that are meant to be used to start the application | + | *XYZ ... Class Files that contain the method //public static main(String args[])// and that are meant to be used to start the application |
− | itfXYZ ... Java Interface | + | *itfXYZ ... Java Interface |
− | tstXYZ ... junit Test Cases | + | *tstXYZ ... junit Test Cases |
− | tssXYZ ... junit Test Suites | + | *tssXYZ ... junit Test Suites |
Latest revision as of 17:01, 2 January 2013
Contents
Coding guidlines
General Conventions
* Comment your code (documentation_guidelines) * One File - One Class * Don't add packages with a wildcard (e.g. java.lang.* - instead always type the whole package name java.lang.Integer) * Produce readable code * Produce efficient code * (in this order - first readability, then efficiency)
Naming Conventions
camel case + (reduced) hungarian notation = ARS coding guidline
- example camel case: clsHeimoZeilinger (new word --> capital letter)\\
- example hungarian : mnCountOfHeimos (m for member, n typeof integer)\\
- [notation - Wikipedia]
Basics in (reduced) hungarian notation:
1st letter:
- m ... member
- p ... method parameter
- i ... interface parameter
- s ... static variable
- blank ... function scope
2nd letter:
- b ... boolean
- e ... enum
- n ... number (integer, long)
- r ... real (floating point, double)
- o ... object (also string)
- g ... generic
File notation (java/eclipse)
- clsXYZ ... Classe Files
- XYZ ... Class Files that contain the method //public static main(String args[])// and that are meant to be used to start the application
- itfXYZ ... Java Interface
- tstXYZ ... junit Test Cases
- tssXYZ ... junit Test Suites