Class TUtils

java.lang.Object

com.thecsdev.common.util.TUtils

public final class TUtils
extends Object

TheCSDev's common utilities.

Method Summary

Modifier and Type	Method	Description
static final ScheduledExecutorService	getSingleThreadScheduledExecutor()	Primary Executors.newSingleThreadScheduledExecutor() instance commonly used by this mod.
static final StackWalker	getStackWalkerRCR()	Deprecated.
static final ExecutorService	getVirtualThreadPerTaskExecutor()	Primary Executors.newVirtualThreadPerTaskExecutor() instance commonly used by this mod.
static final @NotNull String	str2pbkdf2(@NotNull String input, byte @NotNull [] salt, int iterations)	Hashes a String using PBKDF2 with HMAC-SHA256.
static final @NotNull String	str2sha256base36(@NotNull String input)	Hashes the given input string using SHA-256 and encodes the hash as a base36 String.
static final void	uncheckedCall(@NotNull CheckedRunnable action)	Runs a CheckedRunnable, throwing a RuntimeException if said CheckedRunnable throws an Exception.
static final <T> T	uncheckedSupply(@NotNull CheckedSupplier<T> supplier)	Gets a value from a CheckedSupplier, throwing a RuntimeException if said CheckedSupplier throws an Exception.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

getStackWalkerRCR

@Deprecated
public static final StackWalker getStackWalkerRCR()

Deprecated.

Returns the StackWalker instance with the StackWalker.Option.RETAIN_CLASS_REFERENCE option.

API Note:

Very expensive for performance. Avoid using this.

getSingleThreadScheduledExecutor

public static final ScheduledExecutorService getSingleThreadScheduledExecutor()

Primary Executors.newSingleThreadScheduledExecutor() instance commonly used by this mod.

The scheduled executor's Thread is a daemon thread.

See Also:

• Thread.isDaemon()

getVirtualThreadPerTaskExecutor

public static final ExecutorService getVirtualThreadPerTaskExecutor()

Primary Executors.newVirtualThreadPerTaskExecutor() instance commonly used by this mod.

uncheckedCall

public static final void uncheckedCall(@NotNull
 @NotNull CheckedRunnable action)
                                throws NullPointerException,
RuntimeException

Runs a CheckedRunnable, throwing a RuntimeException if said CheckedRunnable throws an Exception.

Parameters:

action - The action to run.

Throws:

NullPointerException - If the argument is null.

RuntimeException - If the CheckedRunnable throws.

uncheckedSupply

public static final <T> T uncheckedSupply(@NotNull
 @NotNull CheckedSupplier<T> supplier)
                                   throws NullPointerException,
RuntimeException

Gets a value from a CheckedSupplier, throwing a RuntimeException if said CheckedSupplier throws an Exception.

Parameters:

supplier - The supplier to get the value from.

Returns:

The value supplied by the supplier.

Throws:

NullPointerException - If the argument is null.

RuntimeException - If the CheckedSupplier throws.

str2sha256base36

@NotNull
public static final @NotNull String str2sha256base36(@NotNull
 @NotNull String input)
                                              throws NullPointerException,
RuntimeException

Hashes the given input string using SHA-256 and encodes the hash as a base36 String.

Parameters:

input - The input string to hash.

Throws:

NullPointerException - If the argument is null.

RuntimeException - If the SHA-256 algorithm is not available.

str2pbkdf2

@NotNull
public static final @NotNull String str2pbkdf2(@NotNull
 @NotNull String input,
 byte @NotNull [] salt,
 int iterations)
                                        throws NullPointerException,
IllegalArgumentException,
RuntimeException

Hashes a String using PBKDF2 with HMAC-SHA256.

Parameters:

input - The string to hash.

salt - The salt to use for hashing.

iterations - The number of iterations to use.

Returns:

The hex-encoded hash.

Throws:

NullPointerException - If an argument is null.

IllegalArgumentException - If iterations is less than 1.

RuntimeException - If the hashing algorithm is unavailable.