chore: update versioning and changelog

Author: karenc-bq

CHANGELOG.md

@@ -3,6 +3,21 @@ 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.3.2] - 2023-12-18
+### :magic_wand: Added
+- [Federated Authentication Plugin](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheFederatedAuthPlugin.md), which supports SAML authentication through ADFS ([PR #741](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/741)).
+- [**Experimental** Enhanced Host Monitoring Plugin v2](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheHostMonitoringPlugin.md#experimental-host-monitoring-plugin-v2), which is a redesign of the original Enhanced Host Monitoring Plugin that addresses memory leaks and high CPU usage during monitoring sessions ([PR #764](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/764)).
+- Fastest Response Strategy Plugin, which implements a new autoscaling strategy ([PR #755](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/755)).
+- Plugin code for Aurora Initial Connection Strategy Plugin. This plugin returns an instance endpoint when connected using a cluster endpoint ([PR #784](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/784)).
+
+### :bug: Fixed
+- Use existing entries to update the round-robin cache ([PR #739](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/739)).
+
+### :crab: Changed
+- Updated HikariCP example to include configuring the datasource with a JDBC URL ([PR #749](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/749)).
+- Replaced the `sychronized` keyword with reentrant locks in AwsCredentialsManager ([PR #785](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/785)).
+- Set HostId in HostSpec when connecting using Aurora instance endpoints ([PR #782](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/782)).
+
 ## [2.3.1] - 2023-11-29
 ### :magic_wand: Added
 - User defined session state transfer functions ([PR #729](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/729)).
@@ -186,7 +201,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ### :crab: Changed
 - Lock initialization of `AuroraHostListProvider` ([PR #347](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/347)).
-- Optimized thread locks and expiring cache for the Enhanced Monitoring Plugin. ([PR #365](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/365)).
+- Optimized thread locks and expiring cache for the Enhanced Monitoring Plugin ([PR #365](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/365)).
 - Updated Hibernate sample code to reflect changes in the wrapper source code ([PR #368](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/368)).
 - Updated KnownLimitations.md to reflect that Amazon RDS Blue/Green Deployments are not supported. See [Amazon RDS Blue/Green Deployments](./docs/KnownLimitations.md#amazon-rds-blue-green-deployments).
 
@@ -224,6 +239,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.3.2]: https://github.com/awslabs/aws-advanced-jdbc-wrapper/compare/2.3.1...2.3.2
 [2.3.1]: https://github.com/awslabs/aws-advanced-jdbc-wrapper/compare/2.3.0...2.3.1
 [2.3.0]: https://github.com/awslabs/aws-advanced-jdbc-wrapper/compare/2.2.5...2.3.0
 [2.2.5]: https://github.com/awslabs/aws-advanced-jdbc-wrapper/compare/2.2.4...2.2.5

Maintenance.md

@@ -1,31 +1,31 @@
-# Release Schedule and Maintenance Policy
+# Release Schedule
 
-| Release Date      | Release                                                                                    |
-|-------------------|--------------------------------------------------------------------------------------------|
-| October 5, 2022   | [Release 1.0.0](https://github.com/awslabs/`aws-advanced-jdbc-wrapper`/releases/tag/1.0.0) |  
-| January 31, 2023  | [Release 1.0.1](https://github.com/awslabs/`aws-advanced-jdbc-wrapper`/releases/tag/1.0.1) | 
-| Mar 30, 2023      | [Release 1.0.2](https://github.com/awslabs/`aws-advanced-jdbc-wrapper`/releases/tag/1.0.2) |
-| April 28, 2023    | [Release 2.0.0](https://github.com/awslabs/`aws-advanced-jdbc-wrapper`/releases/tag/2.0.0) |  
-| May 11, 2023      | [Release 2.1.0](https://github.com/awslabs/`aws-advanced-jdbc-wrapper`/releases/tag/2.1.0) |
-| May 21, 2023      | [Release 2.1.1](https://github.com/awslabs/`aws-advanced-jdbc-wrapper`/releases/tag/2.1.1) |
-| June 14, 2023     | [Release 2.2.0](https://github.com/awslabs/`aws-advanced-jdbc-wrapper`/releases/tag/2.2.0) |
-| June 16, 2023     | [Release 2.2.1](https://github.com/awslabs/`aws-advanced-jdbc-wrapper`/releases/tag/2.2.1) |
-| July 5, 2023      | [Release 2.2.2](https://github.com/awslabs/`aws-advanced-jdbc-wrapper`/releases/tag/2.2.2) |
-| July 31, 2023     | [Release 2.2.3](https://github.com/awslabs/`aws-advanced-jdbc-wrapper`/releases/tag/2.2.3) |
-| August 25, 2023   | [Release 2.2.4](https://github.com/awslabs/`aws-advanced-jdbc-wrapper`/releases/tag/2.2.4) |
-| October 3, 2023   | [Release 2.2.5](https://github.com/awslabs/`aws-advanced-jdbc-wrapper`/releases/tag/2.2.5) |
-| November 15, 2023 | [Release 2.3.0](https://github.com/awslabs/`aws-advanced-jdbc-wrapper`/releases/tag/2.3.0) |
-| November 29, 2023 | [Release 2.3.1](https://github.com/awslabs/`aws-advanced-jdbc-wrapper`/releases/tag/2.3.1) |
+| Release Date      | Release                                                                                  |
+|-------------------|------------------------------------------------------------------------------------------|
+| October 5, 2022   | [Release 1.0.0](https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/tag/1.0.0) |  
+| January 31, 2023  | [Release 1.0.1](https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/tag/1.0.1) | 
+| Mar 30, 2023      | [Release 1.0.2](https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/tag/1.0.2) |
+| April 28, 2023    | [Release 2.0.0](https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/tag/2.0.0) |  
+| May 11, 2023      | [Release 2.1.0](https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/tag/2.1.0) |
+| May 21, 2023      | [Release 2.1.1](https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/tag/2.1.1) |
+| June 14, 2023     | [Release 2.2.0](https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/tag/2.2.0) |
+| June 16, 2023     | [Release 2.2.1](https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/tag/2.2.1) |
+| July 5, 2023      | [Release 2.2.2](https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/tag/2.2.2) |
+| July 31, 2023     | [Release 2.2.3](https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/tag/2.2.3) |
+| August 25, 2023   | [Release 2.2.4](https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/tag/2.2.4) |
+| October 3, 2023   | [Release 2.2.5](https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/tag/2.2.5) |
+| November 15, 2023 | [Release 2.3.0](https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/tag/2.3.0) |
+| November 29, 2023 | [Release 2.3.1](https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/tag/2.3.1) |
+| December 18, 2023 | [Release 2.3.2](https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/tag/2.3.2) |
 
-``aws-advanced-jdbc-wrapper`` [follows semver](https://semver.org/#semantic-versioning-200) which means we will only
+`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
 adding new features. Minor version releases will include new features as well as fixes to existing features. We will do
-our
-best to deprecate existing features before removing them completely.
+our best to deprecate existing features before removing them completely.
 
 For minor version releases, `aws-advanced-jdbc-wrapper` uses a “release-train” model. Approximately every four weeks we
 release a new minor version which includes all the new features and fixes that are ready to go.
-Having a set release schedule makes sure ``aws-advanced-jdbc-wrapper`` is released in a predictable way and prevents a
+Having a set release schedule makes sure `aws-advanced-jdbc-wrapper` is released in a predictable way and prevents a
 backlog of unreleased changes.
 
 In contrast, `aws-advanced-jdbc-wrapper` releases new major versions only when there are a critical mass of
@@ -37,7 +37,7 @@ Please note: Both the roadmap and the release dates reflect intentions rather th
 as we learn more or encounter unexpected issues. If dates do need to change, we will be as transparent as possible,
 and log all changes in the changelog at the bottom of this page.
 
-Maintenance Policy
+# Maintenance Policy
 
 For `aws-advanced-jdbc-wrapper` new features and active development always takes place against the newest version.
 The `aws-advanced-jdbc-wrapper` project follows the semantic versioning specification for assigning version numbers
@@ -70,4 +70,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.3.1                | Current     | Apr 28, 2023    | N/A                      | N/A                    | 
+| 2             | 2.3.2                | 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.3.1-jmh.jar`.
+2. Run the benchmarks with the following command `java -jar build/libs/benchmarks-2.3.2-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.3.1'
+    implementation group: 'software.amazon.jdbc', name: 'aws-advanced-jdbc-wrapper', version: '2.3.2'
     implementation group: 'org.postgresql', name: 'postgresql', version: '42.5.0'
 }
 ```
@@ -30,13 +30,13 @@ 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/awslabs/aws-advanced-jdbc-wrapper/releases/download/2.3.1/aws-advanced-jdbc-wrapper-2.3.1.jar
+wget https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/download/2.3.2/aws-advanced-jdbc-wrapper-2.3.2.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.3.1.jar
+export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-advanced-jdbc-wrapper-2.3.2.jar
 ```
 
 ### As a Maven Dependency
@@ -48,7 +48,7 @@ You can use [Maven's dependency management](https://search.maven.org/search?q=g:
     <dependency>
         <groupId>software.amazon.jdbc</groupId>
         <artifactId>aws-advanced-jdbc-wrapper</artifactId>
-        <version>2.3.1</version>
+        <version>2.3.2</version>
     </dependency>
 </dependencies>
 ```
@@ -59,15 +59,15 @@ You can use [Gradle's dependency management](https://search.maven.org/search?q=g
 
 ```gradle
 dependencies {
-    implementation group: 'software.amazon.jdbc', name: 'aws-advanced-jdbc-wrapper', version: '2.3.1'
+    implementation group: 'software.amazon.jdbc', name: 'aws-advanced-jdbc-wrapper', version: '2.3.2'
 }
 ```
 
 To add a Gradle dependency in a Kotlin syntax, use the following configuration:
 
 ```kotlin
 dependencies {
-    implementation("software.amazon.jdbc:aws-advanced-jdbc-wrapper:2.3.1")
+    implementation("software.amazon.jdbc:aws-advanced-jdbc-wrapper:2.3.2")
 }
 ```
 

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.3.1
+>    - AWS JDBC Driver 2.3.2
 >    - 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.3.1
+>    - AWS JDBC Driver 2.3.2
 >    - 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.3.1
+>    - AWS JDBC Driver 2.3.2
 >    - 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.3.1
+>    - AWS JDBC Driver 2.3.2
 >    - Postgresql 42.5.4
 >    - Gradle 7
 >    - Java 11
@@ -38,7 +38,7 @@ Create a Gradle project with the following project hierarchy:
               │       └───main
               │       │   │───module.xml
               │       │   │───postgresql-42.5.4.jar
-              │       │   └───aws-advanced-jdbc-wrapper-2.3.1.jar
+              │       │   └───aws-advanced-jdbc-wrapper-2.3.2.jar
       └───standalone
           ├───configuration
               ├───amazon
@@ -135,7 +135,7 @@ Since this example uses the PostgreSQL JDBC driver as the target driver, you nee
 <module xmlns="urn:jboss:module:1.1" name="software.amazon.jdbc">
 
   <resources>
-    <resource-root path="aws-advanced-jdbc-wrapper-2.3.1.jar"/>
+    <resource-root path="aws-advanced-jdbc-wrapper-2.3.2.jar"/>
     <resource-root path="postgresql-42.5.4.jar"/>
   </resources>
 </module>

examples/SpringWildflyExample/wildfly/modules/software/amazon/jdbc/main/module.xml

@@ -19,7 +19,7 @@
 <module xmlns="urn:jboss:module:1.1" name="software.amazon.jdbc">
 
   <resources>
-    <resource-root path="aws-advanced-jdbc-wrapper-2.3.1.jar"/>
+    <resource-root path="aws-advanced-jdbc-wrapper-2.3.2.jar"/>
     <resource-root path="postgresql-42.5.4.jar"/>
   </resources>
 </module>

examples/VertxExample/README.md

@@ -3,7 +3,7 @@
 In this tutorial, you will set up a Vert.x application with the AWS JDBC Driver, and use the driver to execute some simple database operations on an Aurora PostgreSQL database.
 
 > Note: this tutorial was written using the following technologies:
->    - AWS JDBC Driver 2.3.1
+>    - AWS JDBC Driver 2.3.2
 >    - PostgreSQL 42.5.4
 >    - Java 8
 >    - Vert.x 4.4.2