deploy: 90cd267

feed.xml

@@ -5,7 +5,7 @@
         <title>Quarkus</title>
         <link>https://quarkus.io</link>
         <description>Quarkus: Supersonic Subatomic Java</description>
-        <lastBuildDate>Tue, 30 Jul 2024 03:03:42 +0000</lastBuildDate>
+        <lastBuildDate>Wed, 31 Jul 2024 03:03:53 +0000</lastBuildDate>
 
 
         <item>

version/main/guides/all-builditems.html

@@ -12526,15 +12526,15 @@ <h2 id="rest-server-spi"><a class="anchor" href="#rest-server-spi"></a>REST - Se
 <div id="conf-collapsible-desc-421" class="openblock description description-collapsed">
 <div class="content">
 <div class="paragraph">
-<p>When an Exception of this type is thrown and no <code>jakarta.ws.rs.ext.ExceptionMapper</code> exists, then RESTEasy Reactive will attempt to locate an <code>ExceptionMapper</code> for the cause of the Exception.</p>
+<p>When an <code>Exception</code> of this type is thrown and no <code>jakarta.ws.rs.ext.ExceptionMapper</code> exists, then RESTEasy Reactive will attempt to locate an <code>ExceptionMapper</code> for the cause of the Exception.</p>
 </div>
 </div>
 </div>
 <div class="paragraph description-decoration">
 <p><i class="fa fa-chevron-down"></i><span>Show more</span></p>
 </div></div></td>
 <td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
-<p><code>java.lang.Class&lt;? extends Throwable&gt; throwableClass</code></p>
+<p><code>java.lang.String throwableClassName</code></p>
 </div>
 <div class="paragraph">
 <p><em>No Javadoc found</em></p>

version/main/guides/cdi-reference.html

@@ -291,7 +291,7 @@ <h3 id="how-to-generate-a-jandex-index"><a class="anchor" href="#how-to-generate
     &lt;plugin&gt;
       &lt;groupId&gt;io.smallrye&lt;/groupId&gt;
       &lt;artifactId&gt;jandex-maven-plugin&lt;/artifactId&gt;
-      &lt;version&gt;3.2.0&lt;/version&gt;
+      &lt;version&gt;3.2.1&lt;/version&gt;
       &lt;executions&gt;
         &lt;execution&gt;
           &lt;id&gt;make-index&lt;/id&gt;

version/main/guides/grpc-generation-reference.html

@@ -564,7 +564,7 @@ <h2 id="using-generated-grpc-classes-from-dependencies"><a class="anchor" href="
         &lt;plugin&gt;
             &lt;groupId&gt;io.smallrye&lt;/groupId&gt;
             &lt;artifactId&gt;jandex-maven-plugin&lt;/artifactId&gt;
-            &lt;version&gt;3.2.0&lt;/version&gt;
+            &lt;version&gt;3.2.1&lt;/version&gt;
             &lt;executions&gt;
                 &lt;execution&gt;
                 &lt;id&gt;make-index&lt;/id&gt;

version/main/guides/maven-tooling.html

@@ -1489,7 +1489,7 @@ <h3 id="multi-module-maven"><a class="anchor" href="#multi-module-maven"></a>Wor
     &lt;plugin&gt;
       &lt;groupId&gt;io.smallrye&lt;/groupId&gt;
       &lt;artifactId&gt;jandex-maven-plugin&lt;/artifactId&gt;
-      &lt;version&gt;3.2.0&lt;/version&gt;
+      &lt;version&gt;3.2.1&lt;/version&gt;
       &lt;executions&gt;
         &lt;execution&gt;
           &lt;id&gt;make-index&lt;/id&gt;

version/main/guides/rest.html

@@ -3082,6 +3082,52 @@ <h3 id="exception-mapping"><a class="anchor" href="#exception-mapping"></a>Excep
 </tr>
 </table>
 </div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>When mapping an exception to a <code>@ServerExceptionMapper</code> method, the cause of the exception normally does not come into play.</p>
+</div>
+<div class="paragraph">
+<p>However, some exception types in Java only serve as wrappers for other exceptions. Often, checked exceptions are wrapped into <code>RuntimeException</code> just to not have them declared in method <code>throws</code> parameters.
+Working with <code>CompletionStage</code> for example, will require <code>CompletionException</code>. There are many such exception types that are just wrappers around the real cause of the exception.</p>
+</div>
+<div class="paragraph">
+<p>If you wish to make sure your exception mapper is called for your exception type even when it is wrapped by one of those wrapper exceptions, you can use <code>@UnwrapException</code> on the exception wrapper type:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">public class MyExceptionWrapper extends RuntimeException {
+    public MyExceptionWrapper(Exception cause) {
+        super(cause);
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>If you don&#8217;t control that exception wrapper type, you can place the annotation on any class and specify the exception wrapper types it applies to as annotation parameter:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@UnwrapException({CompletionException.class, RuntimeException.class})
+public class Mapper {
+
+    @ServerExceptionMapper
+    public Response handleMyException(MyException x) {
+        // ...
+    }
+
+}</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
 <div class="admonitionblock note">
 <table>
 <tr>

version/main/guides/spring-data-jpa.html

@@ -1001,6 +1001,9 @@ <h3 id="what-is-currently-unsupported"><a class="anchor" href="#what-is-currentl
 <p>QueryDSL support. No attempt will be made to generate implementations of the QueryDSL related repositories.</p>
 </li>
 <li>
+<p>Using <code>org.springframework.data.jpa.repository.JpaSpecificationExecutor</code></p>
+</li>
+<li>
 <p>Customizing the base repository for all repository interfaces in the code base.</p>
 <div class="ulist">
 <ul>