clustercommandreplypacket.java

很多人都在开发的QQ代码

/*
* LumaQQ - Java QQ Client
*
* Copyright (C) 2004 luma <[e-mail]>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
package edu.tsinghua.lumaqq.qq.packets.in;

import java.nio.ByteBuffer;
import java.util.ArrayList;
import java.util.List;

import edu.tsinghua.lumaqq.qq.PacketParseException;
import edu.tsinghua.lumaqq.qq.QQ;
import edu.tsinghua.lumaqq.qq.Utils;
import edu.tsinghua.lumaqq.qq.beans.ClusterInfo;
import edu.tsinghua.lumaqq.qq.beans.QQFriend;
import edu.tsinghua.lumaqq.qq.packets.InPacket;

/**
 * <pre>
 * 群命令的回复包，根据不同的子命令类型格式有所不同：
 * 创建群的回复包，格式为：
 * 1. 头部
 * 2. 命令类型，1字节，创建群是0x1
 * 3. 回复码，1字节，成功是0x0，如果成功则后面为
 *    1. 群内部ID，4字节，如果为0，表示创建失败
 *    2. 群外部ID，4字节，如果为0，表示创建失败
 * 4. 如果回复码不为0，则后面为出错信息
 * 5. 尾部
 * 
 * 激活群的回复包，格式为：
 * 1. 头部
 * 2. 命令类型，激活是0x5
 * 3. 回复码，1字节，成功是0x0
 * 4. 群的内部ID
 * 5. 尾部
 * 
 * 得到群信息的回复包，格式为：
 * 1. 头部
 * 2. 命令类型，1字节，得到群信息是0x4
 * 3. 回复码，1字节，成功是0x0
 * 4. 群内部ID，4字节
 * 5. 群外部ID，4字节
 * 6. 群类型，1字节
 * 7. 创建者QQ号，4字节
 * 8. 认证类型，1字节
 * 9. 未知的2字节，全0
 * 10. 群分类，2字节
 * 11. 未知的两字节，全0
 * 12. 未知的两字节，全0
 * 13. 群名称长度，1字节
 * 14. 群名称
 * 15. 未知的两字节，全0
 * 15. 群声明长度，1字节
 * 16. 群声明
 * 17. 群描述长度，1字节
 * 18. 群描述
 * 19. 群中成员的QQ号，4字节
 * 20. 分隔符，1字节，0x00
 * 21. 如果存在更多成员，重复19, 20部分
 * 22. 尾部
 * 
 * 退出群的回复，格式为：
 * 1. 头部
 * 2. 命令类型，1字节，退出是0x9
 * 3. 回复码，1字节，成功是0x0
 * 4. 群内部ID，4字节，应该是个非0值
 * 5. 尾部
 * 
 * 请求成员信息的回复包，格式为
 * 1. 头部
 * 2. 命令类型，1字节，请求成员信息是0x0C
 * 3. 回复码，1字节，成功是0x0
 * 4. 群内部ID，4字节
 * 5. 成员QQ号，4字节
 * 6. 分隔符1字节
 * 7. 头像号，1字节
 * 8. 年龄，1字节
 * 9. 性别，1字节
 * 10. 昵称长度，1字节
 * 11. 昵称
 * 12. 未知的2字节
 * 13. 扩展标志，1字节
 * 14. 通用标志，1字节
 * 15. 如果有更多成员，重复5-14部分，5－14部分其实也就是QQFriend结构
 * 16. 尾部
 * 
 * 得到在线成员的回复包，格式为：
 * 1. 头部
 * 2. 命令类型，1字节，请求成员信息是0x0B
 * 3. 回复码，1字节，成功是0x0
 * 4. 群内部ID，4字节
 * 5. 未知字节，0x3C
 * 6. 在线成员的qq号
 * 7. 如果有更多在线成员，重复5
 * 8. 尾部
 * 
 * 请求加入群的回复包，格式为：
 * 1. 头部
 * 2. 命令类型，1字节，请求成员信息是0x07
 * 3. 回复码，1字节，成功是0x0
 * 4. 群内部ID，4字节
 * 5. 回复码，这个回复码是比较细的特定于join请求的回复，1字节
 * 6. 尾部
 * 
 * 请求加入群的认证信息回复包，没什么太大用处，就是表示服务器收到了，格式为：
 * 1. 头部
 * 2. 命令类型，这里是0x8
 * 3. 回复码，1字节，成功是0x0
 * 4. 群内部ID，4字节，如果为0表示出错
 * 5. 尾部
 * 
 * 修改群信息的回复包，格式为：
 * 1. 头部
 * 2. 命令类型，这里是0x03
 * 3. 回复码，1字节，成功是0x0
 * 4. 群内部ID，4字节
 * 5. 尾部
 *
 * 搜索群的回复包，格式为：
 * 1. 头部
 * 2. 命令类型，这里是0x06
 * 3. 回复码，1字节，成功是0x0
 * 4. 搜索方式，1字节
 * 5. 群内部ID，4字节
 * 6. 群外部ID，4字节
 * 7. 群类型，1字节
 * 8. 群创建者，4字节
 * 9. 未知的2字节
 * 10. 群分类，2字节
 * 11. 群名称长度，1字节
 * 12. 群名称
 * 13. 未知的两字节
 * 14. 认证类型，1字节
 * 15. 群简介长度，1字节
 * 16. 群简介
 * 17. 尾部
 * </pre>
 * 
 * @author 马若劼
 */
