Revision as of 17:06, 19 March 2014

Java 8

Summary

Make Java 8 (OpenJDK 8 which is java-1.8.0-openjdk) the default Java runtime. The current default Java runtime (OpenJDK 7, java-1.7.0-openjdk) will be obsoleted and removed.

This is essentially an upgrade of OpenJDK to the latest version.

Owner

Name: Omair Majid
Email: omajid@redhat.com
Release notes owner:

Current status

Targeted release: Fedora 21
Last updated: 2014-03-19
Tracker bug: <will be assigned by the Wrangler>

Detailed Description

The current default Java 7 runtime in Fedora is OpenJDK 7. The latest version of OpenJDK, 8, was released on 18 March 2014. Given that Fedora 21 will not be released before August, it makes sense to include the latest version of OpenJDK in Fedora 21.

OpenJDK 8 is a significant update to Java. It brings in significant new features to the Java language, including lambdas, a new javascript engine and lots of new library features. A complete list of features is available.

OpenJDK 8 is a backwards compatible update. Theoretically everything that worked against OpenJDK 7 should continue working against OpenJDK 8. There are a few exceptions:

OpenJDK8 is much more strict when it comes to building javadocs. Many -javadoc package in Fedora fail to build. Those that are built should continue working just fine.
Packages that rely on non-public OpenJDK API may fail to build/run.

A complete list of incompatibilities is avilable. The incompatibilities are source and behavioural only.

It may be a good idea to mass rebuild Java packages against OpenJDK 8 to spot any source compatiblities earlier. This is not required.

Benefit to Fedora

Shipping the latest version of OpenJDK works towards the Fedora goal of "First". OpenJDK 8 brings significant new features to the Java language and libraries and platform. Soon, programmers will want to use these Java features and Fedora should provide them. Sooner or later, upstream projects will start to require Java 8.

If what happended with OpenJDK 6 is going to repeat, then development of OpenJDK 7 will stop before (or just around the time) Fedora 21 is End-of-Life'ed and security patches may not be backported to OpenJDK 7 (or if they are, they will be significantly delayed). If Fedora 21 ships with OpenJDK 7, this will leave users vulnerable to exploits.

Scope

Proposal owners:
- Deprecate/Obsolete java-1.7.0-openjdk
- Promote java-1.8.0-openjdk to a full java runtime status (fix provides in package)
- In case of a mass rebuild, supply/apply patches to fix build against OpenJDK 8

Other developers:
- icedtea-web maintainers will need to update icedtea-web to run against OpenJDK 8
- Other java packagers will need to apply patches to their java package to ensure they can build against OpenJDK 8
- Everyone will need to test packages to verify that they work against OpenJDK 8

Release engineering:
- Remove java-1.7.0-openjdk
- Possibly mass-rebuild (?) all Java packages. This is not strictly required to make OpenJDK 8 the default Java runtime.

Policies and guidelines:
- Many -javadoc packages fail to build. The OpenJDK 8 maintainers and the Java SIG are working on identifying a solution. The solution may require guideline changes making -javadoc subpackages optional.

Upgrade/compatibility impact

Upgrades from previous Fedora versions should be seamless. java-1.8.0-openjdk will replace java-1.7.0-openjdk.

OpenJDK 8 is a backwards compatible update. Code that worked against OpenJDK 7 should continue to run against OpenJDK 8.

Customizations of OpenJDK 7 will be lost with an update to OpenJDK 8.

How To Test

This is a software only change. The results should be consistent across all architectures (i686, x86_64, armv7, aarch64) and hardware.

0. What special hardware / data / etc. is needed (if any)? Answer: None

1. How do I prepare my system to test this change? What packages need to be installed, config files edited, etc.? Answer: Install any Java package (ant,maven, eclipse are good candidates).

2. What specific actions do I perform to check that the change is working like it's supposed to? Answer: Run the java package you installed in step 1.

3. What are the expected results of those actions? Answer: java-1.8.0-openjdk (or java-1.8.0-openjdk-headless) should be installed as a dependency. The Java application you installed should work like it does normally.

