golang-github-inconshreveable-muxado-dev - 0.0~git20140312.0.f693c7e-2.1 main

What is stream multiplexing?
.
Imagine you have a single stream (a bi-directional stream of bytes) like a TCP
connection. Stream multiplexing is a method for enabling the transmission of
multiple simultaneous streams over the one underlying transport stream.
.
What is muxado?
.
muxado is an implementation of a stream multiplexing library in Go that can be
layered on top of a net.Conn to multiplex that stream. muxado's protocol is not
currently documented explicitly, but it is very nearly an implementation of the
HTTP2 framing layer with all of the HTTP-specific bits removed. It is heavily
inspired by HTTP2, SPDY, and WebMUX.
.
How does it work?
.
Simplifying, muxado chunks data sent over each multiplexed stream and transmits
each piece as a "frame" over the transport stream. It then sends these frames,
often interleaving data for multiple streams, to the remote side. The remote
endpoint then reassembles the frames into distinct streams of data which are
presented to the application layer.
.
What good is it anyways?
.
A stream multiplexing library is a powerful tool for an application developer's
toolbox which solves a number of problems:
.
- It allows developers to implement asynchronous/pipelined protocols with
ease. Instead of matching requests with responses in your protocols, just
open a new stream for each request and communicate over that.
- muxado can do application-level keep-alives and dead-session detection so
that you don't have to write heartbeat code ever again.
- You never need to build connection pools for services running your
protocol. You can open as many independent, concurrent streams as you need
without incurring any round-trip latency costs.
- muxado allows the server to initiate new streams to clients which is
normally very difficult without NAT-busting trickery.
.
This package contains the source.