com.objsys.asn1j.runtime

Class Asn1Util

java.lang.Object

com.objsys.asn1j.runtime.Asn1Util

public class Asn1Util
extends java.lang.Object

This class contains some general purpose static utility functions.

Constructor Summary

Constructors

Constructor and Description
Asn1Util()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	BCDToString(byte[] bcd) Translates a BCD string to an ASCII string.
static void	closeRuntime() Signal that you are finished with the ASN1C runtime and release internal resources.
static byte[]	decodeBase64Array(char[] srcArray) Translates the specified Base64 array into byte array.
static java.lang.String	encodeBase64Array(byte[] srcArray) Translates the specified byte array to Base64 string.
static java.lang.String	firstSortedElement(java.util.Vector v) Returns the element of a Vector (that is assumed to contain strings) that is lexicographically the lowest element in the Vector.
static int	getBytesCount(long val) Calculate the count of bytes necessary to represent a signed long value.
static java.util.Vector	getKeys(java.util.Hashtable h) Returns a Vector containing the keys (assumed to be strings) of a passed Hashtable.
static int	getUlongBytesCount(long val) Calculate the count of bytes necessary to represent an unsigned long value.
static int	hexToByte(char c) Return the value of a single hexadecimal character.
static boolean	isLetter(char c) Determine if a specified character is a letter.
static boolean	isLimited() Indicates whether the run-time is limited or unlimited.
static boolean	isSpaceChar(char ch) Determine if a specified character is a space.
static boolean	isWhitespace(char ch) Determine if a specified character is whitespace.
static double	log2(double val) Calculate the log base 2 of value
static java.lang.String[]	PLMNidentityToString(byte[] plmnIdentity) Translates a PLMN identity string (i.e., byte array) to ASCII strings for the MCC and the MNC.
static double	pow(int base, int exponent) Raises an integer base to an integer power and returns the result as a double.
static int	rotateLeft(int value, int bitCnt) Return the result of rotating the bits in value left by bitCnt positions.
static java.lang.String[]	splitOnWhitespace(java.lang.String delimitedString) Split a string around whitespace characters.
static byte[]	stringToBCD(java.lang.String str) Translates an ASCII string to a BCD string.
static byte[]	stringToPLMNidentity(java.lang.String mcc, java.lang.String mnc) Translates ASCII Strings for MCC and MNC to a PLMNidentity.
static byte[]	stringToTBCD(java.lang.String str) Translates an ASCII String to a TBCD String.
static java.lang.String	stripWhitespace(java.lang.String value) Return the given string with all whitespace characters removed.
static char	tbcdBinToChar(byte tbcdDigit) This function converts a TBCD binary character into its ASCII equivalent.
static byte	tbcdCharToBin(char digit) This function converts a TBCD character ('0'-'9',"*#abc") into its binary equivalent.
static java.lang.String	TBCDToString(byte[] bcd) Translates a TBCD string to an ASCII string.
static char	toHexChar(int nibble) Convert a value from 0x0 to 0xF to the corresponding hex char.
static java.lang.String	toHexString(byte b) Convert a byte value to a hex string.
static java.lang.String	toHexString(byte[] b, int offset, int nbytes) Convert a string of bytes into a hex string.
static java.lang.StringBuffer	toHexString(byte b, java.lang.StringBuffer hexbuf) Convert a byte value to a hex string.

Methods inherited from class java.lang.Object

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

Constructor Detail

Asn1Util

public Asn1Util()

Method Detail

closeRuntime

public static void closeRuntime()

Signal that you are finished with the ASN1C runtime and release internal resources. Do not use the runtime classes, on any thread, after calling this. This may be called from any thread.

stripWhitespace

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

Return the given string with all whitespace characters removed. Here, "whitespace characters" means those characters defined by X.680 12.1.6 as whitespace: HT, LF, VT, FF, CR, SPACE.

Parameters:

value -

Returns:

value, with all whitespace removed; if the input string has no whitespace, it is returned itself.

