wiki:GoodCodeExamples

Version 13 (modified by meddle, 16 years ago) (diff)

--

Here we will be adding examples of good code, if you want to add somethings, please talk with the integrators first.

  • Example for good equals method.
    • You can use the mouse-right-button menu in the source code area of eclipse -> Source -> "Generate hashCode() and equals()..." for template, but refactor it to look like the example bellow:
              @Override
      	public boolean equals(Object object) {
      		
      		if (object == null) {
      			return false;
      		}
      		
      		if (object == this) {
      			return true;
      		}
      		
      		if (object.getClass() != this.getClass()) {
      			return false;
      		}
      		
      		// Custom code here...
      	}
      
  • Writing if, else, else if, for, while, do while, try, catch, finally statements, blocks.
    • First of all always put curly brackets after the special word that opens the statement, even if the statement contains one row.
      		if (some_condition) {
      			System.out.println("pass");
      		}
      
    • Insert spaces between the brackets and the words. The opening bracket of a statement is on the row where the statement is!
      		while (some_condition) {
                              // something...
      		}
      
    • When writing conditions put spaces between the operands and the operators!
      		if (a != b) {
      			System.out.println("a is not the same as b");
      		}
      
    • if-else if- else example:
      		if (a != b) {
      			// something...
      		} else if (c != d) {
      			// other thing...			
      		} else if ((b == c) && (a == d)) {
      			// third thing, I put the brackets for easier reading, they are not mandatory.
      		} else {
      			// four...
      		}
      
    • for examples
                      for (i = 0; i < n; i++) {
      			// do something...
      		}
      
                      for (Some_iterable_type some_var : some_iterable) {
      			// do something...
      		}
      
    • try-catch-finally... The same as the above as spacing and etc...
                      try {
      			// some code
      		} catch (Exception e) {
      			// handle exception
      		} finally {
      			// some stuff
      		}
      
  • Don't use @SuppressWarnings("all"), @SuppressWarnings("synthetic-access"), etc.. or use them rarely only when needed!