Class: Protocol::HTTP::Header::Priority

Inherits:
Split
  • Object
show all
Defined in:
lib/protocol/http/header/priority.rb

Overview

Represents the priority header, used to indicate the relative importance of an HTTP request.

The priority header allows clients to express their preference for how resources should be prioritized by the server. It supports directives like u= to specify the urgency level of a request, and i to indicate whether a response can be delivered incrementally. The urgency levels range from 0 (highest priority) to 7 (lowest priority), while the i directive is a boolean flag.

Constant Summary collapse

DEFAULT_URGENCY =

The default urgency level if not specified.

3

Constants inherited from Split

Split::COMMA

Instance Method Summary collapse

Methods inherited from Split

#to_s

Constructor Details

#initialize(value = nil) ⇒ Priority

Initialize the priority header with the given value.



18
19
20
 
# File 'lib/protocol/http/header/priority.rb', line 18

def initialize(value = nil)
	super(value&.downcase)
end

Instance Method Details

#<<(value) ⇒ Object

Add a value to the priority header.



25
26
27
 
# File 'lib/protocol/http/header/priority.rb', line 25

def << value
	super(value.downcase)
end

#incremental? ⇒ Boolean

Checks if the response should be delivered incrementally.

The i directive, when present, indicates that the response can be delivered incrementally as data becomes available.

Returns:

  • (Boolean) 


51
52
53
 
# File 'lib/protocol/http/header/priority.rb', line 51

def incremental?
	self.include?("i")
end

#urgency(default = DEFAULT_URGENCY) ⇒ Object

The urgency level, if specified using u=. 0 is the highest priority, and 7 is the lowest.

Note that when duplicate Dictionary keys are encountered, all but the last instance are ignored.



37
38
39
40
41
42
43
44
 
# File 'lib/protocol/http/header/priority.rb', line 37

def urgency(default = DEFAULT_URGENCY)
	if value = self.reverse_find{|value| value.start_with?("u=")}
		_, level = value.split("=", 2)
		return Integer(level)
	end
	
	return default
end