Deploying to gh-pages - 07:53:22

micronaut-projects · Oct 10, 2023 · e5dcabb · e5dcabb
1 parent 13980fa
commit e5dcabb
Show file tree

Hide file tree

Showing 2 changed files with 69 additions and 63 deletions.
diff --git a/snapshot/guide/configurationreference.html b/snapshot/guide/configurationreference.html
@@ -51,9 +51,9 @@ <h1>Configuration Reference</h1>
             </div>
 <div class="sect2">
 <h3 id="_micronaut_data_azure_cosmos_config_properties">Micronaut Data Azure Cosmos Config Properties</h3>
-<a id="io.micronaut.data.cosmos.config.CosmosDatabaseConfiguration$CosmosContainerSettings$ContainerThroughputSettings" href="#io.micronaut.data.cosmos.config.CosmosDatabaseConfiguration$CosmosContainerSettings$ContainerThroughputSettings">&#128279;</a>
+<a id="io.micronaut.data.cosmos.config.CosmosDatabaseConfiguration$DefaultThroughputSettings" href="#io.micronaut.data.cosmos.config.CosmosDatabaseConfiguration$DefaultThroughputSettings">&#128279;</a>
 <table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. Configuration Properties for <a href="../api/io/micronaut/data/cosmos/config/CosmosDatabaseConfiguration.CosmosContainerSettings.ContainerThroughputSettings.html">CosmosDatabaseConfiguration$CosmosContainerSettings$ContainerThroughputSettings</a></caption>
+<caption class="title">Table 1. Configuration Properties for <a href="../api/io/micronaut/data/cosmos/config/CosmosDatabaseConfiguration.DefaultThroughputSettings.html">CosmosDatabaseConfiguration$DefaultThroughputSettings</a></caption>
 <colgroup>
 <col style="width: 33.3333%;">
 <col style="width: 33.3333%;">
@@ -68,21 +68,21 @@ <h3 id="_micronaut_data_azure_cosmos_config_properties">Micronaut Data Azure Cos
 </thead>
 <tbody>
 <tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>azure.cosmos.database.container-settings[*].throughput-settings.request-units</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>azure.cosmos.database.throughput-settings.request-units</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">java.lang.Integer</p></td>
 <td class="tableblock halign-left valign-top"></td>
 </tr>
 <tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>azure.cosmos.database.container-settings[*].throughput-settings.auto-scale</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>azure.cosmos.database.throughput-settings.auto-scale</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
 <td class="tableblock halign-left valign-top"></td>
 </tr>
 </tbody>
 </table>
 <div style="page-break-after: always;"></div>
-<a id="io.micronaut.data.cosmos.config.CosmosDatabaseConfiguration" href="#io.micronaut.data.cosmos.config.CosmosDatabaseConfiguration">&#128279;</a>
+<a id="io.micronaut.data.cosmos.config.CosmosDatabaseConfiguration$CosmosContainerSettings$ContainerThroughputSettings" href="#io.micronaut.data.cosmos.config.CosmosDatabaseConfiguration$CosmosContainerSettings$ContainerThroughputSettings">&#128279;</a>
 <table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. Configuration Properties for <a href="../api/io/micronaut/data/cosmos/config/CosmosDatabaseConfiguration.html">CosmosDatabaseConfiguration</a></caption>
+<caption class="title">Table 2. Configuration Properties for <a href="../api/io/micronaut/data/cosmos/config/CosmosDatabaseConfiguration.CosmosContainerSettings.ContainerThroughputSettings.html">CosmosDatabaseConfiguration$CosmosContainerSettings$ContainerThroughputSettings</a></caption>
 <colgroup>
 <col style="width: 33.3333%;">
 <col style="width: 33.3333%;">
@@ -97,26 +97,14 @@ <h3 id="_micronaut_data_azure_cosmos_config_properties">Micronaut Data Azure Cos
 </thead>
 <tbody>
 <tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>azure.cosmos.database.database-name</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">java.lang.String</p></td>
-<td class="tableblock halign-left valign-top"></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>azure.cosmos.database.update-policy</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../api/io/micronaut/data/cosmos/config/StorageUpdatePolicy.html">StorageUpdatePolicy</a></p></td>
-<td class="tableblock halign-left valign-top"></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>azure.cosmos.database.packages</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">java.util.List</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>azure.cosmos.database.container-settings[*].throughput-settings.request-units</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">java.lang.Integer</p></td>
 <td class="tableblock halign-left valign-top"></td>
 </tr>
 <tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>azure.cosmos.database.query-metrics-enabled</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>azure.cosmos.database.container-settings[*].throughput-settings.auto-scale</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Gets the indicator telling whether query metrics will be enabled for Azure Cosmos Db query requests.
- If this is turned off then detailed query metrics information will not be retrieved in the Cosmos Diagnostics query response.
- The default value is true.</p></td>
+<td class="tableblock halign-left valign-top"></td>
 </tr>
 </tbody>
 </table>
