org.mobicents.protocols.ss7.map.datacoding

Class GSMCharset

java.lang.Object

java.nio.charset.Charset

org.mobicents.protocols.ss7.map.datacoding.GSMCharset

All Implemented Interfaces:

Comparable<Charset>

public class GSMCharset
extends Charset

The encoding/decoding of 7 bits characters in USSD strings is used doing GSMCharset.

For further details look at GSM 03.38 Specs

Author:

amit bhayani, sergey vetyutnev

Field Summary

Fields

Modifier and Type	Field and Description
protected static float	averageBytesPerChar
protected static float	averageCharsPerByte
protected static int	BUFFER_SIZE
static int[]	BYTE_TO_CHAR_DefaultAlphabet
static int[]	BYTE_TO_CHAR_DefaultAlphabetExtentionTable
static int[]	BYTE_TO_CHAR_UrduAlphabet
static int[]	BYTE_TO_CHAR_UrduAlphabetExtentionTable
static byte	ESCAPE
protected int[]	extensionTable
static String	GSM_CANONICAL_NAME
protected int[]	mainTable
protected static float	maxBytesPerChar
protected static float	maxCharsPerByte

Constructor Summary

Constructors

Constructor and Description
GSMCharset(String canonicalName, String[] aliases)
GSMCharset(String canonicalName, String[] aliases, int[] mainTable, int[] extentionTable)
GSMCharset(String canonicalName, String[] aliases, NationalLanguageIdentifier nationalLanguageLockingShiftIdentifier, NationalLanguageIdentifier nationalLanguageSingleShiftIdentifier)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	checkAllCharsCanBeEncoded(String data) Returns true if all characters in data String is included in main and extension encoding tables of the GSM7 charset
static boolean	checkAllCharsCanBeEncoded(String data, int[] mainTable, int[] extentionTable) Returns true if all characters in data String is included in main and extension encoding tables of the GSM7 charset
int	checkEncodedDataLengthInChars(String data) Returns a count in characters / septets of the data String after which the String will be GSM7 style encoded.
static int	checkEncodedDataLengthInChars(String data, int[] mainTable, int[] extentionTable) Returns a count in characters / septets of the data String after which the String will be GSM7 style encoded.
boolean	contains(Charset cs)
CharsetDecoder	newDecoder()
CharsetEncoder	newEncoder()
static int	octetsToSeptets(int byteCnt) Calculates how many septets are encapsulated in the provides octets count.
static int	septetsToOctets(int septCnt) Calculates how many octets encapsulate the provides septets count.
String[]	sliceString(String data, int charCount) Slicing of a data String into substrings that fits to characters / septets count in charCount parameter.
static String[]	sliceString(String data, int charCount, int[] mainTable, int[] extentionTable) Slicing of a data String into substrings that fits to characters / septets count in charCount parameter.

Methods inherited from class java.nio.charset.Charset

aliases, availableCharsets, canEncode, compareTo, decode, defaultCharset, displayName, displayName, encode, encode, equals, forName, hashCode, isRegistered, isSupported, name, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

GSM_CANONICAL_NAME

public static final String GSM_CANONICAL_NAME

See Also:

Constant Field Values

averageCharsPerByte

protected static final float averageCharsPerByte

See Also:

Constant Field Values

maxCharsPerByte

protected static final float maxCharsPerByte

See Also:

Constant Field Values

averageBytesPerChar

protected static final float averageBytesPerChar

See Also:

Constant Field Values

maxBytesPerChar

protected static final float maxBytesPerChar

See Also:

Constant Field Values

BUFFER_SIZE

protected static final int BUFFER_SIZE

See Also:

Constant Field Values

ESCAPE

public static final byte ESCAPE

See Also:

Constant Field Values

mainTable

protected int[] mainTable

extensionTable

protected int[] extensionTable

BYTE_TO_CHAR_DefaultAlphabet

public static final int[] BYTE_TO_CHAR_DefaultAlphabet

BYTE_TO_CHAR_DefaultAlphabetExtentionTable

public static final int[] BYTE_TO_CHAR_DefaultAlphabetExtentionTable

BYTE_TO_CHAR_UrduAlphabet

public static final int[] BYTE_TO_CHAR_UrduAlphabet

BYTE_TO_CHAR_UrduAlphabetExtentionTable

public static final int[] BYTE_TO_CHAR_UrduAlphabetExtentionTable

Constructor Detail

GSMCharset

public GSMCharset(String canonicalName,
          String[] aliases)

GSMCharset

public GSMCharset(String canonicalName,
          String[] aliases,
          int[] mainTable,
          int[] extentionTable)

GSMCharset

public GSMCharset(String canonicalName,
          String[] aliases,
          NationalLanguageIdentifier nationalLanguageLockingShiftIdentifier,
          NationalLanguageIdentifier nationalLanguageSingleShiftIdentifier)

Method Detail

contains

public boolean contains(Charset cs)

Specified by:

contains in class Charset

newDecoder

public CharsetDecoder newDecoder()

Specified by:

newDecoder in class Charset

newEncoder

public CharsetEncoder newEncoder()

Specified by:

newEncoder in class Charset

checkAllCharsCanBeEncoded

public boolean checkAllCharsCanBeEncoded(String data)

Returns true if all characters in data String is included in main and extension encoding tables of the GSM7 charset

Parameters:

data -

Returns:

checkAllCharsCanBeEncoded

public static boolean checkAllCharsCanBeEncoded(String data,
                                int[] mainTable,
                                int[] extentionTable)

Returns true if all characters in data String is included in main and extension encoding tables of the GSM7 charset

Parameters:

data -

Returns:

checkEncodedDataLengthInChars

public int checkEncodedDataLengthInChars(String data)

Returns a count in characters / septets of the data String after which the String will be GSM7 style encoded. For all characters from the extension character table two bytes will be reserved. For all characters from the main character table or which are not present in main or extension character tables one byte will be reserved.

Parameters:

data -

Returns:

checkEncodedDataLengthInChars

public static int checkEncodedDataLengthInChars(String data,
                                int[] mainTable,
                                int[] extentionTable)

Returns a count in characters / septets of the data String after which the String will be GSM7 style encoded. For all characters from the extension character table two bytes will be reserved. For all characters from the main character table or which are not present in main or extension character tables one byte will be reserved.

Parameters:

data -

Returns:

septetsToOctets

public static int septetsToOctets(int septCnt)

Calculates how many octets encapsulate the provides septets count.

Parameters:

data -

Returns:

octetsToSeptets

public static int octetsToSeptets(int byteCnt)

Calculates how many septets are encapsulated in the provides octets count.

Parameters:

data -

Returns:

sliceString

public String[] sliceString(String data,
                   int charCount)

Slicing of a data String into substrings that fits to characters / septets count in charCount parameter.

Parameters:

data -

Returns:

sliceString

public static String[] sliceString(String data,
                   int charCount,
                   int[] mainTable,
                   int[] extentionTable)

Slicing of a data String into substrings that fits to characters / septets count in charCount parameter.

Parameters:

data -

Returns: