SUtil (Jadex Active Component Platform 2.5-SNAPSHOT API.)

java.lang.Object
- jadex.commons.SUtil

```
public class SUtil
extends Object
```
This class provides several useful static util methods.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`SUtil.AccessiblePrintStream` An subclass of print stream to allow accessing the underlying stream.
`static interface`	`SUtil.AndroidUtils`

Field Summary

Fields
Modifier and Type	Field and Description
`static String[]`	`BYTE_UNITS` Units for representing byte values.
`static DecimalFormat`	`BYTEFORMATTER1` The byte formatter for one predecimal digit.
`static DecimalFormat`	`BYTEFORMATTER2` The byte formatter for two predecimal digits.
`static DecimalFormat`	`BYTEFORMATTER3` The byte formatter for three predecimal digits.
`static int`	`CONVERT_ALL` Constant that indicates a conversion of all known characters.
`static int`	`CONVERT_ALL_EXCEPT_AMP` Constant that indicates a conversion of all known characters except &.
`static int`	`CONVERT_NONE` Constant that indicates a conversion of no characters.
`static Class[]`	`EMPTY_CLASS_ARRAY` An empty class array.
`static Enumeration`	`EMPTY_ENUMERATION` An empty enumeration.
`static String[]`	`EMPTY_STRING_ARRAY` An empty string array.
`static String`	`JADEXDIR` Directory were jadex stores files generated during runtime, to be used for later runs.
`static String`	`LF` Line separator.
`static String[]`	`macs` Cached for speed.
`static String`	`NULL` A Null value.
`static ThreadLocal<DateFormat>`	`SDF` Simple date format.
`static ThreadLocal<DateFormat>`	`SDF2`
`static ThreadLocal<DateFormat>`	`SDF3`
`static int`	`SORT_DOWN` Constant for sorting down.
`static int`	`SORT_UP` Constant for sorting up.

Constructor Summary

Constructors
Constructor and Description

SUtil()

