Package 

Class HelpersKt

  • All Implemented Interfaces:
    
public final class HelpersKt

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description

    • Field Summary

      Fields 
      Modifier and Type Field Description
      private static Boolean disableChecks
      private final static Void fail

    • Constructor Summary

      Constructors 
      Constructor Description

    • Enum Constant Summary

      Enum Constants 
      Enum Constant Description

    • Method Summary

      Modifier and Type Method Description
      Boolean getDisableChecks() Disable heavy and optional checks in runtime.
      void setDisableChecks(Boolean disableChecks) Disable heavy and optional checks in runtime.
      final Void getFail()
      final static <T extends Any> T println(T $self, String prefix) Print receiver to stdout.
      final static Map<String, String> properties(URL url) Load a '*.properties' file from a URL transforming the content into a plain map.
      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.
      final static String exec(List<String> $self, File workingDirectory, Long timeout, Boolean fail) TODO.
      final static String exec(String $self, File workingDirectory, Long timeout, Boolean fail) TODO Add use case and example in documentation.
      final static Unit check(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 String toText(Throwable $self, String prefix) Return this throwable as a text.

      • Methods inherited from class java.lang.Object

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

    • Constructor Detail

    • 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_CHECKS flag. 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_CHECKS flag. 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.

      • properties

         final static Map<String, String> properties(URL url)

        Load a '*.properties' file from a URL transforming the content into a plain map. If the resource can not be found, a ResourceNotFoundException is thrown.

        Parameters:
        url - URL pointing to the file to load.

      • 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 from zero.

      • check

         final static Unit check(String message, Function0<Unit> blocks)

        TODO.

      • 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.