com.dua3.utility

Some libraries with utility classes.

library	description	exported module
utility	general purpose utilities	com.dua3.utility
utility-db	database utilities	com.dua3.utility.db
utility-fx	JavaFX utilities	com.dua3.utility.fx
utility-logging	logging utilities and simple logging implementation	com.dua3.utility.logging
utility-samples	samples	com.dua3.utility.samples
utility-swing	swing utilities	com.dua3.utility.swing

License

This library is developed by Axel Howind and available under the MIT License. Refer to the accompanying file LICENSE for details.

Source

Source code is available at https://github.com/xzel23/utility.

Requirements

• JDK 17 or later

Including the library

Binaries are available on Maven Central Repository.

Maven

Replace ${utility_version} with the current version.

    <dependency>
        <groupId>com.dua3.utility</groupId>
        <artifactId>utility</artifactId>
        <version>${utility_version}</version>
    </dependency>
    <dependency>
        <groupId>com.dua3.utility</groupId>
        <artifactId>utility-db</artifactId>
        <version>${utility_version}</version>
    </dependency>
    ...

Gradle

Replace ${utility_version} with the current version.

dependencies {
    compile        "com.dua3.utility:utility:${utility_version}"
    compile        "com.dua3.utility:utility-db:${utility_version}"
    ...        
}

Logging

As of version 12.0.0, logging changed from SLF4J to Log4J-API!

You can use whatever logging implementation you want, for configuration refer to the Log4J documentation. You can also look at the swing samples that use a SwingLogPane and route all logging output regardless of source (Log4J, SLF4J, JUL) to the logging implementation.

utility-logging

This project adds a small lightweight implementation that can be used instead of SLF4J SimpleLogger. It is intended as a lightweight logging implementation in desktop applications or during development and does not support advanced features such as log rotation or writing to a database.

Configuration is done by providing a file called logging.properties on the classpath.

• configure log level:

   logger.level = (ERROR|WARN|INFO|DEBUG|TRACE)(, <prefix>:(ERROR|WARN|INFO|DEBUG|TRACE))*
  

  setting ony the global level:

   logger.level = INFO
  

  setting global level and different levels for packages:

   logger.level = WARN, com.dua3.:DEBUG, my.current.project.:TRACE
  

• configure logging to console

   logger.console.stream = system.out|system.err
   logger.console.colored = true|false
  

• configure a log buffer (see below):

  logger.buffer = #entries
  

Using SLF4J with different logging frameworks

Just to save time searching the internet for this:

• JUL (java.util.logging)

  • add "org.slf4j:jul-to-slf4j:" to your dependencies

  • when using JPMS modules, add requires jul.to.slf4j; to your module-info.java

  • initialize the bridge handler:

    static {
        java.util.logging.LogManager.getLogManager().reset();
        SLF4JBridgeHandler.install();
    }
    

• Log4J2

  • add "org.apache.logging.log4j:log4j-to-slf4j:2.18.0" to your dependencies

SwingLogPane (Swing-widget for log viewing)

If you want to show logs in a swing application, configure a log buffer and add a SwingLogPane to your UI. Have a look at the code of SwingComponentsSample for details.

Using the BuildInfo class in Gradle builds

Add this to your build.gradle to include a build.properties file in your JAR:

// === generate BuildInfo ===
def generateBuildInfo = tasks.register('generateBuildInfo') {
    // do not cache the buildinfo
    outputs.upToDateWhen { false }

    // create build.properties
    doLast {
        def resourcesDir = sourceSets.main.output.resourcesDir
        resourcesDir.mkdirs()

        def buildTime = OffsetDateTime.now().atZoneSameInstant(ZoneId.of("UTC"))
        def contents = "build.time=${buildTime}\nbuild.version=${version}\n"

        def file = new File(resourcesDir, "build.properties")
        file.text = contents
    }
}

Add this in your code to read the build.properties file and create a BuildInfo instance containing version and build time information:

public static final BuildInfo BUILD_INFO = BuildInfo.create(Main.class, "/build.properties");

Cabe

Starting with version 14, utility uses JSpecify annotations for all method parameters.

The resulting Jar files are instrumented using Cabe.

When you run your code with assertions disabled, virtually no overhead is introduced, as assertions are removed at JVM level.

