Class: PahoMqtt::Packet::Subscribe

Inherits:
PahoMqtt::Packet show all
Defined in:
lib/paho.mqtt/packet_manager.rb

Overview

Class representing an MQTT Client Subscribe packet

Constant Summary collapse

ATTR_DEFAULTS =

Default attribute values

{
  :topics => [],
  :flags => [false, true, false, false],
}

Instance Attribute Summary collapse

Attributes inherited from PahoMqtt::Packet

#body_length, #flags, #id, #version

Instance Method Summary collapse

Methods inherited from PahoMqtt::Packet

create_from_header, parse, parse_header, read, #to_s, #type_id, #type_name, #update_attributes

Constructor Details

#initialize(args = {}) ⇒ Subscribe

Create a new Subscribe packet



758
759
760
 
# File 'lib/paho.mqtt/packet_manager.rb', line 758

def initialize(args={})
  super(ATTR_DEFAULTS.merge(args))
end

Instance Attribute Details

#topics ⇒ Object

One or more topic filters to subscribe to



749
750
751
 
# File 'lib/paho.mqtt/packet_manager.rb', line 749

def topics
  @topics
end

Instance Method Details

#encode_body ⇒ Object

Get serialisation of packet’s body



805
806
807
808
809
810
811
812
813
814
815
 
# File 'lib/paho.mqtt/packet_manager.rb', line 805

def encode_body
  if @topics.empty?
    raise "no topics given when serialising packet"
  end
  body = encode_short(@id)
  topics.each do |item|
    body += encode_string(item[0])
    body += encode_bytes(item[1])
  end
  return body
end

#inspect ⇒ Object

Returns a human readable string, summarising the properties of the packet



838
839
840
841
842
843
 
# File 'lib/paho.mqtt/packet_manager.rb', line 838

def inspect
  _str = "\#<#{self.class}: 0x%2.2X, %s>" % [
    id,
    topics.map {|t| "'#{t[0]}':#{t[1]}"}.join(', ')
  ]
end

#parse_body(buffer) ⇒ Object

Parse the body (variable header and payload) of a packet



818
819
820
821
822
823
824
825
826
827
 
# File 'lib/paho.mqtt/packet_manager.rb', line 818

def parse_body(buffer)
  super(buffer)
  @id = shift_short(buffer)
  @topics = []
  while(buffer.bytesize>0)
    topic_name = shift_string(buffer)
    topic_qos = shift_byte(buffer)
    @topics << [topic_name,topic_qos]
  end
end

#validate_flags ⇒ Object

Check that fixed header flags are valid for this packet type



831
832
833
834
835
 
# File 'lib/paho.mqtt/packet_manager.rb', line 831

def validate_flags
  if @flags != [false, true, false, false]
    raise "Invalid flags in SUBSCRIBE packet header"
  end
end