Constructors
Constructor and Description
`SUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`addSystemErrListener(IChangeListener listener)` Add a listener to System.err.
`static void`	`addSystemOutListener(IChangeListener listener)` Add a listener to System.out.
`static SUtil.AndroidUtils`	`androidUtils()` Get the AndroidUtils, if available.
`static boolean`	`arrayContains(Object array, Object value)` Check if an element is contained in an array.
`static boolean`	`arrayEquals(Object array1, Object array2)` Test if two arrays are content equal or both null.
`static int`	`arrayHashCode(Object a)` Calculate a hash code for an array.
`static <T> List<T>`	`arrayToList(Object a)` Transform an array to a vector.
`static <T> Set<T>`	`arrayToSet(Object a)` Transform an array to a vector.
`static String`	`arrayToString(Object array)` Get a string representation for an array.
`static byte[]`	`base16Decode(String data)` Decodes a Base16-encoded String and returns the data.
`static String`	`base16Encode(byte[] data)` Encodes a set of data as a Base16 String (hex).
`static String`	`beanToString(Object bean, ClassLoader cl)` Converts a bean to a string.
`static int`	`bytesToInt(byte[] buffer)` Convert bytes to an integer.
`static long`	`bytesToLong(byte[] buffer)` Convert bytes to an integer.
`static short`	`bytesToShort(byte[] buffer)` Convert bytes to a short.
`static String`	`bytesToString(long bytes)` Get bytes as human readable string.
`static List`	`calculateCartesianProduct(String[] names, Object[] values)` Calculate the cartesian product of parameters.
`static Set<URL>`	`collectClasspathURLs(ClassLoader baseloader)` Get other contained (but not directly managed) urls from parent classloaders.
`static void`	`collectManifestURLs(URL url, Set<URL> set, Set<String> jarnames)` Collect all URLs as specified in a manifest.
`static int`	`compareTo(String a, String b)` Compares two strings, ignoring case.
`static byte[]`	`computeFileHash(String filename)` Compute a file hash.
`static byte[]`	`computeFileHash(String filename, String algorithm)` Compute a file hash.
`static boolean`	`containsDigit(String s)` Test if a string contains a digit.
`static String`	`convertPathToPackage(String path, URL[] urls)` Find a package name from a path.
`static String`	`convertPathToRelative(String absolute)` Convert an absolute path to a relative path based on the current user directory.
`static String`	`convertURLToString(URL url)` Convert an URL to a local file name.
`static <T> T[]`	`copyArray(T[] original)` Copy an array.
`static void`	`copyFile(File source, File target)` Copy a file.
`static void`	`copyStream(InputStream is, OutputStream os)` Copy all data from input to output stream.
`static int`	`countOccurrences(String string, char find)` Count the occurrences of a char in a string.
`static <T> List<T>`	`createArrayList(T[] values)` Create an array list from values.
`static <K,T> Map<K,T>`	`createHashMap(K[] keys, T[] values)` Create a hash map from keys and values.
`static <T> Set<T>`	`createHashSet(T[] values)` Create a hash set from values.
`static Pattern`	`createRegexFromGlob(String glob)` Create a regex from a normal bnf pattern.
`static String`	`createUniqueId(String name)` Create a globally unique conversation id.
`static String`	`createUniqueId(String name, int length)` Create a globally unique conversation id.
`static Object`	`cutArrays(Object a1, Object a2)` Cut two arrays.
`static boolean`	`deleteDirectory(File dir)` Delete a directory completely (including all subdirs and files).
`static boolean`	`equals(Object val1, Object val2)`
`static String`	`escapeString(String str)` Escape a java string.
`static String`	`firstToUpperCase(String str)` Convert a string to the same string with first letter in upper case.
`static String`	`formatByteSize(long bytes)` Converts a number of bytes into a human-friendly binary prefix unit string (kiB, MiB, GiB, ...).
`static int`	`getArrayDimension(Object array)` Get the array dimension.
`static List<URL>`	`getClasspathURLs(ClassLoader classloader, boolean includebootpath)` Get the current classpath as a list of URLs
`static String`	`getCodeSource(String filename, String pck)` Get the source code base using a packagename and a filename.
`static File`	`getDefaultDirectory()` Get the home directory.
`static String`	`getDisplayName(File file)` Get the display name (e.g.
`static String`	`getDurationHMS(long ms)` Get a string representation for a duration.
`static String`	`getExceptionStacktrace(Exception e)` Get the exception stacktrace.
`static File`	`getFile(URL url)` Get the file from an URL.
`static File[]`	`getFiles(File file, boolean hiding)` Get the files of a directory.
`static String`	`getHashCode(File f)` Get the hash code for a file or directory.
`static File`	`getHomeDirectory()` Get the home directory.
`static InetAddress`	`getInet4Address()` Get a IPV4 address of the local host.
`static InetAddress`	`getInet6Address()` Get a IPV4 address of the local host.
`static InetAddress`	`getInetAddress()` Get an address of the local host.
`static String`	`getJarName(String filename)` Get the name of a jar file without extension and version info.
`static String`	`getMacAddress()` Get the mac address.
`static String[]`	`getMacAddresses()` Get the mac address.
`static String[]`	`getNetworkAddresses()` Get the addresses to be used for transports.
`static List<NetworkInterface>`	`getNetworkInterfaces()` Get the network interfaces.
`static InetAddress`	`getNetworkIp(InetAddress addr, short prefixlen)` Get the network ip for an internet address and the prefix length.
`static short`	`getNetworkPrefixLength(InetAddress iadr)` Get the network prefix length for IPV4 address 24=C, 16=B, 8=A classes.
`static OutputStream`	`getOutForSystemIn()` Get an output stream that is automatically fed into the new System.in, i.e.
`static File`	`getParentDirectory(File file)` Get the parent directory.
`static String`	`getPlural(String s)` Get the plural of a word in singular.
`static int`	`getPrefixLength(File file)` Get the prefix length of a file.
`static InputStream`	`getResource(String name, ClassLoader classloader)` Get an input stream for whatever provided.
`static InputStream`	`getResource0(String name, ClassLoader classloader)` Get an input stream for whatever provided.
`static ResourceInfo`	`getResourceInfo0(String name, ClassLoader classloader)` Get an input stream for whatever provided.
`static String`	`getSingular(String s)` Get the singular of a word in plural.
`static String`	`getStackTrace(Exception e)` Get the exception stack trace as string.
`static String[]`	`getStringArray(String key, Properties props)` Get a string array of properties that are separated by commas.
`static String`	`guessContentTypeByFilename(String name)` Guess the mime type by the file name.
`static String`	`hex(byte[] data)` Convert a byte array to a string representation.
`static String`	`hex(byte[] data, boolean uppercase)` Convert a byte array to a string representation.
`static String`	`hex(byte[] data, String delim, int block)` Convert a byte array to a string representation.
`static String`	`hex(byte[] data, String delim, int block, boolean uppercase)` Convert a byte array to a string representation.
`static String`	`hex(char ch)` Convert char to hex vavlue.
`static int`	`indexOfFilename(String url, List<String> urlstrings)` Test if a file name is contained.
`static byte[]`	`intToBytes(int val)` Convert an integer to bytes.
`static boolean`	`isFloppyDrive(File file)` Check if a file represents a floppy.
`static boolean`	`isGuiThread()` Test if a call is running on a gui (e.g.
`static boolean`	`isInRange(Date date, Date start, Date end)` Test if the date is in the range.
`static boolean`	`isJavaSourceFilename(String filename)` Test if a file is a Java source file.
`static boolean`	`isUTF8(byte[] bytes)` Test if starts with UTF-8 BOM.
`static Object[]`	`iteratorToArray(Iterator it, Class clazz)` Transform an iterator to an array.
`static List`	`iteratorToList(Iterator it)` Transform an iterator to a list.
`static List`	`iteratorToList(Iterator it, List ret)` Transform an iterator to a list.
`static <T> T[]`	`joinArbitraryArrays(Object[] as)` Joins any arrays of (possibly) different type.
`static Object`	`joinArrays(Object a1, Object a2)` Joins two arrays of the same type.
`static String`	`loadBinary(String file)` Load a binary file as base 64 string, e.g.
`static int`	`log2(int num)` Fast way to compute log2(x).
`static int`	`log2(long num)` Fast way to compute log2(x).
`static byte[]`	`longToBytes(long val)` Convert an integer to bytes.
`static void`	`main(String[] args)` Main method for testing.
`static String`	`makeConform(String input)` Convert an output to html/wml conform presentation.
`static String`	`makeConform(String input, int flag)` Convert an output to html/wml conform presentation.
`static String`	`makeEnglishConform(String input)` Convert an output readable in english.
`static void`	`moveFile(File source, File target)` Moves a file to a target location.
`static byte[]`	`readFile(File file)` Reads a file into memory (byte array).
`static String`	`readFile(String filename)` Read a file to string.
`static String`	`removeBOM(String text)` Remove BOM from UTF text.
`static String`	`removeExtension(String fn)` Remove file extension.
`static void`	`removeSystemErrListener(IChangeListener listener)` Remove a listener from System.err.
`static void`	`removeSystemOutListener(IChangeListener listener)` Remove a listener from System.out.
`static void`	`replace(String source, StringBuffer dest, String old, String newstring)` Parse a source string replacing occurrences and storing the result in the given string buffer.
`static String`	`replace(String source, String old, String newstring)` Parse a source string replacing occurrences and returning the result.
`static byte[]`	`shortToBytes(int val)` Convert a short to bytes.
`static String[]`	`splitCommandline(String line)` Taken from ant.
`static String`	`stripTags(String source)` Strip tags (e.g.
`static Object`	`substractArrays(Object a1, Object a2)` First array minus second array.
`static URI`	`toURI(URL url)` Convert a URL to a URI but ignore exceptions
`static URI`	`toURI0(URL url)` Convert a URL to a URI but ignore exceptions
`static URL`	`toURL(Object url)` Convert a file/string/url.
`static URL`	`toURL0(URI uri)` Convert a URI to a URL but ignore exceptions
`static URL[]`	`toURLs(Object[] urls)` Convert a file/string/url array.
`static void`	`unzip(ZipFile zip, File dir)` Unzip a file into a specific dir.
`static File`	`urlToFile(String url)` Convert an URL to a file.
`static String`	`wrapText(String text)` Wrap a text at a given line length.
`static String`	`wrapText(String text, int wrap)` Wrap a text at a given line length.
`static void`	`writeDirectory(File dir, OutputStream out)` Write a directory as jar to an output stream.
`static void`	`writeFile(String val, String filename)` Write a string to a file.
`static void`	`writeFile(String val, String filename, String charset)` Write a string to a file.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - JADEXDIR
```
public static final String JADEXDIR
```
    Directory were jadex stores files generated during runtime, to be used for later runs.
    
    See Also:
    
    Constant Field Values
  - LF
```
public static final String LF
```
    Line separator.
  - BYTE_UNITS
```
public static final String[] BYTE_UNITS
```
    Units for representing byte values.
  - BYTEFORMATTER1
```
public static final DecimalFormat BYTEFORMATTER1
```
    The byte formatter for one predecimal digit.
  - BYTEFORMATTER2
```
public static final DecimalFormat BYTEFORMATTER2
```
    The byte formatter for two predecimal digits.
  - BYTEFORMATTER3
```
public static final DecimalFormat BYTEFORMATTER3
```
    The byte formatter for three predecimal digits.
  - CONVERT_ALL
```
public static final int CONVERT_ALL
```
    Constant that indicates a conversion of all known characters.
    
    See Also:
    
    Constant Field Values
  - CONVERT_ALL_EXCEPT_AMP
```
public static final int CONVERT_ALL_EXCEPT_AMP
```
    Constant that indicates a conversion of all known characters except &.
    
    See Also:
    
    Constant Field Values
  - CONVERT_NONE
```
public static final int CONVERT_NONE
```
    Constant that indicates a conversion of no characters.
    
    See Also:
    
    Constant Field Values
  - NULL
```
public static final String NULL
```
    A Null value.
    
    See Also:
    
    Constant Field Values
  - SDF
```
public static final ThreadLocal<DateFormat> SDF
```
    Simple date format.
  - SDF2
```
public static final ThreadLocal<DateFormat> SDF2
```
  - SDF3
```
public static final ThreadLocal<DateFormat> SDF3
```
  - EMPTY_ENUMERATION
```
public static final Enumeration EMPTY_ENUMERATION
```
    An empty enumeration.
  - EMPTY_STRING_ARRAY
```
public static final String[] EMPTY_STRING_ARRAY
```
    An empty string array.
  - EMPTY_CLASS_ARRAY
```
public static final Class[] EMPTY_CLASS_ARRAY
```
    An empty class array.
  - SORT_UP
```
public static final int SORT_UP
```
    Constant for sorting up.
    
    See Also:
    
    Constant Field Values
  - SORT_DOWN
```
public static final int SORT_DOWN
```
    Constant for sorting down.
    
    See Also:
    
    Constant Field Values
  - macs
```
public static volatile String[] macs
```
    Cached for speed.
- Constructor Detail
  - SUtil
```
public SUtil()
```
- Method Detail
  - getStringArray
```
public static String[] getStringArray(String key,
                                      Properties props)
