Package oracle.i18n.lcsd

Class LCSDetectionInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

oracle.i18n.lcsd.LCSDetectionInputStream

All Implemented Interfaces:

Closeable, AutoCloseable

Direct Known Subclasses:

LCSDetectionHTMLInputStream

public class LCSDetectionInputStream
extends FilterInputStream

The LCSDetectionInputStream class is the language and character detector stream class that transparently detects the language and character set for the stream object.

The output of read methods are the original contents of the input stream in its original state. If the character set conversion using the detected character set is needed, use the LCSDetectionReader class. If the input stream includes the HTML contents, use the LCSDetectionHTMLInputStream class or the LCSDetectionHTMLReader class. The LCSDetectionInputStream class is used to determine the language and character set information used in the content.

Since:

10.2

Field Summary

Fields

Modifier and Type	Field	Description
protected static int	DEFAULT_SAMPLING_SIZE	Default buffer size for the dual stream objects.

Fields inherited from class java.io.FilterInputStream

in

Constructor Summary

Constructors

Constructor	Description
LCSDetectionInputStream(InputStream in)	Constructs the default LCS Detector input stream object.
LCSDetectionInputStream(InputStream in, int size)	Constructs the default LCS Detector input stream object with the sampling length.
LCSDetectionInputStream(String profile, InputStream in)	Constructs the LCS Detector input stream object using the specified LCSD profile.
LCSDetectionInputStream(String profile, InputStream in, int size)	Constructs the LCS Detector input stream object using the specified LCSD profile, input stream object, and sampling length.

Method Summary

Modifier and Type	Method	Description
LCSDResultSet	getResult()	Returns the result set of LCSD.
int	read()	Reads the next byte of data from the input stream.
int	read(byte[] b)	Reads some number of bytes from the input stream and stores them into the buffer array b.
int	read(byte[] b, int off, int len)	Reads up to len bytes of data from the input stream into an array of bytes.

Methods inherited from class java.io.FilterInputStream

available, close, mark, markSupported, reset, skip

Methods inherited from class java.io.InputStream

nullInputStream, readAllBytes, readNBytes, readNBytes, transferTo

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_SAMPLING_SIZE

protected static final int DEFAULT_SAMPLING_SIZE

Default buffer size for the dual stream objects.

See Also:

Constant Field Values

Constructor Detail

LCSDetectionInputStream

public LCSDetectionInputStream(InputStream in)
                        throws IOException,
                               UTFDataFormatException

Constructs the default LCS Detector input stream object.

Parameters:

in - the input stream to be sampled by the detector

Throws:

IOException - if any I/O error occurs

UTFDataFormatException - if an UTF-8 data sequence is detected. Note this occurs only if the source is UTF-8 data.

LCSDetectionInputStream

public LCSDetectionInputStream(InputStream in,
                               int size)
                        throws IOException,
                               UTFDataFormatException

Constructs the default LCS Detector input stream object with the sampling length.

Parameters:

in - the input stream to be sampled by the detector

size - the sampling size

Throws:

IOException - if any I/O error occurs

UTFDataFormatException - if an invalid UTF-8 data sequence is detected. Note this occurs only if the source is UTF-8 data.

LCSDetectionInputStream

public LCSDetectionInputStream(String profile,
                               InputStream in)
                        throws IOException,
                               UTFDataFormatException

Constructs the LCS Detector input stream object using the specified LCSD profile.

Parameters:

profile - the LCSD profile name. Specify null for the default profile.

in - the input stream to be sampled by the detector

Throws:

IOException - if any I/O error occurs

UTFDataFormatException - if an invalid UTF-8 data sequence is detected. Note this occurs only if the source is UTF-8 data.

LCSDetectionInputStream

public LCSDetectionInputStream(String profile,
                               InputStream in,
                               int size)
                        throws IOException,
                               UTFDataFormatException

Constructs the LCS Detector input stream object using the specified LCSD profile, input stream object, and sampling length.

The sampling is performed for the specified length. The detection result does not change until the read operation exceeds the specified length. Each minimum data length will be sampled afterwards.

Parameters:

profile - the LCSD profile name. Specify null for the default profile.

in - the input stream to be sampled by the detector

size - the sampling length

Throws:

IOException - if any I/O error occurs

UTFDataFormatException - if an invalid UTF-8 data sequence is detected. Note this occurs only if the source is UTF-8 data.

Method Detail

getResult

public LCSDResultSet getResult()
                        throws IOException,
                               EOFException,
                               UTFDataFormatException

Returns the result set of LCSD.

If your application requires information about the language, the character set, or both, call this method.

Returns:

The result set of LCSD.

Throws:

IOException - if an I/O error occurs

EOFException - if the stream ends unexpectedly

UTFDataFormatException - if an invalid UTF-8 data sequence is detected. Note this occurs only if the source is UTF-8 data.

read

public int read()
         throws IOException,
                UTFDataFormatException

Reads the next byte of data from the input stream.

Overrides:

read in class FilterInputStream

Returns:

The next byte of data, or -1 if the end of the stream is reached.

Throws:

IOException - if an I/O error occurs

UTFDataFormatException - if an invalid UTF-8 data sequence is detected. Note this occurs only if the source is UTF-8 data.

read

public int read(byte[] b)
         throws IOException,
                UTFDataFormatException

Reads some number of bytes from the input stream and stores them into the buffer array b.

Overrides:

read in class FilterInputStream

Parameters:

b - the buffer into which the data is read

Returns:

The total number of bytes read into the buffer, or -1 if there is no more data because the end of the stream has been reached.

Throws:

IOException - if an I/O error occurs

UTFDataFormatException - if an invalid UTF-8 data sequence is detected. Note this occurs only if the source is UTF-8 data.

read

public int read(byte[] b,
                int off,
                int len)
         throws IOException,
                UTFDataFormatException

Reads up to len bytes of data from the input stream into an array of bytes.

Overrides:

read in class FilterInputStream

Parameters:

b - the buffer into which the data is read

off - the start offset in array b to where the data is written

len - the maximum number of bytes to read

Returns:

The total number of bytes read into the buffer, or -1 if there is no more data because the end of the stream has been reached.

Throws:

IOException - if an I/O error occurs

UTFDataFormatException - if an invalid UTF-8 data sequence is detected. Note this occurs only if the source is UTF-8 data.