hexToByte

public static int hexToByte(char c)

Return the value of a single hexadecimal character.

Parameters:

c - The hex character (0-9,A-F,a-f)

Returns:

Value of hex character, 0-15.

Throws:

Asn1Exception - if charater is not a hex character.

toHexString

public static java.lang.String toHexString(byte b)

Convert a byte value to a hex string. Unlike the Java built-in function, this will: a. not sign extend the byte value out to 32 bits if the MSB is set, and b. put a zero padding byte in front if less than 0xf In other words, a character string of length 2 is always returned.

toHexChar

public static char toHexChar(int nibble)

Convert a value from 0x0 to 0xF to the corresponding hex char. Lowercase letters are used for the hex characters.

toHexString

public static java.lang.StringBuffer toHexString(byte b,
                                                 java.lang.StringBuffer hexbuf)

Convert a byte value to a hex string. Unlike the Java built-in function, this will: a. not sign extend the byte value out to 32 bits if the MSB is set, and b. put a zero padding byte in front if less than or equal to 0xf In other words, a character string of length 2 is always appended to hexbuf.

toHexString

public static java.lang.String toHexString(byte[] b,
                                           int offset,
                                           int nbytes)

Convert a string of bytes into a hex string.

getBytesCount

public static int getBytesCount(long val)

Calculate the count of bytes necessary to represent a signed long value.

Parameters:

val - Integer value in which to count bytes.

Returns:

Bit count.

log2

public static double log2(double val)

Calculate the log base 2 of value

Parameters:

val - double value for which to count log(base2) val.

Returns:

result value.

getUlongBytesCount

public static int getUlongBytesCount(long val)

Calculate the count of bytes necessary to represent an unsigned long value.

Parameters:

val - Integer value in which to count bytes.

Returns:

Bit count.

encodeBase64Array

public static java.lang.String encodeBase64Array(byte[] srcArray)

Translates the specified byte array to Base64 string.

Parameters:

srcArray - byte array to be translated

Returns:

Base64 string

decodeBase64Array

public static byte[] decodeBase64Array(char[] srcArray)

Translates the specified Base64 array into byte array. The resulting array could be converted to the String by new String (byte[]) constructor.

Parameters:

srcArray - Base64 byte array to be translated

Returns:

decoded byte array

stringToBCD

public static byte[] stringToBCD(java.lang.String str)
                          throws Asn1ValueParseException

Translates an ASCII string to a BCD string. The ASCII string must contain only the following characters: [0..9A-Ea-e]. If the length of the source string is not even, the unused part of the last byte will be set to 0xF.

Parameters:

str - the source ASCII string

Returns:

the BCD string as a byte array.

Throws:

Asn1ValueParseException - If invalid characters are in the source string.

BCDToString

public static java.lang.String BCDToString(byte[] bcd)

Translates a BCD string to an ASCII string. The returned string will consist of characters in [0..9] and [A-E]. All half-bytes in the input shall be less than 0xF, except that in the final byte, the low half-byte may be 0xF, to act as filler for a string of odd length.

Parameters:

bcd - the source BCD string

Returns:

the ASCII string.

stringToTBCD

public static byte[] stringToTBCD(java.lang.String str)
                           throws Asn1ValueParseException

