OpenJDK 27 · jdk.internal.net.http.quic.packets.QuicPacketNumbers

Access	Constructor and Description
public	QuicPacketNumbers()

Method Summary

Modifier and Type	Method and Description
public static int	Returns: the number of bytes required to encode the packet computePacketNumberLength(long the full packet number fullPN, long the largest ACK'd packet, or -1 if none so far largestAcked) Returns the number of bytes needed to encode a packet number given the full packet number and the largest ACK'd packet.
public static long	Returns: the decoded packet number decodePacketNumber(long the largest packet number that has been successfully processed in the current packet number space largestPN, ByteBuffer a `ByteBuffer` containing the value of the Packet Number field buf, int the number of bytes indicated by the Packet Number Length field pnNBytes) Decode the packet numbers against the largest ACK'd packet after header protection has been removed.
public static byte[]	Returns: byte array containing fullPN encodePacketNumber(long the full packet number fullPN, long the largest ACK'd packet, or -1 if none so far largestAcked) Encode the full packet number against the largest ACK'd packet.
public static byte[]	Returns: byte array containing fullPN truncatePacketNumber(long the full packet number fullPN, int the number of bytes in which to encode the packet number numBytes) Truncate the full packet number to fill into `numBytes`.

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

QuicPacketNumbers	back to summary
public QuicPacketNumbers()

Method Detail

computePacketNumberLength	back to summary
public static int computePacketNumberLength(long fullPN, long largestAcked) Returns the number of bytes needed to encode a packet number given the full packet number and the largest ACK'd packet. Parameters fullPN:long the full packet number largestAcked:long the largest ACK'd packet, or -1 if none so far Returns:int the number of bytes required to encode the packet Exceptions IllegalArgumentException: if number can't represented in 4 bytes

computePacketNumberLength

back to summary

public static int computePacketNumberLength(long fullPN, long largestAcked)

Returns the number of bytes needed to encode a packet number given the full packet number and the largest ACK'd packet.

Parameters

fullPN:long: the full packet number
largestAcked:long: the largest ACK'd packet, or -1 if none so far

Returns:int

the number of bytes required to encode the packet

Exceptions

IllegalArgumentException:: if number can't represented in 4 bytes

decodePacketNumber back to summary

decodePacketNumber	back to summary
public static long decodePacketNumber(long largestPN, ByteBuffer buf, int pnNBytes) Decode the packet numbers against the largest ACK'd packet after header protection has been removed. Follows the algorithm outlined in RFC 9000, Appendix A.3 Parameters largestPN:long the largest packet number that has been successfully processed in the current packet number space buf:ByteBuffer a `ByteBuffer` containing the value of the Packet Number field pnNBytes:int the number of bytes indicated by the Packet Number Length field Returns:long the decoded packet number Exceptions BufferUnderflowException: if there is not enough data in the buffer

public static long decodePacketNumber(long largestPN, ByteBuffer buf, int pnNBytes)

Decode the packet numbers against the largest ACK'd packet after header protection has been removed. Follows the algorithm outlined in RFC 9000, Appendix A.3

Parameters

largestPN:long: the largest packet number that has been successfully processed in the current packet number space
buf:ByteBuffer: a ByteBuffer containing the value of the Packet Number field
pnNBytes:int: the number of bytes indicated by the Packet Number Length field

Returns:long

the decoded packet number

Exceptions

BufferUnderflowException:: if there is not enough data in the buffer

encodePacketNumber	back to summary
public static byte[] encodePacketNumber(long fullPN, long largestAcked) Encode the full packet number against the largest ACK'd packet. Follows the algorithm outlined in RFC 9000. Appendix A.2 Parameters fullPN:long the full packet number largestAcked:long the largest ACK'd packet, or -1 if none so far Returns:byte[] byte array containing fullPN Exceptions IllegalArgumentException: if number can't be represented in 4 bytes

encodePacketNumber

back to summary

public static byte[] encodePacketNumber(long fullPN, long largestAcked)

Encode the full packet number against the largest ACK'd packet. Follows the algorithm outlined in RFC 9000. Appendix A.2

Parameters

fullPN:long: the full packet number
largestAcked:long: the largest ACK'd packet, or -1 if none so far

Returns:byte[]

byte array containing fullPN

Exceptions

IllegalArgumentException:: if number can't be represented in 4 bytes

truncatePacketNumber back to summary

truncatePacketNumber	back to summary
public static byte[] truncatePacketNumber(long fullPN, int numBytes) Truncate the full packet number to fill into `numBytes`. Follows the algorithm outlined in RFC 9000, Appendix A.2 API Note `numBytes` should have been computed using `computePacketNumberLength(long, long)` Parameters fullPN:long the full packet number numBytes:int the number of bytes in which to encode the packet number Returns:byte[] byte array containing fullPN Exceptions IllegalArgumentException: if numBytes is out of range

public static byte[] truncatePacketNumber(long fullPN, int numBytes)

Truncate the full packet number to fill into numBytes. Follows the algorithm outlined in RFC 9000, Appendix A.2

API Note

numBytes should have been computed using computePacketNumberLength(long, long)

Parameters

fullPN:long: the full packet number
numBytes:int: the number of bytes in which to encode the packet number

Returns:byte[]

byte array containing fullPN

Exceptions

IllegalArgumentException:: if numBytes is out of range

public Class QuicPacketNumbers

Constructor Summary

Method Summary

Constructor Detail

Method Detail