JMRI: Recommended Practices

This is page of miscellaneous info and pointers for JMRI developers.

Class Library Preferences

We use Java Swing for our GUI development. It's a lot more powerful than the original AWT, and the price is right. We have a recommended organization and usage pattern that's documented on another page.
JMRI uses the RXTX libraries to support serial communications on Macintosh, Linux and Windows. On Windows only, the Serialio package from Serialio.com is also used to be able to use the MS100 baud rate. To do this, the jmri.jmrix.loconet.ms100.MS100Adapter class was converted to use Java reflection to decide which whether the Serialio package is available; on other systems, it uses RXTX. Note that our license for Serialio limits it to this use only; we are not permitted to distribute the libraries for other purposes.
Take a few moments to learn about the the different types of Java collections that are available (List, HashMap, etc) in the java.util package. Not everything needs to be a Vector or an array!
JMRI uses Java generics extensively to reduce errors and improve understanding. With lots of people writing and sharing code, using generics instead of casts makes it much easier to understand the code, and allows the compiler to catch many misunderstandings about how things should be used. Most of the important information on them can be found on this page from the Java Tutorial.
If you need to use comma-separated variable (CSV) files, please use the javacsv API if possible. We are already using that in a number of places, and will probably use it in more. If that doesn't provide enough functionality, we might eventually move to the opencsv API, but since we only want to use one, the conversion will be a lot of work.

Code Format

The Java recommendations for names, formatting, etc are really useful. If you find that you can't read a piece of code, these will help make it better.