When running your code with exceptions enabled, parameters are checked for invalid null values and an AssertionError will be generated when null is passed for a @NonNull annotated parameter. The assertion message contains the name of the parameter.

Logging

• all internal logging is done through log4j-api

Changes

14

• org.jspecify annotations are used in the code base; all modules annotated with @NullMarked. That you may not pass null in any method or constructor parameter that is not explicitly annotated as @Nullable.
• module definitions have been reviewed.
• change type parameter for IoUtil.closeAll() to ? extends AutoCloseable
• complete Javadoc
• code cleanup

13.1.2

• IoUtil.closeAll()
• code cleanup
• prevent serialization of logging related classes for security reasons
• javadoc

13.1.1

• FIX: do not throw an exception when temp directory permissions cannot be set, log a warning message instead. The reason is that especially the Files.setWriteable() does not seem to always return correct results, even when the
  directory does have the requested permissions.

13.1

• BREAKING: in the fx module, the methods Validator.matches() and Validator.notEmpty() have been renamed to setRegex() and disallowEmpty() to better express the fact that the content is not checked immediately but instead a rule is added that is validated at validation time
• IMPORTANT: resolved ambiguity of LangUtil.ConsumerThrows.andThen() overloads by renaming the version taking an argument of ConsumerThrows to andThenTry(); this might require a source change but code compiled using the previous version should still work in the same way
• IoUtil: added methods createSecureTempDirectory(), createSecureTempDirectoryAndDeleteOnExit(), deleteRecursiveOnExit()
• small improvements and code cleanup

13.0.2

• add overload of DataUtil.diff() that takes a map factory

13.0.1

• TextUtil.toString(Object obj, String valueIfNull)
• use HexFormat for converting Color instances to hex format
• add Text Filter to FxLogPane

13

• new utility-fx modules with JavaFX related classes and components
• StreamUtil.zip() has been changed to take an operation as third parameter that defines the combining operation
• StreamUtil.concat() did not close streams
• SwingImageUtil, SwingFontUtil have been renamed to AwtImageUtil, AwtFontUtil as they are usable also in non-Swing applications
• Color methods have been renamed to reduce ambiguity
• SwingUtil.getDisplayScale() to retrieve the actual scaling factor for the display (taking into account UHD and retina displays)
• AffineTransformation2f.combine()
• return value of getTextDimension() changed to Rectangle2f (this gives access to the baseline value)
• Rectangle2f.getXCenter(), getYCenter(), min(), max(), center(), dimension(), withCenter()
• Dimension2f.scaled()
• Font.scaled()
• TextUtil.isBlank(CharSequence)
• toolkit agnostic Graphics interface and implementations for Swing and JavaFX
• code cleanups and reorganizations
• Javadoc additions
• many small fixes and improvements

12.3

• added i18n package
• ConsoleHandler (utility-logging): make colored output configurable at runtime
• added getGlobalDispatcher to the LogUtilLog4J and LogUtilSLF4J classes
• improve logging performance
• add LogUtilLog4J.init(LogLevel) to initialize the logging system and reroute all logging through Log4J
• log filtering
• extracted common code from the two Swing Logging samples
• added documentation to the LogUtil classes about rerouting logging implementations
• code cleanup and minor fixes
• StopWatch.log...() returns an Object that does the formatting in the toString() method instead of a Supplier to integrate better with logging frameworks (this way, lambda support is not needed)
• TextUtil.nonEmptyOr()

12.2.1

• add LangUtil.require...() overloads for double and float arguments
• LangUtil.isBetween() will throw IllegalArgumentsException when an invalid intervall is specified instead of using an assertion

12.2

• support for options that prevent validation when present, i.e., to pass a help flag without the parser throwing an exception when there are problems with other options
• moved to Arguments and made public argument validation methods
• add separate desciption for arguments
• added LangUtil.require...() methods to check integer arguments
• added LangUtil.formatLazy()
• fix: LoggerFactorySlf4j should not dispose the default handler
• add LogEntryDispatcher.getHandlers()
• make Stopwatch(Supplier name) protected

12.1.2

• IoUtil.toURI(Path) returns relative URI when called with relative Path instance

12.1.1

• code cleanup and refactorings
• fix a malformed logging message
• set modification date for zip entries
• fix creation of extra empty file in zip

12.1.0

• add TextUtil.digest() methods to support other digests than MD5
• digests can be calculated on streams without loading the full data into memory
• add IoUtil.zip() and unzip() methods
• javadoc additions