```
    Get a string array of properties that are separated by commas.
    
    Parameters:
    
    key - The key.
    
    props - The properties.
    
    Returns:
    
    The strings.
  - joinArrays
```
public static Object joinArrays(Object a1,
                                Object a2)
```
    Joins two arrays of the same type. Creates a new array containing the values of the first array followed by the values of the second.
    
    Parameters:
    
    a1 - The first array.
    
    a2 - The second array.
    
    Returns:
    
    The joined array.
  - joinArbitraryArrays
```
public static <T> T[] joinArbitraryArrays(Object[] as)
```
    Joins any arrays of (possibly) different type. todo: Does not support basic types yet. Problem basic type array and object arrays cannot be mapped (except they are mapped).
    
    Parameters:
    
    as - The array of arrays to join..
    
    Returns:
    
    The joined array.
  - cutArrays
```
public static Object cutArrays(Object a1,
                               Object a2)
```
    Cut two arrays.
    
    Parameters:
    
    a1 - The first array.
    
    a2 - The second array.
    
    Returns:
    
    The cutted array.
  - substractArrays
```
public static Object substractArrays(Object a1,
                                     Object a2)
```
    First array minus second array.
    
    Parameters:
    
    a1 - The first array.
    
    a2 - The second array.
    
    Returns:
    
    The substracted array.
  - arrayToList
```
public static <T> List<T> arrayToList(Object a)
```
    Transform an array to a vector.
    
    Parameters:
    
    a - The array.
    
    Returns:
    
    The vector for the array.
  - arrayToSet
```
public static <T> Set<T> arrayToSet(Object a)
```
    Transform an array to a vector.
    
    Parameters:
    
    a - The array.
    
    Returns:
    
    The vector for the array.
  - iteratorToList
```
public static List iteratorToList(Iterator it)
```
    Transform an iterator to a list.
  - iteratorToList
```
public static List iteratorToList(Iterator it,
                                  List ret)
