io.netty.incubator.codec.quic

Interface QuicChannel

All Superinterfaces:

io.netty.util.AttributeMap, io.netty.channel.Channel, io.netty.channel.ChannelOutboundInvoker, java.lang.Comparable<io.netty.channel.Channel>

public interface QuicChannel
extends io.netty.channel.Channel

A QUIC Channel.

Nested Class Summary

Nested classes/interfaces inherited from interface io.netty.channel.Channel

io.netty.channel.Channel.Unsafe

Method Summary

Modifier and Type	Method and Description
default io.netty.channel.ChannelFuture	bind(java.net.SocketAddress localAddress)
default io.netty.channel.ChannelFuture	bind(java.net.SocketAddress localAddress, io.netty.channel.ChannelPromise promise)
default io.netty.channel.ChannelFuture	close()
default io.netty.channel.ChannelFuture	close(boolean applicationClose, int error, io.netty.buffer.ByteBuf reason) Close the QuicChannel
io.netty.channel.ChannelFuture	close(boolean applicationClose, int error, io.netty.buffer.ByteBuf reason, io.netty.channel.ChannelPromise promise) Close the QuicChannel
default io.netty.channel.ChannelFuture	close(io.netty.channel.ChannelPromise promise)
default io.netty.util.concurrent.Future<QuicConnectionStats>	collectStats() Collects statistics about the connection and notifies the Future once done.
io.netty.util.concurrent.Future<QuicConnectionStats>	collectStats(io.netty.util.concurrent.Promise<QuicConnectionStats> promise) Collects statistics about the connection and notifies the Promise once done.
QuicChannelConfig	config() Returns the configuration of this channel.
default io.netty.channel.ChannelFuture	connect(java.net.SocketAddress remoteAddress)
default io.netty.channel.ChannelFuture	connect(java.net.SocketAddress remoteAddress, io.netty.channel.ChannelPromise promise)
default io.netty.channel.ChannelFuture	connect(java.net.SocketAddress remoteAddress, java.net.SocketAddress localAddress)
default io.netty.channel.ChannelFuture	connect(java.net.SocketAddress remoteAddress, java.net.SocketAddress localAddress, io.netty.channel.ChannelPromise promise)
default io.netty.util.concurrent.Future<QuicStreamChannel>	createStream(QuicStreamType type, io.netty.channel.ChannelHandler handler) Creates a stream that is using this QuicChannel and notifies the Future once done.
io.netty.util.concurrent.Future<QuicStreamChannel>	createStream(QuicStreamType type, io.netty.channel.ChannelHandler handler, io.netty.util.concurrent.Promise<QuicStreamChannel> promise) Creates a stream that is using this QuicChannel and notifies the Promise once done.
default io.netty.channel.ChannelFuture	deregister()
default io.netty.channel.ChannelFuture	deregister(io.netty.channel.ChannelPromise promise)
default io.netty.channel.ChannelFuture	disconnect()
default io.netty.channel.ChannelFuture	disconnect(io.netty.channel.ChannelPromise promise)
QuicChannel	flush()
boolean	isTimedOut() Returns true if the connection was closed because of idle timeout.
static QuicChannelBootstrap	newBootstrap(io.netty.channel.Channel channel) Creates a new QuicChannelBootstrap that can be used to create and connect new QuicChannels to endpoints using the given Channel as transport layer.
default io.netty.channel.ChannelFuture	newFailedFuture(java.lang.Throwable cause)
default io.netty.channel.ChannelProgressivePromise	newProgressivePromise()
default io.netty.channel.ChannelPromise	newPromise()
default QuicStreamChannelBootstrap	newStreamBootstrap() Returns a new QuicStreamChannelBootstrap which makes it easy to bootstrap new QuicStreamChannels with custom options and attributes.
default io.netty.channel.ChannelFuture	newSucceededFuture()
long	peerAllowedStreams(QuicStreamType type) Returns the number of streams that can be created before stream creation will fail with QuicError.STREAM_LIMIT error.
QuicChannel	read()
javax.net.ssl.SSLEngine	sslEngine() Returns the used SSLEngine or null if none is used (yet).
default io.netty.channel.ChannelPromise	voidPromise()
default io.netty.channel.ChannelFuture	write(java.lang.Object msg)
default io.netty.channel.ChannelFuture	write(java.lang.Object msg, io.netty.channel.ChannelPromise promise)
default io.netty.channel.ChannelFuture	writeAndFlush(java.lang.Object msg)
default io.netty.channel.ChannelFuture	writeAndFlush(java.lang.Object msg, io.netty.channel.ChannelPromise promise)