12.0.9

• allow null attr parameter for SwingDocumentFilter methods replace() and insertString()

12.0.8

• javadoc updates
• refactorings and small fixes
• fix race condition in SwingLogPane
• update dependencies and plugins
• code refactorings and small fixes

12.0.7

• remove obsolete null-checks
• update gradle, cabe

12.0.6

• TextUtil.quote(), TextUtil.quoteIfNeeded(), TextUtil.joinQuoted()
• use Java compatible quoting in Arguments.toString()

12.0.5

• add Arguments.toString()
• add Option.toString()
• fix: TextUtil.toSystemLineEnds() appended a newline character even if the argument did not end with newline
• fix: ArgumentsParserTest failed on Windows

12.0.4

• fix runtime error (cabe)

12.0.3

• fix record equals() not accepting null arguments
• make output of ArgumentsParser.help() more compact

12.0.2

• Use assertions to check parameters of internal methods, throw NPE for parameters to methods that are part of the public API. From now on, snapshots and beta versions will unconditionally throw AssertionErrors when null is passed to a parameter that isn't nullable. In release versions, standard assertions are used for internal methods while methods that are part of the public API will throw NullPointerExceptions.

12.0.1

• remove obsolete classes in utility.math.geometry
• fix locale dependent output of toString() implementations
• code cleanup
• dependency updates

12.0.0

• BREAKING: ArgumentsParser has been split into ArgumentsParserBuilder and ArgumentsParser; see unit tests for examples
• BREAKING: RichText.trim() now works the same as String.trim(), i.e. only considers character codes less than or equal to ' ' as whitespace. Use RichText.strip() to remove all whitespace.
• BREAKING: OpenMode.includes() has been renamed to isIncluded()
• BREAKING: removed Pair.toMap() static methods. Use Map.ofEntries() instead.
• BREAKING: LineOutputStream returns lines with line end characters removed
• BREAKING: removed PredefinedDateFormat - use PredefinedDateTimeFormat instead
• Pair<T1,T2> now implements Map.Entry<T1,T2>
• added RichText.strip(), RichText.stripLeading(), RichText.stripTrailing()
• added ThreadFactoryBuilder class
• enable automatic download of Gradle JVM toolchains in build
• util-logging: reworked util-logging, simplified SwingLogPane use, fixed multithreading issues in SwingLogPane
• util-db: added NamedParameterStatement.setInstant(), cleaned up NamedParameterStatement javadoc
• SimpleNamespaceContext: added methods get Prefixes(), getNamespaceURIs
• TextUtil.transform(): accept Object instances as substitutions (String.valueOf() is used for formatting of instances)
• reduce code duplication
• increase unit test coverage
• add @Nullable annotations for record types where needed (because cabe 2.x adds support for record types)
• add javadoc
• fix RichText.split() with non-trivial regex and limit 0 not skipping trailing empty segments in result
• fix build issues on windows
• fix issues in FontDef CSS conversion
• fix font size not extracted when getting FontDef directly from TextAttributes
• fix Vector2f returning NaN for zero denominator
• fix IoUtil.glob() and IoUtil.findFiles() returning paths with inconsistent root under certain circumstances
• fix smaller issues
• update plugins and dependencies

11.1.3

• update log4j to 2.21.0 (according to release notes now fully JLink compatible)

11.1.2

• update plugins and dependencies
• Pair.mapFirst() and Pair.mapSecond()
• code cleanups

11.1.0

• overload TextUtil.getMD5String(byte[])
• Value interface as an abstraction for observable values that is meant to be used in place of JavaFX ObservableValue or Swing Properties in library code that is supposed not to have dependencies on either JavaFX or java.desktop

11.0.0

• (BREAKING) remove deprecations
• (BREAKING) remove LangUtil.checkIndex()
• (BREAKING) reverse order of arguments in CryptUtil.encrypt()/decrypt() with string arguments to match those of byte[] arguments
• lots of Javadoc updates and additions
• add ComboBoxEx
• add ArgumentsDialog
• add SwingDocumentFilter
• add samples project
• reduce code duplication in RichTextBuilder
• exception handling in drag and drop support
• DbUtil.stream()
• make FontDef Cloneable
• RichText.equalizer() returns a customizable equalizer for comparing texts ignoring certain properties
• RichText.wrap() combines styles instead of replacing them
• IOUtil.glob() and IOUtil.listFiles() to search directory trees

