diff --git a/CHANGELOG.md b/CHANGELOG.md index a20d74a3f..30d391669 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,6 +3,27 @@ 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.0] - 2025-06-10 +### :magic_wand: Added +- Add support of Blue/Green Deployment for Aurora MySQL clusters, Aurora PostgreSQL clusters, RDS MySQL Instances, and RDS PostgreSQL Instances. See [Using The Blue/Green Deployment Plugin](https://github.com/aws/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheBlueGreenPlugin.md). +- Allow driver to recognize lower case parameters ([PR #1361](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1361)). +- Set names for all internal threads ([PR #1410](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1410)). + +### :bug: Fixed +- Fix connection leaks in Limitless Plugin: + - [PR #1369](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1369). + - [PR #1388](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1388). +- Fix wrong calls in wrapper class ([PR #1413](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1413)). +- Fix host info type ([PR #1423](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1423)). +- Include optional trailing dot in DNS regex patterns ([Issue #1381](https://github.com/aws/aws-advanced-jdbc-wrapper/issues/1381)). +- Clean up connections in a separate thread ([Issue #1390](https://github.com/aws/aws-advanced-jdbc-wrapper/issues/1390)). + +### :crab: Changed +- Javadoc improvement ([PR #1368](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1368)). +- Set `failover2` as default plugin ([PR #1414](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1414)). +- Improve logging for Limitless Plugin ([PR #1431](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1431)). +- Clarifies support for blue/green deployments by specifying minimum versions ([PR #1434](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1434)). + ## [2.5.6] - 2025-04-09 ### :bug: Fixed - Issue with non-cluster database dialects and/or custom domains ([PR #1315](https://github.com/aws/aws-advanced-jdbc-wrapper/pull/1315)). @@ -435,6 +456,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.0]: https://github.com/awslabs/aws-advanced-jdbc-wrapper/compare/2.5.6...2.6.0 [2.5.6]: https://github.com/awslabs/aws-advanced-jdbc-wrapper/compare/2.5.5...2.5.6 [2.5.5]: https://github.com/awslabs/aws-advanced-jdbc-wrapper/compare/2.5.4...2.5.5 [2.5.4]: https://github.com/awslabs/aws-advanced-jdbc-wrapper/compare/2.5.3...2.5.4 diff --git a/Maintenance.md b/Maintenance.md index 4eb8129ba..8ce151a5f 100644 --- a/Maintenance.md +++ b/Maintenance.md @@ -1,7 +1,7 @@ # Release Schedule -| Release Date | Release | -|--------------------|------------------------------------------------------------------------------------------| +| Release Date | Release | +|--------------------|--------------------------------------------------------------------------------------| | October 5, 2022 | [Release 1.0.0](https://github.com/aws/aws-advanced-jdbc-wrapper/releases/tag/1.0.0) | | January 31, 2023 | [Release 1.0.1](https://github.com/aws/aws-advanced-jdbc-wrapper/releases/tag/1.0.1) | | Mar 30, 2023 | [Release 1.0.2](https://github.com/aws/aws-advanced-jdbc-wrapper/releases/tag/1.0.2) | @@ -32,6 +32,7 @@ | December 23, 2024 | [Release 2.5.4](https://github.com/aws/aws-advanced-jdbc-wrapper/releases/tag/2.5.4) | | March 6, 2025 | [Release 2.5.5](https://github.com/aws/aws-advanced-jdbc-wrapper/releases/tag/2.5.5) | | April 9, 2025 | [Release 2.5.6](https://github.com/aws/aws-advanced-jdbc-wrapper/releases/tag/2.5.6) | +| June 10, 2025 | [Release 2.6.0](https://github.com/aws/aws-advanced-jdbc-wrapper/releases/tag/2.6.0) | `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 @@ -85,4 +86,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.5.6 | Current | Apr 28, 2023 | N/A | N/A | +| 2 | 2.6.0 | Current | Apr 28, 2023 | N/A | N/A | diff --git a/benchmarks/README.md b/benchmarks/README.md index 5e341e0fe..90440ca93 100644 --- a/benchmarks/README.md +++ b/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.5.6-jmh.jar`. +2. Run the benchmarks with the following command `java -jar build/libs/benchmarks-2.6.0-jmh.jar`. 1. you may have to update the command based on the exact version of the produced JAR file diff --git a/docs/GettingStarted.md b/docs/GettingStarted.md index 684306083..9a7b4a73b 100644 --- a/docs/GettingStarted.md +++ b/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.5.6' + implementation group: 'software.amazon.jdbc', name: 'aws-advanced-jdbc-wrapper', version: '2.6.0' 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.5.6/aws-advanced-jdbc-wrapper-2.5.6.jar +wget https://github.com/aws/aws-advanced-jdbc-wrapper/releases/download/2.6.0/aws-advanced-jdbc-wrapper-2.6.0.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.5.6.jar +export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-advanced-jdbc-wrapper-2.6.0.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.5.6.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.0.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://search.maven.org/search?q=g: software.amazon.jdbc aws-advanced-jdbc-wrapper - 2.5.6 + 2.6.0 ``` @@ -61,7 +61,7 @@ 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.5.6' + implementation group: 'software.amazon.jdbc', name: 'aws-advanced-jdbc-wrapper', version: '2.6.0' } ``` @@ -69,7 +69,7 @@ To add a Gradle dependency in a Kotlin syntax, use the following configuration: ```kotlin dependencies { - implementation("software.amazon.jdbc:aws-advanced-jdbc-wrapper:2.5.6") + implementation("software.amazon.jdbc:aws-advanced-jdbc-wrapper:2.6.0") } ``` diff --git a/docs/using-the-jdbc-driver/UsingTheJdbcDriver.md b/docs/using-the-jdbc-driver/UsingTheJdbcDriver.md index 41da59266..640d64959 100644 --- a/docs/using-the-jdbc-driver/UsingTheJdbcDriver.md +++ b/docs/using-the-jdbc-driver/UsingTheJdbcDriver.md @@ -228,7 +228,7 @@ If there is an unreleased feature you would like to try, it may be available in software.amazon.jdbc aws-advanced-jdbc-wrapper - 2.5.6-SNAPSHOT + 2.6.1-SNAPSHOT system path-to-snapshot-jar diff --git a/docs/using-the-jdbc-driver/using-plugins/UsingTheFederatedAuthPlugin.md b/docs/using-the-jdbc-driver/using-plugins/UsingTheFederatedAuthPlugin.md index caeffe5a0..7cd9a7dc7 100644 --- a/docs/using-the-jdbc-driver/using-plugins/UsingTheFederatedAuthPlugin.md +++ b/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.5.6.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.0.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). diff --git a/examples/SpringBootHikariExample/README.md b/examples/SpringBootHikariExample/README.md index 7d5190d06..35b15029b 100644 --- a/examples/SpringBootHikariExample/README.md +++ b/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.5.6 +> - AWS JDBC Driver 2.6.0 > - Postgresql 42.5.4 > - Java 8 diff --git a/examples/SpringHibernateExample/README.md b/examples/SpringHibernateExample/README.md index 98995c165..dc98060ae 100644 --- a/examples/SpringHibernateExample/README.md +++ b/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.5.6 +> - AWS JDBC Driver 2.6.0 > - Postgresql 42.5.4 > - Gradle 7 > - Java 11 diff --git a/examples/SpringTxFailoverExample/README.md b/examples/SpringTxFailoverExample/README.md index 394b768a8..f77270848 100644 --- a/examples/SpringTxFailoverExample/README.md +++ b/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.5.6 +> - AWS JDBC Driver 2.6.0 > - Postgresql 42.5.4 > - Java 8 diff --git a/examples/SpringWildflyExample/README.md b/examples/SpringWildflyExample/README.md index 6828853b8..480a61157 100644 --- a/examples/SpringWildflyExample/README.md +++ b/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.5.6 +> - AWS JDBC Driver 2.6.0 > - Postgresql 42.5.4 > - Gradle 7 > - Java 11 diff --git a/examples/SpringWildflyExample/wildfly/modules/software/amazon/jdbc/main/module.xml b/examples/SpringWildflyExample/wildfly/modules/software/amazon/jdbc/main/module.xml index c16daa415..0b2f6faff 100644 --- a/examples/SpringWildflyExample/wildfly/modules/software/amazon/jdbc/main/module.xml +++ b/examples/SpringWildflyExample/wildfly/modules/software/amazon/jdbc/main/module.xml @@ -19,7 +19,7 @@ - + diff --git a/examples/VertxExample/README.md b/examples/VertxExample/README.md index 262831018..38ff7f576 100644 --- a/examples/VertxExample/README.md +++ b/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.5.6 +> - AWS JDBC Driver 2.6.0 > - PostgreSQL 42.5.4 > - Java 8 > - Vert.x 4.4.2 diff --git a/gradle.properties b/gradle.properties index cdd8bd3d4..d824b56c2 100644 --- a/gradle.properties +++ b/gradle.properties @@ -13,8 +13,8 @@ # limitations under the License. aws-advanced-jdbc-wrapper.version.major=2 -aws-advanced-jdbc-wrapper.version.minor=5 -aws-advanced-jdbc-wrapper.version.subminor=6 +aws-advanced-jdbc-wrapper.version.minor=6 +aws-advanced-jdbc-wrapper.version.subminor=0 snapshot=false nexus.publish=true diff --git a/wrapper/src/test/resources/hibernate_files/hibernate-core.gradle b/wrapper/src/test/resources/hibernate_files/hibernate-core.gradle index bd63da78e..5ea24eb3e 100644 --- a/wrapper/src/test/resources/hibernate_files/hibernate-core.gradle +++ b/wrapper/src/test/resources/hibernate_files/hibernate-core.gradle @@ -61,7 +61,7 @@ dependencies { transitive = true } testImplementation "joda-time:joda-time:2.3" - testImplementation files('/app/libs/aws-advanced-jdbc-wrapper-2.5.6.jar') + testImplementation files('/app/libs/aws-advanced-jdbc-wrapper-2.6.0.jar') testImplementation dbLibs.postgresql testImplementation dbLibs.mysql testImplementation dbLibs.h2 diff --git a/wrapper/src/test/resources/hibernate_files/java-module.gradle b/wrapper/src/test/resources/hibernate_files/java-module.gradle index 6bb94dc9c..2b78df17c 100644 --- a/wrapper/src/test/resources/hibernate_files/java-module.gradle +++ b/wrapper/src/test/resources/hibernate_files/java-module.gradle @@ -97,7 +97,7 @@ dependencies { // Since both the DB2 driver and HANA have a package "net.jpountz" we have to add dependencies conditionally // This is due to the "no split-packages" requirement of Java 9+ - testRuntimeOnly files('/app/libs/aws-advanced-jdbc-wrapper-2.5.6.jar') + testRuntimeOnly files('/app/libs/aws-advanced-jdbc-wrapper-2.6.0.jar') testRuntimeOnly dbLibs.mysql if ( db.startsWith( 'db2' ) ) {