ru.bgcrm.util

Class Utils

java.lang.Object

ru.bgcrm.util.Utils

public class Utils
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static char[]	HEX
static char[]	HEX_LOWERCASE
static java.lang.Integer[]	INTEGER_ARRAY
static org.apache.log4j.Logger	log
static java.lang.String[]	STRING_ARRAY

Constructor Summary

Constructors

Constructor and Description
Utils()

Method Summary

Methods

Modifier and Type	Method and Description
static void	addCommaSeparated(java.lang.StringBuilder result, java.lang.String value) Добавляет в конец строки новое значение, отделяя запятой с пробелом, если он не первый.
static void	addSeparated(java.lang.StringBuilder result, java.lang.String separator, java.lang.String value)
static void	addSetupPair(java.lang.StringBuilder data, java.lang.String prefix, java.lang.String param, java.lang.String value)
static java.lang.String	booleanToStringInt(boolean value) Преобразует boolean в строку "1" или "0".
static java.lang.String	bytesToString(byte[] bytes, boolean upperCase) Преобразование массива байт в HEX строку.
static java.io.File	createDirectoryIfNoExistInWorkDir(java.lang.String dirName)
static <T> java.util.List<T>	emptyToNull(java.util.List<T> value) Возвращает null, если List пустой либо null, иначе возвращает исходный List.
static <T> java.util.Set<T>	emptyToNull(java.util.Set<T> value) Возвращает null, если Set пустой либо null, иначе возвращает исходный Set.
static java.lang.String	escapeXml(java.lang.String value) Кодирует символы XML форматирования (кавычки, теги) для нормального их отображения в HTML тексте.
static java.lang.String	formatPatternString(java.lang.String object, int objectId, ParamValueDAO paramValueDAO, java.lang.String pattern) Генерирует строку из шаблона с подстановкой макросов вида ${param_<код параметра>}.
static java.util.Date	getDateFromMinutes(int minutes)
static java.lang.String	getDigest(java.lang.String value) Вызывает getDigest(String, String) с кодировкой UTF-8.
static java.lang.String	getDigest(java.lang.String value, java.lang.String charset) Возвращает строковое представление MD5 хэша от входной строки.
static <T> T	getFirst(java.util.Collection<T> collection) Возвращает первый элемент коллекции либо null если коллекция пуста.
static <T extends Id> java.lang.String	getObjectIds(java.util.Collection<T> list) Возвращает коды объектов из коллекции через запятую.
static <T extends Id> java.lang.String	getObjectIds(java.util.Collection<T> list, java.lang.String startValues) Возвращает коды объектов из коллекции через запятую с указанным началом строки.
static <T extends Id> java.lang.String	getObjectIds(java.util.Collection<T> list, java.lang.String startValues, java.lang.String delim) Возвращает коды объектов из коллекции с указанием разделителя и начала строки.
static <T extends IdTitle> java.util.List<java.lang.Integer>	getObjectIdsList(java.util.Collection<T> list) Возвращает список кодов объектов.
static <T extends IdTitle> java.util.Set<java.lang.Integer>	getObjectIdsSet(java.util.Collection<T> list) Возаращает набор кодов объектов.
static <T extends IdTitle> java.util.List<T>	getObjectList(java.util.List<T> fullList, java.util.Set<java.lang.Integer> selectedIds) Возвращает объекты из полного списка с указанными кодами.
static <T extends IdTitle> java.util.List<T>	getObjectList(java.util.Map<java.lang.Integer,T> fullMap, java.util.List<java.lang.Integer> selectedIds) Возвращает объекты из полного мапа с указанным порядком кодов.
static <T extends IdTitle> java.lang.String	getObjectTitles(java.util.Collection<T> list) Возвращает наименования объектов через запятую.
static <T extends IdTitle> java.lang.String	getObjectTitles(java.util.Collection<T> list, java.lang.String startValues) Возвращает наименования объектов с указанным началом строки.
static <T extends IdTitle> java.lang.String	getObjectTitles(java.util.Collection<T> list, java.lang.String startValues, java.lang.String delim) Возвращает наименования объектов с указанием начала строки и разделителя.
static java.lang.String	getTmpDir()
static boolean	isBlankString(java.lang.String value) Проверяет, является ли строка пустой, состоящей из пробельных символов или null.
static boolean	isEmptyString(java.lang.String value) Проверяет, является ли строка пустой или null.
static boolean	isStringNumber(java.lang.String str) Определяет хранится ли в строке число.
static java.lang.String	maskEmpty(java.lang.String value, java.lang.String defaultValue) Преобразует входную строку в значение по-умолчанию, если она null или пустая.
static java.lang.String	maskNull(java.lang.String value) Преобразует входную строку в пустую, если она null.
static java.math.BigDecimal	maskNullDecimal(java.math.BigDecimal value) Возвращает входное значение тогда и только тогда, когда оно не равно null, иначе возвращает BigDecimal.ZERO.
static <T> java.util.Set<T>	maskNullSet(java.util.Set<T> value) Возвращает пустой немодифируемый Set, если value == null либо value.
static boolean	notBlankString(java.lang.String value) Проверяет, является ли строка пустой, состоящей из пробельных символов или null.
static boolean	notEmptyString(java.lang.String value) Проверяет, является ли строка пустой или null.
static java.math.BigDecimal	parseBigDecimal(java.lang.String str) Преобразует строку в BigDecimal, и, в случае ошибки, возвращает 0.0
static java.math.BigDecimal	parseBigDecimal(java.lang.String str, java.math.BigDecimal defaultValue) Преобразует строку в BigDecimal, и, в случае ошибки, возвращает значение по умолчанию.
static boolean	parseBoolean(java.lang.String str) Вызывает функию #parseBoolean(String, boolean) со вторым параметром false.
static java.lang.Boolean	parseBoolean(java.lang.String str, java.lang.Boolean defaultValue) Преобразует строку в boolean.
static java.util.List<IdTitle>	parseIdTitleList(java.lang.String value) Возвращает список объектов из строки вида код:наименование; код:наименование.
static java.util.List<IdTitle>	parseIdTitleList(java.lang.String value, java.lang.String noPairValue) Возвращает список объектов из строки вида код:наименование; код:наименование.
static int	parseInt(java.lang.String str) Преобразует строку в int, в случае ошибки возращает 0.
static int	parseInt(java.lang.String str, int defaultValue) Преобразует строку в int, в случае ошибки возращает defaultValue.
static java.util.List<ListItem>	parseList(org.w3c.dom.Element listElement)
static long	parseLong(java.lang.String str) Преобразует строку в long, в случае ошибки возращает 0.
static long	parseLong(java.lang.String str, long defaultValue) Преобразует строку в long, в случае ошибки возращает defaultValue.
static byte[]	stringToBytes(java.lang.String s) Конвертирование HEX строки вида 0bcf224ba2 или 0BCF224BA2 в массив байт.
static java.lang.String	substringAfter(java.lang.String value, java.lang.String token, int num) Возвращает остаток строки после num вхождения token в строку value.
static java.lang.String	swapWords(java.lang.String str) Меняет местами четные символы с соответствующими нечетными
static java.util.List<java.lang.Integer>	toIntegerList(java.lang.String valuesStr) Преобразует строку с разделителями - запятыми или точками с запятой к списку Integer.
static java.util.List<java.lang.Integer>	toIntegerList(java.lang.String valuesStr, java.lang.String delims) Преобразует строку с произвольными разделителями - символами в delims в список Integer.
static java.util.Set<java.lang.Integer>	toIntegerSet(java.lang.String valuesStr) Преобразование строки, разделенной запятыми к набору Integer.
static java.util.List<java.lang.String>	toList(java.lang.String valuesStr) Преобразует строку разделённую , либо ; в список строк.
static java.util.List<java.lang.String>	toList(java.lang.String valuesStr, java.lang.String delims) Преобразует строку с произвольными разделителями - симвоолами в delims в список строк.
static <T> java.util.List<T>	toList(T... value) Преобразует несколько элементов в список.
static java.util.Set<java.lang.String>	toSet(java.lang.String valuesStr) Преобразует строку разделённую , либо ; в набор строк.
static java.util.Set<java.lang.String>	toSet(java.lang.String valuesStr, java.lang.String delims) Преобразует строку разделённую произвольными разделителями - симвоолами в delims в набор строк.
static <T> java.util.Set<T>	toSet(T... value) Преобразует несколько элементов в набор.
static java.lang.String	toString(java.util.Collection<?> valuesList) Вызывается toString(Collection, String, String) с параметром emptyValue="", delim=DEFAULT_DELIM.
static java.lang.String	toString(java.util.Collection<?> valuesList, java.lang.String emptyValue, java.lang.String delim) Преобразовывает коллекцию в строку, разделенную значениями delim.
static java.lang.String	toText(java.util.List<java.lang.String> config, java.lang.String separator) Преобразует лист строк в planeText с произвольным разделителем
static boolean	validateEmail(java.lang.String email)

