cumin

cumin provides some utility classes for java (standard edition):

Overview

• MapUtils - Simply creating maps
• ExceptionUtils - Get nice mini stacktrace, check for exception types in cause hierarchy
• ZipUtils - Write data or a string to a zip-file
• ReflectionUtils - Some reflections helper
• AnnotationUtils - Gets fields of a class annotated with a special annotation
• ObjectUtils - Annotation based toString(), equals(), hashCode
• LocaleUtils - Access locales (JDK or ICU (preferred))
• StringUtils - Get capitals of a string
• RandomStringUtils - Create random strings
• CSVUtils - Reading a CSV file as a list of string-arrays
• MathUtils - Getting a logarithm arbitary with an arbitary base
• IOUtils - Copy a StringWriter, close a stream quietly
• ParseUtils - Parsing file sizes (like '5.3GB', '6k') or durations (like '5s', '2.5h')
• DNSUtils - Get domain record, check for hostname against ip-address
• DomUtils - Manipulation DOM, DOM as string
• PasswordUtils - Hashes for password
• WrappingAtomicCounter - used for wrapping counter 0..1..2..3..4..5..0..1..2.. .
• Locker - For locking arbitrary objects.
• Deferred - For lazy initialization
• NamedRunnable - Runnable with the ability to set the thread-name that is used while running
• NamedCallable - Callable with the ability to set the thread-name that is used while calling
• CheckedFunction, CheckedSupplier, CheckedConsumer, CheckedRunnable - Functional interfaces that can throws exceptions
• ThreadUtils - Sleep without exceptions ;)
• ScalingWorkerQueue - A scaling worker queue
• ResizableCircularAverage - A bounded, resizable queue of BigDecimal to get its average (and sum) of all included values.

... more to come ...

Documentation

Browse the Javadoc of the latest version. ('cumin' is well documented there.)

Installation

<dependency>
    <groupId>net.thk-systems.commons</groupId>
    <artifactId>cumin</artifactId>
    <version>4.3.3</version>
</dependency>

You can browse maven-central to download the jar or another versions.

Changelog

**4.3.3 **

• Optimized Deferred#toString
• Updated parent pom and maven dependencies because of CVE-2021-37533

4.3.2

• Some (non-functional) code optimizations
• Add custom Deferred#toString

4.3.1

• Added MathUtils#log
• Updated parent pom and maven dependencies

4.3.0

• Added ResizableCircularAverage
• Added Deferred#invalidate to invalidate the cached value

4.2.3

• Exposed pattern used by ParseUtils#parseDuration

4.2.2

• Fixed bug in ParseUtils#parseDuration to consider negative values
• Updated parent pom and maven dependencies

4.2.1

• Updated parent pom and maven dependencies

4.2.0

• Updated parent pom and maven dependencies

4.1.0

• Updated parent pom and maven dependencies
• ScalingWorkerQueue: Add custom toStringFunction
• Removed UnsafeUtils

4.0.5

• ScalingWorkerQueue: Fixing bug regarding return value

4.0.4

• ScalingWorkerQueue: Added support for priority queue

4.0.3

• ScalingWorkerQueue: Fixed bug regarding mandatory workers
• ScalingWorkerQueue: Optimized error logging
• ExceptionUtils: Added method 'asShortString'

4.0.2

• Removed events from scaling worker queue
• Added tiny support for monitoring for scaling worker queue

4.0.1

• Added events to scaling worker queue

4.0.0

• Clean up deprecated / obsolete stuff
• Updated parent pom

3.13.5

• Added Consumers.noBiOp
• Added thread id of dispatch to event listener of ScalingWorkerQueue
• Bugfixes

3.13.4

• Bugfixes

3.13.3

• Added event listener to ScalingWorkerQueue
• Optimized logging
• Bugfixes

3.13.2

• Optimized logging
• Bugfixes

3.13.1

• Make ParseUtils.* nullsafe
• Bugfixes

3.13.0

• Added ScalingWorkerQueue
• Added ThreadUtils
• Added IOUtils.closeQuietly
• Updated dependencies
• Moved to GitHub

3.12.0

• Added ReflectivBasicBean
• Added RandomStringUtils

3.11.0

• Added StringUtils.getCapitals
• Extended NamedCallable to use the thread-id
• Changed logger for Locker to SLF4J
• Fixed bug of Locker regarding garbage collection

3.10.0

• Added LocaleUtils.isValidLocaleCode

3.9.0

• Added ExceptionUtils.getCauseWithType

3.8.0

• Added LocaleUtils.isValidCurrencyCode

3.7.0

• Added LocaleUtils

3.6.0

• Added CheckedRunnable

3.5.0

• Added CheckedFunction

3.4.0

• Added IOUtils.copyStringWriter

3.3.0

• Added CheckedConsumer
• Added CheckedSupplier
• Fixed WrappingAtomicCounter -> Now its really atomic
• Added Locker.executeWithLock variants
• Added Locker.executeCheckedWithLock

3.2.0

• Added NamedRunnable
• Added NamedCallable

3.1.0

• Optimized Locker
• Added Locker.tryLock

3.0.0

• Added Deferred
• Added Locker.executeWithLock
• Move to Java 8 (first without changing anything)

2.2.0

• Added Locker

2.1.0

• REMOVED EncryptionUtils in cause of security reasons

2.0.0

• Released as 2.0.0 under new maven group id

1.3.1

• Fixed BaseService.commit does a rollback, if set rollbackOnly

1.3

• Added UnsafeUtils
• Added ServletUtils.getServletDump
• Added ReflectionUtils.getFieldValue
• Added AnnotationUtils.getFieldsAnnotatedWith (2 methods)
• Added WrappingAtomicCounter

1.2

• Renamed to 'cumin'
• Added ObjectUtils
• Added AnnotationUtils
• Fixed IdentifiedEntity.equals to be symmetric
• Added IdentifiedEntity.hashCode
• Added IdentifiedEntity.compareTo
• Added ReflectionUtils.getFieldValuesOfType

1.1

• Added BaseRepository
• Added IdentifiedEntity
• Added BaseService

1.0

• Merged with tksCommons-Crypto
• Merged with tksCommons-XStream
• Merged with tksCommons-Web
• Merged with tksCommons-Lang

0.5

• AddressUtils - Added
• DNSUtils - Added
• ServletUtils - Added
• ExceptionUtils - Added
• ParseUtils.parseDuration - Added

0.3.1

• Compiled with JDK 1.7 (before 1.8)

0.3

• CollectionUtils - Added
• CollectionUtils#createArrayList - Added
• CollectionUtils#addToCollection - Added
• ParseUtils#parseFileSize - Fixed bug: Return null for negative input value
• ParseUtils#parseFileSize - Changed: Return null for invalid input value (not -1)
• CSVUtils - Moved to package util.text
• DOMUtils - Added
• ZipUtils - Added
• MapUtils - Added