io.netty.incubator.codec.quic

Class QuicHeaderParser

java.lang.Object

io.netty.incubator.codec.quic.QuicHeaderParser

All Implemented Interfaces:

java.lang.AutoCloseable

public final class QuicHeaderParser
extends java.lang.Object
implements java.lang.AutoCloseable

Parses the QUIC packet header and notifies a callback once parsing was successful. Once the parser is not needed anymore the user needs to call close() to ensure all resources are released. Failed to do so may lead to memory leaks. This class can be used for advanced use-cases. Usually you want to just use QuicClientCodecBuilder or QuicServerCodecBuilder.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	QuicHeaderParser.QuicHeaderProcessor Called when a QUIC packet and its header could be parsed.

Constructor Summary

Constructors

Constructor and Description
QuicHeaderParser(int maxTokenLength, int localConnectionIdLength)

Method Summary

Modifier and Type	Method and Description
void	close()
void	parse(java.net.InetSocketAddress sender, java.net.InetSocketAddress recipient, io.netty.buffer.ByteBuf packet, QuicHeaderParser.QuicHeaderProcessor callback) Parses a QUIC packet and extract the header values out of it.

Methods inherited from class java.lang.Object

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

Constructor Detail

QuicHeaderParser

public QuicHeaderParser(int maxTokenLength,
                        int localConnectionIdLength)

Method Detail

close

public void close()

Specified by:

close in interface java.lang.AutoCloseable

parse

public void parse(java.net.InetSocketAddress sender,
                  java.net.InetSocketAddress recipient,
                  io.netty.buffer.ByteBuf packet,
                  QuicHeaderParser.QuicHeaderProcessor callback)
           throws java.lang.Exception

Parses a QUIC packet and extract the header values out of it. This method takes no ownership of the packet itself which means the caller of this method is expected to call ReferenceCounted.release() once the packet is not needed anymore.

Parameters:

sender - the sender of the packet. This is directly passed to the QuicHeaderParser.QuicHeaderProcessor once parsing was successful.

recipient - the recipient of the packet.This is directly passed to the QuicHeaderParser.QuicHeaderProcessor once parsing was successful.

packet - raw QUIC packet itself. The ownership of the packet is not transferred. This is directly passed to the QuicHeaderParser.QuicHeaderProcessor once parsing was successful.

callback - the QuicHeaderParser.QuicHeaderProcessor that is called once a QUIC packet could be parsed and all the header values be extracted.

Throws:

java.lang.Exception - thrown if we couldn't parse the header or if the QuicHeaderParser.QuicHeaderProcessor throws an exception.