aboutsummaryrefslogtreecommitdiffstats
path: root/lib/plum/frame_utils.rb
blob: 0093f89dc9019387144531dad28203f31ab867aa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
using Plum::BinaryString

module Plum
  module FrameUtils
    # Splits the frame into multiple frames if the payload size exceeds max size.
    #
    # @param max [Integer] The maximum size of a frame payload.
    # @return [Array<Frame>] The splitted frames.
    def split_data(max)
      return [self] if self.length <= max
      raise "Frame type must be DATA" unless self.type == :data

      fragments = []
      while (pos = fragments.size * max) <= self.length # zero
        fragments << self.payload.byteslice(pos, max)
      end

      frames = []
      last = Frame.data(stream_id, fragments.pop, *(self.flags & [:end_stream]))
      fragments.each do |fragment|
        frames << Frame.data(stream_id, fragment, *(self.flags - [:end_stream]))
      end
      frames << last
      frames
    end

    def split_headers(max)
      return [self] if self.length <= max
      raise "Frame type must be DATA" unless [:headers, :push_promise].include?(self.type)

      fragments = []
      while (pos = fragments.size * max) < self.length # zero
        fragments << self.payload.byteslice(pos, max)
      end

      frames = []
      frames << Frame.new(type_value: self.type_value, flags: self.flags - [:end_headers], stream_id: self.stream_id, payload: fragments.shift)
      if fragments.size > 0
        last = Frame.continuation(stream_id, fragments.pop, *(self.flags & [:end_headers]))
        fragments.each do |fragment|
          frames << Frame.continuation(stream_id, fragment)
        end
        frames << last
      end
      frames
    end

    # Parses SETTINGS frame payload. Ignores unknown settings type (see RFC7540 6.5.2).
    #
    # @return [Hash<Symbol, Integer>] The parsed strings.
    def parse_settings
      settings = {}
      payload.each_byteslice(6) do |param|
        id = param.uint16
        name = Frame::SETTINGS_TYPE.key(id)
        # ignore unknown settings type
        settings[name] = param.uint32(2) if name
      end
      settings
    end
  end
end