Modifier and Type	Class and Description
private static class	StrictUtf8.Decoder
pack-priv static class	StrictUtf8.Encoder
public static class	StrictUtf8.Parser Surrogate parsing support.

Access	Constructor and Description
public	StrictUtf8()

Modifier and Type	Method and Description
public boolean	contains(Charset The given charset cs) Implements abstract java.nio.charset.Charset.contains. Tells whether or not this charset contains the given charset.
private static char	highSurrogate(int codePoint)
private static boolean	isSurrogate(char ch)
private static char	lowSurrogate(int codePoint)
public CharsetDecoder	newDecoder() Implements abstract java.nio.charset.Charset.newDecoder. Constructs a new decoder for this charset.
public CharsetEncoder	newEncoder() Implements abstract java.nio.charset.Charset.newEncoder. Constructs a new encoder for this charset.
private static void	updatePositions(ByteBuffer src, int sp, CharBuffer dst, int dp)
private static void	updatePositions(CharBuffer src, int sp, ByteBuffer dst, int dp)

StrictUtf8	back to summary
public StrictUtf8()

Method Detail

contains back to summary

contains	back to summary
public boolean contains(Charset cs) Implements abstract java.nio.charset.Charset.contains. Doc from java.nio.charset.Charset.contains. Tells whether or not this charset contains the given charset. A charset C is said to contain a charset D if, and only if, every character representable in D is also representable in C. If this relationship holds then it is guaranteed that every string that can be encoded in D can also be encoded in C without performing any replacements. That C contains D does not imply that each character representable in C by a particular byte sequence is represented in D by the same byte sequence, although sometimes this is the case. Every charset contains itself. This method computes an approximation of the containment relation: If it returns `true` then the given charset is known to be contained by this charset; if it returns `false`, however, then it is not necessarily the case that the given charset is not contained in this charset. Parameters cs:Charset The given charset Returns:boolean `true` if the given charset is contained in this charset Annotations @Override

public boolean contains(Charset cs)

Implements abstract java.nio.charset.Charset.contains.

Doc from java.nio.charset.Charset.contains.

Tells whether or not this charset contains the given charset.

A charset C is said to contain a charset D if, and only if, every character representable in D is also representable in C. If this relationship holds then it is guaranteed that every string that can be encoded in D can also be encoded in C without performing any replacements.

That C contains D does not imply that each character representable in C by a particular byte sequence is represented in D by the same byte sequence, although sometimes this is the case.

Every charset contains itself.

This method computes an approximation of the containment relation: If it returns true then the given charset is known to be contained by this charset; if it returns false, however, then it is not necessarily the case that the given charset is not contained in this charset.

Parameters

cs:Charset: The given charset

Returns:boolean

true if the given charset is contained in this charset

Annotations

@Override

highSurrogate	back to summary
private static char highSurrogate(int codePoint)

isSurrogate	back to summary
private static boolean isSurrogate(char ch)

lowSurrogate	back to summary
private static char lowSurrogate(int codePoint)

newDecoder	back to summary
public CharsetDecoder newDecoder() Implements abstract java.nio.charset.Charset.newDecoder. Doc from java.nio.charset.Charset.newDecoder. Constructs a new decoder for this charset. Returns:CharsetDecoder A new decoder for this charset Annotations @Override

newDecoder

back to summary

public CharsetDecoder newDecoder()

Implements abstract java.nio.charset.Charset.newDecoder.

Doc from java.nio.charset.Charset.newDecoder.

Constructs a new decoder for this charset.

Returns:CharsetDecoder

A new decoder for this charset

Annotations

@Override

newEncoder	back to summary
public CharsetEncoder newEncoder() Implements abstract java.nio.charset.Charset.newEncoder. Doc from java.nio.charset.Charset.newEncoder. Constructs a new encoder for this charset. Returns:CharsetEncoder A new encoder for this charset Annotations @Override

newEncoder

back to summary

public CharsetEncoder newEncoder()

Implements abstract java.nio.charset.Charset.newEncoder.

Doc from java.nio.charset.Charset.newEncoder.

Constructs a new encoder for this charset.

Returns:CharsetEncoder

A new encoder for this charset

Annotations

@Override

updatePositions	back to summary
private static void updatePositions(ByteBuffer src, int sp, CharBuffer dst, int dp)