@@ -155,9 +143,9 @@ <h3 id="_micronaut_data_azure_cosmos_config_properties">Micronaut Data Azure Cos
 </tbody>
 </table>
 <div style="page-break-after: always;"></div>
-<a id="io.micronaut.data.cosmos.config.CosmosDatabaseConfiguration$DefaultThroughputSettings" href="#io.micronaut.data.cosmos.config.CosmosDatabaseConfiguration$DefaultThroughputSettings">&#128279;</a>
+<a id="io.micronaut.data.cosmos.config.CosmosDatabaseConfiguration" href="#io.micronaut.data.cosmos.config.CosmosDatabaseConfiguration">&#128279;</a>
 <table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 4. Configuration Properties for <a href="../api/io/micronaut/data/cosmos/config/CosmosDatabaseConfiguration.DefaultThroughputSettings.html">CosmosDatabaseConfiguration$DefaultThroughputSettings</a></caption>
+<caption class="title">Table 4. Configuration Properties for <a href="../api/io/micronaut/data/cosmos/config/CosmosDatabaseConfiguration.html">CosmosDatabaseConfiguration</a></caption>
 <colgroup>
 <col style="width: 33.3333%;">
 <col style="width: 33.3333%;">
@@ -172,15 +160,27 @@ <h3 id="_micronaut_data_azure_cosmos_config_properties">Micronaut Data Azure Cos
 </thead>
 <tbody>
 <tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>azure.cosmos.database.throughput-settings.request-units</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">java.lang.Integer</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>azure.cosmos.database.database-name</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">java.lang.String</p></td>
 <td class="tableblock halign-left valign-top"></td>
 </tr>
 <tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>azure.cosmos.database.throughput-settings.auto-scale</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>azure.cosmos.database.update-policy</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../api/io/micronaut/data/cosmos/config/StorageUpdatePolicy.html">StorageUpdatePolicy</a></p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>azure.cosmos.database.packages</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">java.util.List</p></td>
 <td class="tableblock halign-left valign-top"></td>
 </tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>azure.cosmos.database.query-metrics-enabled</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Gets the indicator telling whether query metrics will be enabled for Azure Cosmos Db query requests.
+ If this is turned off then detailed query metrics information will not be retrieved in the Cosmos Diagnostics query response.
+ The default value is true.</p></td>
+</tr>
 </tbody>
 </table>
 <div style="page-break-after: always;"></div>
@@ -333,9 +333,33 @@ <h3 id="_micronaut_data_r2dbc_config_properties">Micronaut Data R2dbc Config Pro
 </div>
 <div class="sect2">
 <h3 id="_micronaut_data_runtime_config_properties">Micronaut Data Runtime Config Properties</h3>
+<a id="io.micronaut.data.runtime.multitenancy.conf.MultiTenancyConfiguration" href="#io.micronaut.data.runtime.multitenancy.conf.MultiTenancyConfiguration">&#128279;</a>
+<table class="tableblock frame-all grid-all stretch">
+<caption class="title">Table 8. Configuration Properties for <a href="../api/io/micronaut/data/runtime/multitenancy/conf/MultiTenancyConfiguration.html">MultiTenancyConfiguration</a></caption>
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Property</th>
+<th class="tableblock halign-left valign-top">Type</th>
+<th class="tableblock halign-left valign-top">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>micronaut.data.multi-tenancy.mode</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../api/io/micronaut/data/runtime/multitenancy/MultiTenancyMode.html">MultiTenancyMode</a></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Multi-tenancy mode specified.</p></td>
+</tr>
+</tbody>
+</table>
+<div style="page-break-after: always;"></div>
 <a id="io.micronaut.data.runtime.config.DataConfiguration$PageableConfiguration" href="#io.micronaut.data.runtime.config.DataConfiguration$PageableConfiguration">&#128279;</a>
 <table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 8. Configuration Properties for <a href="../api/io/micronaut/data/runtime/config/DataConfiguration.PageableConfiguration.html">DataConfiguration$PageableConfiguration</a></caption>
+<caption class="title">Table 9. Configuration Properties for <a href="../api/io/micronaut/data/runtime/config/DataConfiguration.PageableConfiguration.html">DataConfiguration$PageableConfiguration</a></caption>
 <colgroup>
 <col style="width: 33.3333%;">
 <col style="width: 33.3333%;">
@@ -387,30 +411,6 @@ <h3 id="_micronaut_data_runtime_config_properties">Micronaut Data Runtime Config
 </tbody>
 </table>
 <div style="page-break-after: always;"></div>
-<a id="io.micronaut.data.runtime.multitenancy.conf.MultiTenancyConfiguration" href="#io.micronaut.data.runtime.multitenancy.conf.MultiTenancyConfiguration">&#128279;</a>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 9. Configuration Properties for <a href="../api/io/micronaut/data/runtime/multitenancy/conf/MultiTenancyConfiguration.html">MultiTenancyConfiguration</a></caption>
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property</th>
-<th class="tableblock halign-left valign-top">Type</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>micronaut.data.multi-tenancy.mode</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../api/io/micronaut/data/runtime/multitenancy/MultiTenancyMode.html">MultiTenancyMode</a></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Multi-tenancy mode specified.</p></td>
-</tr>
-</tbody>
-</table>
-<div style="page-break-after: always;"></div>
 </div>
         </div>
     </div>

