xmpp的初步认识

一.xmpp的初步认识

如果在一般的Java Project上开发xmpp的相关应用需要加入smack.jar 和klmx2.jar。
如果是Android Project，基本代码只需加入 asmack.jar包。

1.ConnectionConfiguration
  作为用于与XMPP服务建立连接的配置。它能配置；连接是否使用TLS，SASL加密。
  包含内嵌类：ConnectionConfiguration.SecurityMode

2.XMPPConnection.
  XMPPConnection这个类用来连接XMPP服务.
  可以使用connect()方法建立与服务器的连接。disconnect()方法断开与服务器的连接.
  在创建连接前可以使用XMPPConnection.DEBUG_ENABLED = true; 使开发过程中可以弹出一个GUI窗口，用于显示我们的连接与发送Packet的信息。

3.ChatManager
  用于监控当前所有chat。可以使用createChat(String userJID, MessageListener listener)创建一个聊天。
 
4.Chat
  Chat用于监控两个用户间的一系列message。使用addMessageListener(MessageListener listener)当有任何消息到达时将会触发listener的processMessage(Chat chat, Message message)方法。

  我们可以使用sendMessage()发送消息，这个方法有两个重载方法，一种类类型的参数时String类型，另一种则是传入Message对象。
  那么有这样一种情况，当别人主动跟我们建立连接发送消息，或者系统发送消息时我们怎么才能接收消息呢？
下面是这样操作的：

chatmanager. addChatListener( new ChatManagerListener() {
@Override
public void chatCreated(Chat chat, boolean createdLocally) {
  chat. addMessageListener( new MessageListener() {
    @Override
    public void processMessage(Chat chat, Message message) {
      System. out. println( "Received message: " + message. getBody());
    }
           
  });
}
});

5.Message
  Message用于表示一个消息包(可以用调试工具看到发送包和接收包的具体内容)。它有以下多种类型。
 
  Message.Type.NORMAL -- （默认）文本消息（比如邮件）。区别于chat，是在两个用户实体进行 聊天外的消息内容，可以回复。可以做需要“回执”动作之类的消息。
  Message.Type.CHAT -- 典型的短消息，消息类型用于两个实体用户之间 聊天。如QQ聊天的一行一行显示的消息。
  Message.Type.GROUP_CHAT -- 群聊消息类型
  Message.Type.HEADLINE -- 滚动显示的消息，即不可回复的消息类型（新闻, 体育, 市场信息, RSS feeds, 等等）
  Message.TYPE.ERROR -- 错误的消息
 

  消息的子元素
  1. <subject/>
  2. <body/>:消息的传送内容
  3. <thread/>：这个用于用户建立两实体间的聊天会话。发送者发送message的时候，在服务器中建立以thread.hashcode为键值的thread池，接收者reply时再从thread池中查找会话线程


下面给出headline的消息类型的使用样例：

XMPPConnection connection = new XMPPConnection(jabber. org);
connection. login(user, password);
Message message = new Message();
message. setTo( " tom@jabber.org ");
message. setSubject( "Server down");
message. setBody( "server has just gone down");
message. setType(Message. Type. HEADLINE);
connection. sendPacket(message);
connection. close();

6.Roster
  表示存储了很多RosterEntry的一个花名册。为了易于管理，花名册的项被分贝到了各个group中。
  当建立与XMPP服务的连接后可以使用connection.getRoster()获取Roster对象。
  别的用户可以使用一个订阅请求(相当于QQ加好友)尝试订阅目的用户。
  可以使用枚举类型Roster.SubscriptionMode的值处理这些请求：
  accept_all: 接收所有订阅请求
  reject_all：拒绝所有订阅请求
  manual：手工处理订阅请求
 
  创建组：RosterGroup group = roster.createGroup("大学");
  向组中添加RosterEntry对象: group.addEntry(entry);
 
7.RosterEntry
  表示Roster（花名册）中的每条记录.它包含了用户的JID，用户名，或用户分配的昵称.
 
8.RosterGroup
  表示RosterEntry的组。可以使用addEntry(RosterEntry entry)添加。
  contains(String user) 判断某用户是否在组中。
  当然removeEntry(RosterEntry entry)就是从组中移除了。
  getEntries()获取所有RosterEntry。
 
9.Presence
  表示XMPP状态的packet。每个presence packet都有一个状态。用枚举类型Presence.Type的值表示：
  available -- （默认）用户空闲状态
  unavailable -- 用户没空看消息
  subscribe -- 请求订阅别人，即请求加对方为好友
  subscribed -- 统一被别人订阅，也就是确认被对方加为好友
  unsubscribe -- 他取消订阅别人，请求删除某好友
  unsubscribed -- 拒绝被别人订阅，即拒绝对放的添加请求
  error -- 当前状态packet有错误
  内嵌两个枚举类型:Presence.Mode和Presence.Type.
  可以使用setStatus自定义用户当前的状态（像QQ一样的)。
 

可以用if(presence.isAvailable() == true) 来判断好友是否在线。