updatePositions	back to summary
private static void updatePositions(CharBuffer src, int sp, ByteBuffer dst, int dp)

org.glassfish.tyrus.core back to summary

private Class StrictUtf8.Decoder

Class Inheritance

extends CharsetDecoder

java.lang.Object
java.nio.charset.CharsetDecoder
org.glassfish.tyrus.core.StrictUtf8.Decoder

Constructor Summary

Access	Constructor and Description
private	Decoder(Charset cs)

Method Summary

Modifier and Type	Method and Description
public int	decode(byte[] sa, int sp, int len, char[] da)
private CoderResult	decodeArrayLoop(ByteBuffer src, CharBuffer dst)
private CoderResult	decodeBufferLoop(ByteBuffer src, CharBuffer dst)
protected CoderResult	decodeLoop(ByteBuffer The input byte buffer src, CharBuffer The output character buffer dst) Implements abstract java.nio.charset.CharsetDecoder.decodeLoop. Decodes one or more bytes into one or more characters.
private static ByteBuffer	getByteBuffer(ByteBuffer bb, byte[] ba, int sp)
private static boolean	isMalformed3(int b1, int b2, int b3)
private static boolean	isMalformed3_2(int b1, int b2)
private static boolean	isMalformed4(int b2, int b3, int b4)
private static boolean	isMalformed4_2(int b1, int b2)
private static boolean	isMalformed4_3(int b3)
private static boolean	isNotContinuation(int b)
private static CoderResult	malformed(ByteBuffer src, int sp, CharBuffer dst, int dp, int nb)
private static CoderResult	malformed(ByteBuffer src, int mark, int nb)
private static CoderResult	malformedForLength(ByteBuffer src, int sp, CharBuffer dst, int dp, int malformedNB)
private static CoderResult	malformedForLength(ByteBuffer src, int mark, int malformedNB)
private static CoderResult	malformedN(ByteBuffer src, int nb)
private static CoderResult	xflow(ByteBuffer src, int sp, int sl, CharBuffer dst, int dp, int nb)
private static CoderResult	xflow(Buffer src, int mark, int nb)

Constructor Detail

Decoder	back to summary
private Decoder(Charset cs)

Method Detail

decode	back to summary
public int decode(byte[] sa, int sp, int len, char[] da)

decodeArrayLoop	back to summary
private CoderResult decodeArrayLoop(ByteBuffer src, CharBuffer dst)

decodeBufferLoop	back to summary
private CoderResult decodeBufferLoop(ByteBuffer src, CharBuffer dst)

decodeLoop back to summary

decodeLoop	back to summary
protected CoderResult decodeLoop(ByteBuffer src, CharBuffer dst) Implements abstract java.nio.charset.CharsetDecoder.decodeLoop. Doc from java.nio.charset.CharsetDecoder.decodeLoop. Decodes one or more bytes into one or more characters. This method encapsulates the basic decoding loop, decoding as many bytes as possible until it either runs out of input, runs out of room in the output buffer, or encounters a decoding error. This method is invoked by the `decode` method, which handles result interpretation and error recovery. The buffers are read from, and written to, starting at their current positions. At most `in.remaining()` bytes will be read, and at most `out.remaining()` characters will be written. The buffers' positions will be advanced to reflect the bytes read and the characters written, but their marks and limits will not be modified. This method returns a `CoderResult` object to describe its reason for termination, in the same manner as the `decode` method. Most implementations of this method will handle decoding errors by returning an appropriate result object for interpretation by the `decode` method. An optimized implementation may instead examine the relevant error action and implement that action itself. An implementation of this method may perform arbitrary lookahead by returning `CoderResult#UNDERFLOW` until it receives sufficient input. Parameters src:ByteBuffer The input byte buffer dst:CharBuffer The output character buffer Returns:CoderResult A coder-result object describing the reason for termination Annotations @Override

protected CoderResult decodeLoop(ByteBuffer src, CharBuffer dst)

Implements abstract java.nio.charset.CharsetDecoder.decodeLoop.

Doc from java.nio.charset.CharsetDecoder.decodeLoop.

Decodes one or more bytes into one or more characters.

This method encapsulates the basic decoding loop, decoding as many bytes as possible until it either runs out of input, runs out of room in the output buffer, or encounters a decoding error. This method is invoked by the decode method, which handles result interpretation and error recovery.

