用Smack编写jabber客户端(中)
使用?Chat 和 GroupChat 传递消息
发送接受消息是即使通讯软件的核心功能.有两个类帮助完成这个任务.
Chat
一个Chat对象在两个用户之间使用一个thread ID创建一个新的消息线程.下面的代码演示了如何使用一个user创建一个新的Chat,然后向它发送文本消息.?
// 假设我们创建了一个 XMPPConnection 对象 名称为 "connection".Chat newChat = connection.createChat("jsmith@jivesoftware.com");newChat.sendMessage("Howdy!");实际上Chat.sendMessage(String) 方法是一个我们提供的创建一个Message对象的方便的方法,它使用String 参数作为body,然后发送这个message.如果你想要加入其它熟悉,请使用:?
// 假设我们创建了一个 XMPPConnection 对象 名称为 "connection".Chat newChat = connection.createChat("jsmith@jivesoftware.com");Message newMessage = newChat.createMessage();newMessage.setBody("Howdy!");message.setProperty("favoriteColor", "red");newChat.sendMessage(newMessage);Chat对象容许你侦听其它chat的回应.下面的代码实现了鹦鹉学舌--它会对任何人的话做出同样的回答.
?
// 假设我们创建了一个 XMPPConnection 对象 名称为 "connection".Chat newChat = connection.createChat("jsmith@jivesoftware.com");newMessage.setBody("Hi, I'm an annoying parrot-bot! Type something back to me.");while (true) { //等待对方给我们发送消息 . Message message = newChat.nextMessage(); // 把对方发给我们的消息原封不动的再发回去 . newChat.sendMessage(message.getBody());}上面的代码使用了Chat.nextMessage()方法来得到下一个message,它是阻塞式的.当然你可以加入一个
listener来获取消息.
GroupChat
?
一个group chat运行你同时和一群用户聊天.你必须使用一个昵称来加入一个聊天组.下面代码演示了
如何加入聊天组,并且发送消息.
?
// 假设我们创建了一个 XMPPConnection 对象 名称为 "connection".GroupChat newGroupChat = connection.createGroupChat("test@jivesoftware.com");// 使用昵称 "jsmith"加入聊天组.newGroupChat.join("jsmith");// 发送消息给聊天组.newGroupChat.sendMessage("Howdy!");发送和接受消息和Chat很类似就不详细讲述了.
?
聊天名单和在线状态
名单允许你跟踪其它用户的状态并且把用户分为好友,同事等等.
你可以通过XMPPConnection.getRoster()方法获取Roster对象,但是必须在你成功登陆后.
Roster 实体
每一个用户都被描述为一个Roster实体,它包包括:
一个 XMPP 地址 (e.g. jsmith@example.com).名称,昵称?(e.g. "Joe").它属于哪个列表,如好友,同事?下面的代码打印出所有Roster实体的信息:
Roster roster = con.getRoster();for (Iterator i=roster.getEntries(); i.hasNext(); ) { System.out.println(i.next());}
我们也提供了取得特定实体的方法,或者式组的方法.
在线状态
?
每一个用户列表中的对象都有在线状态.Roster.getPresence(String user)返回一个Presence对象描述用户的在线状态.
一个用户的presence要么是在线要么是离线.当一个用户在线时候,它他们的presence还可以包含一些额外的信息,例如当前他们
在做什么,他们是否乐于别打扰.
监听好友名单和Presence的改变
一般的来说都是用一个tree来显好友,例如,你看看下面的图:
?
presence信息通常都是随时变化的,当然也有可能名单的增加和删除.要监听名单和presence的改变,
必须使用RosterListener .下面的代码演示了如何监听并把任何presence改变打印出来.通常客户端
软件有显示的代码来完成更新用户名单UI的代码来反映变化.
final Roster roster = con.getRoster();roster.addRosterListener(new RosterListener() { public void rosterModified() { // Ignore event for this example. } public void presenceChanged(String user) { // If the presence is unavailable then "null" will be printed, // which is fine for this example. System.out.println("Presence changed: " + roster.getPresence(user)); }});增加用户到用户列表
用户列表使用的允许模型,也就是只有对方容许你才能把他加入到你的用户名单中.这个保护了用户的
隐私.因此,你加入一个用户将会进入一个未决状态直到对方接受请求.
同时如果有一个用户请求把你加入,你必须对这个请求作出接受或反对的回应.Smack提供了三种策略:
自动接受所有请求.自动反对所有请求.交给用户手动处理.
你可以通过Roster.setSubscriptionMode(int subscriptionMode)来设置使用哪种策略.一个简单的客户端
可以使用自动同意模式,但是一个功能比较健全的客户端应该提供用户手动出来.在手动模式中,你必须提供
一个PacketListener 注册来诊听含有类型Presence.Type.SUBSCRIBE的Presence 包.