io.jstuff.pipeline.codec

Class SwitchableDecoder<R>

java.lang.Object

io.jstuff.pipeline.BaseAbstractAcceptor<R>

io.jstuff.pipeline.AbstractIntAcceptor<R>

io.jstuff.pipeline.AbstractIntPipeline<R>

io.jstuff.pipeline.codec.SwitchableDecoder<R>

Type Parameters:

R - the "Result" class (may be Void)

All Implemented Interfaces:

BaseAcceptor<R>, BasePipeline<R>, IntAcceptor<R>, IntPipeline<R>, AutoCloseable, IntConsumer

Direct Known Subclasses:

DynamicDecoder

public class SwitchableDecoder<R>
extends AbstractIntPipeline<R>

A switchable decoder that allows the encoding of an input stream to be determined from the data in the early part of the stream.

An XML file declares its encoding on the prefix line, and an HTML file can contain a META tag specifying the content type and encoding of the data. These rely on the declaration occurring early in the file, before any characters outside the base ASCII set are expected to be encountered.

This decoder allows the reading of an input stream to commence in ASCII decoding, switching to the full decoding once the declaration has been read.

Author:

Peter Wall

Field Summary

Fields

Modifier and Type	Field and Description
protected IntAcceptor<? extends R>	delegate

Constructor Summary

Constructors

Constructor and Description
SwitchableDecoder(IntAcceptor<? extends R> downstream) Construct a SwitchableDecoder with the given downstream IntAcceptor.

Method Summary

Modifier and Type	Method and Description
void	acceptInt(int value) Accept a character, after closed check and test for end of data.
boolean	isStageComplete() Return true if all sequences in the input to this stage of the pipeline are complete, that is, the input is not in the middle of a sequence requiring more data.
void	switchTo(Charset charset) Switch to the nominated character set.
void	switchTo(IntAcceptor<? extends R> delegate) Switch to the specified delegate.
void	switchTo(String charsetName) Switch to the nominated character set.

Methods inherited from class io.jstuff.pipeline.AbstractIntPipeline

close, emit, flush, getDownstream

Methods inherited from class io.jstuff.pipeline.AbstractIntAcceptor

accept, accept

Methods inherited from class io.jstuff.pipeline.BaseAbstractAcceptor

isClosed

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.jstuff.pipeline.IntAcceptor

accept, accept, accept, accept, accept, accept, accept, accept, accept, accept

Methods inherited from interface java.util.function.IntConsumer

andThen

Methods inherited from interface io.jstuff.pipeline.BasePipeline

getResult, isComplete

Methods inherited from interface io.jstuff.pipeline.BaseAcceptor

isClosed, safeClose

Field Detail

delegate

protected IntAcceptor<? extends R> delegate

Constructor Detail

SwitchableDecoder

public SwitchableDecoder(IntAcceptor<? extends R> downstream)

Construct a SwitchableDecoder with the given downstream IntAcceptor.

Parameters:

downstream - the IntAcceptor

Method Detail

acceptInt

public void acceptInt(int value)

Accept a character, after closed check and test for end of data. Forward the character to the delegate if present, otherwise emit it directly (with no conversion).

Specified by:

acceptInt in class AbstractIntAcceptor<R>

Parameters:

value - the input value

isStageComplete

public boolean isStageComplete()

Return true if all sequences in the input to this stage of the pipeline are complete, that is, the input is not in the middle of a sequence requiring more data.

Returns:

true if the input is in the "complete" state

switchTo

public void switchTo(IntAcceptor<? extends R> delegate)

Switch to the specified delegate.

Parameters:

delegate - the new delegate

switchTo

public void switchTo(Charset charset)

Switch to the nominated character set.

Parameters:

charset - the Charset

switchTo

public void switchTo(String charsetName)

Switch to the nominated character set.

Parameters:

charsetName - the character set name