-
- All Implemented Interfaces:
public final class HelpersKt
-
-
Field Summary
Fields Modifier and Type Field Description private static BooleandisableChecksprivate final static Voidfail
-
Method Summary
Modifier and Type Method Description BooleangetDisableChecks()Disable heavy and optional checks in runtime. voidsetDisableChecks(Boolean disableChecks)Disable heavy and optional checks in runtime. final VoidgetFail()final static <T extends Any> Tprintln(T $self, String prefix)Print receiver to stdout. final static <T extends ResourceBundle> ResourceBundleresourceBundle(Locale locale)TODO. final static <T extends ResourceBundle> ResourceBundleresourceBundle(KClass<T> type, Locale locale)TODO. final static IntegerfreePort()Return a random free port (not used by any other local process). final static BooleanisPortOpened(Integer port)Check if a port is already opened. final static <T extends Any> Tretry(Integer times, Long delay, Function0<T> block)Execute a lambda until no exception is thrown or a number of times is reached. final static Stringexec(List<String> $self, File workingDirectory, Long timeout, Boolean fail)TODO. final static Stringexec(String $self, File workingDirectory, Long timeout, Boolean fail)TODO Add use case and example in documentation. final static Unitcheck(String message, Function0<Unit> blocks)TODO. final static Array<out StackTraceElement>filterStackTrace(Throwable $self, String prefix)Return the stack trace array of the frames that starts with the given prefix. final static StringtoText(Throwable $self, String prefix)Return this throwable as a text. final static <Z extends Any> Collection<Z>ensureSize(Collection<Z> $self, IntRange count)TODO. final static <T extends Any> Tkeys(Map<?, ?> $self, Object keys)TODO. final static <T extends Any> Tinvoke(Map<?, ?> $self, Object keys)TODO. final static <T extends Any> TrequireKeys(Map<?, ?> $self, Object name)TODO. final static <T extends Any> Map<String, ?>fieldsMapOf(Pair<KProperty1<T, ?>, ?> fields)TODO. final static <K extends Any, V extends Any> Vrequire(Map<K, V> $self, K name)TODO. final static <K extends Any, V extends Any> Map<K, V>filterEmpty(Map<K, V> $self)TODO. final static <V extends Any> List<V>filterEmpty(List<V> $self)TODO. final static <V extends Any> BooleannotEmpty(V value)TODO. -
-
Method Detail
-
getDisableChecks
Boolean getDisableChecks()
Disable heavy and optional checks in runtime. This flag can be enabled to get a small performance boost. Do NOT do this on development (it could mask problems) and enable it on production only if you have tested your application extensively.
It's initial value is taken from the
DISABLE_CHECKSflag. See Jvm.systemFlag for details on how flags are checked on a JVM.This variable can be changed on code to affect only certain parts of the code, however this is not advised and should be done carefully.
-
setDisableChecks
void setDisableChecks(Boolean disableChecks)
Disable heavy and optional checks in runtime. This flag can be enabled to get a small performance boost. Do NOT do this on development (it could mask problems) and enable it on production only if you have tested your application extensively.
It's initial value is taken from the
DISABLE_CHECKSflag. See Jvm.systemFlag for details on how flags are checked on a JVM.This variable can be changed on code to affect only certain parts of the code, however this is not advised and should be done carefully.
-
println
final static <T extends Any> T println(T $self, String prefix)
Print receiver to stdout. Convenient utility to debug variables quickly.
- Parameters:
prefix- String to print before the actual object information.
-
resourceBundle
final static <T extends ResourceBundle> ResourceBundle resourceBundle(Locale locale)
TODO.
- Parameters:
locale- .
-
resourceBundle
final static <T extends ResourceBundle> ResourceBundle resourceBundle(KClass<T> type, Locale locale)
TODO.
- Parameters:
type- .locale- .
-
freePort
final static Integer freePort()
Return a random free port (not used by any other local process).
-
isPortOpened
final static Boolean isPortOpened(Integer port)
Check if a port is already opened.
- Parameters:
port- Port number to check.
-
retry
final static <T extends Any> T retry(Integer times, Long delay, Function0<T> block)
Execute a lambda until no exception is thrown or a number of times is reached.
- Parameters:
times- Number of times to try to execute the callback.delay- Milliseconds to wait to next execution if there was an error.block- Code to be executed.
-
exec
final static String exec(List<String> $self, File workingDirectory, Long timeout, Boolean fail)
TODO.
TODO Assure JVM closes properly after process execution (dispose process resources, etc.)
-
exec
final static String exec(String $self, File workingDirectory, Long timeout, Boolean fail)
TODO Add use case and example in documentation. TODO Support multiple words parameters by processing " and '
Run the receiver's text as a process in the host operating system. The command can have multiple lines and may or may not contain the shell continuation string (
\\n).- Parameters:
workingDirectory- Directory on which the process will be executed.timeout- Maximum number of seconds allowed for process execution.fail- If true Raise an exception if the result code is different than zero.
-
filterStackTrace
final static Array<out StackTraceElement> filterStackTrace(Throwable $self, String prefix)
Return the stack trace array of the frames that starts with the given prefix.
- Parameters:
prefix- Prefix used to filter stack trace elements (applied to class names).
-
toText
final static String toText(Throwable $self, String prefix)
Return this throwable as a text.
- Parameters:
prefix- Optional prefix to filter stack trace elements.
-
ensureSize
final static <Z extends Any> Collection<Z> ensureSize(Collection<Z> $self, IntRange count)
TODO.
- Parameters:
count- .
-
invoke
final static <T extends Any> T invoke(Map<?, ?> $self, Object keys)
TODO.
- Parameters:
keys- .
-
requireKeys
final static <T extends Any> T requireKeys(Map<?, ?> $self, Object name)
TODO.
- Parameters:
name- .
-
fieldsMapOf
final static <T extends Any> Map<String, ?> fieldsMapOf(Pair<KProperty1<T, ?>, ?> fields)
TODO.
- Parameters:
fields- .
-
require
final static <K extends Any, V extends Any> V require(Map<K, V> $self, K name)
TODO.
- Parameters:
name- .
-
filterEmpty
final static <K extends Any, V extends Any> Map<K, V> filterEmpty(Map<K, V> $self)
TODO.
-
filterEmpty
final static <V extends Any> List<V> filterEmpty(List<V> $self)
TODO.
-
-
-
-