chore: update changelog and bump version to v2.6.5 (#1566)

Author: aaron-congo

CHANGELOG.md

@@ -3,6 +3,33 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/#semantic-versioning-200).
 
+## [2.6.5] - 2025-10-16
+
+### :magic_wand: Added
+- Weighted random host selector strategy ([PR #1537](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1537)).
+
+### :bug: Fixed
+- Problem where monitor plugin chains were created unnecessarily, leading to performance degradation ([PR #1530](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1530)).
+- Limitless rounding bug for host weights ([PR #1537](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1537)).
+- Issue with Blue/Green metadata retrieval for PG databases after switchover is completed ([PR #1552](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1552)).
+- Issue where host monitors would occasionally call isValid() without a timeout ([PR #1546](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1546)).
+- Verify connection is not a stale writer in the cluster topology monitor ([PR #1322](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1322)).
+- Issue where the closedExplicitly flag in the Failover2 plugin was not updated correctly ([PR #1560](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1560)).
+
+### :crab: Changed
+- Refactor failover handler tasks to use separate PluginService instances ([PR #1514](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1514)).
+- Replace ConnectionService with ServiceUtility ([PR #1534](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1534)).
+- Decouple initialization objects and clean up initialization logic ([PR #1541](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1541)).
+- Refactor PG SQL queries to be fully qualified ([PR #1561](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1561)).
+- Documentation:
+  - Required permissions for non-admin to the Blue/Green docs ([PR #1559](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1559)).
+  - Remove important service dependency in the Blue/Green docs ([PR #1544](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1544)).
+  - Supported service versions required for Blue/Green support ([PR #1548](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1548)).
+  - Remove outdated information regarding Blue/Green support ([PR #1549](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1549)).
+  - Correct property for the Secrets Manager plugin ([PR #1556](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1556)).
+  - ClusterId requirement when using non-standard RDS URLs([PR #1553](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1553) and [PR #1558](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1558)).
+  - RDS Proxy compatibility ([PR #1535](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1535)).
+
 ## [2.6.4] - 2025-08-28
 
 ### :bug: Fixed
@@ -508,6 +535,7 @@ The Amazon Web Services (AWS) Advanced JDBC Driver allows an application to take
 - The [AWS IAM Authentication Connection Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheIamAuthenticationPlugin.md)
 - The [AWS Secrets Manager Connection Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAwsSecretsManagerPlugin.md)
 
+[2.6.5]: https://github.com/aws/aws-advanced-jdbc-wrapper/compare/2.6.4...2.6.5
 [2.6.4]: https://github.com/aws/aws-advanced-jdbc-wrapper/compare/2.6.3...2.6.4
 [2.6.3]: https://github.com/aws/aws-advanced-jdbc-wrapper/compare/2.6.2...2.6.3
 [2.6.2]: https://github.com/aws/aws-advanced-jdbc-wrapper/compare/2.6.1...2.6.2

Maintenance.md

@@ -37,6 +37,7 @@
 | July 31, 2025      | [Release 2.6.2](https://github.com/aws/aws-advanced-jdbc-wrapper/releases/tag/2.6.2) |
 | August 28, 2025    | [Release 2.6.3](https://github.com/aws/aws-advanced-jdbc-wrapper/releases/tag/2.6.3) |
 | September 11, 2025 | [Release 2.6.4](https://github.com/aws/aws-advanced-jdbc-wrapper/releases/tag/2.6.4) |
+| October 16, 2025   | [Release 2.6.5](https://github.com/aws/aws-advanced-jdbc-wrapper/releases/tag/2.6.5) |
 
 `aws-advanced-jdbc-wrapper` [follows semver](https://semver.org/#semantic-versioning-200) which means we will only
 release breaking changes in major versions. Generally speaking patches will be released to fix existing problems without
@@ -90,4 +91,4 @@ from the updated source after the PRs are merged.
 | Major Version | Latest Minor Version | Status      | Initial Release | Maintenance Window Start | Maintenance Window End |
 |---------------|----------------------|-------------|-----------------|--------------------------|------------------------|
 | 1             | 1.0.2                | Maintenance | Oct 5, 2022     | Apr 28, 2023             | Apr 28, 2024           | 
-| 2             | 2.6.4                | Current     | Apr 28, 2023    | N/A                      | N/A                    | 
+| 2             | 2.6.5                | Current     | Apr 28, 2023    | N/A                      | N/A                    | 

benchmarks/README.md

@@ -7,5 +7,5 @@ The benchmarks do not measure the performance of target JDBC drivers nor the per
 ## Usage
 1. Build the benchmarks with the following command `../gradlew jmhJar`.
     1. the JAR file will be outputted to `build/libs`
-2. Run the benchmarks with the following command `java -jar build/libs/benchmarks-2.6.4-jmh.jar`.
+2. Run the benchmarks with the following command `java -jar build/libs/benchmarks-2.6.5-jmh.jar`.
     1. you may have to update the command based on the exact version of the produced JAR file

docs/GettingStarted.md

@@ -16,7 +16,7 @@ If you are using the AWS JDBC Driver as part of a Gradle project, include the wr
 
 ```gradle
 dependencies {
-    implementation group: 'software.amazon.jdbc', name: 'aws-advanced-jdbc-wrapper', version: '2.6.4'
+    implementation group: 'software.amazon.jdbc', name: 'aws-advanced-jdbc-wrapper', version: '2.6.5'
     implementation group: 'org.postgresql', name: 'postgresql', version: '42.5.0'
 }
 ```
@@ -30,16 +30,16 @@ You can use pre-compiled packages that can be downloaded directly from [GitHub R
 For example, the following command uses wget to download the wrapper:
 
 ```bash
-wget https://github.com/aws/aws-advanced-jdbc-wrapper/releases/download/2.6.4/aws-advanced-jdbc-wrapper-2.6.4.jar
+wget https://github.com/aws/aws-advanced-jdbc-wrapper/releases/download/2.6.5/aws-advanced-jdbc-wrapper-2.6.5.jar
 ```
 
 Then, the following command adds the AWS JDBC Driver to the CLASSPATH:
 
 ```bash
-export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-advanced-jdbc-wrapper-2.6.4.jar
+export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-advanced-jdbc-wrapper-2.6.5.jar
 ```
 
-> **Note**: There is also a JAR suffixed with `-bundle-federated-auth`. It is an Uber JAR that contains the AWS JDBC Driver as well as all the dependencies needed to run the Federated Authentication Plugin. **Our general recommendation is to use the `aws-advanced-jdbc-wrapper-2.6.4.jar` for use cases unrelated to complex Federated Authentication environments**. To learn more, please check out the [Federated Authentication Plugin](./using-the-jdbc-driver/using-plugins/UsingTheFederatedAuthPlugin.md#bundled-uber-jar). 
+> **Note**: There is also a JAR suffixed with `-bundle-federated-auth`. It is an Uber JAR that contains the AWS JDBC Driver as well as all the dependencies needed to run the Federated Authentication Plugin. **Our general recommendation is to use the `aws-advanced-jdbc-wrapper-2.6.5.jar` for use cases unrelated to complex Federated Authentication environments**. To learn more, please check out the [Federated Authentication Plugin](./using-the-jdbc-driver/using-plugins/UsingTheFederatedAuthPlugin.md#bundled-uber-jar). 
 
 ### As a Maven Dependency
 
@@ -50,7 +50,7 @@ You can use [Maven's dependency management](https://central.sonatype.com/artifac
     <dependency>
         <groupId>software.amazon.jdbc</groupId>
         <artifactId>aws-advanced-jdbc-wrapper</artifactId>
-        <version>2.6.4</version>
+        <version>2.6.5</version>
     </dependency>
 </dependencies>
 ```
@@ -61,15 +61,15 @@ You can use [Gradle's dependency management](https://central.sonatype.com/artifa
 
 ```gradle
 dependencies {
-    implementation group: 'software.amazon.jdbc', name: 'aws-advanced-jdbc-wrapper', version: '2.6.4'
+    implementation group: 'software.amazon.jdbc', name: 'aws-advanced-jdbc-wrapper', version: '2.6.5'
 }
 ```
 
 To add a Gradle dependency in a Kotlin syntax, use the following configuration:
 
 ```kotlin
 dependencies {
-    implementation("software.amazon.jdbc:aws-advanced-jdbc-wrapper:2.6.4")
+    implementation("software.amazon.jdbc:aws-advanced-jdbc-wrapper:2.6.5")
 }
 ```
 

docs/using-the-jdbc-driver/UsingTheJdbcDriver.md

@@ -235,7 +235,7 @@ To use a snapshot build in your project, check the following examples. More info
   <dependency>
     <groupId>software.amazon.jdbc</groupId>
     <artifactId>aws-advanced-jdbc-wrapper</artifactId>
-    <version>2.6.4-SNAPSHOT</version>
+    <version>2.6.5-SNAPSHOT</version>
   </dependency>
 </dependencies>
 

docs/using-the-jdbc-driver/using-plugins/UsingTheFederatedAuthPlugin.md

@@ -32,7 +32,7 @@ This JAR is a drop-in ready solution and is **recommended for customers who do n
 As this plugin has a number of transitive dependencies, the goal of this JAR is to eliminate the need to manually source all the dependencies and avoid potential issues with managing them. 
 In that spirit, the dependencies in this JAR are shaded with the prefix `shaded` to avoid potential package conflicts with pre-existing packages in your environment.
 
-It is important to note that the Uber JAR is bundled with the AWS Java RDS SDK and is larger (**15 MB**) than our `aws-advanced-jdbc-wrapper-2.6.4.jar`. So please take that into account when deciding if this solution is for you.
+It is important to note that the Uber JAR is bundled with the AWS Java RDS SDK and is larger (**15 MB**) than our `aws-advanced-jdbc-wrapper-2.6.5.jar`. So please take that into account when deciding if this solution is for you.
 
 If you would like to download and install the bundled Uber JAR, follow these [instructions](../../GettingStarted.md#direct-download-and-installation).
 

examples/SpringBootHikariExample/README.md

@@ -4,7 +4,7 @@ In this tutorial, you will set up a Spring Boot application using Hikari and the
 
 > Note: this tutorial was written using the following technologies:
 >    - Spring Boot 2.7.0
->    - AWS JDBC Driver 2.6.4
+>    - AWS JDBC Driver 2.6.5
 >    - Postgresql 42.5.4
 >    - Java 8
 

examples/SpringHibernateExample/README.md

@@ -5,7 +5,7 @@ In this tutorial, you will set up a Spring Boot and Hibernate application with t
 > Note: this tutorial was written using the following technologies:
 >    - Spring Boot 2.7.1
 >    - Hibernate
->    - AWS JDBC Driver 2.6.4
+>    - AWS JDBC Driver 2.6.5
 >    - Postgresql 42.5.4
 >    - Gradle 7
 >    - Java 11

examples/SpringTxFailoverExample/README.md

@@ -4,7 +4,7 @@ In this tutorial, you will set up a Spring Boot application using the AWS JDBC D
 
 > Note: this tutorial was written using the following technologies:
 >    - Spring Boot 2.7.0
->    - AWS JDBC Driver 2.6.4
+>    - AWS JDBC Driver 2.6.5
 >    - Postgresql 42.5.4
 >    - Java 8
 

examples/SpringWildflyExample/README.md

@@ -5,7 +5,7 @@ In this tutorial, you will set up a Wildfly and Spring Boot application with the
 > Note: this tutorial was written using the following technologies:
 >    - Spring Boot 2.7.1
 >    - Wildfly 26.1.1 Final
->    - AWS JDBC Driver 2.6.4
+>    - AWS JDBC Driver 2.6.5
 >    - Postgresql 42.5.4
 >    - Gradle 7
 >    - Java 11