Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Concurrency 3.0 release review #449

Merged
merged 7 commits into from
May 11, 2022
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
49 changes: 32 additions & 17 deletions concurrency/3.0/_index.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,46 @@
---
title: "Jakarta Concurrency 3.0 (Under Development)"
date: 2021-05-20
title: "Jakarta Concurrency 3.0"
date: 2022-02-28
summary: "Jakarta EE 10 Release"
---
Jakarta Concurrency provides a specification for using concurrency from application components without compromising container integrity while still preserving the Jakarta EE platform's fundamental benefits.

# Plan
Jakarta Concurrency 3.0 will target the Jakarta EE 10 platform release.
* [Jakarta Concurrency 3.0 Release Record](https://projects.eclipse.org/projects/ee4j.cu/releases/3.0.0)
* [Jakarta EE Platform 10 Release Plan](https://eclipse-ee4j.github.io/jakartaee-platform/jakartaee10/JakartaEE10ReleasePlan)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be a pointer to the PMI plan (you are welcome to keep this link, but the PMI link is what is asked for in the checklist): https://projects.eclipse.org/projects/ee4j.cu/releases/3.0/plan

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Adding the link that you mentioned, but without removing either of the other links because it is unclear to me which was unnecessary and the 2.0 release review appears to have them both.

* [Jakarta Concurrency 3.0 Specification Document](./jakarta-concurrency-spec-3.0.pdf) (PDF)
* [Jakarta Concurrency 3.0 Specification Document](./jakarta-concurrency-spec-3.0.html) (HTML)
* [Jakarta Concurrency 3.0 Javadoc](./apidocs)
* Jakarta Concurrency 3.0 TCK (includes signature tests) [staging](https://jakarta.oss.sonatype.org/content/groups/staging/jakarta/enterprise/concurrent/jakarta.enterprise.concurrent-tck/3.0.0/)
* [mirrored](https://public.dhe.ibm.com/ibmdl/export/pub/software/olrepo/io/openliberty/jakarta/enterprise/concurrent/jakarta.enterprise.concurrent-tck/3.0.0.20220126/jakarta.enterprise.concurrent-tck-3.0.0.20220126.jar)
* [SHA](https://jakarta.oss.sonatype.org/content/groups/staging/jakarta/enterprise/concurrent/jakarta.enterprise.concurrent-tck/3.0.0/jakarta.enterprise.concurrent-tck-3.0.0.pom.sha1)
* Maven coordinates
* [jakarta.enterprise.concurrent:jakarta.enterprise.concurrent-api:3.0.0](https://search.maven.org/artifact/jakarta.enterprise.concurrent/jakarta.enterprise.concurrent-api/3.0.0/jar) Currently located on [staging](https://jakarta.oss.sonatype.org/content/groups/staging/jakarta/enterprise/concurrent/jakarta.enterprise.concurrent-api/3.0.0/) until release is approved, and then we will push it to Maven.

Jakarta Concurrency 3.0 will aim to contain.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rather than remove the plan I'd recommend either changing this to a list of accomplishments (and move it above the set of release pointers) or, you can refer readers to the Release Record link. If the latter, I would recommend you update the Release Record to state the list of accomplishments/changes. It might be helpful to summarize why this is a major release and provide references to any potential issues that would impact users who intend to upgrade. (Either here, or in the Release Record if you want to just refer readers to that.)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry about that. I had removed the Plan section because it was absent in the 2.0 release review which I was using as a guide, but now I realize it was a bad idea to copy from that because 2.0 didn't actually have any new function and was just the jakarta package rename.

To correct this, I'm following your first option and restoring the Plan section with a list of new features included just prior to the release information.


Features identified by the community on GitHub tagged with 3.0 see 3.0 Milestone (github.com)

Bug Fixes as they arise during the release cycle

Documentation clean up as identified during the release cycle

Any updates required to meet the Java version requirements of Jakarta EE 10

Any requirements identified by other specifications or the Jakarta EE 10 platform projects during the release cycle.

* [Jakarta Concurrency 3.0 Release Record](https://projects.eclipse.org/projects/ee4j.cu/releases/3.0)

# Compatible Implementations

* [Open Liberty 22.0.0.3-beta](https://public.dhe.ibm.com/ibmdl/export/pub/software/openliberty/runtime/beta/2022-02-01_1901/openliberty-22.0.0.3-beta.zip)
* [TCK results on Java 11](https://openliberty.io/certifications/jakartaee/10/concurrency/22.0.0.3-beta-Java11-TCKResults.html)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

TCK results are not necessary. Please remove the TCK result links. The CCR issue reference in the PR is sufficient.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm removing these links. Thanks for pointing it out.

* [TCK results on Java 17](https://openliberty.io/certifications/jakartaee/10/concurrency/22.0.0.3-beta-Java17-TCKResults.html)

# Ballots

## Release Review

The Release Review Specification Committee Ballot needs to be started after the above is completely filled in. Results need to be reported below.

| | Yes | No | Abstain |
|-----------------------|---------|---------|----------|
|Fujitsu | | | |
|IBM | | | |
|Oracle | | | |
|Payara | | | |
|Red Hat | | | |
|Tomitribe | | | |
|EE4J PMC | | | |
|Participant Members | | | |
|Committer Members | | | |

## Plan Review

The Specification Committee Ballot concluded successfully on 2021-05-21 with the following results:
Expand Down
365 changes: 365 additions & 0 deletions concurrency/3.0/apidocs/allclasses-index.html

Large diffs are not rendered by default.

55 changes: 55 additions & 0 deletions concurrency/3.0/apidocs/allclasses.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
<!DOCTYPE HTML>
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc (11.0.2) on Thu Jan 20 20:19:49 UTC 2022 -->
<title>All Classes (jakarta.enterprise.concurrent-api 3.0.0 API)</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="dc.created" content="2022-01-20">
<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
<link rel="stylesheet" type="text/css" href="jquery/jquery-ui.css" title="Style">
<script type="text/javascript" src="script.js"></script>
<script type="text/javascript" src="jquery/jszip/dist/jszip.min.js"></script>
<script type="text/javascript" src="jquery/jszip-utils/dist/jszip-utils.min.js"></script>
<!--[if IE]>
<script type="text/javascript" src="jquery/jszip-utils/dist/jszip-utils-ie.min.js"></script>
<![endif]-->
<script type="text/javascript" src="jquery/jquery-3.3.1.js"></script>
<script type="text/javascript" src="jquery/jquery-migrate-3.0.1.js"></script>
<script type="text/javascript" src="jquery/jquery-ui.js"></script>
</head>
<body>
<h1 class="bar">All&nbsp;Classes</h1>
<main role="main" class="indexContainer">
<ul>
<li><a href="jakarta/enterprise/concurrent/AbortedException.html" title="class in jakarta.enterprise.concurrent">AbortedException</a></li>
<li><a href="jakarta/enterprise/concurrent/Asynchronous.html" title="annotation in jakarta.enterprise.concurrent">Asynchronous</a></li>
<li><a href="jakarta/enterprise/concurrent/Asynchronous.Result.html" title="class in jakarta.enterprise.concurrent">Asynchronous.Result</a></li>
<li><a href="jakarta/enterprise/concurrent/ContextService.html" title="interface in jakarta.enterprise.concurrent"><span class="interfaceName">ContextService</span></a></li>
<li><a href="jakarta/enterprise/concurrent/ContextServiceDefinition.html" title="annotation in jakarta.enterprise.concurrent">ContextServiceDefinition</a></li>
<li><a href="jakarta/enterprise/concurrent/ContextServiceDefinition.List.html" title="annotation in jakarta.enterprise.concurrent">ContextServiceDefinition.List</a></li>
<li><a href="jakarta/enterprise/concurrent/CronTrigger.html" title="class in jakarta.enterprise.concurrent">CronTrigger</a></li>
<li><a href="jakarta/enterprise/concurrent/LastExecution.html" title="interface in jakarta.enterprise.concurrent"><span class="interfaceName">LastExecution</span></a></li>
<li><a href="jakarta/enterprise/concurrent/ManageableThread.html" title="interface in jakarta.enterprise.concurrent"><span class="interfaceName">ManageableThread</span></a></li>
<li><a href="jakarta/enterprise/concurrent/ManagedExecutorDefinition.html" title="annotation in jakarta.enterprise.concurrent">ManagedExecutorDefinition</a></li>
<li><a href="jakarta/enterprise/concurrent/ManagedExecutorDefinition.List.html" title="annotation in jakarta.enterprise.concurrent">ManagedExecutorDefinition.List</a></li>
<li><a href="jakarta/enterprise/concurrent/ManagedExecutors.html" title="class in jakarta.enterprise.concurrent">ManagedExecutors</a></li>
<li><a href="jakarta/enterprise/concurrent/ManagedExecutorService.html" title="interface in jakarta.enterprise.concurrent"><span class="interfaceName">ManagedExecutorService</span></a></li>
<li><a href="jakarta/enterprise/concurrent/ManagedScheduledExecutorDefinition.html" title="annotation in jakarta.enterprise.concurrent">ManagedScheduledExecutorDefinition</a></li>
<li><a href="jakarta/enterprise/concurrent/ManagedScheduledExecutorDefinition.List.html" title="annotation in jakarta.enterprise.concurrent">ManagedScheduledExecutorDefinition.List</a></li>
<li><a href="jakarta/enterprise/concurrent/ManagedScheduledExecutorService.html" title="interface in jakarta.enterprise.concurrent"><span class="interfaceName">ManagedScheduledExecutorService</span></a></li>
<li><a href="jakarta/enterprise/concurrent/ManagedTask.html" title="interface in jakarta.enterprise.concurrent"><span class="interfaceName">ManagedTask</span></a></li>
<li><a href="jakarta/enterprise/concurrent/ManagedTaskListener.html" title="interface in jakarta.enterprise.concurrent"><span class="interfaceName">ManagedTaskListener</span></a></li>
<li><a href="jakarta/enterprise/concurrent/ManagedThreadFactory.html" title="interface in jakarta.enterprise.concurrent"><span class="interfaceName">ManagedThreadFactory</span></a></li>
<li><a href="jakarta/enterprise/concurrent/ManagedThreadFactoryDefinition.html" title="annotation in jakarta.enterprise.concurrent">ManagedThreadFactoryDefinition</a></li>
<li><a href="jakarta/enterprise/concurrent/ManagedThreadFactoryDefinition.List.html" title="annotation in jakarta.enterprise.concurrent">ManagedThreadFactoryDefinition.List</a></li>
<li><a href="jakarta/enterprise/concurrent/SkippedException.html" title="class in jakarta.enterprise.concurrent">SkippedException</a></li>
<li><a href="jakarta/enterprise/concurrent/spi/ThreadContextProvider.html" title="interface in jakarta.enterprise.concurrent.spi"><span class="interfaceName">ThreadContextProvider</span></a></li>
<li><a href="jakarta/enterprise/concurrent/spi/ThreadContextRestorer.html" title="interface in jakarta.enterprise.concurrent.spi"><span class="interfaceName">ThreadContextRestorer</span></a></li>
<li><a href="jakarta/enterprise/concurrent/spi/ThreadContextSnapshot.html" title="interface in jakarta.enterprise.concurrent.spi"><span class="interfaceName">ThreadContextSnapshot</span></a></li>
<li><a href="jakarta/enterprise/concurrent/Trigger.html" title="interface in jakarta.enterprise.concurrent"><span class="interfaceName">Trigger</span></a></li>
<li><a href="jakarta/enterprise/concurrent/ZonedTrigger.html" title="interface in jakarta.enterprise.concurrent"><span class="interfaceName">ZonedTrigger</span></a></li>
</ul>
</main>
</body>
</html>
178 changes: 178 additions & 0 deletions concurrency/3.0/apidocs/allpackages-index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,178 @@
<!DOCTYPE HTML>
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc (11.0.2) on Thu Jan 20 20:19:49 UTC 2022 -->
<title>All Packages (jakarta.enterprise.concurrent-api 3.0.0 API)</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="dc.created" content="2022-01-20">
<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
<link rel="stylesheet" type="text/css" href="jquery/jquery-ui.css" title="Style">
<script type="text/javascript" src="script.js"></script>
<script type="text/javascript" src="jquery/jszip/dist/jszip.min.js"></script>
<script type="text/javascript" src="jquery/jszip-utils/dist/jszip-utils.min.js"></script>
<!--[if IE]>
<script type="text/javascript" src="jquery/jszip-utils/dist/jszip-utils-ie.min.js"></script>
<![endif]-->
<script type="text/javascript" src="jquery/jquery-3.3.1.js"></script>
<script type="text/javascript" src="jquery/jquery-migrate-3.0.1.js"></script>
<script type="text/javascript" src="jquery/jquery-ui.js"></script>
</head>
<body>
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="All Packages (jakarta.enterprise.concurrent-api 3.0.0 API)";
}
}
catch(err) {
}
//-->
var pathtoroot = "./";
var useModuleDirectories = true;
loadScripts(document, 'script');</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<header role="banner">
<nav role="navigation">
<div class="fixedNav">
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a id="navbar.top">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
<a id="navbar.top.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="index.html">Overview</a></li>
<li>Package</li>
<li>Class</li>
<li>Use</li>
<li><a href="overview-tree.html">Tree</a></li>
<li><a href="deprecated-list.html">Deprecated</a></li>
<li><a href="index-all.html">Index</a></li>
<li><a href="help-doc.html">Help</a></li>
</ul>
<div class="aboutLanguage"><br>Jakarta Concurrency API v3.0.0</div>
</div>
<div class="subNav">
<ul class="navList" id="allclasses_navbar_top">
<li><a href="allclasses.html">All&nbsp;Classes</a></li>
</ul>
<ul class="navListSearch">
<li><label for="search">SEARCH:</label>
<input type="text" id="search" value="search" disabled="disabled">
<input type="reset" id="reset" value="reset" disabled="disabled">
</li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_top");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
</div>
<a id="skip.navbar.top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
</div>
<div class="navPadding">&nbsp;</div>
<script type="text/javascript"><!--
$('.navPadding').css('padding-top', $('.fixedNav').css("height"));
//-->
</script>
</nav>
</header>
<main role="main">
<div class="header">
<h1 title="All&amp;nbsp;Packages" class="title">All&nbsp;Packages</h1>
</div>
<div class="allPackagesContainer">
<ul class="blockList">
<li class="blockList">
<table class="packagesSummary">
<caption><span>Package Summary</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Package</th>
<th class="colLast" scope="col">Description</th>
</tr>
<tbody>
<tr class="altColor">
<th class="colFirst" scope="row"><a href="jakarta/enterprise/concurrent/package-summary.html">jakarta.enterprise.concurrent</a></th>
<td class="colLast">
<div class="block">Classes and interfaces that make up the Jakarta Concurrency specification.</div>
</td>
</tr>
<tr class="rowColor">
<th class="colFirst" scope="row"><a href="jakarta/enterprise/concurrent/spi/package-summary.html">jakarta.enterprise.concurrent.spi</a></th>
<td class="colLast">
<div class="block">Interfaces for third-party providers of thread context to implement.</div>
</td>
</tr>
</tbody>
</table>
</li>
</ul>
</div>
</main>
<footer role="contentinfo">
<nav role="navigation">
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a id="navbar.bottom">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
<a id="navbar.bottom.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="index.html">Overview</a></li>
<li>Package</li>
<li>Class</li>
<li>Use</li>
<li><a href="overview-tree.html">Tree</a></li>
<li><a href="deprecated-list.html">Deprecated</a></li>
<li><a href="index-all.html">Index</a></li>
<li><a href="help-doc.html">Help</a></li>
</ul>
<div class="aboutLanguage"><br>Jakarta Concurrency API v3.0.0</div>
</div>
<div class="subNav">
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="allclasses.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_bottom");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
</div>
<a id="skip.navbar.bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
</nav>
<p class="legalCopy"><small>Copyright (c) 2022 Eclipse Foundation. Use is subject to <a href="./doc-files/speclicense.html" target="_top">license terms</a>.</small></p>
</footer>
</body>
</html>