The buffers are read from, and written to, starting at their current positions. At most in.remaining() bytes will be read, and at most out.remaining() characters will be written. The buffers' positions will be advanced to reflect the bytes read and the characters written, but their marks and limits will not be modified.

This method returns a CoderResult object to describe its reason for termination, in the same manner as the decode method. Most implementations of this method will handle decoding errors by returning an appropriate result object for interpretation by the decode method. An optimized implementation may instead examine the relevant error action and implement that action itself.

An implementation of this method may perform arbitrary lookahead by returning CoderResult#UNDERFLOW until it receives sufficient input.

Parameters

src:ByteBuffer: The input byte buffer
dst:CharBuffer: The output character buffer

Returns:CoderResult

A coder-result object describing the reason for termination

Annotations

@Override

getByteBuffer	back to summary
private static ByteBuffer getByteBuffer(ByteBuffer bb, byte[] ba, int sp)

isMalformed3	back to summary
private static boolean isMalformed3(int b1, int b2, int b3)

isMalformed3_2	back to summary
private static boolean isMalformed3_2(int b1, int b2)

isMalformed4	back to summary
private static boolean isMalformed4(int b2, int b3, int b4)

isMalformed4_2	back to summary
private static boolean isMalformed4_2(int b1, int b2)

isMalformed4_3	back to summary
private static boolean isMalformed4_3(int b3)

isNotContinuation	back to summary
private static boolean isNotContinuation(int b)

malformed	back to summary
private static CoderResult malformed(ByteBuffer src, int sp, CharBuffer dst, int dp, int nb)

malformed	back to summary
private static CoderResult malformed(ByteBuffer src, int mark, int nb)

malformedForLength	back to summary
private static CoderResult malformedForLength(ByteBuffer src, int sp, CharBuffer dst, int dp, int malformedNB)

malformedForLength	back to summary
private static CoderResult malformedForLength(ByteBuffer src, int mark, int malformedNB)

malformedN	back to summary
private static CoderResult malformedN(ByteBuffer src, int nb)

xflow	back to summary
private static CoderResult xflow(ByteBuffer src, int sp, int sl, CharBuffer dst, int dp, int nb)

xflow	back to summary
private static CoderResult xflow(Buffer src, int mark, int nb)

org.glassfish.tyrus.core back to summary

pack-priv final Class StrictUtf8.Encoder

Class Inheritance

extends CharsetEncoder

java.lang.Object
java.nio.charset.CharsetEncoder
org.glassfish.tyrus.core.StrictUtf8.Encoder

Field Summary

Modifier and Type	Field and Description
private StrictUtf8.Parser	sgp

Constructor Summary

Access	Constructor and Description
private	Encoder(Charset cs)

Method Summary

Modifier and Type	Method and Description
public boolean	canEncode(char The given character c) Overrides java.nio.charset.CharsetEncoder.canEncode. Tells whether or not this encoder can encode the given character.
public int	encode(char[] sa, int sp, int len, byte[] da)
private CoderResult	encodeArrayLoop(CharBuffer src, ByteBuffer dst)
private CoderResult	encodeBufferLoop(CharBuffer src, ByteBuffer dst)
protected final CoderResult	encodeLoop(CharBuffer The input character buffer src, ByteBuffer The output byte buffer dst) Implements abstract java.nio.charset.CharsetEncoder.encodeLoop. Encodes one or more characters into one or more bytes.
public boolean	isLegalReplacement(byte[] The byte array to be tested repl) Overrides java.nio.charset.CharsetEncoder.isLegalReplacement. Tells whether or not the given byte array is a legal replacement value for this encoder.
private static CoderResult	overflow(CharBuffer src, int sp, ByteBuffer dst, int dp)
private static CoderResult	overflow(CharBuffer src, int mark)

Field Detail

sgp	back to summary
private StrictUtf8.Parser sgp

Constructor Detail

Encoder	back to summary
private Encoder(Charset cs)

Method Detail

canEncode back to summary