Methods inherited from class java.lang.Object

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

Field Detail

HEX

public static final char[] HEX

HEX_LOWERCASE

public static final char[] HEX_LOWERCASE

log

public static final org.apache.log4j.Logger log

STRING_ARRAY

public static final java.lang.String[] STRING_ARRAY

INTEGER_ARRAY

public static final java.lang.Integer[] INTEGER_ARRAY

Constructor Detail

Utils

public Utils()

Method Detail

parseInt

public static int parseInt(java.lang.String str)

Преобразует строку в int, в случае ошибки возращает 0.

Parameters:

str - входная строка

Returns:

число преобразованное из строки или 0 в случае ошибки

parseInt

public static int parseInt(java.lang.String str,
           int defaultValue)

Преобразует строку в int, в случае ошибки возращает defaultValue.

Parameters:

str - входная строка

defaultValue - значение возращаемое в случае ошибки при преобразовании

Returns:

число преобразованное из строки или defaultValue в случае ошибки

parseLong

public static long parseLong(java.lang.String str)

Преобразует строку в long, в случае ошибки возращает 0.

Parameters:

str - входная строка

Returns:

число преобразованное из строки или 0 в случае ошибки

parseLong

public static long parseLong(java.lang.String str,
             long defaultValue)

Преобразует строку в long, в случае ошибки возращает defaultValue.

