Method: MQTT::Client#publish

Defined in:
lib/mqtt/client.rb

#publish(topics, payload = nil, retain: false, qos: 0) ⇒ Object

Publish a message on a particular topic to the MQTT server.



355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
# File 'lib/mqtt/client.rb', line 355

def publish(topics, payload = nil, retain: false, qos: 0)
  if topics.is_a?(Hash) && !payload.nil?
    raise ArgumentError, 'Payload cannot be passed if passing a hash for topics and payloads'
  end
  raise NotConnectedException unless connected?

  if @batch_publish && qos != 0
    values = @batch_publish[{ retain: retain, qos: qos }] ||= {}
    if topics.is_a?(Hash)
      values.merge!(topics)
    else
      values[topics] = payload
    end
    return
  end

  pending_acks = []

  topics = { topics => payload } unless topics.is_a?(Hash)

  topics.each do |(topic, topic_payload)|
    raise ArgumentError, 'Topic name cannot be nil' if topic.nil?
    raise ArgumentError, 'Topic name cannot be empty' if topic.empty?

    packet = MQTT::Packet::Publish.new(
      id: next_packet_id,
      qos: qos,
      retain: retain,
      topic: topic,
      payload: topic_payload
    )

    pending_acks << register_for_ack(packet) unless qos.zero?

    # Send the packet
    send_packet(packet)
  end

  return if qos.zero?

  pending_acks.each do |ack|
    wait_for_ack(ack)
  end
  nil
end