Skip to content

Latest commit

 

History

History
336 lines (250 loc) · 13.3 KB

CHANGELOG.md

File metadata and controls

336 lines (250 loc) · 13.3 KB

Changelog

All notable changes to kb-util will be documented in this file.

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

[Unreleased]

Added

1.6.5 - 2025-02-04

Added

  • New Service2Service class that can be used both for HTTP calls and ContinutationStreams and will inject any existing OAuth to the call. The new methods should be used in all client implementations in modules that uses web-template project wit OAuth.
    Old methods not using OAuth has been kept so the transition can be implemented step-by-step and in each module.

1.6.4 - 2025-02-03

Added

  • Added JsonObjectStreamWriter and ExportWriterFactory methods using it.

1.6.3 - 2025-01-30

Added

  • Added Servlet for redirecting request to /api-docs endpoints to /api

1.6.2 - 2025-01-10

Changed

  • Excluded dependency jakarta.activation from jaxb-runtime as it is imported directly into kb-util.

1.6.1 - 2025-01-09

Updated

  • Updated YAML implementation to allow keys with null values. These gets interpreted as empty YAML structures.

Fixed

  • Fixed HeaderInputStream unit test which expected wrongly defined headers at kb.dk.

1.6.0

Changed

  • Marked JSONWrapper deprecated for removal; dependency on org.json will probably be removed too

Updated

  • Upgraded org.json version from 20231013 to 20240303

1.5.13

Fixed

  • Fixed order of datetime repairing.

1.5.12

Changed

  • Changed DatetimeParser to also fix UTC datetimes, where seconds are missing from timestamp.

1.5.11

Fixed

  • Nullpointer in ImplBase logging by adding a check for null.

1.5.10 [YANKED]

Changed

  • Changed logging in ImplBase to not include mapping and endpoint, when they are identical.

1.5.9

Added

  • Added TimeMap class that are used when enabling OAuth2 on services.

1.5.6

  • Added class DatetimeParser, which parses wrongly defined DOMS dates.

1.5.5

Changed

  • Changed logging in YAML class as it extrapolates by default since kb-util 1.5.0

1.5.4

Changed

  • Changed how OpenApiResource handles substitution of multiple values. Now substitutinos using placeholders in yaml paths can be used in OpenAPI enums. Related to Jira DRA-327

1.5.3

Added

  • Added option to CallbackReplacer for replacing the full capture when using Pattern with 1 group
  • Added the class OpenApiResource which handles dynamic updating of OpenAPI specifications in JAX-RS webapps.

1.5.1

Fixed

  • Timing.toString now allows child-specific display elements instead of using the parent elements

1.5.0

Added

  • Extended YAML-path syntax: ** for matching any key at any depth (DRA-99)
  • YAML-path supporting Visitor pattern for YAML (DRA-99, DRA-134)
  • Fully generic getMultiple method, utilizing the Visitor implementation (DRA-99)

Changed

  • Leaf-key based getMultipleFromSubYaml in YAML is now deprecated as the extended YAML syntax cover these scenarios (DRA-99)
  • Breaking: Leaf-key based getMultiple has changed behaviour to generic yPath expansion (DRA-99)
  • Breaking: Default behaviour for YAML is now to extrapolate. Alternate constructors are provided to disable extrapolation (DRA-145)

Fixed

  • Timing.measure and Timing.getAllChrildren are now thread safe (DRA-165)

1.4.26

Added

  • Added support for the Paging-Record-Count header in the ContinuationStream

1.4.24

Fixed

  • The method getRecordCount in ContinuationUtil returned the value of getMore. Has been fixed to return actual record count for the stream.

1.4.23

Added

  • Support for extracting multiple values from a YAML file that share the same key. The getMultiple method works for YAMLs that are not overly complicated.

1.4.22

Added

  • Support for fetching git information through BuildInfoManager. Commit hash, deployed branch, time of latest commit and closest git tag is extracted.

1.4.19

Added

  • Support for request headers when creating HeaderInputStreams from URIs
  • Support for Paging-Record-Count headers for continuations

1.4.18

Added

  • Helper classes for HTTP header based continuation tokens for paging through datasets through webservices

1.4.17

Bugfix

  • Wrong dependency for @Nullable

1.4.16

Changed

  • Bump of practically all dependencies to latest compatible version

1.4.15

Added

  • XMLStepper.serializeSubElements for streaming serialization (aka extraction) of XML sub elements.
  • Extension of the Timing class with several helper methods for lambda and streaming
  • Make HttpServletResponse optional in wrap for StreamingExportFactory

1.4.14

Bugfix

  • Path-substitution still failed when using YAML.getSubMap(...) and requesting a key with a substitution using value.

1.4.13

Added

  • Path-substitution in YAML, allowing for YAML entries like dburl: ${path:databases.primary.url}
  • Conditionals in path in YAML, allowing for Java calls like myYAML.get("databases.[default=true].url");
  • Combining path substitution and conditional paths, allowing for YAML entries like dburl: ${path:databases.[default=true].url}

1.4.12

Added

  • Support for positioning an XMLStreamReader at a given XPath, so that the path-matching sub-XML can be processed or extracted
  • Exception throwing on unfulfillable expansion in YAML configs

1.4.11

Added

  • Large port from sb-util: The full replacer-suite and XML-utilities plus profiling tools

