deploy: 82529d2

gsmet · gsmet · commit 2d460a5d6fb4 · 2025-10-03T03:19:38.000Z
diff --git a/feed.xml b/feed.xml
@@ -5,7 +5,7 @@
         <title>Quarkus</title>
         <link>https://quarkus.io</link>
         <description>Quarkus: Supersonic Subatomic Java</description>
-        <lastBuildDate>Thu, 02 Oct 2025 18:54:54 +0000</lastBuildDate>
+        <lastBuildDate>Fri, 03 Oct 2025 03:14:16 +0000</lastBuildDate>
         
         
         <item>
diff --git a/version/main/guides/all-config.html b/version/main/guides/all-config.html
@@ -14530,7 +14530,7 @@ <h3 class="mb-0"></h3>
 <p><i class="fa fa-chevron-down"></i><span>Show more</span></p>
 </div></div></td>
 <td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
-<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>quay.io/keycloak/keycloak:26.3.4</code></p></td>
+<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>quay.io/keycloak/keycloak:26.4.0</code></p></td>
 </tr>
 <tr class="row-collapsible row-collapsed row-with-desc row-hidden odd">
 <td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
diff --git a/version/main/guides/dev-services.html b/version/main/guides/dev-services.html
@@ -1531,7 +1531,7 @@ <h3 id="keycloak"><a class="anchor" href="#keycloak"></a>Keycloak</h3>
 <p><i class="fa fa-chevron-down"></i><span>Show more</span></p>
 </div></div></td>
 <td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
-<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>quay.io/keycloak/keycloak:26.3.4</code></p></td>
+<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>quay.io/keycloak/keycloak:26.4.0</code></p></td>
 </tr>
 <tr class="row-collapsible row-collapsed row-with-desc row-hidden">
 <td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
diff --git a/version/main/guides/hibernate-orm-panache.html b/version/main/guides/hibernate-orm-panache.html
@@ -1750,7 +1750,7 @@ <h2 id="custom-ids"><a class="anchor" href="#custom-ids"></a>Custom IDs</h2>
 <h2 id="mocking"><a class="anchor" href="#mocking"></a>Mocking</h2>
 <div class="sectionbody">
 <div class="sect2">
-<h3 id="using-the-active-record-pattern"><a class="anchor" href="#using-the-active-record-pattern"></a>Using the active record pattern</h3>
+<h3 id="mocking_active_record"><a class="anchor" href="#mocking_active_record"></a>Using the active record pattern</h3>
 <div class="paragraph">
 <p>If you are using the active record pattern you cannot use Mockito directly as it does not support mocking static methods,
 but you can use the <code>quarkus-panache-mock</code> module which allows you to use Mockito to mock all provided static
@@ -2149,7 +2149,7 @@ <h2 id="defining-entities-in-external-projects-or-jars"><a class="anchor" href="
 <li><a href="#custom-ids">Custom IDs</a></li>
 <li><a href="#mocking">Mocking</a>
 <ul class="sectlevel2">
-<li><a href="#using-the-active-record-pattern">Using the active record pattern</a></li>
+<li><a href="#mocking_active_record">Using the active record pattern</a></li>
 <li><a href="#using-the-repository-pattern">Using the repository pattern</a></li>
 </ul>
 </li>
diff --git a/version/main/guides/security-keycloak-authorization.html b/version/main/guides/security-keycloak-authorization.html
@@ -805,7 +805,7 @@ <h2 id="starting-and-configuring-the-keycloak-server"><a class="anchor" href="#s
 <table>
 <tr>
 <td><i class="conum" data-value="1"></i><b>1</b></td>
-<td>For <code>keycloak.version</code>, ensure the version is <code>26.3.4</code> or later.</td>
+<td>For <code>keycloak.version</code>, ensure the version is <code>26.4.0</code> or later.</td>
 </tr>
 <tr>
 <td><i class="conum" data-value="2"></i><b>2</b></td>
diff --git a/version/main/guides/security-oidc-bearer-token-authentication-tutorial.html b/version/main/guides/security-oidc-bearer-token-authentication-tutorial.html
@@ -618,7 +618,7 @@ <h2 id="start-and-configure-the-keycloak-server"><a class="anchor" href="#start-
 <div class="ulist">
 <ul>
 <li>