User Experience

This change to the Java runtime should be mostly invisible to a user.

Java developers will notice that a newer version of Java is packaged. Java applications will run on top of the latest Java runtime.

Dependencies

Contingency Plan

Contingency mechanism:
- Leave OpenJDK 7 as the default Java SDK and runtime.
- Ship OpenJDK 8 as a leaf package.
- *If* a mass rebuild was done, rebuild Java packages against OpenJDK 7
Contingency deadline: 2014-08-01
Blocks release? No
Blocks product? TODO

Documentation

Java 8 Release Notes. Please note that these release notes refer to a few proprietary components (including JavaFX, Deployment, Java DB and Java Mission Control) that are not included in Fedora packages.
OpenJDK 8 Features
Deveopment timeline

Release Notes

Java 8 Release notes
User customizations made to java-1.7.0-openjdk (specifically, to files under /usr/lib/jvm/java-1.7.0*/*) will not be carried across to java-1.8.0-openjdk.

@@ Line 5: / Line 5: @@
 == Summary ==
-Make Java 8 (OpenJDK 8, <code>java-1.8.0-openjdk</code>) the default Java runtime. The current default Java runtime (OpenJDK 7, <code>java-1.7.0-openjdk</code>) will be removed.
+Make Java 8 (OpenJDK 8 which is <code>java-1.8.0-openjdk</code>) the default Java runtime. The current default Java runtime (OpenJDK 7, <code>java-1.7.0-openjdk</code>) will be obsoleted and removed.
-This is  essentially an upgrade of OpenJDK.
+This is essentially an upgrade of OpenJDK to the latest version.
 == Owner ==
@@ Line 24: / Line 24: @@
 == Current status ==
 * Targeted release: [[Releases/21 | Fedora 21 ]]
-* Last updated: 2014-03-13
+* Last updated: 2014-03-19
 <!-- After the change proposal is accepted by FESCo, tracking bug is created in Bugzilla and linked to this page
 Bugzilla states meaning as usual:
@@ Line 36: / Line 36: @@
 == Detailed Description ==
-The current default Java 7 runtime in Fedora is OpenJDK 7. The latest version of OpenJDK, 8, is to be released by the end of March 2014. Given that Fedora 21 will not be released before August, it makes sense to include the latest version of OpenJDK in Fedora 21.
+<!-- Expand on the summary, if appropriate.  A couple sentences suffices to explain the goal, but the more details you can provide the better. -->
+The current default Java 7 runtime in Fedora is OpenJDK 7. The latest version of OpenJDK, 8, was released on 18 March 2014. Given that Fedora 21 will not be released before August, it makes sense to include the latest version of OpenJDK in Fedora 21.
 OpenJDK 8 is a significant update to Java. It brings in significant new features to the Java language, including lambdas, a new javascript engine and lots of new library features. A [http://openjdk.java.net/projects/jdk8/features complete list of features] is available.
-OpenJDK 8 is a backwards compatible update. Theoreticallyn everything that worked against OpenJDK 7 should continue working against OpenJDK 8. There are a few exceptions:
+OpenJDK 8 is a backwards compatible update. Theoretically everything that worked against OpenJDK 7 should continue working against OpenJDK 8. There are a few exceptions:
 * OpenJDK8 is much more strict when it comes to building javadocs. Many <code>-javadoc</code> package in Fedora fail to build. Those that are built should continue working just fine.
 * Packages that rely on non-public OpenJDK API may fail to build/run.
-<!-- Expand on the summary, if appropriate.  A couple sentences suffices to explain the goal, but the more details you can provide the better. -->
+A complete [http://www.oracle.com/technetwork/java/javase/8-compatibility-guide-2156366.html list of incompatibilities is avilable]. The incompatibilities are source and behavioural only.
+It may be a good idea to mass rebuild Java packages against OpenJDK 8 to spot any source compatiblities earlier. This is not required.
 == Benefit to Fedora ==
 <!-- What is the benefit to the platform?  If this is a major capability update, what has changed?  If this is a new functionality, what capabilities does it bring? Why will Fedora become a better distribution or project because of this proposal?-->
-Shipping the latest version of OpenJDK works towards the Fedora goal of "First". OpenJDK 8 brings significant new features to the Java language and libraries and platform.
+Shipping the latest version of OpenJDK works towards the Fedora goal of "First". OpenJDK 8 brings significant new features to the Java language and libraries and platform. Soon, programmers will want to use these Java features and Fedora should provide them. Sooner or later, upstream projects will start to require Java 8.
-If what happended with OpenJDK 6 is going to repeat, then development of OpenJDK 7 will stop before Fedora 21 is End-of-Life'ed and security patches may not be backported to OpenJDK 7 (or if they are, they will be severly delayed). If Fedora 21 ships with OpenJDK 7, this will leave users vulnerable to exploits.
+If what happended with OpenJDK 6 is going to repeat, then development of OpenJDK 7 will stop before (or just around the time) Fedora 21 is End-of-Life'ed and security patches may not be backported to OpenJDK 7 (or if they are, they will be significantly delayed). If Fedora 21 ships with OpenJDK 7, this will leave users vulnerable to exploits.
 == Scope ==
@@ Line 58: / Line 62: @@
 * Proposal owners:
 <!-- What work do the feature owners have to accomplish to complete the feature in time for release?  Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?-->
 ** Deprecate/Obsolete <code>java-1.7.0-openjdk</code>
-** Promote <code>java-1.8.0-openjdk</code> to a full java runtime status
+** Promote <code>java-1.8.0-openjdk</code> to a full java runtime status (fix provides in package)
 ** In case of a mass rebuild, supply/apply patches to fix build against OpenJDK 8
 * Other developers:
 <!-- What work do other developers have to accomplish to complete the feature in time for release?  Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?-->
 ** <code>icedtea-web</code> maintainers will need to update <code>icedtea-web</code> to run against OpenJDK 8
-** Other java packagers will need to apply patches to their java package to ensure they build against OpenJDK 8
+** Other java packagers will need to apply patches to their java package to ensure they can build against OpenJDK 8
 ** Everyone will need to test packages to verify that they work against OpenJDK 8
-* Release engineering: N/A (not a System Wide Change)  <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
+* Release engineering:
 <!-- Does this feature require coordination with release engineering (e.g. changes to installer image generation or update package delivery)?  Is a mass rebuid required?  If a rel-eng ticket exists, add a link here.  -->
 ** Remove <code>java-1.7.0-openjdk</code>
-** Mass-rebuild (?) all package related to java
+** Possibly mass-rebuild (?) all Java packages. This is not strictly required to make OpenJDK 8 the default Java runtime.
-* Policies and guidelines: N/A (not a System Wide Change) <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
+* Policies and guidelines:
 <!-- Do the packaging guidelines or other documents need to be updated for this feature?  If so, does it need to happen before or after the implementation is done?  If a FPC ticket exists, add a link here. -->
-** Most <code>-javadoc</code> packages fail to build. The OpenJDK 8 maintainers and the Java SIG is working on identifying a solution. The solution may require guideline changes making <code>-javadoc</code> subpackages optional.
+** Many <code>-javadoc</code> packages fail to build. The OpenJDK 8 maintainers and the Java SIG are working on identifying a solution. The solution may require [https://lists.fedoraproject.org/pipermail/devel/2014-March/196808.html guideline changes making <code>-javadoc</code> subpackages optional].
 == Upgrade/compatibility impact ==
@@ Line 84: / Line 88: @@
 OpenJDK 8 is a backwards compatible update. Code that worked against OpenJDK 7 should continue to run against OpenJDK 8.
-TODO: Add more impact concerns.
+Customizations of OpenJDK 7 will be lost with an update to OpenJDK 8.
 == How To Test ==
@@ Line 90: / Line 94: @@
 Remember that you are writing this how to for interested testers to use to check out your change implementation - documenting what you do for testing is OK, but it's much better to document what *I* can do to test your change.
+-->
-A good "how to test" should answer these four questions:
+This is a software only change. The results should be consistent across all architectures (i686, x86_64, armv7, aarch64) and hardware.
 . What special hardware / data / etc. is needed (if any)?
+Answer: None
 . How do I prepare my system to test this change? What packages
 need to be installed, config files edited, etc.?
+Answer: Install any Java package (<code>ant</code>,<code>maven</code>, <code>eclipse</code> are good candidates).
 . What specific actions do I perform to check that the change is
 working like it's supposed to?
+Answer: Run the java package you installed in step 1.
 . What are the expected results of those actions?
--->
+Answer: <code>java-1.8.0-openjdk</code> (or <code>java-1.8.0-openjdk-headless</code>) should be installed as a dependency. The Java application you installed should work like it does normally.
-<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
-'''TODO'''
 == User Experience ==
-<!-- If this change proposal is noticeable by its target audience, how will their experiences change as a result?  Describe what they will see or notice. -->
-<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
 This change to the Java runtime should be mostly invisible to a user.
-Java developers will notice that a newer version of Java is packaged.
+Java developers will notice that a newer version of Java is packaged. Java applications will run on top of the latest Java runtime.
 == Dependencies ==
@@ Line 116: / Line 122: @@
 <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
-None (not a System Wide Change)
 == Contingency Plan ==
 <!-- If you cannot complete your feature by the final development freeze, what is the backup plan?  This might be as simple as "Revert the shipped configuration".  Or it might not (e.g. rebuilding a number of dependent packages).  If you feature is not completed in time we want to assure others that other parts of Fedora will not be in jeopardy.  -->
-'''TODO'''
-* Contingency mechanism: (What to do?  Who will do it?) N/A (not a System Wide Change)  <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
+* Contingency mechanism:
-<!-- When is the last time the contingency mechanism can be put in place?  This will typically be the beta freeze. -->
+** Leave OpenJDK 7 as the default Java SDK and runtime.
-* Contingency deadline: N/A (not a System Wide Change)  <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
+** Ship OpenJDK 8 as a leaf package.
-<!-- Does finishing this feature block the release, or can we ship with the feature in incomplete state? -->
+** *If* a mass rebuild was done, rebuild Java packages against OpenJDK 7
-* Blocks release? N/A (not a System Wide Change), Yes/No <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
+* Contingency deadline: 2014-08-01
-* Blocks product? product <-- Applicable for Changes that blocks specific product release/Fedora.next -->
+* Blocks release? No
+* Blocks product? TODO
 == Documentation ==
-<!-- Is there upstream documentation on this change, or notes you have written yourself?  Link to that material here so other interested developers can get involved. -->
+<!-- Is there upstream documentation on this change, or notes you have written yourself? -->
+* [http://www.oracle.com/technetwork/java/javase/8train-relnotes-latest-2153846.html Java 8 Release Notes]. Please note that these release notes refer to a few proprietary components (including JavaFX, Deployment, Java DB and Java Mission Control) that are not included in Fedora packages.
 * [http://openjdk.java.net/projects/jdk8/features OpenJDK 8 Features]
 * [http://openjdk.java.net/projects/jdk8/ Deveopment timeline]
@@ Line 142: / Line 148: @@
 Release Notes are not required for initial draft of the Change Proposal but has to be completed by the Change Freeze.
 -->
+* [http://www.oracle.com/technetwork/java/javase/8train-relnotes-latest-2153846.html Java 8 Release notes]
+* User customizations made to java-1.7.0-openjdk (specifically, to files under <code>/usr/lib/jvm/java-1.7.0*/*<code>) will not be carried across to java-1.8.0-openjdk.
 [[Category:ChangePageIncomplete]]
@@ Line 149: / Line 158: @@
 <!-- After review, the Wrangler will move your page to Category:ChangeReadyForFesco... if it still needs more work it will move back to Category:ChangePageIncomplete-->
-<!-- Select proper category, default is Self Contained Change -->
+[[Category:SystemWideChange]]
-[[Category:SelfContainedChange]]
-<!-- [[Category:SystemWideChange]] -->

Search

Changes/Java8: Difference between revisions