Developer's Guide recommends use of a deprecated method

The "Shutting down the system" topic in the Developer's Guide (and probably other places in the user documentation) recommends the following pattern for re-loading the engine driver after it was unloaded by a graceful system shutdown:

Class.forName("org.apache.derby.jdbc.EmbeddedDriver").newInstance();

However, if you use Java 9 or later to compile an application which follows that pattern, then you will get a deprecation warning. That is because Java 9 deprecated Class.newInstance(). Some future rev of the JDK may remove the method altogether.

This issue was discovered while investigating DERBY-7031.