diff --git a/snapshot/guide/index.html b/snapshot/guide/index.html
@@ -8462,13 +8462,13 @@ <h2 id="dbcRepositories"><a class="anchor" href="#dbcRepositories"></a>6.3 Repos
 
     private final JdbcTemplate jdbcTemplate;
 
-    public AbstractBookRepository(JdbcTemplate jdbcTemplate) { // <b class="conum">(1)</b>
-        this.jdbcTemplate = jdbcTemplate;
+    public AbstractBookRepository(DataSource dataSource) { // <b class="conum">(1)</b>
+        this.jdbcTemplate = new JdbcTemplate(DelegatingDataSource.unwrapDataSource(dataSource)); //<b class="conum">(2)</b>
     }
 
     @Transactional
     public List&lt;Book&gt; findByTitle(@NonNull @NotNull String title) {
-        return jdbcTemplate.queryForList("SELECT * FROM Book AS book WHERE book.title = ?", title) // <b class="conum">(2)</b>
+        return jdbcTemplate.queryForList("SELECT * FROM Book AS book WHERE book.title = ?", title) // <b class="conum">(3)</b>
             .stream()
             .map(m -&gt; new Book((Long) m.get("id"), (String) m.get("title"), (Integer) m.get("pages")))
             .toList();
@@ -8481,15 +8481,15 @@ <h2 id="dbcRepositories"><a class="anchor" href="#dbcRepositories"></a>6.3 Repos
 <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@JdbcRepository(dialect = Dialect.H2)
 abstract class AbstractBookRepository implements CrudRepository&lt;@Valid Book, @NotNull Long&gt; {
 
-    private final JdbcTemplate jdbcTemplate
+    private final JdbcTemplate jdbcTemplate;
 
-    AbstractBookRepository(JdbcTemplate jdbcTemplate) { // <b class="conum">(1)</b>
-        this.jdbcTemplate = jdbcTemplate
+    AbstractBookRepository(DataSource dataSource) { // <b class="conum">(1)</b>
+        this.jdbcTemplate = new JdbcTemplate(DelegatingDataSource.unwrapDataSource(dataSource)); //<b class="conum">(2)</b>
     }
 
     @Transactional
     List&lt;Book&gt; findByTitle(@NonNull @NotNull String title) {
-        return jdbcTemplate.queryForList('SELECT * FROM Book AS book WHERE book.title = ?', title) // <b class="conum">(2)</b>
+        return jdbcTemplate.queryForList('SELECT * FROM Book AS book WHERE book.title = ?', title) // <b class="conum">(3)</b>
             .collect(m -&gt; new Book(m.id as Long, m.title as String, m.pages as Integer))
     }
 }</code></pre>
@@ -8498,11 +8498,13 @@ <h2 id="dbcRepositories"><a class="anchor" href="#dbcRepositories"></a>6.3 Repos
 <div class="listingblock multi-language-sample">
 <div class="content">
 <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@JdbcRepository(dialect = Dialect.H2)
-abstract class AbstractBookRepository(val jdbcTemplate: JdbcTemplate) : CrudRepository&lt;@Valid Book, Long&gt; {  //<b class="conum">(1)</b>
+abstract class AbstractBookRepository(dataSource: DataSource) : CrudRepository&lt;@Valid Book, Long&gt; { // <b class="conum">(1)</b>
+
+    private val jdbcTemplate: JdbcTemplate = JdbcTemplate(DelegatingDataSource.unwrapDataSource(dataSource)) //<b class="conum">(2)</b>
 
     @Transactional
     open fun findByTitle(title: String) = jdbcTemplate
-        .queryForList("SELECT * FROM Book AS book WHERE book.title = ?", title) // <b class="conum">(2)</b>
+        .queryForList("SELECT * FROM Book AS book WHERE book.title = ?", title) // <b class="conum">(3)</b>
         .map { m -&gt; Book(m["id"] as Long, m["title"] as String, m["pages"] as Int) }
 }</code></pre>
 </div>
@@ -8511,10 +8513,14 @@ <h2 id="dbcRepositories"><a class="anchor" href="#dbcRepositories"></a>6.3 Repos
 <table>
 <tr>
 <td><i class="conum" data-value="1"></i><b>1</b></td>
-<td>Inject the <code>org.springframework.jdbc.core.JdbcTemplate</code> configured by the application.</td>
+<td>Inject the <code>java.sql.DataSource</code> configured by the application.</td>
 </tr>
 <tr>
 <td><i class="conum" data-value="2"></i><b>2</b></td>
+<td>Instantiate a <code>JdbcTemplate</code> object using the injected <code>DataSource</code>.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="3"></i><b>3</b></td>
 <td>Now the <code>JdbcTemplate</code> API can be used to implement repository methods.</td>
 </tr>
 </table>