Class: HTTP2::Client

Inherits:
Connection show all
Defined in:
lib/http/2/client.rb

Overview

HTTP 2.0 client connection class that implements appropriate header compression / decompression algorithms and stream management logic.

Your code is responsible for driving the client object, which in turn performs all of the necessary HTTP 2.0 encoding / decoding, state management, and the rest. A simple example:

Examples:

socket = YourTransport.new

conn = HTTP2::Client.new
conn.on(:frame) {|bytes| socket << bytes }

while bytes = socket.read
  conn << bytes
end

Instance Attribute Summary

Attributes inherited from Connection

#active_stream_count, #error, #local_settings, #local_window, #pending_settings, #remote_settings, #remote_window, #state

Instance Method Summary collapse

Methods inherited from Connection

#goaway, #new_stream, #ping, #receive, #settings

Methods included from Emitter

#add_listener, #emit, #once

Methods included from FlowBuffer

#buffered_amount

Constructor Details

#initialize(**settings) ⇒ Client

Initialize new HTTP 2.0 client object.



23
24
25
26
27
28
29
30
31
 
# File 'lib/http/2/client.rb', line 23

def initialize(**settings)
  @stream_id    = 1
  @state        = :waiting_connection_preface

  @local_role   = :client
  @remote_role  = :server

  super
end

Instance Method Details

#send(frame) ⇒ Object

Send an outgoing frame. Connection and stream flow control is managed by Connection class.

Parameters:

  • frame (Hash)

See Also:



38
39
40
41
 
# File 'lib/http/2/client.rb', line 38

def send(frame)
  send_connection_preface
  super(frame)
end

#send_connection_preface ⇒ Object

Emit the connection preface if not yet



44
45
46
47
48
49
50
51
52
 
# File 'lib/http/2/client.rb', line 44

def send_connection_preface
  if @state == :waiting_connection_preface
    @state = :connected
    emit(:frame, CONNECTION_PREFACE_MAGIC)

    payload = @local_settings.select {|k,v| v != SPEC_DEFAULT_CONNECTION_SETTINGS[k]}
    settings(payload)
  end
end