1.4.10

Added

  • ExtractionUtils focused on sampling and extracting minimum or maximum values from Streams and Collections.
  • Splitting of an incoming Stream to multiple partitions

1.4.9

Added

  • Auto updating YAML based config
  • Streaming export, used by webservices
  • HTTP Exceptions used by webservices
  • OpenAPI implementation super class used by OpenAPI applications
  • build.properties programmatic access (application-ID, version, build-time)
  • kbutil.build.properties file in the kb-util JAR

1.4.8

Added

  • Support for quoting keys in YAML paths to allow for keys with dots (.)
  • Expansion of system properties in YAML
  • Fully flattening (single line) XML.domToString method

1.4.7

Changed

  • Fix resource leak in Resolver#walkMatches

1.4.6

Added

  • CallbackReplacer and XMLEscapeSanitiser: Regexp-based replacements with callbacks

1.4.5

Added

  • Added StringListUtils.toModifiableList(list) utility to check, and, if nessesary, wrap your list as a modifiable list

Changed

  • Fixed JSON.java to correctly handle java 8 datetime objects

1.4.4

Added

Changed jaxb to use

<!--Nessesary for jaxb-xml with java 11-->
<!-- https://mvnrepository.com/artifact/jakarta.xml.bind/jakarta.xml.bind-api -->
<dependency>
    <groupId>jakarta.xml.bind</groupId>
    <artifactId>jakarta.xml.bind-api</artifactId>
    <version>2.3.2</version>
</dependency>
<!-- https://mvnrepository.com/artifact/jakarta.activation/jakarta.activation-api -->
<dependency>
    <groupId>jakarta.activation</groupId>
    <artifactId>jakarta.activation-api</artifactId>
    <version>1.2.1</version>
</dependency>
<!-- https://mvnrepository.com/artifact/org.glassfish.jaxb/jaxb-runtime -->
<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-runtime</artifactId>
    <version>2.3.2</version>
    <scope>runtime</scope>
</dependency>
<!--XML end-->

as this prevents the nasty

java.lang.module.FindException: Two versions of module jakarta.activation found in /home/abr/Projects/java-xcorrsound/java-xcorrsound-cli/target/java-xcorrsound-cli-0.1-SNAPSHOT/bin/../lib (jakarta.activation-api-1.2.2.jar and jakarta.activation-1.2.2.jar)

when used in a module-based projekt

1.4.3

Added

1.4.2

Added

  • Better exceptions when creating a YAML from non-existing resources
  • Choice between loading multiple YAML-files as a single reference-supporting stream or as multiple overwriting streams

1.4.1

Bugfix

  • Globbing now supports . and .. (foo/bar/../bar/./boom.txt)

1.4.0

Added

  • YAML.parse methods that takes a Path or File as input, rather than a classpath Name or InputStream. Just for more flexibility in how to read your YAML file.
  • Globbing (resolving of files with wildcards) to the Resolver
  • Default globbing when resolving YAML configs

1.3.0

Added

  • Shadow-class dk.kb.util.YAML introduced to compensate for breaking backwards compatibility in 1.2.0.

  • Dependency for jaxb runtime (org.glassfish.jaxb:jaxb-runtime) to make xml classes not throw runtime exceptions due to missing implementation

Updated

  • Dependencies updated:
    • snakeyaml: 1.23 -> 1.26
    • slf4j-api: 1.7.25 -> 1.7.30
    • jackson-databind: 2.9.10 -> 2.11.2
    • jakarta.ws.rs-api: 2.1.5 -> 2.1.6

1.2.0

Added

  • YAML.java supports indexed lists in getter methods

  • Generic utils from alma-client ported to kb-utils

    • JSON
      • fromJson(String/File) parses json to java object
      • toJson(Object) serialize java object to json
    • AutochainingIterator: Class to automatically chain generated iterators
    • NamedThread: Autoclosable thread namer
    • StringListUtils: Utility String and Stream methods
    • Resolver
      • GetPathFromClasspath -> Path
      • ReadFileFromClasspath -> String
      • OpenFileFromClasspath -> InputStream
    • XML (ported and adapted from sbutil)
      • String/Stream to/from Document
      • Java Object to/from Xml String
      • XPath support

  • Apache Commons Utilities that we should use

    • commons-io:2.7
    • commons-collections4:4.4
    • commons-codec:1.14
    • commons-lang3:3.11
    • commons-text:1.9

  • Xml libraries for java 11+

    • jakarta.xml.bind-api 2.3.3
    • com.sun.xml.bind:jaxb-impl:2.3.3

  • JSON libraries

    • com.fasterxml.jackson.core:jackson-databind:2.11.0
    • jakarta.ws.rs:jakarta.ws.rs-api:2.1.5

  • Other libraries

    • org.hamcrest:hamcrest-core:2.1 for assertThat in tests
    • jakarta.validation:jakarta.validation-api:2.0.2 for @NotNull annotations in method contracts

1.1.0

Added

  • Changelog
  • Release procedure in the README.md
  • Fail-early for missing values when using YAML get-methods without default value
  • Key-value based recursive extraction of YAML leaf entries
  • YAMLUtils with toProperties method for conversion to flat Java Properties

1.0.0

Added

  • The kb-util-project itself
  • YAML: Parse from file or URL, path-based getters of elements