Class: Blather::Stanza::PubSub::Subscribe

Inherits:
Blather::Stanza::PubSub show all
Defined in:
lib/blather/stanza/pubsub/subscribe.rb

Overview

# PubSub Subscribe Stanza

[XEP-0060 Section 6.1 - Subscribe to a Node](xmpp.org/extensions/xep-0060.html#subscriber-subscribe)

Constant Summary

Constants inherited from Iq

Iq::VALID_TYPES

Constants inherited from XMPPNode

XMPPNode::BASE_NAMES

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Blather::Stanza::PubSub

import, #inherit, #pubsub

Methods inherited from Iq

#error?, #get?, import, #reply!, #result?, #set?, #type=

Methods inherited from Blather::Stanza

#as_error, #error?, #from, #from=, handler_list, #id, #id=, next_id, register, #reply, #reply!, #to, #to=, #type, #type=

Methods inherited from XMPPNode

class_from_registration, #content_from, import, #inherit, #inherit_attrs, #inspect, #namespace=, #namespace_href, #nokogiri_namespace=, #read_attr, #read_content, register, #remove_child, #remove_children, #set_content_for, #to_stanza, #write_attr

Methods inherited from Nokogiri::XML::Node

#[]=, #attr_set, #find_first, #nokogiri_xpath, #xpath

Class Method Details

.new(type = :set, host = nil, node = nil, jid = nil) ⇒ Object

Create a new subscription node

Parameters:

  • type (Blather::Stanza::Iq::VALID_TYPES) (defaults to: :set)

    the IQ stanza type

  • host (String) (defaults to: nil)

    the host name to send the request to

  • node (String) (defaults to: nil)

    the node to subscribe to

  • jid (Blather::JID, #to_s) (defaults to: nil)

    see #jid=



19
20
21
22
23
24
# File 'lib/blather/stanza/pubsub/subscribe.rb', line 19

def self.new(type = :set, host = nil, node = nil, jid = nil)
  new_node = super(type, host)
  new_node.node = node
  new_node.jid = jid
  new_node
end

Instance Method Details

#jidBlather::JID

Get the JID of the entity to subscribe

Returns:



29
30
31
# File 'lib/blather/stanza/pubsub/subscribe.rb', line 29

def jid
  JID.new(subscribe[:jid])
end

#jid=(jid) ⇒ Object

Set the JID of the entity to subscribe

Parameters:



36
37
38
# File 'lib/blather/stanza/pubsub/subscribe.rb', line 36

def jid=(jid)
  subscribe[:jid] = jid
end

#nodeString

Get the name of the node to subscribe to

Returns:

  • (String)


43
44
45
# File 'lib/blather/stanza/pubsub/subscribe.rb', line 43

def node
  subscribe[:node]
end

#node=(node) ⇒ Object

Set the name of the node to subscribe to

Parameters:

  • node (String)


50
51
52
# File 'lib/blather/stanza/pubsub/subscribe.rb', line 50

def node=(node)
  subscribe[:node] = node
end

#subscribeBlather::XMPPNode

Get or create the actual subscribe node on the stanza

Returns:



57
58
59
60
61
62
63
# File 'lib/blather/stanza/pubsub/subscribe.rb', line 57

def subscribe
  unless subscribe = pubsub.find_first('ns:subscribe', :ns => self.class.registered_ns)
    self.pubsub << (subscribe = XMPPNode.new('subscribe', self.document))
    subscribe.namespace = self.pubsub.namespace
  end
  subscribe
end