The source code of the Pi4J library is documented with JavaDoc. If you use the library in your IDE, you can download the library sources to have more code hints while coding.
Thanks to APIdia, this documentation is also available online on apidia.net/mvn/com.pi4j/pi4j.