canEncode	back to summary
public boolean canEncode(char c) Overrides java.nio.charset.CharsetEncoder.canEncode. Doc from java.nio.charset.CharsetEncoder.canEncode. Tells whether or not this encoder can encode the given character. This method returns `false` if the given character is a surrogate character; such characters can be interpreted only when they are members of a pair consisting of a high surrogate followed by a low surrogate. The `canEncode(CharSequence)` method may be used to test whether or not a character sequence can be encoded. This method may modify this encoder's state; it should therefore not be invoked if an encoding operation is already in progress. The default implementation of this method is not very efficient; it should generally be overridden to improve performance. Parameters c:char The given character Returns:boolean `true` if, and only if, this encoder can encode the given character Annotations @Override

public boolean canEncode(char c)

Overrides java.nio.charset.CharsetEncoder.canEncode.

Doc from java.nio.charset.CharsetEncoder.canEncode.

Tells whether or not this encoder can encode the given character.

This method returns false if the given character is a surrogate character; such characters can be interpreted only when they are members of a pair consisting of a high surrogate followed by a low surrogate. The canEncode(CharSequence) method may be used to test whether or not a character sequence can be encoded.

This method may modify this encoder's state; it should therefore not be invoked if an encoding operation is already in progress.

The default implementation of this method is not very efficient; it should generally be overridden to improve performance.

Parameters

c:char: The given character

Returns:boolean

true if, and only if, this encoder can encode the given character

Annotations

@Override

encode	back to summary
public int encode(char[] sa, int sp, int len, byte[] da)

encodeArrayLoop	back to summary
private CoderResult encodeArrayLoop(CharBuffer src, ByteBuffer dst)

encodeBufferLoop	back to summary
private CoderResult encodeBufferLoop(CharBuffer src, ByteBuffer dst)

encodeLoop back to summary

encodeLoop	back to summary
protected final CoderResult encodeLoop(CharBuffer src, ByteBuffer dst) Implements abstract java.nio.charset.CharsetEncoder.encodeLoop. Doc from java.nio.charset.CharsetEncoder.encodeLoop. Encodes one or more characters into one or more bytes. This method encapsulates the basic encoding loop, encoding as many characters as possible until it either runs out of input, runs out of room in the output buffer, or encounters an encoding error. This method is invoked by the `encode` method, which handles result interpretation and error recovery. The buffers are read from, and written to, starting at their current positions. At most `in.remaining()` characters will be read, and at most `out.remaining()` bytes will be written. The buffers' positions will be advanced to reflect the characters read and the bytes written, but their marks and limits will not be modified. This method returns a `CoderResult` object to describe its reason for termination, in the same manner as the `encode` method. Most implementations of this method will handle encoding errors by returning an appropriate result object for interpretation by the `encode` method. An optimized implementation may instead examine the relevant error action and implement that action itself. An implementation of this method may perform arbitrary lookahead by returning `CoderResult#UNDERFLOW` until it receives sufficient input. Parameters src:CharBuffer The input character buffer dst:ByteBuffer The output byte buffer Returns:CoderResult A coder-result object describing the reason for termination Annotations @Override

protected final CoderResult encodeLoop(CharBuffer src, ByteBuffer dst)

Implements abstract java.nio.charset.CharsetEncoder.encodeLoop.

Doc from java.nio.charset.CharsetEncoder.encodeLoop.

Encodes one or more characters into one or more bytes.

This method encapsulates the basic encoding loop, encoding as many characters as possible until it either runs out of input, runs out of room in the output buffer, or encounters an encoding error. This method is invoked by the encode method, which handles result interpretation and error recovery.

The buffers are read from, and written to, starting at their current positions. At most in.remaining() characters will be read, and at most out.remaining() bytes will be written. The buffers' positions will be advanced to reflect the characters read and the bytes written, but their marks and limits will not be modified.

This method returns a CoderResult object to describe its reason for termination, in the same manner as the encode method. Most implementations of this method will handle encoding errors by returning an appropriate result object for interpretation by the encode method. An optimized implementation may instead examine the relevant error action and implement that action itself.

An implementation of this method may perform arbitrary lookahead by returning CoderResult#UNDERFLOW until it receives sufficient input.

Parameters

src:CharBuffer: The input character buffer
dst:ByteBuffer: The output byte buffer

Returns:CoderResult

A coder-result object describing the reason for termination

Annotations

@Override

isLegalReplacement back to summary