10.3.4

• add FileInput drag&drop support to FileInput

10.3.3

• add Qodana to CI pipeline
• code cleanups
• added LangUtil.asFunction()

10.3.2

• Fix XmlUtil.prettyPrint(String) indentation

10.3.1

• Fix XmlUtil.prettyPrint(String) not indenting

10.3.0

• StreamUtil.stream() to create streams from iterators and iterables
• IoUtil.prettyPrint(String) support namespaces; attributes written in alphabetical order

10.2.10

• IoUtil.prettyPrint(String) retains comments in output
• code and javadoc cleanup

10.2.9

• reimplemented XmlUtil.prettyPrint(String) with a StAX parser so that no DOM has to be created when pretty-printing

10.2.8

• DataUtil.convert converting to/from URI, URL, Path, File

10.2.7

• FileInput swing component

10.2.6

• support value "auto" for configuring colored log output. colors are enabled if a terminal is attached and the TERM environment variable is set. this is the new default for this option.
• update plugins, junit

10.2.5

• add overloads for XmlUtil.prettyPrint()
• update gradle, dependencies

10.2.4

• update plugins
• fix compile time warnings in build script

10.2.3

• add XmlUtil.prettyPrint(String)
• use ProgressView.update(PROGRESS_INDETERMINATE) to set indeterminate state
• add assertion messages
• code cleanup

10.2.2

• update dependencies
• fix javadoc problems
• make Option fields private
• FileType.read(): add overloads taking options
• fix AssertionError when writing null value in CSV

10.2.1

• fix handling of default namespace URI in SimpleNamespaceContext
• use version catalog defined in settings.gradle.kts for dependencies and plugins
• update SLF4J to 2.0.1

10.2.0

• add SimpleNamespaceContext for use with XPath
• add XmlUtil.xpath(node) to create namespace aware XPath instances (namespace information is automatically extracted from the node and its parents)
• fix SLF4J warnings on console when running unit tests
• small fixes and improvements

10.1.2

• make XMLUtil namespace aware by default
• log levels can be configured by prefix in logging.properties file

10.1.1

• print exception stack traces in log
• some fixes for SwingProgressView

10.1.0

• Logging is done through SLF4J
• moved the logging stuff to its own library utility-logging so that you don't need to pull everything unless needed

10.0.0

• Java 17 required!
• use Kotlin DSL in gradle build scripts
• changed module names to com.dua3.utility again
• upgraded gradle to 7.4 for Java 17 support
• publish snapshots to sonatype snapshot repository
• geometry classes taking float parameters have been renamed to ...2f
• some classes (Pair, Vector2f, ...) have been converted to records
• updates to FileTreeNode to allow use as a base class
• added BuildInfo class
• add constants for different line ending sequences in TextUtil
• add command line option "--log-path-pattern" to LogUtil
• fix duplicate item output in LangUtil.surroundingItems() when regions overlap
• added several Font.withXXX()-methods to help quickly deriving fonts that differ only in one attribute
• LangUtil.enumValues()
• options can be passed a handler that is executed when arguments.handle() is called
• LangUtil.formatStackTrace(Exception)
• IOUtil.stringStream(String)
• LangUtil.map(OptionalXXX, XXXFunction) for mapping primitive Optionals
• improve output and performance of XmlUtil.prettyPrint()
• fix MathUtil.gcd for negative arguments
• many fixes and smaller improvements, added many Javadoc comments, improve test coverage
• XmlUtil defaultInstance() is now unsynchronized and should be faster
• added LangUtil.orElse() and LangUtil.orElseGet() for Optional-like functionality without creating an Optional instance first
• added cabe annotations to parameters
• rename IOUtil, IOOptions to IoUtil, IoOptions
• reorder parameters to the different LogAdapter addListener() and removeListener() methods and add overloads for these methods that add/remove listeners to /from the framework's root logger.
• remove LogUtil.format() as it is not shorter than the equivalent lambda (i.e. LogUtil.format("message %s", arg) can be replaced by () -> "message %s".formatted(arg))
• remove MathUtil.toDecimalString()
• remove SandboxURLHandler
• remove methods taking java.io.File; use Path instead
• Color is now an interface with implementations RGBColor and HSVColor
• RichText and Run classes provide an overloaded equals() method that accepts a predicate to give fine-grained control to exclude certain attributes from equality checks
• Platform: added methods to help with quoting arguments for ProcessBuilder
• LangUtil.defaultToString()
• rename RichText.textEquals() to equalsText()
• add equalsTextAndFont(), equalsIgnoreCase()
• add TextUTil.normalizeLineEnds(), TextUtil.toUnixLineEnds(), TextUtil.toWindowsLineEnds(), TextUtil.toSystemLineEnds()
• fix unit test failures on Windows
• StreamUtil.concat()
• StreamUtil.merge()
• Bearer interface
• LangUtil.triStateSelect()
• added FontDef.fontspec()
• small fixes and improvements