```
    Transform an iterator to a list.
  - iteratorToArray
```
public static Object[] iteratorToArray(Iterator it,
                                       Class clazz)
```
    Transform an iterator to an array.
  - arrayContains
```
public static boolean arrayContains(Object array,
                                    Object value)
```
    Check if an element is contained in an array.
    
    Parameters:
    
    array - The array.
    
    value - The value.
  - getArrayDimension
```
public static int getArrayDimension(Object array)
```
    Get the array dimension.
    
    Parameters:
    
    array - The array.
    
    Returns:
    
    The number of dimensions.
  - equals
```
public static boolean equals(Object val1,
                             Object val2)
```
  - arrayEquals
```
public static boolean arrayEquals(Object array1,
                                  Object array2)
```
    Test if two arrays are content equal or both null.
    
    Parameters:
    
    array1 - The first array.
    
    array2 - The second array.
    
    Returns:
    
    True when the arrays are content equal.
  - arrayHashCode
```
public static int arrayHashCode(Object a)
```
    Calculate a hash code for an array.
  - arrayToString
```
public static String arrayToString(Object array)
```
    Get a string representation for an array.
    
    Parameters:
    
    array - The array.
    
    Returns:
    
    formatted string.
  - getSingular
```
public static String getSingular(String s)
```
    Get the singular of a word in plural. Does NOT find all correct singular.
    
    Parameters:
    
    s - The plural word.
    
    Returns:
    
    The singular of this word.
  - getPlural
```
public static String getPlural(String s)
```
    Get the plural of a word in singular. Does NOT find all correct plurals.
    
    Parameters:
    
    s - The word.
    
    Returns:
    
    The plural of this word.
  - compareTo
```
public static int compareTo(String a,
                            String b)
