This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/groovy-dev-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 9c86152 2026/03/26 23:09:16: Generated dev website from
groovy-website@b6109ea
9c86152 is described below
commit 9c8615243273bcd329111bab223bb0005729aa1f
Author: jenkins <[email protected]>
AuthorDate: Thu Mar 26 23:09:16 2026 +0000
2026/03/26 23:09:16: Generated dev website from groovy-website@b6109ea
---
blog/groovy-async-await.html | 55 ++++++++++++++++++++++++++++++++++++++------
search/search-index.json | 2 +-
2 files changed, 49 insertions(+), 8 deletions(-)
diff --git a/blog/groovy-async-await.html b/blog/groovy-async-await.html
index 3e18aa1..5a9d266 100644
--- a/blog/groovy-async-await.html
+++ b/blog/groovy-async-await.html
@@ -69,12 +69,12 @@
<h2 id="_introduction">Introduction</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>A proposed enhancement for Groovy adds native
<code>async</code>/<code>await</code> as a
-language-level feature
+<p>A proposed enhancement, targeted for Groovy 6,
+adds native <code>async</code>/<code>await</code> as a language-level feature
(<a href="https://issues.apache.org/jira/browse/GROOVY-9381";>GROOVY-9381</a>,
<a href="https://github.com/apache/groovy/pull/2387";>PR #2387</a>).
Inspired by similar constructs in JavaScript, C#, Kotlin, and Swift,
-the proposal lets you write asynchronous code in a sequential, readable
+the proposal would let you write asynchronous code in a sequential, readable
style — with first-class support for async streams, deferred cleanup,
structured concurrency, Go-style channels, and framework adapters
for Reactor and RxJava.</p>
@@ -144,6 +144,11 @@ Before diving in, here’s a quick guide to when
you’d reach for each:
<td class="tableblock halign-left valign-top"><p
class="tableblock">Groovy’s take on the same goal as JDK
<code>StructuredTaskScope</code>, with <code>async</code>/<code>await</code>
integration.</p></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>AsyncContext</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">You need
contextual data (e.g. player session, logging trace ID) to follow your async
calls across thread hops.</p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Automatically propagated through
<code>async</code>/<code>await</code>, <code>AsyncScope</code>, and
<code>Awaitable.go</code>.</p></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Framework
adapters</p></td>
<td class="tableblock halign-left valign-top"><p
class="tableblock">You’re already using Reactor or RxJava and want
<code>await</code> to work transparently with their types.</p></td>
<td class="tableblock halign-left valign-top"><p
class="tableblock">Auto-discovered via <code>ServiceLoader</code> — just add
the dependency.</p></td>
@@ -187,7 +192,9 @@ CompletableFuture<Quest> quest =
<div class="paragraph">
<p>Each <code>.thenCompose()</code> adds a nesting level, exception recovery is
separated from the code that causes the exception, and the control
-flow reads inside-out.</p>
+flow reads inside-out. For this example, the simple chaining
+is manageable, but the complexity grows non-linearly with
+branching and error handling</p>
</div>
</div>
</div>
@@ -330,8 +337,8 @@ for the next wave, preventing unbounded enemy spawning. No
explicit
queues, signals, or synchronization required.</p>
</div>
<div class="paragraph">
-<p>There’s nothing comparable in plain Java today. You’d typically
-reach for Reactor’s <code>Flux</code> or RxJava’s
<code>Flowable</code>, each of which
+<p>There’s no language-level equivalent in plain Java today.
+You’d typically reach for Reactor’s <code>Flux</code> or
RxJava’s <code>Flowable</code>, each of which
brings its own operator vocabulary and mental model. With <code>for
await</code>,
async iteration feels as natural as a regular <code>for</code> loop.</p>
</div>
@@ -455,6 +462,40 @@ scouting task throws (the hero falls), sibling tasks are
cancelled
immediately — the raid retreats.</p>
</div>
<div class="sect2">
+<h3 id="_cancellation_and_timeouts">Cancellation and timeouts</h3>
+<div class="paragraph">
+<p>Cancellation is one of the trickiest parts of async programming —
+and one of `CompletableFuture’s biggest pain points. The proposal
+makes it straightforward. For instance, a raid might have a time
+limit — if the party takes too long, all scouting missions are
+cancelled:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="prettyprint highlight"><code data-lang="groovy">async
raidWithTimeLimit(List<Hero> party, List<Room> rooms) {
+ try {
+ await Awaitable.orTimeoutMillis(30_000) {
+ AsyncScope.withScope { scope ->
+ var missions = unique(party, rooms).collect { hero, room ->
+ scope.async { await hero.scout(room) }
+ }
+ missions.collect { await it }
+ }
+ }
+ } catch (TimeoutException e) {
+ party.each { it.retreat() }
+ return [] // no loot this time
+ }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>When the timeout fires, the scope’s child tasks are cancelled and
+a <code>TimeoutException</code> is thrown — which you handle with an ordinary
+<code>catch</code>, just like any other error.</p>
+</div>
+</div>
+<div class="sect2">
<h3 id="_complementing_jdk_structured_concurrency">Complementing JDK
structured concurrency</h3>
<div class="paragraph">
<p>Java’s <code>StructuredTaskScope</code>
@@ -542,7 +583,7 @@ async villainAlerts(dungeonId) {
<div class="sectionbody">
<div class="paragraph">
<p>Readers of the
-<a href="https://groovy-lang.org/blog/gpars-meets-virtual-threads.html";>GPars
meets virtual threads</a>
+<a href="https://groovy.apache.org/blog/gpars-meets-virtual-threads";>GPars
meets virtual threads</a>
blog post will recall that GPars provides parallel collections,
actors, agents, and dataflow concurrency — and that it works well
with virtual threads via custom executor services.</p>
diff --git a/search/search-index.json b/search/search-index.json
index 92070a8..8cfc043 100644
--- a/search/search-index.json
+++ b/search/search-index.json
@@ -254,7 +254,7 @@
{
"id": "blog/groovy-async-await.html",
"title": "The Apache Groovy programming language - Blogs - Async/await
for Groovy",
- "content": "The Apache Groovy programming language - Blogs -
Async/await for Groovy Socialize Discuss on the mailing list Groovy on X Groovy
on Bluesky Groovy on Mastodon Groovy on LinkedIn Events and conferences Source
code on GitHub Report issues in Jira Stack Overflow questions Slack Community
You are using an outdated browser. Please upgrade your browser to improve your
experience. Apache Groovy™ Learn Documentation Download Support
Contribute Ecosystem Blog posts Socia [...]
+ "content": "The Apache Groovy programming language - Blogs -
Async/await for Groovy Socialize Discuss on the mailing list Groovy on X Groovy
on Bluesky Groovy on Mastodon Groovy on LinkedIn Events and conferences Source
code on GitHub Report issues in Jira Stack Overflow questions Slack Community
You are using an outdated browser. Please upgrade your browser to improve your
experience. Apache Groovy™ Learn Documentation Download Support
Contribute Ecosystem Blog posts Socia [...]
"url": "blog/groovy-async-await.html",
"site": "dev"
},
