Package com.fasterxml.jackson.core.io

Class UTF8Writer

java.lang.Object

java.io.Writer

com.fasterxml.jackson.core.io.UTF8Writer

All Implemented Interfaces:

Closeable, Flushable, Appendable, AutoCloseable

public final class UTF8Writer
extends Writer

Field Summary

Fields

Modifier and Type	Field	Description
private final IOContext	_context
private OutputStream	_out
private byte[]	_outBuffer
private final int	_outBufferEnd
private int	_outPtr
private int	_surrogate	When outputting chars from BMP, surrogate pairs need to be coalesced.
(package private) static final int	SURR1_FIRST
(package private) static final int	SURR1_LAST
(package private) static final int	SURR2_FIRST
(package private) static final int	SURR2_LAST
static final int	SURROGATE_BASE

Fields inherited from class java.io.Writer

lock

Constructor Summary

Constructors

Constructor	Description
UTF8Writer(IOContext ctxt, OutputStream out)

Method Summary

Modifier and Type	Method	Description
Writer	append(char c)
void	close()
protected int	convertSurrogate(int secondPart)	Method called to calculate Unicode code-point, from a surrogate pair.
void	flush()
protected static void	illegalSurrogate(int code)
protected static String	illegalSurrogateDesc(int code)
void	write(char[] cbuf)
void	write(char[] cbuf, int off, int len)
void	write(int c)
void	write(String str)
void	write(String str, int off, int len)

Methods inherited from class java.io.Writer

append, append, nullWriter

Methods inherited from class java.lang.Object

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

Field Details

SURR1_FIRST

static final int SURR1_FIRST

See Also:

• Constant Field Values

SURR1_LAST

static final int SURR1_LAST

See Also:

• Constant Field Values

SURR2_FIRST

static final int SURR2_FIRST

See Also:

• Constant Field Values

SURR2_LAST

static final int SURR2_LAST

See Also:

• Constant Field Values

SURROGATE_BASE

public static final int SURROGATE_BASE

Since:

2.17

See Also:

• Constant Field Values

_context

private final IOContext _context

_out

private OutputStream _out

_outBuffer

private byte[] _outBuffer

_outBufferEnd

private final int _outBufferEnd

_outPtr

private int _outPtr

_surrogate

private int _surrogate

When outputting chars from BMP, surrogate pairs need to be coalesced. To do this, both pairs must be known first; and since it is possible pairs may be split, we need temporary storage for the first half

Constructor Details

UTF8Writer

public UTF8Writer(IOContext ctxt,
 OutputStream out)

Method Details

append

public Writer append(char c)
              throws IOException

Specified by:

append in interface Appendable

Overrides:

append in class Writer

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Specified by:

close in class Writer

Throws:

IOException

flush

public void flush()
           throws IOException

Specified by:

flush in interface Flushable

Specified by:

flush in class Writer

Throws:

IOException

write

public void write(char[] cbuf)
           throws IOException

Overrides:

write in class Writer

Throws:

IOException

write

public void write(char[] cbuf,
 int off,
 int len)
           throws IOException

Specified by:

write in class Writer

Throws:

IOException

write

public void write(int c)
           throws IOException

Overrides:

write in class Writer

Throws:

IOException

write

public void write(String str)
           throws IOException

Overrides:

write in class Writer

Throws:

IOException

write

public void write(String str,
 int off,
 int len)
           throws IOException

Overrides:

write in class Writer

Throws:

IOException

convertSurrogate

protected int convertSurrogate(int secondPart)
                        throws IOException

Method called to calculate Unicode code-point, from a surrogate pair.

Parameters:

secondPart - Second UTF-16 unit of surrogate (first part stored in _surrogate)

Returns:

Decoded Unicode point

Throws:

IOException - If surrogate pair is invalid

illegalSurrogate

protected static void illegalSurrogate(int code)
                                throws IOException

Throws:

IOException

illegalSurrogateDesc

protected static String illegalSurrogateDesc(int code)