The following functionality has been removed because it is available in JDK 17:

• TextUtil.byteArrayToHexString(): use HexFormat.of().formatHex()
• TextUtil.hexStringToByteArray(): use HexFormat.of().parseHex()

9.1.1

• fix AIOOBE in SwingLogPane when messages come in at a high rate

9.1.0

• BACKPORT: StreamUtil.merge()

9.0.1

• add HtmlConverter.inlineTextDecorations()
• some JavaDoc corrections and completions
• update Gradle to 7.2-rc2 for JDK 17 compatibility (during compilation)

9.0

• migrate from bintray to sonatype
• JDK 11+ required! It's finally time to dump Java 8 support. I won't put any more effort into supporting a Java version that has long reached EOL and is a maintenance burden because of its missing modularity support.
• build uses Gradle 7 to enable building on JDK 17
• removed use of the JPMS Gradle plugin as it is not compatible with Gradle 7 and not needed anymore after dropping JDK 8 support and Gradle 7 added modularity support.
• logback support has been replaced by log4j2 due to missing jigsaw support in logback. This means if you have been using a Log4J to Logback bridge before, it's now time to do it the other way around.
• NamedParameterStatement supports many more data types; fixes for inserting null values.
• source parameter of CsvReader changed from String to URI
• com.dua3.utility.cmd and com.dua3.utility.options have been merged; there had been a lot of duplicated functionality, and the implementation in the cmd package was much cleaner; the result is again located in com.dua3.utility.options but the code is mostly based on what had been in the cmd package. Classes have been renamed because they are no more intended to be used only for command line arguments.
• move from JFrog Bintray to Sonatype OSSRH
• ImageUtil.load() does not return Optional
• made Image an interface
• removed the Image.write() method
• added Image.getArgb()
• some changes and fixes to AffineTransformation
• introduce class Dimension2d
• changes to FontUtil interface; rename FontUtil.getTextBounds() to getTextDimension(); loadFont replaced by loadFonts()
• introduce math.geometry package and contained classes

8.2.2

• remove bintray support
• publish builds to GitLab Packages (private access)
• TODO: publish to Mavencentral

8.2.1

• fix: FontDef.merge() only worked if color was set

8.2.0

• add double overload to MathUtil.clamp()
• fix typo: ProgressTracker.State.SCHEDULED (low possibility of breaking client code)
• (Swing): remove MigLayout from runtime dependencies
• (Swing): make SwingProgressView horizontally resizable
• (Swing): fix resize behaviour of SwingLogPane

Version 8.1.6

• RichText.stylesAt()
• RichText.runAt()
• RichText.runs()
• RichText.valueOf() with styles parameter

Version 8.1.5

• LangUtil.surroundingItems()

Version 8.1.4

• CmdParser.errorMessage()

Version 8.1.3

• command line parser improvements & bugfixes

Version 8.1.2

• fix XmlUtil.parse(String)
• add XmlUtil.parse(URI)

Version 8.1.1

• non-throwing (at least when correctly configured, otherwise RTE), reusable XmlUtil.defaultInstance()

Version 8.1

• remove the Text class
• some changes in XmlUtil

Version 8.0.2

• XmlUtil.xpath()

Version 8.0.1

• change argument of XmlUtil.format() from Document to its superclass Node

Version 8

• DomUtil renamed to XmlUtil, methods are instance methods now so that instances using different DocumentBuilder and Transformer implementations can be used
• moved all XML related methods from IoUtil and TextUtil to XmlUtil
• SwingUtil: added helper methods for adding basic drag and drop support

Version 7.0.8

