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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
# =XMPP4R - XMPP Library for Ruby
# License:: Ruby's license (see the LICENSE file) or GNU GPL, at your option.
# Website::http://xmpp4r.github.io
require 'xmpp4r/iq'
module Jabber
module Vcard
##
# The Vcard helper retrieves vCards
class Helper
##
# Initialize a new Vcard helper
def initialize(stream)
@stream = stream
end
##
# Retrieve vCard of an entity
#
# Raises exception upon retrieval error, please catch that!
# (The exception is ServerError and is raisen by
# Stream#send_with_id.
#
# Usage of Threads is suggested here as vCards can be very
# big (see <tt>/iq/vCard/PHOTO/BINVAL</tt>).
#
# jid:: [Jabber::JID] or nil (should be stripped, nil for the client's own vCard)
# result:: [Jabber::IqVcard] or nil (nil results may be handled as empty vCards)
def get(jid=nil)
res = nil
request = Iq.new(:get, jid)
request.from = @stream.jid # Enable components to use this
request.add(IqVcard.new)
@stream.send_with_id(request) { |answer|
# No check for sender or queryns needed (see send_with_id)
if answer.type == :result
res = answer.vcard
true
else
false
end
}
res
end
##
# Set your own vCard (Clients only)
#
# Raises exception when setting fails
#
# Usage of Threads suggested here, too. The function
# waits for approval from the server.
#
# iqvcard:: [Jabber::IqVcard]
def set(iqvcard)
iq = Iq.new(:set)
iq.add(iqvcard)
@stream.send_with_id(iq) { |answer|
if answer.type == :result
true
else
false
end
}
end
##
# Quickly initialize a Vcard helper and get
# a vCard. See Vcard#get
def self.get(stream, jid=nil)
new(stream).get(jid)
end
##
# Quickly initialize a Vcard helper and set
# your vCard. See Vcard#set
def self.set(stream, iqvcard)
new(stream).set(iqvcard)
end
end
end
end
|
