freenet.client.filter

Interface CharsetExtractor

All Known Implementing Classes:

CSSReadFilter, HTMLFilter

public interface CharsetExtractor

For a specific text/-based MIME type, extracts the charset if possible.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	CharsetExtractor.BOMDetection

Method Summary

Modifier and Type	Method and Description
java.lang.String	getCharset(byte[] input, int length, java.lang.String parseCharset)
int	getCharsetBufferSize() How many bytes must be fed into the CharsetExtractor to figure out the charset
CharsetExtractor.BOMDetection	getCharsetByBOM(byte[] input, int length) Inspect the first few bytes of the file for any obvious but type-specific BOM.

Method Detail

getCharset

java.lang.String getCharset(byte[] input,
                            int length,
                            java.lang.String parseCharset)
                     throws DataFilterException,
                            java.io.IOException

Throws:

DataFilterException

java.io.IOException

getCharsetByBOM

CharsetExtractor.BOMDetection getCharsetByBOM(byte[] input,
                                              int length)
                                       throws DataFilterException,
                                              java.io.IOException

Inspect the first few bytes of the file for any obvious but type-specific BOM. Don't try too hard, if we don't find anything we will call getCharset() with some specific charset families to try.

Parameters:

input - The data.

Returns:

The BOM-detected charset family, this is essentially a guess which will have to be fed to getCharset(). (A true BOM would give an exact match, but the caller will have already tested for true BOMs by this point; we are looking for "@charset \"" encoded with the given format)

Throws:

DataFilterException

java.io.IOException

getCharsetBufferSize

int getCharsetBufferSize()

How many bytes must be fed into the CharsetExtractor to figure out the charset