Package systextil

Class Util

java.lang.Object
systextil.Util
public class Util extends Object

  • Method Summary

    Modifier and Type
    Method
    Description
    static String
    adjustToSql(Integer... values)
    Remove os colchetes do Varargs informado.
    static double
    arredondar(double valor, int digitos)
     
    static boolean
    between(Time hora, Time horaIni, Time horaFim)
    Retorna se uma hora está entre outras duas.
    static int
    compare(Time hora1, Time hora2)
    Compara duas horas descartando a informação de fuso horário.
    static Amount
    desc(double total, double porcentagem)
    Calcula o valor resultante do desconto de um total a partir da porcentagem informada.
    static Amount
    desc(double total, Amount porcentagem)
    Calcula o valor resultante do desconto de um total a partir da porcentagem informada.
    static Amount
    desc(Amount total, double porcentagem)
    Calcula o valor resultante do desconto de um total a partir da porcentagem informada.
    static Amount
    desc(Amount total, Amount porcentagem)
    Calcula o valor resultante do desconto de um total a partir da porcentagem informada.
    static double
    descDouble(double total, double porcentagem)
    Calcula o desconto sem arredondar, e retorna o valor double resultante.
    static double
    descDouble(double total, Amount porcentagem)
    Calcula o desconto sem arredondar, e retorna o valor double resultante.
    static double
    descDouble(Amount total, double porcentagem)
    Calcula o desconto sem arredondar, e retorna o valor double resultante.
    static double
    descDouble(Amount total, Amount porcentagem)
    Calcula o desconto sem arredondar, e retorna o valor double resultante.
    static <T> boolean
    in(T valor, T... valoresComparacao)
    Compara se valor está na lista de comparação.
    static boolean
    isEmpty(String string)
    Informa se a variável é nula ou não possui caracteres diferentes de espaços.
    static Amount
    perc(double total, double porcentagem)
    Calcula o valor percentual de um total a partir da porcentagem informada.
    static Amount
    perc(double total, Amount porcentagem)
    Calcula o valor percentual de um total a partir da porcentagem informada.
    static Amount
    perc(Amount total, double porcentagem)
    Calcula o valor percentual de um total a partir da porcentagem informada.
    static Amount
    perc(Amount total, Amount porcentagem)
    Calcula o valor percentual de um total a partir da porcentagem informada.
    static Collection<Integer>
    toIntegers(String integersList)
    Transforma uma lista de valores inteiros em uma coleção.
    static String
    toSqlStrings(Object[] vals)
    Retorna uma lista de valores com aspas simples separados por vírgulas, como '1','2','3' para serem usadas em cĺáusulas IN em SQL.
    static String
    toSqlVals(int[] vals)
    Retorna uma lista de valores sem aspas simples separados por vírgulas, como 1,2,3 para serem usadas em cĺáusulas IN em SQL.
    static String
    toSqlVals(Object[] vals)
    Retorna uma lista de valores sem aspas simples separados por vírgulas, como 1,2,3 para serem usadas em cĺáusulas IN em SQL.
    static String
    toString(Throwable thr)
    Exibe em forma de mensagem com stack trace, para facilitar o diagnóstico de erros.
    static String
    toString(Throwable thr, String baseClassName)
    Exibe em forma de mensagem com stack trace, para facilitar o diagnóstico de erros.
    static String
    toStringInForms(Throwable thr)
    Exibe em forma de mensagem com stack trace, para facilitar o diagnóstico de erros em formulários NXJ.

    Methods inherited from class java.lang.Object

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

  • Method Details

    • arredondar

      public static double arredondar(double valor, int digitos)

    • perc

      public static Amount perc(double total, double porcentagem)
      Calcula o valor percentual de um total a partir da porcentagem informada.

      Prefira usar o método de Amount.

      Parameters:
      total - o total
      porcentagem - a porcentagem
      Returns:
      o valor percentual

    • desc

      public static Amount desc(double total, double porcentagem)
      Calcula o valor resultante do desconto de um total a partir da porcentagem informada. Para isso, calcula primeiro o desconto com essa porcentagem, arredonda-o convenientemente, e então subtrai-o do total.

      Prefira usar o método de Amount.

      Parameters:
      total - o total
      porcentagem - a porcentagem
      Returns:
      o valor total menos o desconto

    • descDouble

      public static double descDouble(double total, double porcentagem)
      Calcula o desconto sem arredondar, e retorna o valor double resultante. Usa internamente BigDecimal para contornar eventuais problemas de arredondamento que ocorrem no uso exclusivo de double.

      Prefira usar o método de Amount.

    • perc

      public static Amount perc(double total, Amount porcentagem)
      Calcula o valor percentual de um total a partir da porcentagem informada.

      Prefira usar o método de Amount.

      Parameters:
      total - o total
      porcentagem - a porcentagem
      Returns:
      o valor percentual

    • perc

      public static Amount perc(Amount total, double porcentagem)
      Calcula o valor percentual de um total a partir da porcentagem informada.

      Prefira usar o método de Amount.

      Parameters:
      total - o total
      porcentagem - a porcentagem
      Returns:
      o valor percentual

    • perc

      public static Amount perc(Amount total, Amount porcentagem)
      Calcula o valor percentual de um total a partir da porcentagem informada.

      Prefira usar o método de Amount.

      Parameters:
      total - o total
      porcentagem - a porcentagem
      Returns:
      o valor percentual

    • desc

      public static Amount desc(double total, Amount porcentagem)
      Calcula o valor resultante do desconto de um total a partir da porcentagem informada. Para isso, calcula primeiro o desconto com essa porcentagem, arredonda-o convenientemente, e então subtrai-o do total.

      Prefira usar o método de Amount.

      Parameters:
      total - o total
      porcentagem - a porcentagem
      Returns:
      o valor total menos o desconto

    • desc

      public static Amount desc(Amount total, double porcentagem)
      Calcula o valor resultante do desconto de um total a partir da porcentagem informada. Para isso, calcula primeiro o desconto com essa porcentagem, arredonda-o convenientemente, e então subtrai-o do total.

      Prefira usar o método de Amount.

      Parameters:
      total - o total
      porcentagem - a porcentagem
      Returns:
      o valor total menos o desconto

    • desc

      public static Amount desc(Amount total, Amount porcentagem)
      Calcula o valor resultante do desconto de um total a partir da porcentagem informada. Para isso, calcula primeiro o desconto com essa porcentagem, arredonda-o convenientemente, e então subtrai-o do total.

      Prefira usar o método de Amount.

      Parameters:
      total - o total
      porcentagem - a porcentagem
      Returns:
      o valor total menos o desconto

    • descDouble

      public static double descDouble(double total, Amount porcentagem)
      Calcula o desconto sem arredondar, e retorna o valor double resultante. Usa internamente BigDecimal para contornar eventuais problemas de arredondamento que ocorrem no uso exclusivo de double.

      Prefira usar o método de Amount.

    • descDouble

      public static double descDouble(Amount total, double porcentagem)
      Calcula o desconto sem arredondar, e retorna o valor double resultante. Usa internamente BigDecimal para contornar eventuais problemas de arredondamento que ocorrem no uso exclusivo de double.

      Prefira usar o método de Amount.

    • descDouble

      public static double descDouble(Amount total, Amount porcentagem)
      Calcula o desconto sem arredondar, e retorna o valor double resultante. Usa internamente BigDecimal para contornar eventuais problemas de arredondamento que ocorrem no uso exclusivo de double.

      Prefira usar o método de Amount.

    • isEmpty

      public static boolean isEmpty(String string)
      Informa se a variável é nula ou não possui caracteres diferentes de espaços.

    • compare

      public static int compare(Time hora1, Time hora2)
      Compara duas horas descartando a informação de fuso horário. Na prática, compara o resultado de toString() entre elas. Isto deve ser usado em lugar dos métodos próprios de comparação de objetos Time, porque estes consideram o fuso horário, dando resultados inesperados.
      Throws:
      NullPointerException - se alguma das horas for nula

    • between

      public static boolean between(Time hora, Time horaIni, Time horaFim)
      Retorna se uma hora está entre outras duas.
      Parameters:
      hora - a hora de referência; não pode ser nula.
      horaIni - a hora inicial do intervalo a considerar; pode ser nula.
      horaFim - a hora final do intervalo a considerar; pode ser nula.
      Returns:
      se hora está entre horaIni e horaFim.
      Throws:
      NullPointerException - se hora for nula

    • toIntegers

      public static Collection<Integer> toIntegers(String integersList)
      Transforma uma lista de valores inteiros em uma coleção. Os elementos dessa lista podem estar separados por vírgula ou por ponto-e-vírgula. Eventuais espaços são descartados. Se a lista estiver cercada por colchetes, como é o padrão na impressão de coleções, também são desconsiderados.

    • in

      public static <T> boolean in(T valor, T... valoresComparacao)
      Compara se valor está na lista de comparação.
      Type Parameters:
      T - o tipo de valor a comparar
      Parameters:
      valor - o valor a ser comparado
      valoresComparacao - a lista para comparação.
      Returns:
      true se valor está em valoresComparacao ou false caso contrário

    • toSqlVals

      public static String toSqlVals(Object[] vals)
      Retorna uma lista de valores sem aspas simples separados por vírgulas, como 1,2,3 para serem usadas em cĺáusulas IN em SQL.
      Returns:
      o texto da lista, ou nulo se não houver valores

    • toSqlVals

      public static String toSqlVals(int[] vals)
      Retorna uma lista de valores sem aspas simples separados por vírgulas, como 1,2,3 para serem usadas em cĺáusulas IN em SQL.
      Returns:
      o texto da lista, ou nulo se não houver valores

    • toSqlStrings

      public static String toSqlStrings(Object[] vals)
      Retorna uma lista de valores com aspas simples separados por vírgulas, como '1','2','3' para serem usadas em cĺáusulas IN em SQL.
      Returns:
      o texto da lista, ou nulo se não houver valores

    • adjustToSql

      public static String adjustToSql(Integer... values)
      Remove os colchetes do Varargs informado.
      Parameters:
      values - um Varargs de Object
      Returns:
      Um String com os valores do var args separados por virgula. ex: (1,2,3)

    • toString

      public static String toString(Throwable thr)
      Exibe em forma de mensagem com stack trace, para facilitar o diagnóstico de erros.
      Parameters:
      thr - o erro
      Returns:
      a mensagem com stack trace

    • toStringInForms

      public static String toStringInForms(Throwable thr)
      Exibe em forma de mensagem com stack trace, para facilitar o diagnóstico de erros em formulários NXJ. Para isso, tenta desconsiderar itens do stack trace irrelevantes, do framework.
      Parameters:
      thr - o erro
      Returns:
      a mensagem com stack trace, enxuta

    • toString

      public static String toString(Throwable thr, String baseClassName)
      Exibe em forma de mensagem com stack trace, para facilitar o diagnóstico de erros. Dá a opção para reduzir a extensão do stack trace exibido, parando de exibir os itens que sucedam uma ocorrência que inicie com determinado nome fragmento de nome de classe.

      Por exemplo: se usar forms., assim que surgir um elemento que inicie com esse fragmento, os seguintes não serão exibidos.

      Outro exemplo: se usar systextil.rgen.api., assim que alcançar um fragmento definido numa classe da API desse plugin, os seguintes não serão exibidos.

      Parameters:
      thr - o erro
      baseClassName - o trecho do início da classe que indica o ponto onde a exibição do stack trace deve parar; se for nulo, não será considerado.
      Returns:
      a mensagem com stack trace