Our newest documentation team member, Martin "MC" Brown has finished the often thankless task of refreshing and expanding our API documentation, which includes Connector/J. I suggest you take a look, as you can now find nice "nuggets" like how to use com.mysql.jdbc.ReplicationDriver to do load-balanced reads across a farm of slave replicas.
Also of note is a plugin for Eclipse that allows you to access the entire MySQL Reference Manual from inside your IDE (which happens to be the IDE that a majority of the Java developers inside MySQL use too!)