Methods inherited from interface io.netty.channel.Channel

alloc, bytesBeforeUnwritable, bytesBeforeWritable, closeFuture, eventLoop, id, isActive, isOpen, isRegistered, isWritable, localAddress, metadata, parent, pipeline, remoteAddress, unsafe

Methods inherited from interface io.netty.util.AttributeMap

attr, hasAttr

Methods inherited from interface java.lang.Comparable

compareTo

Method Detail

bind

default io.netty.channel.ChannelFuture bind(java.net.SocketAddress localAddress)

Specified by:

bind in interface io.netty.channel.ChannelOutboundInvoker

connect

default io.netty.channel.ChannelFuture connect(java.net.SocketAddress remoteAddress)

Specified by:

connect in interface io.netty.channel.ChannelOutboundInvoker

connect

default io.netty.channel.ChannelFuture connect(java.net.SocketAddress remoteAddress,
                                               java.net.SocketAddress localAddress)

Specified by:

connect in interface io.netty.channel.ChannelOutboundInvoker

disconnect

default io.netty.channel.ChannelFuture disconnect()

Specified by:

disconnect in interface io.netty.channel.ChannelOutboundInvoker

close

default io.netty.channel.ChannelFuture close()

Specified by:

close in interface io.netty.channel.ChannelOutboundInvoker

deregister

default io.netty.channel.ChannelFuture deregister()

Specified by:

deregister in interface io.netty.channel.ChannelOutboundInvoker

bind

default io.netty.channel.ChannelFuture bind(java.net.SocketAddress localAddress,
                                            io.netty.channel.ChannelPromise promise)

Specified by:

bind in interface io.netty.channel.ChannelOutboundInvoker

connect

default io.netty.channel.ChannelFuture connect(java.net.SocketAddress remoteAddress,
                                               io.netty.channel.ChannelPromise promise)

Specified by:

connect in interface io.netty.channel.ChannelOutboundInvoker

connect

default io.netty.channel.ChannelFuture connect(java.net.SocketAddress remoteAddress,
                                               java.net.SocketAddress localAddress,
                                               io.netty.channel.ChannelPromise promise)

Specified by:

connect in interface io.netty.channel.ChannelOutboundInvoker

disconnect

default io.netty.channel.ChannelFuture disconnect(io.netty.channel.ChannelPromise promise)

Specified by:

disconnect in interface io.netty.channel.ChannelOutboundInvoker

close

default io.netty.channel.ChannelFuture close(io.netty.channel.ChannelPromise promise)

Specified by:

close in interface io.netty.channel.ChannelOutboundInvoker

deregister

default io.netty.channel.ChannelFuture deregister(io.netty.channel.ChannelPromise promise)

Specified by:

deregister in interface io.netty.channel.ChannelOutboundInvoker

write

default io.netty.channel.ChannelFuture write(java.lang.Object msg)

Specified by:

write in interface io.netty.channel.ChannelOutboundInvoker

write

default io.netty.channel.ChannelFuture write(java.lang.Object msg,
                                             io.netty.channel.ChannelPromise promise)

Specified by:

write in interface io.netty.channel.ChannelOutboundInvoker

writeAndFlush

default io.netty.channel.ChannelFuture writeAndFlush(java.lang.Object msg,
                                                     io.netty.channel.ChannelPromise promise)

Specified by:

writeAndFlush in interface io.netty.channel.ChannelOutboundInvoker

writeAndFlush

default io.netty.channel.ChannelFuture writeAndFlush(java.lang.Object msg)

Specified by:

writeAndFlush in interface io.netty.channel.ChannelOutboundInvoker

newPromise

default io.netty.channel.ChannelPromise newPromise()

Specified by:

newPromise in interface io.netty.channel.ChannelOutboundInvoker

newProgressivePromise

default io.netty.channel.ChannelProgressivePromise newProgressivePromise()

Specified by:

newProgressivePromise in interface io.netty.channel.ChannelOutboundInvoker

newSucceededFuture

default io.netty.channel.ChannelFuture newSucceededFuture()

Specified by:

newSucceededFuture in interface io.netty.channel.ChannelOutboundInvoker

newFailedFuture

default io.netty.channel.ChannelFuture newFailedFuture(java.lang.Throwable cause)

Specified by:

newFailedFuture in interface io.netty.channel.ChannelOutboundInvoker

voidPromise

default io.netty.channel.ChannelPromise voidPromise()

Specified by:

voidPromise in interface io.netty.channel.ChannelOutboundInvoker

read

QuicChannel read()

Specified by:

