Package org.apache.commons.io.input

Class CharSequenceInputStream

java.lang.Object

java.io.InputStream

org.apache.commons.io.input.CharSequenceInputStream

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class CharSequenceInputStream
extends java.io.InputStream

Implements an InputStream to read bytes from String, StringBuffer, StringBuilder or CharBuffer, encoded using the specified Charset. The Charset defaults to Charset.defaultCharset().

Note: Supports mark(int) and reset().

To build an instance, use CharSequenceInputStream.Builder.

Since:

2.2

See Also:

CharSequenceInputStream.Builder

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	CharSequenceInputStream.Builder	Builds a new CharSequenceInputStream.

Field Summary

Fields

Modifier and Type	Field	Description
private java.nio.ByteBuffer	bBuf
private int	bBufMark
private java.nio.CharBuffer	cBuf
private int	cBufMark
private java.nio.charset.CharsetEncoder	charsetEncoder
private static int	NO_MARK

Constructor Summary

Constructors

Modifier	Constructor	Description
private	CharSequenceInputStream(java.lang.CharSequence cs, int bufferSize, java.nio.charset.CharsetEncoder charsetEncoder)
	CharSequenceInputStream(java.lang.CharSequence cs, java.lang.String charset)	Deprecated. Use builder(), CharSequenceInputStream.Builder, and CharSequenceInputStream.Builder.get()
	CharSequenceInputStream(java.lang.CharSequence cs, java.lang.String charset, int bufferSize)	Deprecated. Use builder(), CharSequenceInputStream.Builder, and CharSequenceInputStream.Builder.get()
	CharSequenceInputStream(java.lang.CharSequence cs, java.nio.charset.Charset charset)	Deprecated. Use builder(), CharSequenceInputStream.Builder, and CharSequenceInputStream.Builder.get()
	CharSequenceInputStream(java.lang.CharSequence cs, java.nio.charset.Charset charset, int bufferSize)	Deprecated. Use builder(), CharSequenceInputStream.Builder, and CharSequenceInputStream.Builder.get()

Method Summary

Modifier and Type	Method	Description
int	available()	Gets a lower bound on the number of bytes remaining in the byte stream.
static CharSequenceInputStream.Builder	builder()	Constructs a new CharSequenceInputStream.Builder.
void	close()
private void	fillBuffer()	Fills the byte output buffer from the input char buffer.
(package private) java.nio.charset.CharsetEncoder	getCharsetEncoder()	Gets the CharsetEncoder.
void	mark(int readLimit)
boolean	markSupported()
private static java.nio.charset.CharsetEncoder	newEncoder(java.nio.charset.Charset charset)
int	read()
int	read(byte[] b)
int	read(byte[] array, int off, int len)
void	reset()
long	skip(long n)

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

NO_MARK

private static final int NO_MARK

See Also:

Constant Field Values

bBuf

private final java.nio.ByteBuffer bBuf

bBufMark

private int bBufMark

cBuf

private final java.nio.CharBuffer cBuf

cBufMark

private int cBufMark

charsetEncoder

private final java.nio.charset.CharsetEncoder charsetEncoder

Constructor Detail

CharSequenceInputStream

@Deprecated
public CharSequenceInputStream(java.lang.CharSequence cs,
                               java.nio.charset.Charset charset)

Deprecated.

Use builder(), CharSequenceInputStream.Builder, and CharSequenceInputStream.Builder.get()

Constructs a new instance with a buffer size of IOUtils.DEFAULT_BUFFER_SIZE.

Parameters:

cs - the input character sequence.

charset - the character set name to use.

Throws:

java.lang.IllegalArgumentException - if the buffer is not large enough to hold a complete character.

CharSequenceInputStream

@Deprecated
public CharSequenceInputStream(java.lang.CharSequence cs,
                               java.nio.charset.Charset charset,
                               int bufferSize)

Deprecated.

Use builder(), CharSequenceInputStream.Builder, and CharSequenceInputStream.Builder.get()

Constructs a new instance.

Parameters:

cs - the input character sequence.

charset - the character set name to use, null maps to the default Charset.

bufferSize - the buffer size to use.

Throws:

java.lang.IllegalArgumentException - if the buffer is not large enough to hold a complete character.

CharSequenceInputStream

private CharSequenceInputStream(java.lang.CharSequence cs,
                                int bufferSize,
                                java.nio.charset.CharsetEncoder charsetEncoder)

CharSequenceInputStream

@Deprecated
public CharSequenceInputStream(java.lang.CharSequence cs,
                               java.lang.String charset)

Deprecated.

Use builder(), CharSequenceInputStream.Builder, and CharSequenceInputStream.Builder.get()

Constructs a new instance with a buffer size of IOUtils.DEFAULT_BUFFER_SIZE.

Parameters:

cs - the input character sequence.

charset - the character set name to use.

Throws:

java.lang.IllegalArgumentException - if the buffer is not large enough to hold a complete character.

CharSequenceInputStream

@Deprecated
public CharSequenceInputStream(java.lang.CharSequence cs,
                               java.lang.String charset,
                               int bufferSize)

Deprecated.

Use builder(), CharSequenceInputStream.Builder, and CharSequenceInputStream.Builder.get()

Constructs a new instance.

Parameters:

cs - the input character sequence.

charset - the character set name to use, null maps to the default Charset.

bufferSize - the buffer size to use.

Throws:

java.lang.IllegalArgumentException - if the buffer is not large enough to hold a complete character.

Method Detail

builder

public static CharSequenceInputStream.Builder builder()

Constructs a new CharSequenceInputStream.Builder.

Returns:

a new CharSequenceInputStream.Builder.

Since:

2.12.0

newEncoder

private static java.nio.charset.CharsetEncoder newEncoder(java.nio.charset.Charset charset)

available

public int available()
              throws java.io.IOException

Gets a lower bound on the number of bytes remaining in the byte stream.

Overrides:

available in class java.io.InputStream

Returns:

the count of bytes that can be read without blocking (or returning EOF).

Throws:

java.io.IOException - if an error occurs (probably not possible).

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Overrides:

close in class java.io.InputStream

Throws:

java.io.IOException

fillBuffer

private void fillBuffer()
                 throws java.nio.charset.CharacterCodingException

Fills the byte output buffer from the input char buffer.

Throws:

java.nio.charset.CharacterCodingException - an error encoding data.

getCharsetEncoder

java.nio.charset.CharsetEncoder getCharsetEncoder()

Gets the CharsetEncoder.

Returns:

the CharsetEncoder.

mark

public void mark(int readLimit)

Overrides:

mark in class java.io.InputStream

Parameters:

readLimit - max read limit (ignored).

markSupported

public boolean markSupported()

Overrides:

markSupported in class java.io.InputStream

read

public int read()
         throws java.io.IOException

Specified by:

read in class java.io.InputStream

Throws:

java.io.IOException

read

public int read(byte[] b)
         throws java.io.IOException

Overrides:

read in class java.io.InputStream

Throws:

java.io.IOException

read

public int read(byte[] array,
                int off,
                int len)
         throws java.io.IOException

Overrides:

read in class java.io.InputStream

Throws:

java.io.IOException

reset

public void reset()
           throws java.io.IOException

Overrides:

reset in class java.io.InputStream

Throws:

java.io.IOException

skip

public long skip(long n)
          throws java.io.IOException

Overrides:

skip in class java.io.InputStream

Throws:

java.io.IOException