[DERBY-7032] Developer's Guide recommends use of a deprecated method

• Type: Bug
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Affects Version/s: 10.15.2.0, 10.16.1.1
• Component/s: Documentation, JDBC
• Urgency: Normal
• Assignee: Unassigned
• Reporter: Richard N. Hillegas
• Created: 27/Jan/19 23:58
• Updated: 29/Jan/19 14:51

Description

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.

Issue Links

• relates to: DERBY-7031 Errors running upgrade tests from 10.15.1.0 release candidate to 10.16 trunk