DERBY-5840: Clean up compiler warnings introduced by using Java 5 language features

Clean up warnings in jdbcapi test suite, and some classes that the
jdbcapi tests depend on in the upgrade test suite.