Class: Protocol::HTTP2::Framer

Inherits:
Object
  • Object
show all
Defined in:
lib/protocol/http2/framer.rb

Instance Method Summary collapse

Constructor Details

#initialize(stream, frames = FRAMES) ⇒ Framer

Returns a new instance of Framer.



55
56
57
58
 
# File 'lib/protocol/http2/framer.rb', line 55

def initialize(stream, frames = FRAMES)
  @stream = stream
  @frames = frames
end

Instance Method Details

#close ⇒ Object 



60
61
62
 
# File 'lib/protocol/http2/framer.rb', line 60

def close
  @stream.close
end

#closed? ⇒ Boolean

Returns:

  • (Boolean) 


64
65
66
 
# File 'lib/protocol/http2/framer.rb', line 64

def closed?
  @stream.closed?
end

#read_connection_preface ⇒ Object 



72
73
74
75
76
77
78
79
80
 
# File 'lib/protocol/http2/framer.rb', line 72

def read_connection_preface
  string = @stream.read(CONNECTION_PREFACE_MAGIC.bytesize)
  
  unless string == CONNECTION_PREFACE_MAGIC
    raise HandshakeError, "Invalid connection preface: #{string.inspect}"
  end
  
  return string
end

#read_frame(maximum_frame_size = MAXIMUM_ALLOWED_FRAME_SIZE) ⇒ Object 



82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
 
# File 'lib/protocol/http2/framer.rb', line 82

def read_frame(maximum_frame_size = MAXIMUM_ALLOWED_FRAME_SIZE)
  # Read the header:
  length, type, flags, stream_id = read_header
  # puts "read_frame: length=#{length} type=#{type} flags=#{flags} stream_id=#{stream_id} -> klass=#{@frames[type].inspect}"
  
  # Allocate the frame:
  klass = @frames[type] || Frame
  # puts "read_frame #{klass} id=#{stream_id} length=#{length} flags=#{flags}"
  
  frame = klass.new(stream_id, flags, type, length)
  
  # Read the payload:
  frame.read(@stream, maximum_frame_size)
  
  return frame
end

#read_header ⇒ Object

Raises:

  • (EOFError) 


108
109
110
111
112
113
114
115
116
 
# File 'lib/protocol/http2/framer.rb', line 108

def read_header
  if buffer = @stream.read(9)
    if buffer.bytesize == 9
      return Frame.parse_header(buffer)
    end
  end
  
  raise EOFError, "Could not read frame header!"
end

#write_connection_preface ⇒ Object 



68
69
70
 
# File 'lib/protocol/http2/framer.rb', line 68

def write_connection_preface
  @stream.write(CONNECTION_PREFACE_MAGIC)
end

#write_frame(frame) ⇒ Object 



99
100
101
102
103
104
105
106
 
# File 'lib/protocol/http2/framer.rb', line 99

def write_frame(frame)
  # puts "framer: write_frame #{frame.inspect}"
  frame.write(@stream)
  
  @stream.flush
  
  return frame
end