用Smack编写jabber客户端(中)

使用 Chat 和 GroupChat 传递消息

发送接受消息是即使通讯软件的核心功能.有两个类帮助完成这个任务.

• org.jivesoftware.smack.Chat -- 用来在两者之间传递信息.
• org.jivesoftware.smack.GroupChat -- 用来加入一个组给很多人之间传递消息.

他们都是使用org.jivesoftware.smack.packet.Message 类来实现消息传递. 在某些环境下你可以绕开Chat
GroupChat这两个高级的类手动传递消息或者是加入listener.

 

Chat

一个Chat对象在两个用户之间使用一个thread ID创建一个新的消息线程.下面的代码演示了如何

使用一个user创建一个新的Chat,然后向它发送文本消息.

 

// 假设我们创建了一个 XMPPConnection 对象 名称为 "connection".
Chat newChat = connection.createChat("[e-mail]");
newChat.sendMessage("Howdy!");

实际上Chat.sendMessage(String) 方法是一个我们提供的创建一个Message对象的方便的方法,它使用String 参数
作为body,然后发送这个message.如果你想要加入其它熟悉,请使用:

 

// 假设我们创建了一个 XMPPConnection 对象 名称为 "connection".
Chat newChat = connection.createChat("[e-mail]");
Message newMessage = newChat.createMessage();
newMessage.setBody("Howdy!");
message.setProperty("favoriteColor", "red");
newChat.sendMessage(newMessage);

Chat对象容许你侦听其它chat的回应.下面的代码实现了鹦鹉学舌--它会对任何人的话做出同样的回答.

 

// 假设我们创建了一个 XMPPConnection 对象 名称为 "connection".
Chat newChat = connection.createChat("[e-mail]");
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("[e-mail]");
// 使用昵称 "jsmith"加入聊天组.
newGroupChat.join("jsmith");
// 发送消息给聊天组.
newGroupChat.sendMessage("Howdy!");

发送和接受消息和Chat很类似就不详细讲述了.

 

聊天名单和在线状态

名单允许你跟踪其它用户的状态并且把用户分为好友,同事等等.

你可以通过XMPPConnection.getRoster()方法获取Roster对象,但是必须在你成功登陆后.

Roster 实体

每一个用户都被描述为一个Roster实体,它包包括:

• 一个 XMPP 地址 (e.g. [e-mail]).
• 名称,昵称 (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 包.