read in interface io.netty.channel.Channel

Specified by:

read in interface io.netty.channel.ChannelOutboundInvoker

flush

QuicChannel flush()

Specified by:

flush in interface io.netty.channel.Channel

Specified by:

flush in interface io.netty.channel.ChannelOutboundInvoker

config

QuicChannelConfig config()

Returns the configuration of this channel.

Specified by:

config in interface io.netty.channel.Channel

sslEngine

javax.net.ssl.SSLEngine sslEngine()

Returns the used SSLEngine or null if none is used (yet).

Returns:

the engine.

peerAllowedStreams

long peerAllowedStreams(QuicStreamType type)

Returns the number of streams that can be created before stream creation will fail with QuicError.STREAM_LIMIT error.

Parameters:

type - the stream type.

Returns:

the number of streams left.

isTimedOut

boolean isTimedOut()

Returns true if the connection was closed because of idle timeout.

Returns:

true if the connection was closed because of idle timeout, false.

createStream

default io.netty.util.concurrent.Future<QuicStreamChannel> createStream(QuicStreamType type,
                                                                        io.netty.channel.ChannelHandler handler)

Creates a stream that is using this QuicChannel and notifies the Future once done. The ChannelHandler (if not null) is added to the ChannelPipeline of the QuicStreamChannel automatically.

Parameters:

type - the QuicStreamType of the QuicStreamChannel.

handler - the ChannelHandler that will be added to the QuicStreamChannels ChannelPipeline during the stream creation.

Returns:

the Future that will be notified once the operation completes.

createStream

io.netty.util.concurrent.Future<QuicStreamChannel> createStream(QuicStreamType type,
                                                                io.netty.channel.ChannelHandler handler,
                                                                io.netty.util.concurrent.Promise<QuicStreamChannel> promise)

Creates a stream that is using this QuicChannel and notifies the Promise once done. The ChannelHandler (if not null) is added to the ChannelPipeline of the QuicStreamChannel automatically.

Parameters:

type - the QuicStreamType of the QuicStreamChannel.

handler - the ChannelHandler that will be added to the QuicStreamChannels ChannelPipeline during the stream creation.

promise - the ChannelPromise that will be notified once the operation completes.

Returns:

the Future that will be notified once the operation completes.

newStreamBootstrap

default QuicStreamChannelBootstrap newStreamBootstrap()

Returns a new QuicStreamChannelBootstrap which makes it easy to bootstrap new QuicStreamChannels with custom options and attributes. For simpler use-cases you may want to consider using createStream(QuicStreamType, ChannelHandler) or createStream(QuicStreamType, ChannelHandler, Promise) directly.

Returns:

QuicStreamChannelBootstrap that can be used to bootstrap a QuicStreamChannel.

close

default io.netty.channel.ChannelFuture close(boolean applicationClose,
                                             int error,
                                             io.netty.buffer.ByteBuf reason)

Close the QuicChannel

Parameters:

applicationClose - true if an application close should be used, false if a normal close should be used.

error - the application error number, or 0 if no special error should be signaled.

reason - the reason for the closure (which may be an empty ByteBuf.

Returns:

the future that is notified.

close

io.netty.channel.ChannelFuture close(boolean applicationClose,
                                     int error,
                                     io.netty.buffer.ByteBuf reason,
                                     io.netty.channel.ChannelPromise promise)

Close the QuicChannel

Parameters:

applicationClose - true if an application close should be used, false if a normal close should be used.

error - the application error number, or 0 if no special error should be signaled.

reason - the reason for the closure (which may be an empty ByteBuf.

promise - the ChannelPromise that will be notified.

Returns:

the future that is notified.

collectStats

default io.netty.util.concurrent.Future<QuicConnectionStats> collectStats()

Collects statistics about the connection and notifies the Future once done.

Returns:

the Future that is notified once the stats were collected.

collectStats

io.netty.util.concurrent.Future<QuicConnectionStats> collectStats(io.netty.util.concurrent.Promise<QuicConnectionStats> promise)

Collects statistics about the connection and notifies the Promise once done.

Parameters:

promise - the ChannelPromise that is notified once the stats were collected.

Returns:

the Future that is notified once the stats were collected.

newBootstrap

static QuicChannelBootstrap newBootstrap(io.netty.channel.Channel channel)

Creates a new QuicChannelBootstrap that can be used to create and connect new QuicChannels to endpoints using the given Channel as transport layer.

Parameters:

channel - the Channel that is used as transport layer.

Returns:

QuicChannelBootstrap that can be used to bootstrap a client side QuicChannel.