Parameters:

str - входная строка

defaultValue - значение возращаемое в случае ошибки при преобразовании

Returns:

число преобразованное из строки или defaultValue в случае ошибки

parseBigDecimal

public static java.math.BigDecimal parseBigDecimal(java.lang.String str,
                                   java.math.BigDecimal defaultValue)

Преобразует строку в BigDecimal, и, в случае ошибки, возвращает значение по умолчанию.

Parameters:

str - строка представляющая BigDecimal-значение.

defaultValue - BigDecimal-значение по умолчанию.

Returns:

новый объект BigDecimal.

parseBigDecimal

public static java.math.BigDecimal parseBigDecimal(java.lang.String str)

Преобразует строку в BigDecimal, и, в случае ошибки, возвращает 0.0

Parameters:

str - строка представляющая BigDecimal-значение.

Returns:

новый объект BigDecimal.

parseBoolean

public static boolean parseBoolean(java.lang.String str)

Вызывает функию #parseBoolean(String, boolean) со вторым параметром false.

Parameters:

str -

Returns:

isStringNumber

public static boolean isStringNumber(java.lang.String str)

Определяет хранится ли в строке число.

Parameters:

str -

Returns:

parseBoolean

public static java.lang.Boolean parseBoolean(java.lang.String str,
                             java.lang.Boolean defaultValue)

