org.midica.file

Class CharsetUtils

java.lang.Object

org.midica.file.CharsetUtils

public final class CharsetUtils
extends java.lang.Object

This class provides charset-dependent methods.

Author:

Jan Trukenmüller

Field Summary

Fields

Modifier and Type	Field and Description
private static java.util.SortedMap<java.lang.String,java.nio.charset.Charset>	availableCharsets
private static java.lang.String	CHARSET_JP
private static java.lang.String	CHARSET_LATIN
private static java.util.regex.Pattern	pattSwitchCharset

Constructor Summary

Constructors

Constructor and Description
CharsetUtils()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	findCharsetSwitch(java.lang.String text) Checks the given string for a new charset marker.
static byte[]	getBytesFromText(java.lang.String text, java.lang.String charset) Converts a text into a byte array using the given charset, if possible.
static java.lang.String	getTextFromBytes(byte[] bytes, java.lang.String chosenCharset, java.lang.String fileCharset) Converts a byte array from a text-based MIDI message into a string.

Methods inherited from class java.lang.Object

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

Field Detail

availableCharsets

private static final java.util.SortedMap<java.lang.String,java.nio.charset.Charset> availableCharsets

pattSwitchCharset

private static final java.util.regex.Pattern pattSwitchCharset

CHARSET_LATIN

private static final java.lang.String CHARSET_LATIN

See Also:

Constant Field Values

CHARSET_JP

private static final java.lang.String CHARSET_JP

See Also:

Constant Field Values

Constructor Detail

CharsetUtils

public CharsetUtils()

Method Detail

getTextFromBytes

public static final java.lang.String getTextFromBytes(byte[] bytes,
                                                      java.lang.String chosenCharset,
                                                      java.lang.String fileCharset)

Converts a byte array from a text-based MIDI message into a string.

For the conversion the following charsets are tried:

• 1st priority: The charset found in the byte order mark, if available.
• 2nd priority: The charset defined in a previous MIDI message, if available.
• 3rd priority: The charset chosen in the file chooser.
• 4th priority: The platform default, if none of the above worked.

Parameters:

bytes - Byte array from the MIDI message.

chosenCharset - Charset chosen in the file selector.

fileCharset - Last charset declared in the sequence.

Returns:

the text.

getBytesFromText

public static final byte[] getBytesFromText(java.lang.String text,
                                            java.lang.String charset)

Converts a text into a byte array using the given charset, if possible.

Parameters:

text - The text to be converted.

charset - The charset to be used for converting.

Returns:

the converted text.

findCharsetSwitch

public static final java.lang.String findCharsetSwitch(java.lang.String text)

Checks the given string for a new charset marker. If one or more such markers are found, returns the charset from the last tag. Otherwise: returns **null*.

Parameters:

text - The text to be examinated.

Returns:

The new charset, if a charset change is found. Otherwise: null.