PriorKnowledgeHandshaker

Handle the prior knowledge preface

The preface is the magic string "PRI * HTTP/2.0\r\n\r\nSM\r\n\r\n" which is intended to cause HTTP/1.x connections to fail gracefully. For clients, this involves sending the magic string and for servers this consists of receiving the magic string. The return value of this function is any unconsumed inbound data.

Perform pipeline manipulations necessary upon successful handshaking

Perform the HTTP/2 prior knowledge handshake

Write a collection of outbound messages to the pipeline with a timeout

Write a collection of outbound messages to the pipeline

Write a single outbound message to the pipeline with a timeout

Write a single outbound message to the pipeline

Find the next outbound Stage of type C, if it exists.

Find the next outbound Stage with the given name, if it exists.

Handle basic startup and shutdown commands.

Replace all downstream Stages, including this Stage.

If this was a MidStage, its inbound element is notified via a Disconnected Command.

Insert the MidStage before this Stage

Shuts down the stage, deallocating resources, etc.

It will be called when the stage receives a Disconnected command unless inboundCommand is overridden. This method should not send or Disconnected commands.

It is possible that this will not be called due to failure of other stages to propagate shutdown commands. Conversely, it is also possible for this to be called more than once due to the reception of multiple shutdown commands. It is therefore recommended that the method be idempotent.

Start the stage, allocating resources etc.

This method should not effect other stages by sending commands etc unless it creates them. It is not impossible that the stage will receive other commands besides Connected before this method is called. It is not impossible for this method to be called multiple times by misbehaving stages. It is therefore recommended that the method be idempotent.