-<p>Where the <code>keycloak.version</code> is set to version <code>26.3.4</code> or later.</p>
+<p>Where the <code>keycloak.version</code> is set to version <code>26.4.0</code> or later.</p>
 </li>
 </ul>
 </div>
diff --git a/version/main/guides/security-oidc-code-flow-authentication-tutorial.html b/version/main/guides/security-oidc-code-flow-authentication-tutorial.html
@@ -564,7 +564,7 @@ <h2 id="start-and-configure-the-keycloak-server"><a class="anchor" href="#start-
 </div>
 </div>
 <div class="paragraph">
-<p>where <code>keycloak.version</code> is set to <code>26.3.4</code> or later.</p>
+<p>where <code>keycloak.version</code> is set to <code>26.4.0</code> or later.</p>
 </div>
 <div class="paragraph">
 <p>You can access your Keycloak Server at <a href="http://localhost:8180">localhost:8180</a>.</p>
diff --git a/version/main/guides/security-oidc-configuration-properties-reference.html b/version/main/guides/security-oidc-configuration-properties-reference.html
@@ -4574,7 +4574,7 @@ <h2 id="keycloak-dev-services-configuration"><a class="anchor" href="#keycloak-d
 <p><i class="fa fa-chevron-down"></i><span>Show more</span></p>
 </div></div></td>
 <td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
-<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>quay.io/keycloak/keycloak:26.3.4</code></p></td>
+<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>quay.io/keycloak/keycloak:26.4.0</code></p></td>
 </tr>
 <tr class="row-collapsible row-collapsed row-with-desc row-hidden">
 <td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
diff --git a/version/main/guides/security-openid-connect-client.html b/version/main/guides/security-openid-connect-client.html
@@ -983,7 +983,7 @@ <h2 id="starting-and-configuring-the-keycloak-server"><a class="anchor" href="#s
 </div>
 </div>
 <div class="paragraph">
-<p>Set <code>{keycloak.version}</code> to <code>26.3.4</code> or later.</p>
+<p>Set <code>{keycloak.version}</code> to <code>26.4.0</code> or later.</p>
 </div>
 <div class="paragraph">
 <p>You can access your Keycloak Server at <a href="http://localhost:8180">localhost:8180</a>.</p>
diff --git a/version/main/guides/security-openid-connect-dev-services.html b/version/main/guides/security-openid-connect-dev-services.html
@@ -638,7 +638,7 @@ <h3 id="running-the-tests"><a class="anchor" href="#running-the-tests"></a>Runni
 <div class="sect2">
 <h3 id="keycloak-initialization"><a class="anchor" href="#keycloak-initialization"></a>Keycloak initialization</h3>
 <div class="paragraph">
-<p>The <code>quay.io/keycloak/keycloak:26.3.4</code> image which contains a Keycloak distribution powered by Quarkus is used to start a container by default.
+<p>The <code>quay.io/keycloak/keycloak:26.4.0</code> image which contains a Keycloak distribution powered by Quarkus is used to start a container by default.
 <code>quarkus.keycloak.devservices.image-name</code> can be used to change the Keycloak image name.
 For example, set it to <code>quay.io/keycloak/keycloak:19.0.3-legacy</code> to use a Keycloak distribution powered by WildFly.
 Be aware that a Quarkus-based Keycloak distribution is only available starting from Keycloak <code>20.0.0</code>.</p>
@@ -1008,7 +1008,7 @@ <h2 id="configuration-reference"><a class="anchor" href="#configuration-referenc
 <p><i class="fa fa-chevron-down"></i><span>Show more</span></p>
 </div></div></td>
 <td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
-<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>quay.io/keycloak/keycloak:26.3.4</code></p></td>
+<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>quay.io/keycloak/keycloak:26.4.0</code></p></td>
 </tr>
 <tr class="row-collapsible row-collapsed row-with-desc odd">
 <td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
diff --git a/version/main/guides/testing-components.html b/version/main/guides/testing-components.html
@@ -243,7 +243,7 @@ <h1 class="text-caps">Testing components </h1>
 <i class="fa icon-tip" title="Tip"></i>
 </td>
 <td class="content">
-This extension is available in the <code>quarkus-junit5-component</code> dependency.
+This JUnit extension is available in the <code>quarkus-junit5-component</code> dependency.
 </td>
 </tr>
 </table>