isLegalReplacement	back to summary
public boolean isLegalReplacement(byte[] repl) Overrides java.nio.charset.CharsetEncoder.isLegalReplacement. Doc from java.nio.charset.CharsetEncoder.isLegalReplacement. Tells whether or not the given byte array is a legal replacement value for this encoder. A replacement is legal if, and only if, it is a legal sequence of bytes in this encoder's charset; that is, it must be possible to decode the replacement into one or more sixteen-bit Unicode characters. The default implementation of this method is not very efficient; it should generally be overridden to improve performance. Parameters repl:byte[] The byte array to be tested Returns:boolean `true` if, and only if, the given byte array is a legal replacement value for this encoder Annotations @Override

public boolean isLegalReplacement(byte[] repl)

Overrides java.nio.charset.CharsetEncoder.isLegalReplacement.

Doc from java.nio.charset.CharsetEncoder.isLegalReplacement.

Tells whether or not the given byte array is a legal replacement value for this encoder.

A replacement is legal if, and only if, it is a legal sequence of bytes in this encoder's charset; that is, it must be possible to decode the replacement into one or more sixteen-bit Unicode characters.

The default implementation of this method is not very efficient; it should generally be overridden to improve performance.

Parameters

repl:byte[]: The byte array to be tested

Returns:boolean

true if, and only if, the given byte array is a legal replacement value for this encoder

Annotations

@Override

overflow	back to summary
private static CoderResult overflow(CharBuffer src, int sp, ByteBuffer dst, int dp)

overflow	back to summary
private static CoderResult overflow(CharBuffer src, int mark)

org.glassfish.tyrus.core back to summary

public Class StrictUtf8.Parser

Class Inheritance

extends Object

java.lang.Object
org.glassfish.tyrus.core.StrictUtf8.Parser

Surrogate parsing support. Charset implementations may use instances of this class to handle the details of parsing UTF-16 surrogate pairs.

Field Summary

Modifier and Type	Field and Description
private CoderResult	error

Constructor Summary

Access	Constructor and Description
public	Parser()

Method Summary

Modifier and Type	Method and Description
public CoderResult	Returns: object describing encountered parse error. error() If the previous parse operation detected an error, return the object describing that error.
public int	Returns: Either a parsed UCS-4 character, in which case the isPair() and increment() methods will return meaningful values, or -1, in which case error() will return a descriptive result object parse(char The first character c, CharBuffer The source buffer, from which one more character will be consumed if c is a high surrogate in) Parses a UCS-4 character from the given source buffer, handling surrogates.
public int	Returns: Either a parsed UCS-4 character, in which case the isPair() and increment() methods will return meaningful values, or -1, in which case error() will return a descriptive result object parse(char The first character c, char[] The input array, from which one more character will be consumed if c is a high surrogate ia, int The input index ip, int The input limit il) Parses a UCS-4 character from the given source buffer, handling surrogates.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

error	back to summary
private CoderResult error

Constructor Detail

Parser	back to summary
public Parser()

Method Detail

error

back to summary

public CoderResult error()

If the previous parse operation detected an error, return the object describing that error.

Returns:CoderResult: object describing encountered parse error.

parse

back to summary

public int parse(char c, CharBuffer in)

Parses a UCS-4 character from the given source buffer, handling surrogates.

Parameters

c:char: The first character
in:CharBuffer: The source buffer, from which one more character will be consumed if c is a high surrogate

Returns:int

Either a parsed UCS-4 character, in which case the isPair() and increment() methods will return meaningful values, or -1, in which case error() will return a descriptive result object

parse

back to summary

public int parse(char c, char[] ia, int ip, int il)

Parses a UCS-4 character from the given source buffer, handling surrogates.

Parameters

c:char: The first character
ia:char[]: The input array, from which one more character will be consumed if c is a high surrogate
ip:int: The input index
il:int: The input limit

Returns:int

Either a parsed UCS-4 character, in which case the isPair() and increment() methods will return meaningful values, or -1, in which case error() will return a descriptive result object

public Class StrictUtf8

Nested and Inner Type Summary

Constructor Summary

Method Summary

Constructor Detail

Method Detail

private Class StrictUtf8.Decoder

Constructor Summary

Method Summary

Constructor Detail

Method Detail

pack-priv final Class StrictUtf8.Encoder

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class StrictUtf8.Parser

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail