Package ru.bgcrm.util

Class Utils

java.lang.Object
ru.bgcrm.util.Utils
public class Utils extends Object

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final char[]
    HEX
     
    static final char[]
    HEX_LOWERCASE
     
    static final Integer[]
    INTEGER_ARRAY
     
    static final Log
    log
     
    static final String[]
    STRING_ARRAY
     
    static final Charset
    UTF8
    Deprecated.

  • Constructor Summary

    Constructors
    Constructor
    Description
    Utils()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    static final void
    addCommaSeparated(StringBuilder result, String value)
    Добавляет в конец строки новое значение, отделяя запятой с пробелом, если он не первый.
    static final void
    addSeparated(StringBuilder result, String separator, String value)
     
    static final void
    addSetupPair(StringBuilder data, String prefix, String param, String value)
     
    static final String
    booleanToStringInt(boolean value)
    Преобразует boolean в строку "1" или "0".
    static final File
    createDirectoryIfNoExistInWorkDir(String dirName)
     
    static final <T> List<T>
    emptyToNull(List<T> value)
    Возвращает null, если List пустой либо null, иначе возвращает исходный List.
    static final <T> Set<T>
    emptyToNull(Set<T> value)
    Возвращает null, если Set пустой либо null, иначе возвращает исходный Set.
    static void
    errorAndExit(int code, String message)
    Writes error message and exists the running application.
    static String
    escapeXml(String value)
    Calls Functions.escapeXml(String) - replaces XML markup symbols to special codes.
    static String
    formatPatternString(String object, int objectId, ParamValueDAO paramValueDAO, String pattern)
    Генерирует строку из шаблона с подстановкой макросов вида ${param_<код параметра>}.
    static final String
    generateSecret()
     
    static String
    getDigest(byte[] value)
    HEX representation of MD5 digest.
    static String
    getDigest(String value)
    Вызывает getDigest(String, String) с кодировкой UTF-8.
    static String
    getDigest(String value, String charset)
    Возвращает строковое представление MD5 хэша от входной строки.
    static <T> T
    getFirst(Collection<T> collection)
     
    static final <T extends Id>
    String
    getObjectIds(Collection<T> list)
    Возвращает коды объектов из коллекции через запятую.
    static final <T extends Id>
    String
    getObjectIds(Collection<T> list, String startValues)
    Возвращает коды объектов из коллекции через запятую с указанным началом строки.
    static <T extends Id>
    String
    getObjectIds(Collection<T> list, String startValues, String delim)
    Возвращает коды объектов из коллекции с указанием разделителя и начала строки.
    static final <T extends IdTitle>
    List<Integer>
    getObjectIdsList(Collection<T> list)
    Возвращает список кодов объектов.
    static final <T extends IdTitle>
    Set<Integer>
    getObjectIdsSet(Collection<T> list)
    Возаращает набор кодов объектов.
    static final <T extends IdTitle>
    List<T>
    getObjectList(List<T> fullList, Set<Integer> selectedIds)
    Возвращает объекты из полного списка с указанными кодами.
    static final <T extends IdTitle>
    List<T>
    getObjectList(Map<Integer,T> fullMap, List<Integer> selectedIds)
    Selects object list from full map by given IDs in the same order.
    static final <T extends Title>
    String
    getObjectTitles(Collection<T> list)
    Возвращает наименования объектов через запятую.
    static final <T extends Title>
    String
    getObjectTitles(Collection<T> list, String startValues)
    Возвращает наименования объектов с указанным началом строки.
    static <T extends Title>
    String
    getObjectTitles(Collection<T> list, String startValues, String delim)
    Возвращает наименования объектов с указанием начала строки и разделителя.
    static final <T extends IdTitle>
    String
    getObjectTitles(Map<Integer,T> fullMap, List<Integer> selectedIds)
     
    static int
    getOpenId(String url)
    Extracts entity ID from URL.
    static String
    getTmpDir()
    System temp directory.
    static boolean
    hasClass(Object o, String... names)
    Checks if object is instance one of classes.
    static String
    htmlEncode(String value)
    Calls JSPFunction.htmlEncode(String) - replaces only HTML tags.
    static final boolean
    isBlankString(String value)
    Проверяет, является ли строка пустой, состоящей из пробельных символов или null.
    static final boolean
    isEmptyString(String value)
    Проверяет, является ли строка пустой или null.
    static final boolean
    isPositive(Integer value)
    Is the integer value greater than zero.
    static boolean
    isStringNumber(String str)
    Определяет хранится ли в строке число.
    static final boolean
    isValidEmail(String value)
    Is the string a valid E-Mail address.
    static final String
    maskEmpty(String value, String defaultValue)
    Преобразует входную строку в значение по-умолчанию, если она null или пустая.
    static final String
    maskNull(String value)
    Преобразует входную строку в пустую, если она null.
    static final <T> T
    maskNull(T value, T defaultValue)
    Возвращает объект либо иное значение, если объект null.
    static final BigDecimal
    maskNullDecimal(BigDecimal value)
    Возвращает входное значение тогда и только тогда, когда оно не равно null, иначе возвращает BigDecimal.ZERO.
    static final <T> Set<T>
    maskNullSet(Set<T> value)
    Возвращает пустой немодифируемый Set, если value == null либо value.
    static Object
    newInstance(String className)
    Creates an object of a given class.
    static final boolean
    notBlankString(String value)
    Checks if string value is blank.
    static final boolean
    notBlankStrings(String... value)
    Checks all the passed values with notBlankString(String).
    static final boolean
    notEmptyString(String value)
    Проверяет, является ли строка пустой или null.
    static BigDecimal
    parseBigDecimal(String str)
    Преобразует строку в BigDecimal, и, в случае ошибки, возвращает 0.0
    static BigDecimal
    parseBigDecimal(String str, BigDecimal defaultValue)
    Преобразует строку в BigDecimal, и, в случае ошибки, возвращает значение по умолчанию.
    static boolean
    parseBoolean(String str)
    Вызывает функию #parseBoolean(String, boolean) со вторым параметром false.
    static Boolean
    parseBoolean(String str, Boolean defaultValue)
    Преобразует строку в boolean.
    static final List<IdTitle>
    parseIdTitleList(String value)
    Возвращает список объектов из строки вида код:наименование; код:наименование.
    static final List<IdTitle>
    parseIdTitleList(String value, String noPairValue)
    Возвращает список объектов из строки вида код:наименование; код:наименование.
    static int
    parseInt(String str)
    Преобразует строку в int, в случае ошибки возращает 0.
    static int
    parseInt(String str, int defaultValue)
    Преобразует строку в int, в случае ошибки возращает defaultValue.
    static final List<ListItem>
    parseList(Element listElement)
     
    static long
    parseLong(String str)
    Преобразует строку в long, в случае ошибки возращает 0.
    static long
    parseLong(String str, long defaultValue)
    Преобразует строку в long, в случае ошибки возращает defaultValue.
    static void
    setFileNameHeaders(javax.servlet.http.HttpServletResponse response, String fileName)
    Sets HTTP headers for downloaded file.
    static final String
    substringAfter(String value, String token, int num)
    Возвращает остаток строки после num вхождения token в строку value.
    static final List<Integer>
    toIntegerList(String valuesStr)
    Преобразует строку с разделителями - запятыми или точками с запятой к списку Integer.
    static final List<Integer>
    toIntegerList(String valuesStr, String delims)
    Преобразует строку с произвольными разделителями - символами в delims в список Integer.
    static final Set<Integer>
    toIntegerSet(String valuesStr)
    Преобразование строки, разделенной запятыми к набору Integer.
    static final List<String>
    toList(String valuesStr)
    Преобразует строку разделённую , либо ; в список строк.
    static final List<String>
    toList(String value, String delims)
    Converts a string with obitary delimeter chars to list of strings.
    static final <T> List<T>
    toList(T... value)
    Преобразует несколько элементов в список.
    static final Set<String>
    toSet(String valuesStr)
    Преобразует строку разделённую , либо ; в набор строк.
    static final Set<String>
    toSet(String valuesStr, String delims)
    Преобразует строку разделённую произвольными разделителями - симвоолами в delims в набор строк.
    static final <T> Set<T>
    toSet(T... value)
    Преобразует несколько элементов в набор.
    static final String
    toString(Collection<?> valuesList)
    Вызывается toString(Collection, String, String) с параметром emptyValue="", delim=DEFAULT_DELIM.
    static final String
    toString(Collection<?> valuesList, String emptyValue, String delim)
    Преобразовывает коллекцию в строку, разделенную значениями delim.
    static final String
    toText(List<String> config, String separator)
    Converts a string with obitary delimeter chars to set of strings.
    static final boolean
    validateEmail(String email)
    Deprecated.

    Methods inherited from class java.lang.Object

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

  • Field Details

    • UTF8

      @Deprecated public static final Charset UTF8
      Deprecated.
      Use StandardCharsets.

    • HEX

      public static final char[] HEX

    • HEX_LOWERCASE

      public static final char[] HEX_LOWERCASE

    • log

      public static final Log log

    • STRING_ARRAY

      public static final String[] STRING_ARRAY

    • INTEGER_ARRAY

      public static final Integer[] INTEGER_ARRAY

  • Constructor Details

    • Utils

      public Utils()

  • Method Details

    • parseInt

      public static int parseInt(String str)
      Преобразует строку в int, в случае ошибки возращает 0.
      Parameters:
      str - входная строка
      Returns:
      число преобразованное из строки или 0 в случае ошибки

    • parseInt

      public static int parseInt(String str, int defaultValue)
      Преобразует строку в int, в случае ошибки возращает defaultValue.
      Parameters:
      str - входная строка
      defaultValue - значение возращаемое в случае ошибки при преобразовании
      Returns:
      число преобразованное из строки или defaultValue в случае ошибки

    • parseLong

      public static long parseLong(String str)
      Преобразует строку в long, в случае ошибки возращает 0.
      Parameters:
      str - входная строка
      Returns:
      число преобразованное из строки или 0 в случае ошибки

    • parseLong

      public static long parseLong(String str, long defaultValue)
      Преобразует строку в long, в случае ошибки возращает defaultValue.
      Parameters:
      str - входная строка
      defaultValue - значение возращаемое в случае ошибки при преобразовании
      Returns:
      число преобразованное из строки или defaultValue в случае ошибки

    • parseBigDecimal

      public static BigDecimal parseBigDecimal(String str, BigDecimal defaultValue)
      Преобразует строку в BigDecimal, и, в случае ошибки, возвращает значение по умолчанию.
      Parameters:
      str - строка представляющая BigDecimal-значение.
      defaultValue - BigDecimal-значение по умолчанию.
      Returns:
      новый объект BigDecimal.

    • parseBigDecimal

      public static BigDecimal parseBigDecimal(String str)
      Преобразует строку в BigDecimal, и, в случае ошибки, возвращает 0.0
      Parameters:
      str - строка представляющая BigDecimal-значение.
      Returns:
      новый объект BigDecimal.

    • parseBoolean

      public static boolean parseBoolean(String str)
      Вызывает функию #parseBoolean(String, boolean) со вторым параметром false.
      Parameters:
      str -
      Returns:

    • isStringNumber

      public static boolean isStringNumber(String str)
      Определяет хранится ли в строке число.
      Parameters:
      str -
      Returns:

    • parseBoolean

      public static Boolean parseBoolean(String str, Boolean defaultValue)
      Преобразует строку в boolean.
      Parameters:
      str - строка.
      defaultValue - значение по-умолчанию.
      Returns:
      true - если str равно "1", "TRUE", "YES", "NO" без учёта регистра; false - если str равно "0", "FALSE", "NO" без учёта регистра; в ином случае - defaultValue.

    • booleanToStringInt

      public static final String booleanToStringInt(boolean value)
      Преобразует boolean в строку "1" или "0".
      Parameters:
      value -
      Returns:

    • maskNull

      public static final <T> T maskNull(T value, T defaultValue)
      Возвращает объект либо иное значение, если объект null.
      Parameters:
      value -
      Returns:

    • maskNull

      public static final String maskNull(String value)
      Преобразует входную строку в пустую, если она null.
      Parameters:
      value -
      Returns:

    • maskNullDecimal

      public static final BigDecimal maskNullDecimal(BigDecimal value)
      Возвращает входное значение тогда и только тогда, когда оно не равно null, иначе возвращает BigDecimal.ZERO.
      Parameters:
      value -
      Returns:

    • maskNullSet

      public static final <T> Set<T> maskNullSet(Set<T> value)
      Возвращает пустой немодифируемый Set, если value == null либо value.
      Type Parameters:
      T -
      Parameters:
      value -
      Returns:

    • emptyToNull

      public static final <T> Set<T> emptyToNull(Set<T> value)
      Возвращает null, если Set пустой либо null, иначе возвращает исходный Set.
      Parameters:
      value -
      Returns:

    • emptyToNull

      public static final <T> List<T> emptyToNull(List<T> value)
      Возвращает null, если List пустой либо null, иначе возвращает исходный List.
      Parameters:
      value -
      Returns:

    • maskEmpty

      public static final String maskEmpty(String value, String defaultValue)
      Преобразует входную строку в значение по-умолчанию, если она null или пустая.
      Parameters:
      value -
      Returns:

    • isEmptyString

      public static final boolean isEmptyString(String value)
      Проверяет, является ли строка пустой или null.
      Parameters:
      value - проверяемая строка
      Returns:
      true - если пустая или null

    • isBlankString

      public static final boolean isBlankString(String value)
      Проверяет, является ли строка пустой, состоящей из пробельных символов или null.
      Parameters:
      value - проверяемая строка
      Returns:
      true если пустая, состоит из пробельных символов или null

    • notEmptyString

      public static final boolean notEmptyString(String value)
      Проверяет, является ли строка пустой или null.
      Parameters:
      value - проверяемая строка
      Returns:
      false если пустая или null

    • notBlankString

      public static final boolean notBlankString(String value)
      Checks if string value is blank.
      Parameters:
      value - checked value.
      Returns:
      false when value is null, empty or has only whitespace chars.

    • notBlankStrings

      public static final boolean notBlankStrings(String... value)
      Checks all the passed values with notBlankString(String).
      Parameters:
      value - values.
      Returns:
      value is not null, all the values aren't blank.

    • isPositive

      public static final boolean isPositive(Integer value)
      Is the integer value greater than zero. To do not create lambda functions.
      Parameters:
      value -
      Returns:

    • isValidEmail

      public static final boolean isValidEmail(String value)
      Is the string a valid E-Mail address.
      Parameters:
      value -
      Returns:

    • toString

      public static final String toString(Collection<?> valuesList)
      Вызывается toString(Collection, String, String) с параметром emptyValue="", delim=DEFAULT_DELIM.
      Parameters:
      valuesList -
      Returns:

    • toString

      public static final String toString(Collection<?> valuesList, String emptyValue, String delim)
      Преобразовывает коллекцию в строку, разделенную значениями delim.
      Parameters:
      valuesList - коллектиция
      emptyValue - значение при пустом списке
      delim - разделитель
      Returns:

    • toIntegerList

      public static final List<Integer> toIntegerList(String valuesStr)
      Преобразует строку с разделителями - запятыми или точками с запятой к списку Integer.
      Parameters:
      valuesStr -
      Returns:

    • toIntegerList

      public static final List<Integer> toIntegerList(String valuesStr, String delims)
      Преобразует строку с произвольными разделителями - символами в delims в список Integer.
      Parameters:
      valuesStr -
      delims -
      Returns:

    • toIntegerSet

      public static final Set<Integer> toIntegerSet(String valuesStr)
      Преобразование строки, разделенной запятыми к набору Integer.
      Parameters:
      valuesStr -
      Returns:

    • toSet

      public static final Set<String> toSet(String valuesStr, String delims)
      Преобразует строку разделённую произвольными разделителями - симвоолами в delims в набор строк.
      Parameters:
      valuesStr -
      delims -
      Returns:

    • toSet

      public static final Set<String> toSet(String valuesStr)
      Преобразует строку разделённую , либо ; в набор строк.
      Parameters:
      valuesStr -
      Returns:

    • toList

      public static final List<String> toList(String valuesStr)
      Преобразует строку разделённую , либо ; в список строк.
      Parameters:
      valuesStr -
      Returns:

    • toList

      public static final List<String> toList(String value, String delims)
      Converts a string with obitary delimeter chars to list of strings.
      Parameters:
      value - incoming string.
      delims - delimeter chars.
      Returns:
      list of tokens, each of that is not empty string.

    • toText

      public static final String toText(List<String> config, String separator)
      Converts a string with obitary delimeter chars to set of strings.
      Parameters:
      value - incoming string.
      delims - delimeter chars.
      Returns:
      set of tokens, each of that is not empty string.

    • toSet

      public static final <T> Set<T> toSet(T... value)
      Преобразует несколько элементов в набор.
      Parameters:
      value -
      Returns:

    • toList

      public static final <T> List<T> toList(T... value)
      Преобразует несколько элементов в список.
      Parameters:
      value -
      Returns:

    • getObjectIdsList

      public static final <T extends IdTitle> List<Integer> getObjectIdsList(Collection<T> list)
      Возвращает список кодов объектов.
      Parameters:
      list -
      Returns:

    • getObjectIdsSet

      public static final <T extends IdTitle> Set<Integer> getObjectIdsSet(Collection<T> list)
      Возаращает набор кодов объектов.
      Parameters:
      list -
      Returns:

    • getObjectIds

      public static final <T extends Id> String getObjectIds(Collection<T> list)
      Возвращает коды объектов из коллекции через запятую.
      Parameters:
      list -
      Returns:

    • getObjectIds

      public static final <T extends Id> String getObjectIds(Collection<T> list, String startValues)
      Возвращает коды объектов из коллекции через запятую с указанным началом строки.
      Parameters:
      list -
      startValues - начало строки.
      Returns:

    • getObjectIds

      public static <T extends Id> String getObjectIds(Collection<T> list, String startValues, String delim)
      Возвращает коды объектов из коллекции с указанием разделителя и начала строки.
      Parameters:
      list -
      startValues - начало строки.
      delim - разделитель кодов.
      Returns:

    • getObjectTitles

      public static final <T extends Title> String getObjectTitles(Collection<T> list)
      Возвращает наименования объектов через запятую.
      Parameters:
      list -
      Returns:

    • getObjectTitles

      public static final <T extends Title> String getObjectTitles(Collection<T> list, String startValues)
      Возвращает наименования объектов с указанным началом строки.
      Parameters:
      list -
      startValues - начало строки.
      Returns:

    • getObjectTitles

      public static <T extends Title> String getObjectTitles(Collection<T> list, String startValues, String delim)
      Возвращает наименования объектов с указанием начала строки и разделителя.
      Parameters:
      list -
      startValues - начало строки.
      delim - разделитель наименований объектов.
      Returns:

    • getObjectTitles

      public static final <T extends IdTitle> String getObjectTitles(Map<Integer,T> fullMap, List<Integer> selectedIds)

    • getObjectList

      public static final <T extends IdTitle> List<T> getObjectList(List<T> fullList, Set<Integer> selectedIds)
      Возвращает объекты из полного списка с указанными кодами.
      Parameters:
      fullList - полный список объектов.
      selectedIds - коды.
      Returns:

    • getObjectList

      public static final <T extends IdTitle> List<T> getObjectList(Map<Integer,T> fullMap, List<Integer> selectedIds)
      Selects object list from full map by given IDs in the same order.
      Parameters:
      fullMap - full objects map.
      selectedIds - ordered IDs list.
      Returns:

    • parseIdTitleList

      public static final List<IdTitle> parseIdTitleList(String value)
      Возвращает список объектов из строки вида код:наименование; код:наименование.
      Parameters:
      value -
      Returns:

    • parseIdTitleList

      public static final List<IdTitle> parseIdTitleList(String value, String noPairValue)
      Возвращает список объектов из строки вида код:наименование; код:наименование. Если значение для второго элемента пары не указано, будет использовано переданное в параметре noPairValue
      Parameters:
      value -
      noPairValue -
      Returns:

    • addSetupPair

      public static final void addSetupPair(StringBuilder data, String prefix, String param, String value)

    • addCommaSeparated

      public static final void addCommaSeparated(StringBuilder result, String value)
      Добавляет в конец строки новое значение, отделяя запятой с пробелом, если он не первый.
      Parameters:
      result -
      value -

    • addSeparated

      public static final void addSeparated(StringBuilder result, String separator, String value)

    • formatPatternString

      public static String formatPatternString(String object, int objectId, ParamValueDAO paramValueDAO, String pattern) throws Exception
      Генерирует строку из шаблона с подстановкой макросов вида ${param_<код параметра>}.
      Parameters:
      object -
      objectId -
      paramValueDAO -
      pattern -
      Returns:
      Throws:
      Exception

    • parseList

      public static final List<ListItem> parseList(Element listElement)

    • getDigest

      public static String getDigest(String value)
      Вызывает getDigest(String, String) с кодировкой UTF-8.
      Parameters:
      value -
      Returns:

    • getDigest

      public static String getDigest(String value, String charset)
      Возвращает строковое представление MD5 хэша от входной строки.
      Parameters:
      value - входные данные
      charset - кодировка
      Returns:
      строка

    • getDigest

      public static String getDigest(byte[] value)
      HEX representation of MD5 digest.
      Parameters:
      value - digest basic.
      Returns:
      digest HEX string or null in case of any error.

    • getTmpDir

      public static String getTmpDir()
      System temp directory.
      Returns:
      value of system property 'java.io.tmpdir', or '/tmp' if it is missing.

    • validateEmail

      @Deprecated public static final boolean validateEmail(String email)
      Deprecated.

    • createDirectoryIfNoExistInWorkDir

      public static final File createDirectoryIfNoExistInWorkDir(String dirName)

    • substringAfter

      public static final String substringAfter(String value, String token, int num)
      Возвращает остаток строки после num вхождения token в строку value.
      Parameters:
      value -
      token -
      num -
      Returns:

    • generateSecret

      public static final String generateSecret()
      Returns:
      generated random string with 32 ASCII chars.

    • getFirst

      public static <T> T getFirst(Collection<T> collection)
      Parameters:
      collection - collection of elements.
      Returns:
      the first element from collection, or null if collection is null or empty.

    • escapeXml

      public static String escapeXml(String value)
      Calls Functions.escapeXml(String) - replaces XML markup symbols to special codes.
      Parameters:
      value -
      Returns:

    • htmlEncode

      public static String htmlEncode(String value)
      Calls JSPFunction.htmlEncode(String) - replaces only HTML tags.
      Parameters:
      value -
      Returns:

    • getOpenId

      public static int getOpenId(String url)
      Extracts entity ID from URL.
      Parameters:
      url - URL.
      Returns:
      extracted positive ID or 0 if couldn't extract.

    • setFileNameHeaders

      public static void setFileNameHeaders(javax.servlet.http.HttpServletResponse response, String fileName)
      Sets HTTP headers for downloaded file.
      Parameters:
      response -
      fileName -

    • errorAndExit

      public static void errorAndExit(int code, String message)
      Writes error message and exists the running application.
      Parameters:
      code - exit code.
      message - message.

    • newInstance

      public static Object newInstance(String className) throws Exception
      Creates an object of a given class.
      Parameters:
      className - the class name.
      Returns:
      created object instance.
      Throws:
      Exception

    • hasClass

      public static boolean hasClass(Object o, String... names)
      Checks if object is instance one of classes.
      Parameters:
      o - the object to check.
      names - class names.
      Returns:
      if object o is instance any of names classes.