net.freeutils.charset

Class PackedGSMCharset

java.lang.Object

java.nio.charset.Charset

net.freeutils.charset.EscapedByteLookupCharset

net.freeutils.charset.GSMCharset

net.freeutils.charset.PackedGSMCharset

All Implemented Interfaces:

Comparable<Charset>

Direct Known Subclasses:

CCPackedGSMCharset, SCPackedGSMCharset

public class PackedGSMCharset
extends GSMCharset

The PackedGSMCharset class handles the encoding and decoding of the GSM default encoding charset, with packing as per GSM 03.38 spec. The encoding and decoding are based on the mapping at http://www.unicode.org/Public/MAPPINGS/ETSI/GSM0338.TXT

Since:

2007-03-20

Author:

Amichai Rothman

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	PackedGSMCharset.Decoder The Decoder inner class handles the decoding of the Packed GSM default encoding charset.
protected class	PackedGSMCharset.Encoder The Encoder inner class handles the encoding of the Packed GSM default encoding charset.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	PackedGSMCharset(String canonicalName, String[] aliases, int[] byteToChar, int[] byteToCharEscaped, int[][] charToByte, int[][] charToByteEscaped) Initializes a new charset with the given canonical name and alias set, and byte-to-char/char-to-byte lookup tables.

Method Summary

Modifier and Type	Method and Description
CharsetDecoder	newDecoder() Constructs a new decoder for this charset.
CharsetEncoder	newEncoder() Constructs a new encoder for this charset.
static byte[]	pack(byte[] in) Packs the given data into full bytes.
static byte[]	unpack(byte[] in) Unpacks the given data into original bytes.

Methods inherited from class net.freeutils.charset.EscapedByteLookupCharset

contains

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

Constructor Detail

PackedGSMCharset

protected PackedGSMCharset(String canonicalName,
                           String[] aliases,
                           int[] byteToChar,
                           int[] byteToCharEscaped,
                           int[][] charToByte,
                           int[][] charToByteEscaped)

Initializes a new charset with the given canonical name and alias set, and byte-to-char/char-to-byte lookup tables.

Parameters:

canonicalName - the canonical name of this charset

aliases - an array of this charset's aliases, or null if it has no aliases

byteToChar - a byte-to-char conversion table for this charset

byteToCharEscaped - a byte-to-char conversion table for this charset for the escaped characters

charToByte - a char-to-byte conversion table for this charset. It can be generated on-the-fly by calling createInverseLookupTable(byteToChar).

charToByteEscaped - a char-to-byte conversion table for this charset for the escaped characters

Throws:

IllegalCharsetNameException - if the canonical name or any of the aliases are illegal

Method Detail

newDecoder

public CharsetDecoder newDecoder()

Constructs a new decoder for this charset.

Overrides:

newDecoder in class EscapedByteLookupCharset

Returns:

a new decoder for this charset

newEncoder

public CharsetEncoder newEncoder()

Constructs a new encoder for this charset.

Overrides:

newEncoder in class EscapedByteLookupCharset

Returns:

a new encoder for this charset

Throws:

UnsupportedOperationException - if this charset does not support encoding

unpack

public static byte[] unpack(byte[] in)

Unpacks the given data into original bytes. This is an external utility method and is not used internally by the Charset implementation.

Parameters:

in - the input bytes

Returns:

the unpacked output bytes

pack

public static byte[] pack(byte[] in)

Packs the given data into full bytes. This is an external utility method and is not used internally by the Charset implementation.

Parameters:

in - the input bytes

Returns:

the packed output bytes