CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, markdownlint, and this project adheres to Semantic Versioning.

[4.0.0-beta.3.0] - 2026-03-12

Changed in 4.0.0-beta.3.0

• Added SzUtilities.bootstrapSettings() method to build bootstrap JSON settings for Senzing environment initialization without requiring a database URI, enabling access to SzProduct functionality.
• Added null-checks to existing SzUtilities.basicSettingsFromDatabaseUri() overloads to fail fast on null URI parameters.
• Fixed trailing comma in JSON example in SzUtilities javadoc.
• Added pre-release suffix support to SemanticVersion for parsing and comparing versions with -alpha, -beta, and -rc suffixes (e.g.: "2.0.0-alpha.2.0", "2.0.0-beta.3.2", "2.0.0-rc.2.1"). Pre-release suffixes are normalized to lowercase.

[4.0.0-beta.2.1] - 2026-01-29

Changed in 4.0.0-beta.2.1

• Changed AsyncWorkerPool to clear busy state in finally block to safeguard against deadlocks on close().
• Added thread-specific override of debug logging in LoggingUtilities
• Fixed potential deadlock in ConnectionPool and PooledConnectionHandler by making the error handling of failed connections more robust.
• Fixed error handling in PostgreSqlConnector to prevent leaking of database connections.

[4.0.0-beta.2.0] - 2026-01-22

Changed in 4.0.0-beta.2.0

• Made the com.senzing.util.SzInstallLocations class public
• Minor dependency version bumps

[4.0.0-beta.1.6] - 2025-12-11

Changed in 4.0.0-beta.1.6

• Added com.senzing.util.SzUtilities
• Added support for connection properties to com.senzing.sql.Connector
• Added support for connection properties to com.senzing.sql.SQLiteConnector

[4.0.0-beta.1.5] - 2025-12-02

Changed in 4.0.0-beta.1.5

• Upgraded dependencies
• Added methods to TextUtilities for ranged size of random text generation
• Added date-handling methods to JsonUtilities using standard JSON date strings
• Modified SQLiteConnector to use NOMUTEX open mode to achieve multi-threaded usage, allowing multiple connections to access the same file so long as no connection is used concurrently in multiple threads.

[4.0.0-beta.1.4] - 2025-10-22

Changed in 4.0.0-beta.1.4

• Upgraded dependencies
• Added methods to LoggingUtilities for StackTraceElement formatting
• Cleaned up compile warnings
• Linting and other minor fixes

[4.0.0-beta.1.2] - 2025-08-12

Changed in 4.0.0-beta.1.2

• First official V4 beta release
• Upgraded to Java 17 code compatibility
• Upgraded dependencies
• Removed dependencies on Senzing v3.x since this will be used with Senzing v4 tools
• Upgraded sqlite-jdbc since getGeneratedKeys() support was restored
• Switched from nexus-staging-maven-plugin to central-publishing-maven-plugin

[3.3.7] - 2025-10-22

Changed in 3.3.7

• Updated dependencies:
  • Upgraded junit-jupiter from version 5.13.4 to 5.14.0
  • Added direct dependency to commons-lang3 version 3.19.0 to override transitive dependency to version 3.17.0 from commons-configuration2 due to CVE-2025-48924
  • Upgraded maven-compiler-plugin from version 3.14.0 to 3.14.1
  • Upgraded maven-surefire-plugin from version 3.5.3 to 3.5.4
  • Upgraded maven-javadoc-plugin from version 3.11.2 to 3.12.0
  • Upgraded central-publishing-maven-plugin from version 0.8.0 to 0.9.0

[3.3.6] - 2025-08-12

Changed in 3.3.6

• Eliminated compile warnings
• Updated dependencies:
  • Upgraded sqlite-jdbc from version 3.42.0.1 to 3.50.3.0 since getGeneratedKeys() support was restored

[3.3.5] - 2025-08-12

Changed in 3.3.5

• Switched from nexus-staging-maven-plugin to central-publishing-maven-plugin
• Updated dependencies:
  • Upgraded commons-csv from version 1.14.0 to 1.14.1
  • Updated jackson-xxxx dependencies from version 2.19.0 to 2.19.2
  • Updated junit-jupiter from version 5.13.1 to 5.13.4
  • Upgraded maven-gpg-plugin from version 3.2.7 to 3.2.8

[3.3.4] - 2025-06-09

Changed in 3.3.4

• Updated dependencies to newer versions:
  • Upgraded commons-configuration2 from version 2.11.0 to 2.12.0
  • Upgraded junit-jupiter from version 5.12.2 to 5.13.1

[3.3.3] - 2025-04-16

Changed in 3.3.3