Преобразует строку в boolean.

Parameters:

str - строка.

defaultValue - значение по-умолчанию.

Returns:

true - если str равно "1", "TRUE", "YES", "NO" без учёта регистра; false - если str равно "0", "FALSE", "NO" без учёта регистра; в ином случае - defaultValue.

booleanToStringInt

public static final java.lang.String booleanToStringInt(boolean value)

Преобразует boolean в строку "1" или "0".

Parameters:

value -

Returns:

maskNull

public static final java.lang.String maskNull(java.lang.String value)

Преобразует входную строку в пустую, если она null.

Parameters:

value -

Returns:

maskNullDecimal

public static final java.math.BigDecimal maskNullDecimal(java.math.BigDecimal value)

Возвращает входное значение тогда и только тогда, когда оно не равно null, иначе возвращает BigDecimal.ZERO.

Parameters:

value -

Returns:

maskNullSet

public static final <T> java.util.Set<T> maskNullSet(java.util.Set<T> value)

Возвращает пустой немодифируемый Set, если value == null либо value.

Type Parameters:

T -

Parameters:

value -

Returns:

emptyToNull

public static final <T> java.util.Set<T> emptyToNull(java.util.Set<T> value)

Возвращает null, если Set пустой либо null, иначе возвращает исходный Set.

Parameters:

value -

Returns:

emptyToNull

public static final <T> java.util.List<T> emptyToNull(java.util.List<T> value)

Возвращает null, если List пустой либо null, иначе возвращает исходный List.

Parameters:

value -

Returns:

maskEmpty

public static final java.lang.String maskEmpty(java.lang.String value,
                         java.lang.String defaultValue)

Преобразует входную строку в значение по-умолчанию, если она null или пустая.

Parameters:

value -

Returns:

isEmptyString

public static final boolean isEmptyString(java.lang.String value)

Проверяет, является ли строка пустой или null.

Parameters:

value - проверяемая строка

Returns:

true - если пустая или null

isBlankString

public static final boolean isBlankString(java.lang.String value)

Проверяет, является ли строка пустой, состоящей из пробельных символов или null.

Parameters:

value - проверяемая строка

Returns:

true если пустая, состоит из пробельных символов или null

notEmptyString

public static final boolean notEmptyString(java.lang.String value)

Проверяет, является ли строка пустой или null.

Parameters:

value - проверяемая строка

Returns:

false если пустая или null

notBlankString

public static final boolean notBlankString(java.lang.String value)

Проверяет, является ли строка пустой, состоящей из пробельных символов или null.

Parameters:

value - проверяемая строка

Returns:

false - если пустая, состоит из пробельных символов или null

toString

public static final java.lang.String toString(java.util.Collection<?> valuesList)

Вызывается toString(Collection, String, String) с параметром emptyValue="", delim=DEFAULT_DELIM.

Parameters:

valuesList -

Returns:

toString

public static final java.lang.String toString(java.util.Collection<?> valuesList,
                        java.lang.String emptyValue,
                        java.lang.String delim)

Преобразовывает коллекцию в строку, разделенную значениями delim.

Parameters:

valuesList - коллектиция

emptyValue - значение при пустом списке

delim - разделитель

Returns:

toIntegerList

public static final java.util.List<java.lang.Integer> toIntegerList(java.lang.String valuesStr)

Преобразует строку с разделителями - запятыми или точками с запятой к списку Integer.

Parameters:

valuesStr -

Returns:

toIntegerList

public static final java.util.List<java.lang.Integer> toIntegerList(java.lang.String valuesStr,
                                              java.lang.String delims)

Преобразует строку с произвольными разделителями - символами в delims в список Integer.

Parameters:

valuesStr -

delims -

Returns:

toIntegerSet