• IOUtil: added IOUtil.copyAllBytes()
• IOUtil: removed inaccessible Method StreamSupplier.lines()

Version 7.0.7

• NamedParameterStatement: don't throw exception in constructor if parameter info can not be queried; fix typo in method name

Version 7.0.6

• NamedParameterStatement: support null values

Version 7.0.5

• RichText performance improvements

Version 7.0.4

• FIX: possible negative index in SwingLogPane
• javadoc
• remove a stray unused interface

Version 7.0.3

• FIX: do not generate interleaved tags in HtmlConverter

Version 7.0.2

• added missing javadoc in many places
• removed obsolete classes and methods (those should have been in use anyway and can in any case be easily replaced with the newer versions/replacements)

Version 7.0.1

• small fixes and cleanups

Version 7

• moved/renamed command line argument parsing classes to their own package, many changes and additions
• move Font.FontDef to upper level
• RichTextBuilder: methods push(Style)/pop(Style), implement Comparable; add textEquals(); bugfixes
• Many RichText/TextAttributes/Style related refactorings
• new classes HtmlConverter, StyledDocumentConverter, AnsiConverter to convert RichText to different formats
• removed old StyledDocumentBuilder class
• several changes in to the classes under util.text
• removed ToStringBuilder class as it was never really used and most IDEs can generate toString() automatically
• overload IOUtil.replaceExtension for Path
• DataUtil.asFunction() to use Map instances as Function
• TextUtil.appendHtmlEscapedCharacters(); mm2pt(); pt2mm()

Version 6.7.1

• update SpotBugs and remove rule filter
• logging: removing log listeners from JUL/Logback/System.out

Version 6.7

• classes SwingLogPane and LogBuffer
• RingBuffer implements the Collection interface
• RingBuffer.subList()

Version 6.6.3.1

• release to solve problems with build - no code changes

Version 6.6.3

• FIX: should be "font-size", not "size"

Version 6.6.2

• fix spelling of TextUtil.getTextBounds()
• remove deprecated Font.isUnderlined()

Version 6.6.1

• FIX: Color.isOpaque() returned wrong value
• FIX: Font.getCssStyle(): returned invalid value "regular" instead of "normal" for font-style
• Color.isTransparent()
• more work on command line parser

Version 6.6

• added simple command line parser class

Version 6.5

• promote ProgressTracker from incubator to concurrent package
• SwingProcessView: more informative exception messages

Version 6.4.2

• Font: fix fontspec parsing

Version 6.4.1

• Font: fix fontspec parsing when font size does not contain a fractional part; do not output fractional part in fontspec if unneeded

Version 6.4

• fontspec color part changed to CSS format (might break app that rely on the fontspec format)
• new constructor Font(String fontspec)
• Font valueOf(String) expects arg in CSS format (might be breaking)

Version 6.3.1

• Color: new methods isOpaque(), toRgba(), toArgb(), toCss()

Version 6.3

• mark Font.FontDef final
• cache Font.fontspec
• Font.similar()
• fix invalid CSS for Fontdef if underline or strikethrough is set explicitly to false
• fix exception and debug messages using default locale instead if Locale.ROOT

Version 6.2.4

• interface ProgressTracker, incubating class SwingProgressView

Version 6.2.3

• fix IOUtil.replaceExtension(), IOUtil.stripExtension() when path contains multiple dots

Version 6.2.2

• IOUtil.lines(InputStream, Charset)
• always use "\r\n" as line delimiter in CSV files (as per RFC 4180)
• minor improvements and code cleanups
• change Font.isUnderlined() to isUnderline()

Version 6.2.1

• new Utility class StreamUtil
• TextUtil.indent()

Version 6.2

• DomUtil and BatchCollector moved out of incubator
• new method FontDef.getCssStyle() returning CSS-compatible font definition

Version 6.1.1

• new method IOUtil.openStream(URI)
• new overload IOUtil.read(URI, Charset)

Version 6.1

• now included in Maven Central Repository
• add instructions for setting up Maven
• fix instructions for setting up Gradle
• many code cleanups
• test code compatible with JDK 8 (but JDK 11+ is still required for the build)
• utility method TextUtil.prettyPrint(...) for pretty-printing org.w3c.dom.Document
• utility methods IOUtil.format(...) for output of org.w3c.dom.Document
• Font.FontDef: added equals(), hashCode(), toString()
• added new package com.dua3.utility.incubator for incubating features
• new Utility class DomUtil (incubating)
• new class BatchCollector (incubating)