• Updated dependencies to newer versions:
  • Upgraded commons-csv from version 1.12.0 to 1.14.0
  • Upgraded icu4j from version 76.1 to 77.1
  • Upgraded junit-jupiter from version 5.11.3 to 5.12.2

[3.3.2] - 2024-12-05

Changed in 3.3.2

• Updated dependencies to newer versions:
  • Upgraded icu4j from version 75.1 to 76.1
  • Upgraded junit-jupiter from version 5.11.2 to 5.11.3
  • Upgraded maven-surefire-plugin from version 3.5.1 to 3.5.2
  • Upgraded maven-javadoc-plugin from version 3.10.1 to 3.11.1

[3.3.1] - 2024-10-08

Changed in 3.3.1

• Updated dependencies to newer versions:
  • Upgraded commons-csv from version 1.11.0 to 1.12.0
  • Upgraded junit-jupiter from version 5.10.3 to 5.11.2
  • Upgraded maven-surefire-plugin from version 3.3.0 to 3.5.1
  • Upgraded maven-javadoc-plugin from version 3.7.0 to 3.10.1
  • Upgraded maven-gpg-plugin from version 3.2.4 to 3.2.7

[3.3.0] - 2024-06-19

Changed in 3.3.0

• Updated dependencies to newer versions:
  • Upgraded commons-csv from version 1.10.0 to 1.11.0
  • Upgraded commons-configuration2 from version 2.9.0 to 2.11.0
  • Upgraded icu4j from version 74.2 to 75.1
  • Upgraded maven-compiler-plugin from version 3.12.1 to 3.13.0
  • Upgraded maven-surefire-plugin from version 3.2.5 to 3.3.0
  • Upgraded maven-source-plugin from version 3.3.0 to 3.3.1
  • Upgraded maven-javadoc-plugin from version 3.6.3 to 3.7.0
  • Upgraded maven-gpg-plugin from version 3.1.0 to 3.2.4
  • Upgraded nexus-staging-maven-plugin from version 1.6.13 to 1.7.0

[3.2.0] - 2024-02-29

Changed in 3.2.0

• Added sqlLeast and sqlGreatest functions to com.senzing.sql.DatabaseType
• Updated dependencies to newer versions:
  • Upgraded junit-jupiter from version 5.10.1 to 5.10.2
  • Upgraded maven-surefire-plugin from version 3.2.3 to version 3.2.5

[3.1.5] - 2024-01-10

Changed in 3.1.5

• Updated dependencies to newer versions:
  • Updated icu4j to version 74.2
  • Updated maven-compiler-plugin to version 3.12.1
  • Updated maven-surefire-plugin to version 3.2.3
  • Updated maven-javadoc-plugin to version 3.6.3

[3.1.4] - 2023-12-07

Changed in 3.1.4

• Added com.senzing.sql.SQLUtilities.UTC_CALENDAR to provide a reusable Calendar instance for working with UTC timestamps in SQL databases for JDBC getTimestamp() function.
• Added additional constructors for MissingDependenciesException.
• Added new functions to JsonUtilities:
  • JsonUtilities.add(JsonObjectBuilder,String,JsonObjectBuilder)
  • JsonUtilities.add(JsonObjectBuilder,String,JsonArrayBuilder)
  • JsonUtilities.add(JsonObjectBuilder,String,JsonValue)
  • JsonUtilities.add(JsonArrayBuilder,JsonObjectBuilder)
  • JsonUtilities.add(JsonArrayBuilder,JsonArrayBuilder)
  • JsonUtilities.add(JsonArrayBuilder,JsonValue)
• Changed sqlite-jdbc dependency to version 3.42.0.1 to avoid the problematic version 3.43.x.x which carelessly breaks backwards compatibility by removing functionality that has been supported for sixteen (16) years.
• Updated runtime and build dependencies.

[3.1.3] - 2023-10-16

Changed in 3.1.3

• Added getDiagnosticLeaseInfo() method to com.senzing.sql.ConnectionPool to allow diagnostic analysis of currently outstanding Connection leases for determining problems when the ConnectionPool is exhausted.

[3.1.2] - 2023-10-13

Changed in 3.1.2

• Fixed bug in DatabaseType for SQLITE handing of setTimestamp().
• Added functionality to LoggingUtilities to format StackTraceElement as a stack trace.

[3.1.1] - 2023-09-13

Changed in 3.1.1

• Removed dependency on ini4j and replaced with Apache commons-configuration2

[3.1.0] - 2023-09-06

Changed in 3.1.0

