IntrodUCtion This is the conclusion of a two-part series on Java coding style. In Good Java Style: Part 1
, I introduced my case for writing Java code using good habits, eXPlained why we should care about the way our code looks, and illustrated some general elements of good Java style. In this part, I illustrate more elements of good style and bring my case to a conclusion.
Source Files There are many ways that a Java source file can be organized. Here is one that works well:
File header comment (optional). Package declaration. Blank line or other separator. Import statements. Blank line or other separator. Class(es).
Example 1. Bad File Organization.
package org.rotpad; import java.awt.*; import javax.swing.event.*; import org.javacogs.*; import javax.swing.*; import java.awt.event.*; class Foo { ... } public class RotPad extends JFrame { ... }
/** * RotPad is a simple GUI application for performing rotation ciphers on plain * text. * * @author Thornton Rose * @version 1.0 */ public class RotPad extends JFrame { ... }