public class ClusterCommandReplyPacket extends InPacket {
	// 公共字段
	/** 子命令 */
	public byte subCommand;
	/** 回复码 */
	public byte replyCode;
	/** 群内部id */
	public int clusterId;
	/** 群外部id */
	public int externalId;
	
	/** 如果replyCode不是ok，那么这个字段有效，表示出错信息 */
	public String errorMessage;
	
	// 仅用于得到群信息的回复包，list的元素类型为ClusterInfo
	/** 群信息 */
	public ClusterInfo info;
	/** 群成员列表，元素类型为Integer，包含了成员的QQ号 */
	public List members;
	
	// 仅用于得到群成员信息的回复包，list的元素类型是QQFriend
	/** 包含了群成员信息的列表，元素类型是QQFriend */
	public List memberInfos;
	
	// 仅用于得到在线成员的回复包，list的元素类型是Integer
	/** 包含了在线成员列表，元素类型是Integer，表示成员的QQ号 */
	public List onlineMembers;
	
	// 仅用于加入群的回复包
	/** 加入群的回复 */
	public byte joinReply;
	
	// 仅用于搜索群的回复包，元素类型是ClusterInfo
	/** 搜索类型 */
	public byte searchType;
	/** 搜索到的群，类型是ClusterInfo */
	public List clusters;
	
    /**
     * 构造函数
     * @param buf 缓冲区
     * @param length 包长度
     * @throws PacketParseException 解析错误
     */
    public ClusterCommandReplyPacket(ByteBuffer buf, int length) throws PacketParseException {
        super(buf, length);
    }   

    /* (non-Javadoc)
     * @see edu.tsinghua.lumaqq.qq.packets.InPacket#parseBody(java.nio.ByteBuffer)
     */
    protected void parseBody(ByteBuffer buf) throws PacketParseException {
        // 得到群操作命令和回复码
		subCommand = buf.get();
		replyCode = buf.get();
		// 判断命令类型
		switch(subCommand) {
			case QQ.QQ_CLUSTER_CMD_SEND_IM:
				parseSendIMReply(buf);
				break;
			case QQ.QQ_CLUSTER_CMD_CREATE_CLUSTER:
				parseCreateReply(buf);
				break;
			case QQ.QQ_CLUSTER_CMD_ACTIVATE_CLUSTER:
				parseActivateReply(buf);
				break;
			case QQ.QQ_CLUSTER_CMD_GET_CLUSTER_INFO:
				parseGetInfoReply(buf);
				break;
			case QQ.QQ_CLUSTER_CMD_EXIT_CLUSTER:
				parseExitReply(buf);
				break;
			case QQ.QQ_CLUSTER_CMD_GET_MEMBER_INFO:
				parseGetMemberInfoReply(buf);
				break;
			case QQ.QQ_CLUSTER_CMD_GET_ONLINE_MEMBER:
				parseGetOnlineMemberReply(buf);
				break;
			case QQ.QQ_CLUSTER_CMD_JOIN_CLUSTER:
				parseJoinReply(buf);
				break;
			case QQ.QQ_CLUSTER_CMD_JOIN_CLUSTER_AUTH:
				parseJoinAuthReply(buf);
				break;
			case QQ.QQ_CLUSTER_CMD_MODIFY_CLUSTER_INFO:
				parseModifyInfoReply(buf);
				break;
			case QQ.QQ_CLUSTER_CMD_SEARCH_CLUSTER:
				parseSearchReply(buf);
				break;
		}			
		
		// 如果操作失败
		if(replyCode != QQ.QQ_CLUSTER_CMD_REPLY_OK) {
			/* 操作失败 */
			byte[] b = new byte[buf.remaining()];
			buf.get(b);
			errorMessage = Utils.getString(b, QQ.QQ_CHARSET_DEFAULT);
		}
    }