public static final java.util.Set<java.lang.Integer> toIntegerSet(java.lang.String valuesStr)

Преобразование строки, разделенной запятыми к набору Integer.

Parameters:

valuesStr -

Returns:

toSet

public static final java.util.Set<java.lang.String> toSet(java.lang.String valuesStr,
                                    java.lang.String delims)

Преобразует строку разделённую произвольными разделителями - симвоолами в delims в набор строк.

Parameters:

valuesStr -

delims -

Returns:

toSet

public static final java.util.Set<java.lang.String> toSet(java.lang.String valuesStr)

Преобразует строку разделённую , либо ; в набор строк.

Parameters:

valuesStr -

Returns:

toList

public static final java.util.List<java.lang.String> toList(java.lang.String valuesStr)

Преобразует строку разделённую , либо ; в список строк.

Parameters:

valuesStr -

Returns:

toList

public static final java.util.List<java.lang.String> toList(java.lang.String valuesStr,
                                      java.lang.String delims)

Преобразует строку с произвольными разделителями - симвоолами в delims в список строк.

Parameters:

valuesStr -

delims -

Returns:

toText

public static final java.lang.String toText(java.util.List<java.lang.String> config,
                      java.lang.String separator)

Преобразует лист строк в planeText с произвольным разделителем

Parameters:

config -

separator -

Returns:

toSet

public static final <T> java.util.Set<T> toSet(T... value)

Преобразует несколько элементов в набор.

Parameters:

value -

Returns:

toList

public static final <T> java.util.List<T> toList(T... value)

Преобразует несколько элементов в список.

Parameters:

value -

Returns:

getObjectIdsList

public static final <T extends IdTitle> java.util.List<java.lang.Integer> getObjectIdsList(java.util.Collection<T> list)

Возвращает список кодов объектов.

Parameters:

list -

Returns:

getObjectIdsSet

public static final <T extends IdTitle> java.util.Set<java.lang.Integer> getObjectIdsSet(java.util.Collection<T> list)

Возаращает набор кодов объектов.

Parameters:

list -

Returns:

getObjectIds

public static final <T extends Id> java.lang.String getObjectIds(java.util.Collection<T> list)

Возвращает коды объектов из коллекции через запятую.

Parameters:

list -

Returns:

getObjectIds

public static final <T extends Id> java.lang.String getObjectIds(java.util.Collection<T> list,
                                           java.lang.String startValues)

Возвращает коды объектов из коллекции через запятую с указанным началом строки.

Parameters:

list -

startValues - начало строки.

Returns:

getObjectIds

public static <T extends Id> java.lang.String getObjectIds(java.util.Collection<T> list,
                                           java.lang.String startValues,
                                           java.lang.String delim)

Возвращает коды объектов из коллекции с указанием разделителя и начала строки.

Parameters:

list -

startValues - начало строки.

delim - разделитель кодов.

Returns:

getObjectTitles

public static final <T extends IdTitle> java.lang.String getObjectTitles(java.util.Collection<T> list)

Возвращает наименования объектов через запятую.

Parameters:

list -

Returns:

getObjectTitles

public static final <T extends IdTitle> java.lang.String getObjectTitles(java.util.Collection<T> list,
                                                   java.lang.String startValues)

Возвращает наименования объектов с указанным началом строки.

Parameters:

list -

startValues - начало строки.

Returns:

getObjectTitles

public static <T extends IdTitle> java.lang.String getObjectTitles(java.util.Collection<T> list,
                                                   java.lang.String startValues,
                                                   java.lang.String delim)

Возвращает наименования объектов с указанием начала строки и разделителя.

Parameters:

list -

startValues - начало строки.

delim - разделитель наименований объектов.

Returns:

getObjectList

public static final <T extends IdTitle> java.util.List<T> getObjectList(java.util.List<T> fullList,
                                                  java.util.Set<java.lang.Integer> selectedIds)

Возвращает объекты из полного списка с указанными кодами.