@@ -680,7 +680,143 @@ <h3 id="config-sources"><a class="anchor" href="#config-sources"></a>5.1. Config
 </div>
 </div>
 <div class="sect1">
-<h2 id="mocking-cdi-interceptors"><a class="anchor" href="#mocking-cdi-interceptors"></a>6. Mocking CDI Interceptors</h2>
+<h2 id="panache-entities-using-the-active-record-pattern"><a class="anchor" href="#panache-entities-using-the-active-record-pattern"></a>6. Panache entities using the active record pattern</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>If you are using the active record pattern you cannot easily leverage <code>Mockito#mockStatic()</code> to mock static methods declared on <code>PanacheEntityBase</code>.
+In a normal Quarkus app, these static methods are automatically overridden in subclasses.
+However, <code>QuarkusComponentTest</code> does not start a full Quarkus application.
+Nevertheless, you can use the <code>quarkus-panache-mock</code> module which integrates seamlessly with <code>QuarkusComponentTest</code>.</p>
+</div>
+<div class="paragraph">
+<p>Add this dependency to your <code>pom.xml</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;io.quarkus&lt;/groupId&gt;
+    &lt;artifactId&gt;quarkus-panache-mock&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Given this simple entity:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Entity
+public class Person extends PanacheEntity {
+
+   public String name;
+
+   public Person(String name) {
+      this.name = name;
+   }
+
+   public static List&lt;Person&gt; findOrdered() {
+      return find("ORDER BY name").list();
+   }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>That is used in a simple bean:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">public class PersonService {
+
+   public List&lt;Person&gt; getPersons(boolen sorted) {
+      if (sorted) {
+         return Person.findOrdered();
+      }
+      return Person.listAll();
+   }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You can write your component test like:</p>
+</div>
+<div class="listingblock">
+<div class="title">Nested test</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import jakarta.inject.Inject;
+import io.quarkus.test.component.QuarkusComponentTest;
+import io.quarkus.panache.mock.MockPanacheEntities;
+import org.junit.jupiter.api.Test;
+import org.mockito.Mockito;
+
+@QuarkusComponentTest <i class="conum" data-value="1"></i><b>(1)</b>
+@MockPanacheEntities(Person.class) <i class="conum" data-value="2"></i><b>(2)</b>
+public class PersonServiceTest {
+
+    @Inject
+    PersonService personService; <i class="conum" data-value="3"></i><b>(3)</b>
+
+    @Test
+    public void testGetPersons() {
+        Mockito.when(Person.listAll()).thenReturn(List.of(new Person("Tom")));
+        List&lt;Person&gt; list = personService.getPersons(false);
+        assertEquals(1, list.size());
+        assertEquals("Tom", list.get(0).name);
+
+        Mockito.when(Person.findOrdered()).thenReturn(List.of(new Person("Tom")));
+        list = personService.getPersons(true);
+        assertEquals(1, list.size());
+        assertEquals("Tom", list.get(0).name);
+    }
+
+}</code></pre>
+</div>
+</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>The <code>QuarkusComponentTest</code> annotation registers the JUnit extension.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="2"></i><b>2</b></td>
+<td><code>@MockPanacheEntities</code> installs mocks for the given entity classes.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="3"></i><b>3</b></td>
+<td>The test injects the component under the test - <code>PersonService</code>.</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+See also <a href="hibernate-orm-panache#mocking_active_record">Simplified Hibernate ORM with Panache - Using the active record pattern</a> for more information.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+Currently, only the integration with Hibernate ORM is supported. Other variants of the Panache API, such as MongoDB and Hibernate Reactive, are not supported yet.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="mocking-cdi-interceptors"><a class="anchor" href="#mocking-cdi-interceptors"></a>7. Mocking CDI Interceptors</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>If a tested component class declares an interceptor binding then you might need to mock the interception too.
@@ -825,7 +961,8 @@ <h2 id="mocking-cdi-interceptors"><a class="anchor" href="#mocking-cdi-intercept
 <li><a href="#config-sources">5.1. Config sources</a></li>
 </ul>
 </li>
-<li><a href="#mocking-cdi-interceptors">6. Mocking CDI Interceptors</a></li>
+<li><a href="#panache-entities-using-the-active-record-pattern">6. Panache entities using the active record pattern</a></li>
+<li><a href="#mocking-cdi-interceptors">7. Mocking CDI Interceptors</a></li>
 </ul></div>
     </div>
   </div>
