diff --git a/CHANGELOG.md b/CHANGELOG.md index dedc70331..c4c641954 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,6 +3,25 @@ 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.0] - 2023-11-23 +### :magic_wand: Added +- Endpoint override for the AWS Secrets Manager plugin ([PR #707](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/707)). +- Allow users to set up a lambda to initialize new connections ([PR #705](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/705)). +- Introduced `Dialect.prepareConnectProperties` to allow dialect classes to modify connection properties when opening a new connection ([PR #704](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/704)). +- Native telemetry support ([PR #617](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/617)). +- Documentation on known limitations with global databases ([PR #695](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/695)). + +### :bug: Fixed +- Continue monitoring if unhandled Exception is thrown ([PR #676](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/676)). +- Password properties are now masked in logs ([PR #701](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/701) and [PR #723](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/723)). +- Issue when getting a connection for a closed statement ([PR #682](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/682)). +- Maven coordinates in README ([PR #681](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/681)). +- Update topology for specific methods ([PR #683](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/683)). + +### :crab: Changed +- Added buffer to IAM token expiry and moved token expiry time creation ([PR #706](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/706)). +- Documentation on known limitations with Blue/Green deployments ([PR #680](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/680)). + ## [2.2.5] - 2023-10-03 ### :magic_wand: Added - Optional preservation of partial session state post failover ([PR #632](https://github.com/awslabs/aws-advanced-jdbc-wrapper/pull/632)). @@ -190,6 +209,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.0]: https://github.com/awslabs/aws-advanced-jdbc-wrapper/compare/2.2.4...2.3.0 [2.2.5]: https://github.com/awslabs/aws-advanced-jdbc-wrapper/compare/2.2.4...2.2.5 [2.2.4]: https://github.com/awslabs/aws-advanced-jdbc-wrapper/compare/2.2.3...2.2.4 [2.2.3]: https://github.com/awslabs/aws-advanced-jdbc-wrapper/compare/2.2.2...2.2.3 diff --git a/Maintenance.md b/Maintenance.md index 30cdb5442..079e00b60 100644 --- a/Maintenance.md +++ b/Maintenance.md @@ -14,6 +14,7 @@ | 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, 2023 | [Release 2.3.0](https://github.com/awslabs/`aws-advanced-jdbc-wrapper`/releases/tag/2.3.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 @@ -68,4 +69,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.2.5 | Current | Apr 28, 2023 | N/A | N/A | +| 2 | 2.3.0 | Current | Apr 28, 2023 | N/A | N/A | diff --git a/benchmarks/README.md b/benchmarks/README.md index 0cc37d89e..8c4463876 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.2.5-jmh.jar`. +2. Run the benchmarks with the following command `java -jar build/libs/benchmarks-2.3.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 5b2226894..d750605fe 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.2.5' + implementation group: 'software.amazon.jdbc', name: 'aws-advanced-jdbc-wrapper', version: '2.3.0' 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.2.5/aws-advanced-jdbc-wrapper-2.2.5.jar +wget https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/download/2.3.0/aws-advanced-jdbc-wrapper-2.3.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.2.5.jar +export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-advanced-jdbc-wrapper-2.3.0.jar ``` ### As a Maven Dependency @@ -48,7 +48,7 @@ You can use [Maven's dependency management](https://search.maven.org/search?q=g: software.amazon.jdbc aws-advanced-jdbc-wrapper - 2.2.5 + 2.3.0 ``` @@ -59,7 +59,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.2.5' + implementation group: 'software.amazon.jdbc', name: 'aws-advanced-jdbc-wrapper', version: '2.3.0' } ``` @@ -67,7 +67,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.2.5") + implementation("software.amazon.jdbc:aws-advanced-jdbc-wrapper:2.3.0") } ``` diff --git a/docs/using-the-jdbc-driver/UsingTheJdbcDriver.md b/docs/using-the-jdbc-driver/UsingTheJdbcDriver.md index 797c387c5..de1ab0059 100644 --- a/docs/using-the-jdbc-driver/UsingTheJdbcDriver.md +++ b/docs/using-the-jdbc-driver/UsingTheJdbcDriver.md @@ -159,7 +159,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.2.6-SNAPSHOT + 2.3.1-SNAPSHOT system path-to-snapshot-jar diff --git a/examples/SpringBootHikariExample/README.md b/examples/SpringBootHikariExample/README.md index abbadde9d..b9e95976c 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.2.5 +> - AWS JDBC Driver 2.3.0 > - Postgresql 42.5.4 > - Java 8 diff --git a/examples/SpringHibernateExample/README.md b/examples/SpringHibernateExample/README.md index 2b80e0f07..03da71039 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 Advanced JDBC Driver 2.2.5 +> - AWS Advanced JDBC Driver 2.3.0 > - Postgresql 42.5.4 > - Gradle 7 > - Java 11 diff --git a/examples/SpringTxFailoverExample/README.md b/examples/SpringTxFailoverExample/README.md index 28c7a63d1..f801b96a3 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.2.5 +> - AWS JDBC Driver 2.3.0 > - Postgresql 42.5.4 > - Java 8 diff --git a/examples/SpringWildflyExample/README.md b/examples/SpringWildflyExample/README.md index e69bb4999..3b10077e1 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.2.5 +> - AWS JDBC Driver 2.3.0 > - 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.2.5.jar + │ │ └───aws-advanced-jdbc-wrapper-2.3.0.jar └───standalone ├───configuration ├───amazon @@ -135,7 +135,7 @@ Since this example uses the PostgreSQL JDBC driver as the target driver, you nee - + 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 98e54573c..9c4e557f4 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 fa55533e8..d2c18bf56 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.2.5 +> - AWS JDBC Driver 2.3.0 > - PostgreSQL 42.5.4 > - Java 8 > - Vert.x 4.4.2 diff --git a/gradle.properties b/gradle.properties index 00e30936a..74b0f0eb9 100644 --- a/gradle.properties +++ b/gradle.properties @@ -13,7 +13,7 @@ # limitations under the License. aws-advanced-jdbc-wrapper.version.major=2 -aws-advanced-jdbc-wrapper.version.minor=2 -aws-advanced-jdbc-wrapper.version.subminor=5 +aws-advanced-jdbc-wrapper.version.minor=3 +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 c9646b43f..0089cc4d4 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.2.5.jar') + testImplementation files('/app/libs/aws-advanced-jdbc-wrapper-2.3.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 770ae3b31..f8e425a42 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.2.5.jar') + testRuntimeOnly files('/app/libs/aws-advanced-jdbc-wrapper-2.3.0.jar') testRuntimeOnly dbLibs.mysql if ( db.startsWith( 'db2' ) ) {