• Added com.senzing.sql.ConnectionPool class
• Added com.senzing.sql.SQLUtilities class
• Added com.senzing.sql.DatabaseType class
• Added com.senzing.sql.TransactionIsolation class
• Added com.senzing.sql.ConnectionProvider interface
• Added com.senzing.sql.PoolConnectionProvider class
• Added com.senzing.sql.PooledConnectionHandler class
• Added com.senzing.sql.Connector interface
• Added com.senzing.sql.SQLiteConnector class
• Added com.senzing.sql.PostgreSqlConnector class
• Added com.senzing.naming.Registry class
• Modified com.senzing.util.ZipUtilities with new compression methods
• Updated dependencies to newer versions:
  • Updated ICU4j to version 71.1
  • Updated Apache Commons-CSV to version 1.9.0
  • Updated Maven Compiler Plugin to version 3.10.1
  • Updated Maven Javadoc Plugin to version 3.4.0
  • Updated Nexus Staging Maven Plugin to version 1.6.13

[3.0.3] - 2023-03-10

Changed in 3.0.3

• Updated dependencies to newer versions.

[3.0.2] - 2022-11-01

Changed in 3.0.2

• Updated RecordReader to handle surrounding spaces around quoted strings in CSV records
• Updated RecordReaderTest to test for surrounding spaces, leading spaces and trailing spaces for quoted strings
• Added JsonUtilities.parseValue() method
• Updated Apache Commons CSV to version 1.9.0
• Changed usage of CSVFormat to CSVFormat.Builder (in according with v1.9.0)

[3.0.1] - 2022-08-23

Changed in 3.0.1

• Fixed a bug in CommandLineUtilities.java that prevented primary options (typically options with no dependencies) from using fallback environment variables.

[3.0.0] - 2022-05-04

Changed in 3.0.0

• Modified RecordReader to eliminate functionality pertaining to entity types.
• Modified pom.xml dependency for g2-sdk-java for version 3.0.0 or later.

[2.1.0] - 2022-04-08

Changed in 2.1.0

• Added AsyncWorkerPool.isBusy() function and associated unit tests.
• Added Timers.getElapsedTime() function and associated unit tests.
• Minor change to JsonUtilities.addProperty() and JsonUtilities.addElement() to allow conversion of Set and Array values to be treated the same as List. It now handles all Collection values the same as List and all Array values as lists as well.
• Modified JsonUtilitiesTest to validate the changes made to JsonUtilities.addProperty() and JsonUtilities.addElement().

[2.0.2] - 2022-03-18

Changed in 2.0.2

• Added Timers.getElapsedTime(String) function to obtain the time for a specific named timer.
• Added AsyncWorkerPool.isBusy() function to check if a task is currently executing.

[2.0.1] - 2022-03-07

Changed in 2.0.1

• Updates to pom.xml to prevent pulling beta versions of senzing-sdk-java version 3.0.0 via the Maven dependency range.

[2.0.0] - 2022-02-03

Changed in 2.0.0

• Initial production release with complete unit tests
• Added error checking to com.senzing.util.Timers
• Added com.senzing.reflect.PropertyReflector class
• Added primitive/promoted type functions to com.senzing.reflect.ReflectionUtilities
• Renamed JsonUtils to JsonUtilities to be consistent with other utility classes
• Changed version to 2.0.0 for initial production release to indicate compatibility with Senzing 2.x (i.e.: com.senzing.io.RecordReader will parse records as Senzing 2.x expects them)

[0.7.0] - 2022-01-07

Changed in 0.7.0

• Added com.senzing.reflect.PropertyReflector utility class.

[0.6.0] - 2021-11-20

Changed in 0.6.0

• Modified com.senzing.cmdline.CommandLineOption to add isSensitive() function with a default implementation based on the naming of the enum
  constant being either PASSWORD or ending in _PASSWORD.
• Changed the semantics of parseCommandLine() function in com.senzing.cmdline.CommandLineUtilities so that it returns the Map describing the command-line options and takes an optional List to populate with DeprecatedOptionWarning instances if the caller is interested.
• Fixed parameters and throws clause on CommandLineParser.parseCommandLine() to better match CommandLineUtilities.parseCommandLine()
• Fixed throws clause for ParameterProcessor.process() so that it now throws BadOptionParameterException.

[0.5.0] - 2021-11-16

Changed in 0.5.0 (Initial Public Prerelease)

• Initial refactoring from senzing-garage/senzing-api-server project
• Added many unit tests
• Unit tests still pending before version 1.0.0 release are as follows:
  • com.senzing.util.JsonUtils
  • com.senzing.util.LoggingUtilities
  • com.senzing.util.OperatingSystemFamily
  • com.senzing.util.SemanticVersion
  • com.senzing.util.ThreadJoinerPool
  • com.senzing.util.Timers
  • com.senzing.util.WorkerThreadPool
  • com.senzing.util.ZipUtilities