[HBASE-25465] Use javac --release option for supporting cross version compilation

• Type: Improvement
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 3.0.0-alpha-3
• Fix Version/s: 2.5.0, 3.0.0-alpha-3, 2.4.13
• Component/s: create-release
• Hadoop Flags: Reviewed

Release Note

When compiling with java 11 and above, we will use --release 8 to maintain java 8 compatibility.
Also upgrade jackson to 2.13.1 because in hbase-thirdparty 4.1.0 we shade jackson 2.13.1.

• Assignee: Duo Zhang
• Reporter: Andrew Kyle Purtell
• Created: 05/Jan/21 20:22
• Updated: 20/May/22 04:35
• Resolved: 18/May/22 23:30

Description

See https://www.morling.dev/blog/bytebuffer-and-the-dreaded-nosuchmethoderror/

the Java compiler’s --release parameter, which was introduced via JEP 247 ("Compile for Older Platform Versions"), added to the platform also in JDK 9. In contrast to the more widely known pair of --source and --target, the --release switch will ensure that only byte code is produced which actually will be usable with the specified Java version. For this purpose, the JDK contains the signature data for all supported Java versions (stored in the $JAVA_HOME/lib/ct.sym file).

Using one JDK (i.e. Java 11) to build Java 8-and-up and Java 11-and-up compatible release artifacts would reduce some sources of accidental complexity, assuming the --release parameter actually works as advertised. To produce Java 8-and-up compatible artifacts, supply --release=8. To produce Java 11-and-up compatible release artifacts, supply --release=11. Maven activations based on JDK version and command line defined profiles can control what --release parameter, if any, should be passed to the compiler.

Issue Links

• is blocked by: HBASE-26773 [hbase-thirdparty] Introduce a hbase-unsafe module in hbase-thirdparty to remove the direct references of Unsafe in our main code base
• is required by: HBASE-26645 Upgrade create-release to support both JDK8 and JDK11
• links to: GitHub Pull Request #3974
• links to: GitHub Pull Request #4164
• links to: https://github.com/apache/hbase/pull/4439
• links to: JDK-8214165