net.sergeych.utils

Class Ut

java.lang.Object

net.sergeych.utils.Ut

public class Ut
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static java.nio.charset.Charset	utf8

Constructor Summary

Constructors

Constructor and Description
Ut()

Method Summary

Modifier and Type	Method and Description
static java.lang.Object[]	array(java.lang.Object... objects) Shortcut: return varargs as array
static <T> java.util.ArrayList<T>	arrayToList(java.lang.Object[] array)
static java.util.ArrayList<java.lang.String>	arrayToStringList(java.lang.Object[] array)
static java.io.File	createTempDirectory() Create temporary folder.
static boolean	deleteRecursive(java.io.File path) By default File#delete fails for non-empty directories, it works like "rm".
static boolean	different(java.lang.Object x, java.lang.Object y) Null-aware difference check.
static boolean	isJUnitTest() Check that current method is called from under junit test.
static boolean	isSymlink(java.io.File file) Hack.
static <T> java.lang.String	join(java.util.Collection<T> collection, java.lang.String separator) Join string representation of items in the collection with a specified delimiter.
static void	later(java.util.concurrent.Callable callable) Execute some callable in the separate thread (this implementation).
static <T> java.util.ArrayList<T>	list(T... objects)
static java.util.HashMap<java.lang.String,java.lang.Object>	mapFromArray(java.lang.Object... args) Convert "key, value" pairs from varargs into a Map.
static <K,V> java.lang.String	mapToString(java.util.Map<K,V> map) Convert map to {key: value,...} string
static java.lang.String	randomString(int length) Create strong enough pseudo-random alphanumeric String id.
static java.lang.String	randomString(int length, java.lang.String alphabet) Create strong enough pseudo-random alphanumeric String id.
static byte[]	readFully(java.io.InputStream inputStream) Java6 compatible way to read the whole stream into a bytes array
static void	readFully(java.io.InputStream inputStream, byte[] buffer) Read inputStream to fill completely the buffer.
static java.lang.String	readToString(java.io.InputStream inputStream) Read whole stream into the String using UTF-8 encoding.
static boolean	same(java.lang.Object a, java.lang.Object b) Null-aware equality that supports nulls.
static java.util.List<java.lang.String>	stringList(java.lang.Object... objects) Shortcut: return varargs as list
static java.lang.Object	trimWithEllipsis(java.lang.String text, int maxLen)

Methods inherited from class java.lang.Object

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

Field Detail

utf8

public static java.nio.charset.Charset utf8

Constructor Detail

Ut

public Ut()

Method Detail

randomString

public static java.lang.String randomString(int length)

Create strong enough pseudo-random alphanumeric String id. Uses [a-zA-Z0-9_] characters only.

Parameters:

length - desired length

Returns:

randomString

public static java.lang.String randomString(int length,
                                            java.lang.String alphabet)

Create strong enough pseudo-random alphanumeric String id. Uses [a-zA-Z0-9_] characters plus any characters from extraChars

Parameters:

length - desired length

alphabet - alphabet to select random characters from

Returns:

readFully

public static byte[] readFully(java.io.InputStream inputStream)
                        throws java.io.IOException

Java6 compatible way to read the whole stream into a bytes array

Parameters:

inputStream -

Returns:

Throws:

java.io.IOException

readFully

public static void readFully(java.io.InputStream inputStream,
                             byte[] buffer)
                      throws java.io.IOException,
                             java.io.EOFException

Read inputStream to fill completely the buffer. Throws EOFException if the stream closes before readung enough bytes.

Parameters:

inputStream - stream to read

buffer - buffer to fill

Throws:

java.io.EOFException

java.io.IOException

readToString

public static java.lang.String readToString(java.io.InputStream inputStream)
                                     throws java.io.IOException

Read whole stream into the String using UTF-8 encoding.

Parameters:

inputStream -

Returns:

result String

Throws:

java.io.IOException

array

public static java.lang.Object[] array(java.lang.Object... objects)

Shortcut: return varargs as array

Parameters:

objects -

Returns:

array

stringList

public static java.util.List<java.lang.String> stringList(java.lang.Object... objects)

Shortcut: return varargs as list

Parameters:

objects -

Returns:

array

arrayToList

public static <T> java.util.ArrayList<T> arrayToList(java.lang.Object[] array)

arrayToStringList

public static java.util.ArrayList<java.lang.String> arrayToStringList(java.lang.Object[] array)

mapFromArray

public static java.util.HashMap<java.lang.String,java.lang.Object> mapFromArray(java.lang.Object... args)

Convert "key, value" pairs from varargs into a Map.

Parameters:

args - key, value pairs.Can be 0 length or any even length.

Returns:

filled Map instance

mapToString

public static <K,V> java.lang.String mapToString(java.util.Map<K,V> map)

Convert map to {key: value,...} string

later

public static void later(java.util.concurrent.Callable callable)

Execute some callable in the separate thread (this implementation). Checked exceptions are logged.

Parameters:

callable -

trimWithEllipsis

public static java.lang.Object trimWithEllipsis(java.lang.String text,
                                                int maxLen)

same

public static boolean same(java.lang.Object a,
                           java.lang.Object b)

Null-aware equality that supports nulls. Object are same if both are nulls, or one is not null and its equals(other) returns true.

Parameters:

a -

b -

Returns:

true if a and b are both null or one that is not null .equals(other) is true

createTempDirectory

public static java.io.File createTempDirectory()
                                        throws java.io.IOException

Create temporary folder.

Returns:

newly created temp folder

Throws:

java.io.IOException

deleteRecursive

public static boolean deleteRecursive(java.io.File path)
                               throws java.io.IOException

By default File#delete fails for non-empty directories, it works like "rm". We need something a little more brutual - this does the equivalent of "rm -r". It will not follow symlinks - that will do no good ;)

Parameters:

path - Root File Path

Returns:

true iff the file and all sub files/directories have been removed

Throws:

java.io.FileNotFoundException

java.io.IOException

isSymlink

public static boolean isSymlink(java.io.File file)
                         throws java.io.IOException

Hack. Check that the file is a symlink

Parameters:

file -

Returns:

true if it is a symlink

Throws:

java.io.IOException

join

public static <T> java.lang.String join(java.util.Collection<T> collection,
                                        java.lang.String separator)

Join string representation of items in the collection with a specified delimiter.

Parameters:

collection - to convert to strign (toString() will be applied to each item)

separator -

Returns:

string representation

different

public static boolean different(java.lang.Object x,
                                java.lang.Object y)

Null-aware difference check.

Parameters:

x -

y -

Returns:

true if only one of x and y is null or !x.equals(y)

list

public static <T> java.util.ArrayList<T> list(T... objects)

isJUnitTest

public static boolean isJUnitTest()

Check that current method is called from under junit test. Thanks Janning for the original idea. Caches result.

Returns:

true if it is the test environment.