【XMPP】XMPP之Element

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对象(后面介绍)。

5、Message

• Message用于表示一个消息包(可以用调试工具看到发送包和接收包的具体内容)。

Message有两个内部类：

• Message.Body -- 表示消息体
• Message.Type -- 表示消息类型

type有以下几种类类型：

• Message.Type.NORMAL -- （默认）文本消息（比如邮件）
• Message.Type.CHAT -- 典型的短消息，如QQ聊天的一行一行显示的消息
• Message.Type.GROUP_CHAT -- 群聊消息
• Message.Type.HEADLINE -- 滚动显示的消息
• Message.TYPE.ERROR -- 错误的消息

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一样的)