```
    Compares two strings, ignoring case.
    
    Parameters:
    
    a - The first string.
    
    b - The second string.
    
    Returns:
    
    a <0
  isInRange
  
  public static boolean isInRange(Date date, Date start, Date end)
  
  Test if the date is in the range. Start or end may null and will so not be checked.
  
  Parameters:
  
  date - The date.
  
  start - The start.
  
  end - The end.
  
  Returns:
  
  True, if date is in range.
  
  removeExtension
  
  public static String removeExtension(String fn)
  
  Remove file extension.
  
  Parameters:
  
  fn - The filename..
  
  Returns:
  
  filename without extension.
  
  wrapText
  
  public static String wrapText(String text)
  
  Wrap a text at a given line length. Doesn't to word wrap, just inserts linebreaks every nth character. If the string already contains linebreaks, these are handled properly (extra linebreaks will only be inserted when needed).
  
  Parameters:
  
  text - The text to wrap.
  
  wrapText
  
  public static String wrapText(String text, int wrap)
  
  Wrap a text at a given line length. Doesn't to word wrap, just inserts linebreaks every nth character. If the string already contains linebreaks, these are handled properly (extra linebreaks will only be inserted when needed).
  
  Parameters:
  
  text - The text to wrap.
  
  wrap - The column width.
  
  makeConform
  
  public static String makeConform(String input)
  
  Convert an output to html/wml conform presentation.
  
  Parameters:
  
  input - The input string.
  
  Returns:
  
  The converted output string.
  
  makeConform
  
  public static String makeConform(String input, int flag)
  
  Convert an output to html/wml conform presentation.
  
  Parameters:
  
  input - The input string.
  
  flag - CONVERT_ALL, CONVERT_NONE, CONVERT_ALL_EXCEPT_AMP;
  
  Returns:
  
  The converted output string.
  
  stripTags
  
  public static String stripTags(String source)
  
  Strip tags (e.g. html) from a string, leaving only the text content.
  
  makeEnglishConform
  
  public static String makeEnglishConform(String input)
  
  Convert an output readable in english. Therefore remove all äs, ös, üs etc.
  
  Parameters:
  
  input - The input string.
  
  Returns:
  
  The converted output string.
  
  replace
  
  public static void replace(String source, StringBuffer dest, String old, String newstring)
  
  Parse a source string replacing occurrences and storing the result in the given string buffer. This is a fast alternative to String.replaceAll(), because it does not use regular expressions.
  
  Parameters:
  
  source - The source string.
  
  dest - The destination string buffer.
  
  old - The string to replace.
  
  newstring - The string to use as replacement.
  
  replace
  
  public static String replace(String source, String old, String newstring)
  
  Parse a source string replacing occurrences and returning the result. This is a fast alternative to String.replaceAll(), because it does not use regular expressions.
  
  Parameters:
  
  source - The source string.
  
  old - The string to replace.
  
  newstring - The string to use as replacement.
  
  getResource
  
  public static InputStream getResource(String name, ClassLoader classloader) throws IOException
  
  Get an input stream for whatever provided. 1. It is tried to load the resource as file. 2. It is tried to load the resource via the ClassLoader. 3. It is tried to load the resource as URL.
  
  Parameters:
  
  name - The resource description.
  
  Returns:
  
  The input stream for the resource.
  
  Throws:
  
  IOException - when the resource was not found.
  
  getResource0
  
  public static InputStream getResource0(String name, ClassLoader classloader)
  
  Get an input stream for whatever provided. 1. It is tried to load the resource as file. 2. It is tried to load the resource via the ClassLoader. 3. It is tried to load the resource as URL.
  
  Parameters:
  
  name - The resource description.
  
  Returns:
  
  The input stream for the resource or null when the resource was not found.
  
  getResourceInfo0
  
  public static ResourceInfo getResourceInfo0(String name, ClassLoader classloader)
  
  Get an input stream for whatever provided. 1. It is tried to load the resource as file. 2. It is tried to load the resource via the ClassLoader. 3. It is tried to load the resource as URL.
  
  Parameters:
  
  name - The resource description.
  
  Returns:
  
  The info object for the resource or null when the resource was not found.
  
  copyStream
  
  public static void copyStream(InputStream is, OutputStream os)
  
  Copy all data from input to output stream.
  
  getDurationHMS
  
  public static String getDurationHMS(long ms)
  
  Get a string representation for a duration.
  
  Parameters:
  
  ms - The duration in ms.
  
  Returns:
  
  The string representation.
  
  convertPathToPackage
  
  public static String convertPathToPackage(String path, URL[] urls)
  
  Find a package name from a path. Searches the most specific classpath and uses the rest of the pathname as package name.
  
  Parameters:
  
  path - The directory.
  
  Returns:
  
  The package.
  
  getClasspathURLs
  
  public static List<URL> getClasspathURLs(ClassLoader classloader, boolean includebootpath)
  
  Get the current classpath as a list of URLs
  
  collectClasspathURLs
  
  public static Set<URL> collectClasspathURLs(ClassLoader baseloader)
  
  Get other contained (but not directly managed) urls from parent classloaders.
  
  Returns:
  
  The set of urls.
  
  getJarName
  
  public static String getJarName(String filename)
  
  Get the name of a jar file without extension and version info.
  
  collectManifestURLs
  
  public static void collectManifestURLs(URL url, Set<URL> set, Set<String> jarnames)
  
  Collect all URLs as specified in a manifest.
  
  calculateCartesianProduct
  
  public static List calculateCartesianProduct(String[] names, Object[] values)
  
  Calculate the cartesian product of parameters. Example: names = {"a", "b"}, values = {{"1", "2"}, {"3", "4"}} result = {{"a"="1", "b"="3"}, {"a"="2", "b"="3"}, {"a"="1", "b"="4"}, {"a=2", b="4"}}
  
  Parameters:
  
  names - The names.
  
  values - The values (must be some form of collection, i.e. array, list, iterator etc.)
  
  isJavaSourceFilename
  
  public static boolean isJavaSourceFilename(String filename)
  
  Test if a file is a Java source file.
  
  Parameters:
  
  filename - The filename.
  
  Returns:
  
  True, if it is a Java source file.
  
  createHashMap
  
  public static <K,T> Map<K,T> createHashMap(K[] keys, T[] values)
  
  Create a hash map from keys and values.
  
  Parameters:
  
  keys - The keys.
  
  values - The values.
  
  Returns:
  
  The map.
  
  createHashSet
  
  public static <T> Set<T> createHashSet(T[] values)
  
  Create a hash set from values.
  
  Parameters:
  
  values - The values.
  
  Returns:
  
  The map.
  
  createArrayList
  
  public static <T> List<T> createArrayList(T[] values)
  
  Create an array list from values.
  
  Parameters:
  
  values - The values.
  
  Returns:
  
  The map.
  
  createUniqueId
  
  public static String createUniqueId(String name)
  
  Create a globally unique conversation id.
  
  Returns:
  
  The conversation id.
  
  createUniqueId
  
  public static String createUniqueId(String name, int length)
  
  Create a globally unique conversation id.
  
  Returns:
  
  The conversation id.
  
  convertPathToRelative
  
  public static String convertPathToRelative(String absolute)
  
  Convert an absolute path to a relative path based on the current user directory.
  
  toURLs
  
  public static URL[] toURLs(Object[] urls)
  
  Convert a file/string/url array.
  
  Parameters:
  
  urls - The url strings.
  
  Returns:
  
  The urls.
  
  toURL
  
  public static URL toURL(Object url)
  
  Convert a file/string/url.
  
  toURL0
  
  public static URL toURL0(URI uri)
  
  Convert a URI to a URL but ignore exceptions
  
  toURI0
  
  public static URI toURI0(URL url)
  
  Convert a URL to a URI but ignore exceptions
  
  toURI
  
  public static URI toURI(URL url)
  
  Convert a URL to a URI but ignore exceptions
  
  main
  
  public static void main(String[] args)
  
  Main method for testing. / public static void main(String[] args) { String res1 = getRelativePath("c:/a/b/c", "c:/a/d"); String res2 = getRelativePath("c:/a/b/c", "c:/a/b/c"); //String res2 = getRelativePath("c:/a/b/c", "d:/a/d"); String res3 = getRelativePath("c:/a/b/c", "c:/a/b/c/d/e"); //String tst = "wwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwww" ; //System.out.println(tst); //System.out.println(SUtil.wrapText(tst)); /*String[] a = new String[]{"a1", "a2", "a3"}; Integer[] b = new Integer[]{Integer.valueOf(1), Integer.valueOf(2), Integer.valueOf(3)}; System.out.println(arrayToString(joinArbitraryArrays(new Object[]{a, b})));
  
  formatByteSize
  
  public static String formatByteSize(long bytes)
  
  Converts a number of bytes into a human-friendly binary prefix unit string (kiB, MiB, GiB, ...).
  
  Parameters:
  
  bytes - Number of bytes.
  
  bytesToShort
  
  public static short bytesToShort(byte[] buffer)
  
  Convert bytes to a short.
  
  shortToBytes
  
  public static byte[] shortToBytes(int val)
  
  Convert a short to bytes.
  
  bytesToInt
  
  public static int bytesToInt(byte[] buffer)
  
  Convert bytes to an integer.
  
  intToBytes
  
  public static byte[] intToBytes(int val)
  
  Convert an integer to bytes.
  
  bytesToLong
  
  public static long bytesToLong(byte[] buffer)
  
  Convert bytes to an integer.
  
  longToBytes
  
  public static byte[] longToBytes(long val)
  
  Convert an integer to bytes.
  
  getNetworkIp
  
  public static InetAddress getNetworkIp(InetAddress addr, short prefixlen)
  
  Get the network ip for an internet address and the prefix length. Example: ip: 134.100.33.22 / prefixlen: 24 (c class) -> 134.100.33.0
  
  Parameters:
  
  addr - The internet address.
  
  prefixlen - The prefix length.
  
  Returns:
  
  The net address.
  
  bytesToString
  
  public static String bytesToString(long bytes)
  
  Get bytes as human readable string.
  
  convertURLToString
  
  public static String convertURLToString(URL url)
  
  Convert an URL to a local file name.
  
  Parameters:
  
  url - The url.
  
  Returns:
  
  The absolute path to the url resource.
  
  indexOfFilename
  
  public static int indexOfFilename(String url, List<String> urlstrings)
  
  Test if a file name is contained.
  
  urlToFile
  
  public static File urlToFile(String url)
  
  Convert an URL to a file.
  
  Returns:
  
  null, if the URL is neither 'file:' nor 'jar:file:' URL and no path point to an existing file.
  
  addSystemOutListener
  
  public static void addSystemOutListener(IChangeListener listener)
  
  Add a listener to System.out.
  
  removeSystemOutListener
  
  public static void removeSystemOutListener(IChangeListener listener)
  
  Remove a listener from System.out.
  
  addSystemErrListener
  
  public static void addSystemErrListener(IChangeListener listener)
  
  Add a listener to System.err.
  
  removeSystemErrListener
  
  public static void removeSystemErrListener(IChangeListener listener)
  
  Remove a listener from System.err.
  
  getOutForSystemIn
  
  public static OutputStream getOutForSystemIn() throws IOException
  
  Get an output stream that is automatically fed into the new System.in, i.e. this method replaces System.in and delivers an output stream to which can be written. Note that writing to the output stream may block when no one reads from system in (default buffer size is 1024 characters).
  
  Throws:
  
  IOException
  
  getInet4Address
  
  public static InetAddress getInet4Address()
  
  Get a IPV4 address of the local host. Ignores loopback address and V6 addresses.
  
  Returns:
  
  First found IPV4 address.
  
  getInet6Address
  
  public static InetAddress getInet6Address()
  
  Get a IPV4 address of the local host. Ignores loopback address and V4 addresses.
  
  Returns:
  
  First found IPV4 address.
  
  getInetAddress
  
  public static InetAddress getInetAddress()
  
  Get an address of the local host. Tries to get a IPV4 address and if not available tries to get a IPV6 address.
  
  Returns:
  
  First found IPV4 or IPV6 address.
  
  getNetworkPrefixLength
  
  public static short getNetworkPrefixLength(InetAddress iadr)
  
  Get the network prefix length for IPV4 address 24=C, 16=B, 8=A classes. Returns -1 in case of V6 address.
  
  Parameters:
  
  iadr - The address.
  
  Returns:
  
  The length of the prefix.
  
  copyArray
  
  public static <T> T[] copyArray(T[] original)
  
  Copy an array.
  
  getCodeSource
  
  public static String getCodeSource(String filename, String pck)
  
  Get the source code base using a packagename and a filename. Looks at the filename and subtracts the package name.
  
  Parameters:
  
  filename - The filename.
  
  pck - The package name.
  
  Returns:
  
  The source base.
  
  countOccurrences
  
  public static int countOccurrences(String string, char find)
  
  Count the occurrences of a char in a string.
  
  Parameters:
  
  string - The string.
  
  find - The char to find.
  
  Returns:
  
  The number of occurrences.
  
  getNetworkInterfaces
  
  public static List<NetworkInterface> getNetworkInterfaces() throws SocketException
  
  Get the network interfaces. The result is cached for a short time period to speed things up.
  
  Throws:
  
  SocketException
  
  getNetworkAddresses
  
  public static String[] getNetworkAddresses() throws SocketException
  
  Get the addresses to be used for transports.
  
  Throws:
  
  SocketException
  
  unzip
  
  public static void unzip(ZipFile zip, File dir)
  
  Unzip a file into a specific dir.
  
  Parameters:
  
  zip - The zip file.
  
  dir - The target dir.
  
  deleteDirectory
  
  public static boolean deleteDirectory(File dir)
  
  Delete a directory completely (including all subdirs and files).
  
  Parameters:
  
  dir - The dir to delete.
  
  Returns:
  
  True, if was successfully deleted.
  
  getHomeDirectory
  
  public static File getHomeDirectory()
  
  Get the home directory.
  
  getDefaultDirectory
  
  public static File getDefaultDirectory()
  
  Get the home directory.
  
  getParentDirectory
  
  public static File getParentDirectory(File file)
  
  Get the parent directory.
  
  getFiles
  
  public static File[] getFiles(File file, boolean hiding)
  
  Get the files of a directory.
  
  getPrefixLength
  
  public static int getPrefixLength(File file)
  
  Get the prefix length of a file.
  
  isFloppyDrive
  
  public static boolean isFloppyDrive(File file)
  
  Check if a file represents a floppy. Returns false on android.
  
  getDisplayName
  
  public static String getDisplayName(File file)
  
  Get the display name (e.g. of a system drive). Returns null on android.
  
  isGuiThread
  
  public static boolean isGuiThread()
  
  Test if a call is running on a gui (e.g. Swing or Android UI) thread. Currently returns false on android.
  
  escapeString
  
  public static String escapeString(String str)
  
  Escape a java string.
  
  Parameters:
  
  str - The string to escape.
  
  Returns:
  
  The escaped string.
  
  hex
  
  public static String hex(char ch)
  
  Convert char to hex vavlue.
  
  hex
  
  public static String hex(byte[] data)
  
  Convert a byte array to a string representation.
  
  hex
  
  public static String hex(byte[] data, boolean uppercase)
  
  Convert a byte array to a string representation.
  
  hex
  
  public static String hex(byte[] data, String delim, int block)
  
  Convert a byte array to a string representation.
  
  hex
  
  public static String hex(byte[] data, String delim, int block, boolean uppercase)
  
  Convert a byte array to a string representation.
  
  base16Encode
  
  public static String base16Encode(byte[] data)
  
  Encodes a set of data as a Base16 String (hex).
  
  Parameters:
  
  data - The data.
  
  Returns:
  
  Base16-encoded String.
  
  base16Decode
  
  public static byte[] base16Decode(String data)
  
  Decodes a Base16-encoded String and returns the data.
  
  Parameters:
  
  data - The encoded data.
  
  Returns:
  
  The decoded data.
  
  splitCommandline
  
  public static String[] splitCommandline(String line)
  
  Taken from ant. Split a command line.
  
  Parameters:
  
  line - The command line to process.
  
  Returns:
  
  The command line broken into strings. An empty or null toProcess parameter results in a zero sized array.
  
  getFile
  
  public static File getFile(URL url)
  
  Get the file from an URL.
  
  Parameters:
  
  url - The file URL.
  
  Returns:
  
  The file.
  
  copyFile
  
  public static void copyFile(File source, File target) throws IOException
  
  Copy a file.
  
  Parameters:
  
  source - The source file.
  
  target - The target file or directory (will be deleted first).
  
  Throws:
  
  IOException
  
  moveFile
  
  public static void moveFile(File source, File target) throws IOException
  
  Moves a file to a target location.
  
  Parameters:
  
  source - The source file.
  
  target - The target file location (will be deleted first, if it exists).
  
  Throws:
  
  IOException
  
  readFile
  
  public static byte[] readFile(File file) throws IOException
  
  Reads a file into memory (byte array). Note: This only works for files smaller than 2GiB.
  
  Parameters:
  
  file - The file.
  
  Returns:
  
  Contents of the file.
  
  Throws:
  
  IOException - Exception on IO errors.
  
  getStackTrace
  
  public static String getStackTrace(Exception e)
  
  Get the exception stack trace as string.
  
  Parameters:
  
  e - The exception.
  
  Returns:
  
  The string.
  
  log2
  
  public static int log2(int num)
  
  Fast way to compute log2(x).
  
  Parameters:
  
  num - The number.
  
  Returns:
  
  The log2(x).
  
  log2
  
  public static int log2(long num)
  
  Fast way to compute log2(x).
  
  Parameters:
  
  num - The number.
  
  Returns:
  
  The log2(x).
  
  computeFileHash
  
  public static byte[] computeFileHash(String filename)
  
  Compute a file hash.
  
  Parameters:
  
  filename - The filename.
  
  Returns:
  
  The hash.
  
  computeFileHash
  
  public static byte[] computeFileHash(String filename, String algorithm)
  
  Compute a file hash.
  
  Parameters:
  
  filename - The filename.
  
  algorithm - The hash algorithm.
  
  Returns:
  
  The hash.
  
  firstToUpperCase
  
  public static String firstToUpperCase(String str)
  
  Convert a string to the same string with first letter in upper case.
  
  Parameters:
  
  str - The string.
  
  Returns:
  
  The string with first letter in uppercase.
  
  getMacAddress
  
  public static String getMacAddress()
  
  Get the mac address.
  
  Returns:
  
  The mac address.
  
  getMacAddresses
  
  public static String[] getMacAddresses()
  
  Get the mac address.
  
  Returns:
  
  The mac address.
  
  createRegexFromGlob
  
  public static Pattern createRegexFromGlob(String glob)
  
  Create a regex from a normal bnf pattern.
  
  beanToString
  
  public static String beanToString(Object bean, ClassLoader cl)
  
  Converts a bean to a string.
  
  Parameters:
  
  bean - The bean.
  
  cl - The classloader.
  
  readFile
  
  public static String readFile(String filename)
  
  Read a file to string.
  
  Parameters:
  
  filename - The file name.
  
  Returns:
  
  The string.
  
  writeFile
  
  public static void writeFile(String val, String filename)
  
  Write a string to a file.
  
  Parameters:
  
  val - The string to write.
  
  filename - The file name.
  
  writeFile
  
  public static void writeFile(String val, String filename, String charset)
  
  Write a string to a file.
  
  Parameters:
  
  val - The string to write.
  
  filename - The file name.
  
  androidUtils
  
  public static SUtil.AndroidUtils androidUtils()
  
  Get the AndroidUtils, if available.
  
  Returns:
  
  AndroidUtils
  
  loadBinary
  
  public static String loadBinary(String file)
  
  Load a binary file as base 64 string, e.g. for embedded html images.
  
  removeBOM
  
  public static String removeBOM(String text)
  
  Remove BOM from UTF text.
  
  Parameters:
  
  text - The text.
  
  Returns:
  
  The corrected string.
  
  isUTF8
  
  public static boolean isUTF8(byte[] bytes)
  
  Test if starts with UTF-8 BOM.
  
  Parameters:
  
  bytes - The text.
  
  Returns:
  
  Bytes without BOM.
  
  getExceptionStacktrace
  
  public static String getExceptionStacktrace(Exception e)
  
  Get the exception stacktrace.
  
  Parameters:
  
  e - The exception.
  
  Returns:
  
  The exception stacktrace.
  
  guessContentTypeByFilename
  
  public static String guessContentTypeByFilename(String name)
  
  Guess the mime type by the file name.
  
  Parameters:
  
  name - The filename
  
  Returns:
  
  The mime type.
  
  containsDigit
  
  public static boolean containsDigit(String s)
  
  Test if a string contains a digit.
  
  Parameters:
  
  s - The string.
  
  Returns:
  
  True, if the string contains a digit.
  
  getHashCode
  
  public static String getHashCode(File f)
  
  Get the hash code for a file or directory.
  
  writeDirectory
  
  public static void writeDirectory(File dir, OutputStream out)
  
  Write a directory as jar to an output stream.

Class SUtil

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

JADEXDIR

LF

BYTE_UNITS

BYTEFORMATTER1

BYTEFORMATTER2

BYTEFORMATTER3

CONVERT_ALL

CONVERT_ALL_EXCEPT_AMP

CONVERT_NONE

NULL

SDF

SDF2

SDF3

EMPTY_ENUMERATION

EMPTY_STRING_ARRAY

EMPTY_CLASS_ARRAY

SORT_UP

SORT_DOWN

macs

Constructor Detail

SUtil

Method Detail

getStringArray

joinArrays

joinArbitraryArrays

cutArrays

substractArrays

arrayToList

arrayToSet

iteratorToList

iteratorToList

iteratorToArray

arrayContains

getArrayDimension

equals

arrayEquals

arrayHashCode

arrayToString

getSingular

getPlural

compareTo

isInRange

removeExtension

wrapText

wrapText

makeConform

makeConform

stripTags

makeEnglishConform

replace

replace

getResource

getResource0

getResourceInfo0

copyStream

getDurationHMS

convertPathToPackage

getClasspathURLs

collectClasspathURLs

getJarName

collectManifestURLs

calculateCartesianProduct

isJavaSourceFilename

createHashMap

createHashSet

createArrayList

createUniqueId

createUniqueId

convertPathToRelative

toURLs

toURL

toURL0

toURI0