com.mgnt.utils

Class StringUnicodeEncoderDecoder

java.lang.Object

com.mgnt.utils.StringUnicodeEncoderDecoder

public class StringUnicodeEncoderDecoder
extends java.lang.Object

This class provides Unicode conversion utility methods that allow to convert a string into Unicode sequence and vice-versa. (See methods descriptions for details)

Author:

Michael Gantman

Constructor Summary

Constructors

Constructor and Description
StringUnicodeEncoderDecoder()

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.String	decodeUnicodeSequenceToString(java.lang.String unicodeSequence) This method converts String that contains a sequence of Unicode codes onto a String of corresponding characters.
static java.lang.String	encodeStringToUnicodeSequence(java.lang.String txt) This method converts a String of characters in any language into a String That contains a sequence of Unicode codes corresponding to characters in the original String For Example String "Hello" will be converted into a String "\u0048\u0065\u006c\u006c\u006f" Null or empty String conversion will return an empty String

Methods inherited from class java.lang.Object

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

Constructor Detail

StringUnicodeEncoderDecoder

public StringUnicodeEncoderDecoder()

Method Detail

encodeStringToUnicodeSequence

public static java.lang.String encodeStringToUnicodeSequence(java.lang.String txt)

This method converts a String of characters in any language into a String That contains a sequence of Unicode codes corresponding to characters in the original String For Example String "Hello" will be converted into a String "\u0048\u0065\u006c\u006c\u006f" Null or empty String conversion will return an empty String

Parameters:

txt - String that contains a sequence of characters to convert

Returns:

String That contains a sequence of unicode codes corresponding to the characters in the original String. Each code will be in hexadecimal format preceded by prefix "\u" with no spaces between them. The String also will have no leading or trailing white spaces

decodeUnicodeSequenceToString

public static java.lang.String decodeUnicodeSequenceToString(java.lang.String unicodeSequence)
                                                      throws java.lang.IllegalArgumentException

This method converts String that contains a sequence of Unicode codes onto a String of corresponding characters. For example a String "\u0048\u0065\u006c\u006c\u006f" will be converted into String "Hello" by this method. This method performs reverse conversion of the one performed by method encodeStringToUnicodeSequence(String) I.e. Any textual String converted into sequence of Unicode codes by method encodeStringToUnicodeSequence(String) may be retrieved back by invoking this method on that Unicode sequence String.

Parameters:

unicodeSequence - String That contains sequence of Unicode codes. Each code must be in hexadecimal format and must be preceded by "'backslash' + 'u'" prefix. (note that prefix '\U' is now valid as opposed to earlier versions). This method allows leading and trailing whitespaces for the whole String as well as spaces between codes. Those white spaces will be ignored.

Returns:

String That contains sequence of characters that correspond to the respective Unicode codes in the original String

Throws:

java.lang.IllegalArgumentException - if input String is in invalid format. For example if any code is not in hexadecimal format or the code is not a valid Unicode code (not valid code point).