Translates an ASCII String to a TBCD String. The TBCD encoding format is as described in 3GPP 29.002: - the characters used are [0-9*#abc]. - each nibble represents a digit, and the upper nibble represents the digit which follows the digit represented in the lower nibble. - 0xF is used as filler in the final high nibble when the input string has and odd length. The ASCII string "12345" would be encoded 0x2143f5.

Parameters:

str - the source ASCII string

Returns:

the BCD string as a byte array.

Throws:

Asn1ValueParseException - If invalid characters are in the source string.

TBCDToString

public static java.lang.String TBCDToString(byte[] bcd)

Translates a TBCD string to an ASCII string. Refer to the description of TBCD in stringToTBCD.

Parameters:

bcd - the source TBCD string

Returns:

the ASCII string.

stringToPLMNidentity

public static byte[] stringToPLMNidentity(java.lang.String mcc,
                                          java.lang.String mnc)
                                   throws Asn1ValueParseException

Translates ASCII Strings for MCC and MNC to a PLMNidentity. The PLMNidentity format is described in (for example) 3GPP TS 25.413. Each nibble represents a digit from 0 through 9 inclusive. The first 3 nibbles are the digits of the MCC. If the MNC is 2 digits long, the fourth nibble is a filler of 0xf. Otherwise, the fourth nibble is the first digit of the MNC. Then the remaining 2 nibbles are the remaining digits of the MNC. An ASCII string of "123" for the MCC and "45" for the MNC would be encoded as 0x21F354.

Parameters:

mcc - the source ASCII string for the MCC.

mnc - the source ASCII string for the MNC.

Returns:

the PLMNidentity string as a byte array.

Throws:

Asn1ValueParseException - If invalid characters are in the source strings or they have an invalid length.

PLMNidentityToString

public static java.lang.String[] PLMNidentityToString(byte[] plmnIdentity)
                                               throws Asn1ValueParseException

Translates a PLMN identity string (i.e., byte array) to ASCII strings for the MCC and the MNC. Refer to the description of PLMN identity in stringToPLMNIdentity().

Parameters:

plmnIdentity - the source PLMN identity string (byte array)

Returns:

array of 2 Strings where element 0 is the MCC and element 1 is the MNC.

Throws:

Asn1ValueParseException

tbcdBinToChar

public static char tbcdBinToChar(byte tbcdDigit)

This function converts a TBCD binary character into its ASCII equivalent.

Parameters:

tbcdDigit - TBCD digit, 0..14 (0x0..0xE)

Returns:

the converted character

tbcdCharToBin

public static byte tbcdCharToBin(char digit)

This function converts a TBCD character ('0'-'9',"*#abc") into its binary equivalent.

Parameters:

digit - TBCD digit character ('0'-'9',"*#abc")

Returns:

binary representation of given char

isLimited

public static boolean isLimited()

Indicates whether the run-time is limited or unlimited.

Returns:

true if limited, false if unlimited

pow

public static double pow(int base,
                         int exponent)

Raises an integer base to an integer power and returns the result as a double.

Parameters:

base - the base to be raised to the power.

exponent - the power to which base is to be raised.

Returns:

base raised to exponent as a double.

rotateLeft

public static int rotateLeft(int value,
                             int bitCnt)

Return the result of rotating the bits in value left by bitCnt positions.

Parameters:

value -

bitCnt -

Returns:

isWhitespace

public static boolean isWhitespace(char ch)

Determine if a specified character is whitespace.

Parameters:

ch - the character to test.

Returns:

true if the character is whitespace, false if it isn't.

isSpaceChar

public static boolean isSpaceChar(char ch)

Determine if a specified character is a space.

Parameters:

ch - the character to test.

Returns:

true if the character is a space, false if it isn't.

firstSortedElement

public static java.lang.String firstSortedElement(java.util.Vector v)

Returns the element of a Vector (that is assumed to contain strings) that is lexicographically the lowest element in the Vector.

Parameters:

v - the Vector to be examined.

Returns:

the lowest value in the Vector as a String.

getKeys

public static java.util.Vector getKeys(java.util.Hashtable h)

Returns a Vector containing the keys (assumed to be strings) of a passed Hashtable.

Parameters:

h - the Hashtable to be examined.

Returns:

a Vector containing the keys.

isLetter

public static boolean isLetter(char c)

Determine if a specified character is a letter.

Parameters:

c - The character to examine.

Returns:

true if the character is a letter, false otherwise.

splitOnWhitespace

public static java.lang.String[] splitOnWhitespace(java.lang.String delimitedString)

Split a string around whitespace characters.

Parameters:

delimitedString - the whitespace-delimited string to parse.

Returns:

an array of Strings with each element being a piece of the original string.