Version 6.0.3

• fix missing root in getUnixPath()

Version 6.0.2

• support Path as argument to FileType.read()/write() methods

Version 6.0.1

• new method FileType.isCompound() is used to exclude file types from lookup by extension (default implementation returns false; see javadoc for details)

Version 6.0

• LangUtil.uncheckedXXX() methods don't wrap uncheckedExceptions
• relaxed some method parameters from String to CharSequence
• code cleanup
• improve unit test coverage

Version 5.3.4.1, 5.3.4.2, 5.3.4.3

• Java 8 compatibility fixes: remove usage of API not available in Java 8

Version 5.3.4

• restore Java 8 compatibility (needed for my customer's project)
• update gradle to 6.3 (for JDK 14 support)
• update SpotBugs and SpotBugs plugin

Version 5.3.3

• Pair.of(Map.Entry)
• add split support to stopwatch class

Version 5.3.2

• IOUtil.toUnixPath()

Version 5.3.1

• TextUtil.containsAnyOf()
• TextUtil.containsNoneOf()

Version 5.3

• IOUtil.toUri()
• IOUtil.toPath()

Version 5.2

• Removal of utility-json

Version 5.1.3

• TextUtil.transform(String, Pair<String,String>...)

Version 5.1.2

• added methods in LangUtil to resolve localized resources
• minor cleanups

Version 5.1.1

• Methods in IOUtil that take a filename as a String argument have been changed to return correct results when instead of a filename a path is given.

Version 5.1

• add Zip class
• add TextUtil.generateMailToLink()

Version 5.0

• update to gradle 6.0.1
• add Platform class

Version 5-BETA6

• update to gradle 6.0; fix gradle 7 compatibility warnings

Version 5-BETA5

• fix DataUtil.convert() to LocalDateTime conversion
• added some unit tests

Version 5-BETA4

• Option.fileOption(): added OpenMode

Version 5-BETA3

• code cleanup
• LangUtil.enumSet()

Version 5-BETA2

• Update spotbugs to 4.0.0-beta4 to be able to compile using JDK 13.
• DataUtil.convert(): be more strict with boolean conversions. Converting a String s to Boolean will yield null if s is null, Boolean.TRUE if and only if s equals ignoring case "true", Boolean.FALSE if and only if s equals ignoring case "false". In all other cases IllegalArgumentException is thrown.

Version 5-BETA1

• fixed many small issues, typos (also in method names), so that I decided to also bump the major version
• module names changed to dua3_util*

Version 4.1.0-BETA12

• DataUtil.convert() overload for converting collections to list
• DataUtil.convertCollection() for converting collections to collection of arbitrary type
• (4.1.0-BETA12a): fix for DataUtil.convert() - don't bail out early if source type is Double or Float

Version 4.1.0-BETA11

• LangUtil.uncheckedSupplier()

Version 4.1.0-BETA10

• new: ÌOUtil.getInputStream(Object) and ÌOUtil.getOutputStream(Object)

Version 4.1.0-BETA9

• new: MathUtil.roundingOperation(int n, RoundingMode mode) for bulk rounding, with support for all types of java.math.RoundingMode
• Better documentation for MathUtil.round() and MathUtil.roundToPrecision()
• fixed some compilation warnings

Version 4.1.0-BETA8

• DataUtil.collect() and DataUtil.collectArray()

Version 4.1.0-BETA7

• LangUtil: public static <E extends Exception> void check(boolean condition, Supplier<E> exceptionSupplier) throws E

Version 4.1.0-BETA6

• new class MappingIterator and method DataUtil.map(Iterator<T>, Function<T,U>)

Version 4.1.0-BETA5

• new class FilterIterator and method DataUtil.filter(Iterator<T>, Predicate<T>)

Version 4.1.0-BETA4

• Support converting Long, Integer to Double, Float in DataUtil.convert...()-methods

Version 4.1.0-BETA3

• Support converting String to LocalDate in the DataUtil.convert...()-methods

Version 4.1.0-BETA2

• DataUtil.convert() and DataUtil.convertToArray() for converting objects to other types. Conversion is done as follows:
  • if value is {@code null}, {@code null} is returned;
  • if the target class is assignment compatible, a simple cast is performed;
  • if the target class is String, Object.toString() is used;
  • if the target class is an integer type and the value is of type double, a conversion without loss of precision is tried;
  • if the target class provides a method public static T valueOf(T) and value instanceof U, that method is invoked;
  • if useConstructor is true and the target class provides a constructor taking a single argument of value's type, that constructor is used;
  • otherwise an exception is thrown.

Version 4.0.8

• new class DataUtil, methods for data conversion

Version 4.0.7

• new helper method TextUtil.align()

Version 4.0.6

• BREAKING: default separator for CSV changed from semicolon to comma to make it compliant with RFCc4180. To change the separator, use CsvIo.getOptionValues(CsvIo.OPTION_SEPARATOR, ';') when creating the CsvReader/CsvWriter instance.

Version 4.0.5

• FileType: new static read(path, class) method

Version 4.0.4

• IOUtil: add more conversion methods between URI, URL, and Path

Version 4.0.3

• remove version file
• update spotbugs plugin
• cleanup build file
• IOUtil.getFileExtension(URI)

Version 4.0.2

• new class JsonUtil: loading JSON from URL/path

Version 4.0.1

• JdbcDataSource.setUser() and JdbcDataSource.setPassword() support null argument to unset value.

Version 4.0.0

• Change default date format to use a 4-digit year.
• utility-json.

BETA 4

• changed the build system to make life easier for me as developer :) - version information is stored in a file named version in the project root. This makes it possible to consistently update dependencies information automatically using a script.

