info.monitorenter.cpdetector.io

类 CodepageDetectorProxy

java.lang.Object

info.monitorenter.cpdetector.io.AbstractCodepageDetector

info.monitorenter.cpdetector.io.CodepageDetectorProxy

所有已实现的接口:

ICodepageDetector, Serializable, Comparable

public final class CodepageDetectorProxy
extends AbstractCodepageDetector

A proxy that delegate the codepage detection to all it's delegates. The first one (added in code-order) that does not return a null Charsetfrom it's delegate method detectCodepage(URL)wins the race and determines the codpage of the document specified by the given URL.

If an underlying ICodepageDetectorthrows an IOException, the delegation search will be terminated by throwing this exception.

作者:

Achim Westermann

另请参阅:

序列化表格

方法概要

方法

限定符和类型	方法和说明
boolean	add(ICodepageDetector detector) Adds the given instance to this proxie's detection capability.
Charset	detectCodepage(InputStream in, int length) Detects the codepage by iteratively delegating the call to all internal ICodepageDetector instances added by add(ICodepageDetector).
Charset	detectCodepage(URL url) Delegates to ICodepageDetector.detectCodepage(java.io.InputStream, int) with a buffered input stream.
static CodepageDetectorProxy	getInstance() Singleton retrieval method.
String	toString()

从类继承的方法 info.monitorenter.cpdetector.io.AbstractCodepageDetector

compareTo, open

从类继承的方法 java.lang.Object

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

方法详细资料

getInstance

public static CodepageDetectorProxy getInstance()

Singleton retrieval method.

Be sure to configure the instance returned at a single location in your code to avoid unpredictable application - wide side effects.

返回:

the sole instance in this VM.

add

public boolean add(ICodepageDetector detector)

Adds the given instance to this proxie's detection capability.

Remember that the order of added ICodepageDetector instances is important for the internal delegation (see class description).

detectCodepage

public Charset detectCodepage(URL url)
                       throws IOException

从类复制的说明: AbstractCodepageDetector

Delegates to ICodepageDetector.detectCodepage(java.io.InputStream, int) with a buffered input stream.

指定者:

detectCodepage 在接口中 ICodepageDetector

覆盖:

detectCodepage 在类中 AbstractCodepageDetector

参数:

url - Should link to a file containing textual document. No check for images or other resources is made.

返回:

null, if the codepage of the document specified by the given URL was not detected or the Charsetthat represents the document's codepage.

抛出:

IOException - If a problem with the url - handling occurs.

另请参阅:

ICodepageDetector.detectCodepage(URL)

detectCodepage

public Charset detectCodepage(InputStream in,
                     int length)
                       throws IOException,
                              IllegalArgumentException

Detects the codepage by iteratively delegating the call to all internal ICodepageDetector instances added by add(ICodepageDetector).

The given InputStream has to support mark such that the call InputStream.mark(int) with argument length does not throw an exception. This is needed, as the stream has to be resetted to the beginning for each internal delegate that tries to detect.

If this is impossible (large documents), prefer using detectCodepage(URL).

参数:

in - An InputStream for the document, that supports mark and a readlimit of argument length.

length - The amount of bytes to take into account. This number shouls not be longer than the amount of bytes retrievable from the InputStream but should be as long as possible to give the fallback detection (chardet) more hints to guess.

抛出:

IllegalArgumentException - if more bytes had to be read from the input stream than param length or the given input stream does not support marking.

IOException

另请参阅:

cpdetector.io.ICodepageDetector#detectCodepage(InputStream, int length)

toString

public String toString()

覆盖:

toString 在类中 Object

另请参阅:

Object.toString()