	// 处理发送消息的回复包
	private void parseSendIMReply(ByteBuffer buf) {
		if(replyCode == QQ.QQ_CLUSTER_CMD_REPLY_OK) {
			clusterId = buf.getInt();
		}
	}

	// 处理搜索群的回复包
	private void parseSearchReply(ByteBuffer buf) {
		if(replyCode == QQ.QQ_CLUSTER_CMD_REPLY_OK) {
			searchType = buf.get();
			clusters = new ArrayList();
			while(buf.hasRemaining()) {
				ClusterInfo info = new ClusterInfo();
				info.readBeanFromSearchReply(buf);
				clusters.add(info);
			}
		}
	}

	// 处理修改群信息的回复包
	private void parseModifyInfoReply(ByteBuffer buf) {
		if(replyCode == QQ.QQ_CLUSTER_CMD_REPLY_OK) {
			clusterId = buf.getInt();
		}
	}

	// 处理认证信息的回复包，这个回复包只是个简单的回复，没什么用
	private void parseJoinAuthReply(ByteBuffer buf) {
		if(replyCode == QQ.QQ_CLUSTER_CMD_REPLY_OK) {
			clusterId = buf.getInt();
		}
	}

	// 处理加入群的回复包
	private void parseJoinReply(ByteBuffer buf) {
		if(replyCode == QQ.QQ_CLUSTER_CMD_REPLY_OK) {
			clusterId = buf.getInt();
			joinReply = buf.get();
		}
	}

	// 处理得到在线成员的回复包
	private void parseGetOnlineMemberReply(ByteBuffer buf) {
		if(replyCode == QQ.QQ_CLUSTER_CMD_REPLY_OK) {
			// 内部ID
			clusterId = buf.getInt();
			// 未知字节，0x3C
			buf.get();
			// 成员信息
			onlineMembers = new ArrayList();
			while(buf.hasRemaining()) {
				onlineMembers.add(new Integer(buf.getInt()));
			}
		}
	}

	// 处理得到群成员信息的回复包
	private void parseGetMemberInfoReply(ByteBuffer buf) {
		if(replyCode == QQ.QQ_CLUSTER_CMD_REPLY_OK) {
			clusterId = buf.getInt();
			// 成员信息
			memberInfos = new ArrayList();
			while(buf.hasRemaining()) {
				QQFriend info = new QQFriend();
				info.readBean(buf);
				memberInfos.add(info);
			}			
		}
	}

	// 处理退出群的回复包
	private void parseExitReply(ByteBuffer buf) {
		if(replyCode == QQ.QQ_CLUSTER_CMD_REPLY_OK)
			clusterId = buf.getInt();
	}

	// 处理得到群信息的回复包
	private void parseGetInfoReply(ByteBuffer buf) {
		if(replyCode == QQ.QQ_CLUSTER_CMD_REPLY_OK) {
			// 群信息
			info = new ClusterInfo();
			info.readBean(buf);
			clusterId = info.clusterId;
			externalId = info.externalId;
			// 读取成员列表
			members = new ArrayList();
			while(buf.hasRemaining()) {
				Integer temp = new Integer(buf.getInt());
				buf.get();
				members.add(temp);
			}			
		}
	}

	// 处理激活群的回复包
	private void parseActivateReply(ByteBuffer buf) {
		if(replyCode == QQ.QQ_CLUSTER_CMD_REPLY_OK)
			clusterId = buf.getInt();
	}

	// 解析创建群的回复包
	private void parseCreateReply(ByteBuffer buf) {		
		if(replyCode == QQ.QQ_CLUSTER_CMD_REPLY_OK) {
			clusterId = buf.getInt();
			externalId = buf.getInt();					
		}
	}
}