BETA 3

• set dependency version information in gradle.properties file
• JdbcDriverInfo: create connection URL from option values

BETA 2

• don't use decimal grouping in CSV output
• ValueChangeListener support in OptionValues
• classes FileType and OpenMode
• fix CSV date formatting issues

BETA 1

• update gradle wrapper
• CsvReader and CsvWriter classes
• new classes Option (an option to control object behavior), OptionSet (a set of options to control object behavior), and Options (a set of options and corresponding values)
• new package com.dua3.utility.data with classes TreeNode (to build tree data structures) and FileTreeNode to create a tree of files and subdirectories of a directory
• moved the Pair and Color classes to the com.dua3.utility.data package
• renamed Options to OptionValues

Version 3.1.4

• add uses declarations in module-info.java files (fix ServiceLoader issues when run from eclipse)
• spotbugs: use exclude filter for false positives; don't ignore failures

Version 3.1.3

• Added methods to measure text in TextUtil. The concrete implementation is using either AWT or JavaFX and is loaded via a ServiceLoader. The AWT implementation is included in utility.swing whereas a JavaFX implementation is included in the fx.util subproject of the fx project.

Version 3.1.2

• skipped

Version 3.1.1

• Fix NamedParameterStatement throwing exception when using ojdbc8.jar with certain statements.

Version 3.1.0

• The git repository moved to https://gitlab.com/com.dua3/lib/utility.git
• Added NamedParameterStatement.getParameterInfo() and NamedParameterStatement.getParameterInfo(String) to query parameter meta data (i.e. the corresponding SQL type)
• Added NamedParameterStatement.getResultSet()
• Added NamedParameterStatement.getUpdateCount()
• Added DbUtil.toLocalTime()

VERSION 3.0.1

• changed license to MIT to make it possible to use in pre-V3 GPL projects

VERSION 3.0

• BREAKING: package com.dua3.utility.db was moved to a separate library utility.db. You have to update dependencies and module-info.
• REMOVED: Font.getAwtFont() and Font.getTextWidth(); these introduced a dependency on java.desktop and can be easily replaced where needed.
• The utility.db library now include methods to dynamically load JDBC drivers. This allows to use jlink on applications that use non-modular JDBC-drivers.
• dependencies on these modules were removed from the main library, allowing for smaller jlink images:
  • java.xml
  • java.desktop
  • java.sql

version 2.2

• New class CryptUtil: encryption and decryption utility.
• TextUtil.base64Encode()
• TextUtil.base64Decode()
• breaking change: TextUtil.byteArrayToHex() has been renamed to byteArrayToHexString()
• TextUtil.hexStringToByteArrayToHex()

version 2.1

• IOUtil.loadText(): helper method to load text files where the character encoding is not known.

version 2.0

• Requires Java 11+
• Removed Swing and JavaFX.