groupnameoppacket.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.out;

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.packets.OutPacket;

/**
 * <pre>
 * 上传下载分组名字的消息包，格式为
 * 1. 头部
 * 2. 操作方式字节，如果为0x2，为上传组名，如果为0x1，为请求下载组名
 *    如果为0x2，后面的部分为
 * 	  i.   组序号，qq缺省的组，比如我的好友，序号是0，其他我们自己添加的组，从1开始，一个字节。
 *         但是要注意的是，这里不包括我的好友组，因为我的好友组是QQ的缺省组，无需上传名称
 *    ii.  16个字节的组名，如果组名长度少于16个字节，后面的填0。之所以是16个，是因为QQ的组名长度最多8个汉字
 *    iii. 如果有更多组，重复i，ii部分
 *    如果为0x1，后面的部分为
 *    i.   未知字节0x2
 *    ii.  4个未知字节，全0 
 * 3. 尾部
 * </pre>
 * 
 * @author 马若劼
 */
public class GroupNameOpPacket extends OutPacket {
	private List groups;
	private byte type;
	
    /**
     * 构造函数
     */
    public GroupNameOpPacket() {
        super(QQ.QQ_CMD_GROUP_NAME_OP, true);
		type = QQ.QQ_UPLOAD_GROUP_NAME;
		groups = new ArrayList();
    }

    /**
     * @param buf
     * @param length
     * @throws PacketParseException
     */
    public GroupNameOpPacket(ByteBuffer buf, int length)
            throws PacketParseException {
        super(buf, length);
    }
    
    /* (non-Javadoc)
     * @see edu.tsinghua.lumaqq.qq.packets.OutPacket#putBody(java.nio.ByteBuffer)
     */
    protected void putBody(ByteBuffer buf) {
		// 上传操作标志字节
		buf.put(type);
		if(type == QQ.QQ_UPLOAD_GROUP_NAME) {
			// 循环写入各个组
			int size = groups.size();
			for(int i = 0; i < size; i++) {
				String name = (String)groups.get(i);
				// 组序号
				buf.put((byte)(i + 1));
				// 组名称
				byte[] nameBytes = Utils.getBytes(name, QQ.QQ_CHARSET_DEFAULT);
				// 超过最大长度的，截短；小于最大长度的，补0
				if(nameBytes.length > QQ.QQ_MAX_GROUP_NAME_BYTE)
					buf.put(nameBytes, 0, QQ.QQ_MAX_GROUP_NAME_BYTE);
				else {
					buf.put(nameBytes);
					int j = QQ.QQ_MAX_GROUP_NAME_BYTE - nameBytes.length;
					while(j-- > 0)
						buf.put((byte)0);
				}
			}
		} else {
			// 未知字节0x2
			buf.put((byte)0x2);
			// 未知4字节，全0
			buf.putInt(0);
		}
    }
    
    /* (non-Javadoc)
     * @see edu.tsinghua.lumaqq.qq.packets.OutPacket#parseBody(java.nio.ByteBuffer)
     */
    protected void parseBody(ByteBuffer buf) throws PacketParseException {
        type = buf.get();
        if(type == QQ.QQ_UPLOAD_GROUP_NAME) {
            while(buf.hasRemaining()) {
                buf.get();
                groups.add(Utils.getString(buf, (byte)0x00, QQ.QQ_MAX_GROUP_NAME_BYTE));
            }
        }
    }

	/**
	 * 添加组名，这个方法没有限制添加的组名叫什么，也没有明确规定第一个组必须是
	 * 我的好友组，这些规范需要在上层程序中实现。当然也可以不一定非要第一个组是
	 * 我的好友组，这些客户端的trick随便你怎么搞
	 * @param name
	 */
	public void addGroup(String name) {
		groups.add(name);
	}
	
	/**
	 * @return Returns the type.
	 */
	public byte getType() {
		return type;
	}
	
	/**
	 * @param type The type to set.
	 */
	public void setType(byte type) {
		this.type = type;
	}
}