Parameters:

fullList - полный список объектов.

selectedIds - коды.

Returns:

getObjectList

public static final <T extends IdTitle> java.util.List<T> getObjectList(java.util.Map<java.lang.Integer,T> fullMap,
                                                  java.util.List<java.lang.Integer> selectedIds)

Возвращает объекты из полного мапа с указанным порядком кодов.

Parameters:

fullMap - полный мап объектов.

selectedIds - требуемый порядок кодов.

Returns:

parseIdTitleList

public static final java.util.List<IdTitle> parseIdTitleList(java.lang.String value)

Возвращает список объектов из строки вида код:наименование; код:наименование.

Parameters:

value -

Returns:

parseIdTitleList

public static final java.util.List<IdTitle> parseIdTitleList(java.lang.String value,
                                       java.lang.String noPairValue)

Возвращает список объектов из строки вида код:наименование; код:наименование. Если значение для второго элемента пары не указано, будет использовано переданное в параметре noPairValue

Parameters:

value -

noPairValue -

Returns:

addSetupPair

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

addCommaSeparated

public static final void addCommaSeparated(java.lang.StringBuilder result,
                     java.lang.String value)

Добавляет в конец строки новое значение, отделяя запятой с пробелом, если он не первый.

Parameters:

result -

value -

addSeparated

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

formatPatternString

public static java.lang.String formatPatternString(java.lang.String object,
                                   int objectId,
                                   ParamValueDAO paramValueDAO,
                                   java.lang.String pattern)
                                            throws BGException

Генерирует строку из шаблона с подстановкой макросов вида ${param_<код параметра>}.

Parameters:

object -

objectId -

paramValueDAO -

pattern -

Returns:

Throws:

BGException

parseList

public static final java.util.List<ListItem> parseList(org.w3c.dom.Element listElement)

getDigest

public static java.lang.String getDigest(java.lang.String value)

Вызывает getDigest(String, String) с кодировкой UTF-8.

Parameters:

value -

Returns:

getDigest

public static java.lang.String getDigest(java.lang.String value,
                         java.lang.String charset)

Возвращает строковое представление MD5 хэша от входной строки.

Parameters:

value - входные данные

charset - кодировка

Returns:

строка

getTmpDir

public static java.lang.String getTmpDir()

validateEmail

public static final boolean validateEmail(java.lang.String email)

createDirectoryIfNoExistInWorkDir

public static final java.io.File createDirectoryIfNoExistInWorkDir(java.lang.String dirName)

substringAfter

public static final java.lang.String substringAfter(java.lang.String value,
                              java.lang.String token,
                              int num)

Возвращает остаток строки после num вхождения token в строку value.

Parameters:

value -

token -

num -

Returns:

getDateFromMinutes

public static java.util.Date getDateFromMinutes(int minutes)

bytesToString

public static java.lang.String bytesToString(byte[] bytes,
                             boolean upperCase)

Преобразование массива байт в HEX строку.

Parameters:

bytes - массив байт

upperCase - если true, то символы результата в верхнем регистре

Returns:

stringToBytes

public static byte[] stringToBytes(java.lang.String s)

Конвертирование HEX строки вида 0bcf224ba2 или 0BCF224BA2 в массив байт.

Parameters:

s - строка вида 0bcf224ba2 или 0BCF224BA2

Returns:

getFirst

public static <T> T getFirst(java.util.Collection<T> collection)

Возвращает первый элемент коллекции либо null если коллекция пуста.

Parameters:

collection -

Returns:

escapeXml

public static java.lang.String escapeXml(java.lang.String value)

Кодирует символы XML форматирования (кавычки, теги) для нормального их отображения в HTML тексте.

Parameters:

value -

Returns:

swapWords

public static java.lang.String swapWords(java.lang.String str)

Меняет местами четные символы с соответствующими нечетными

Parameters:

str - входная строка

Returns: