net.sf.jqql.packets
Class _05OutPacket

java.lang.Object
  net.sf.jqql.packets.Packet
      net.sf.jqql.packets.OutPacket
          net.sf.jqql.packets._05OutPacket

Direct Known Subclasses:

_05DebugPacket, RequestAgentPacket, RequestBeginPacket, RequestFacePacket, TransferPacket, Unknown05OutPacket

public abstract class _05OutPacket
extends OutPacket

 output packet with 05 series header, its form is 
 1. packet header sign, 1 byte
 2. source, 2 byte
 3. packet length, 2 byte
 4. packet command, 2 byte
 5. packet sequence number, 2 byte
 6. user QQ number, 4 byte
 7. packet body
 8. packet tail, 1 byte

 noteworthiness is: packet body of this packet is really not full encryption type, but part encryption.

 包头是05系列的输出包，格式为
 1. 包头标识，1字节
 2. source，2字节
 3. 包长度，2字节
 4. 包命令，2字节
 5. 包序号，2字节
 6. 用户QQ号，4字节
 7. 包体
 8. 包尾，1字节
 
 值得注意的是：这种包的包体并非完全加密型，而是部分加密型
 

Author:

luma

Field Summary

Fields inherited from class net.sf.jqql.packets.OutPacket

ack, key, resendCountDown, sendCount, seq, timeout

Fields inherited from class net.sf.jqql.packets.Packet

bodyBuf, bodyDecrypted, command, crypter, ds, duplicated, header, log, sequence, source, user

Constructor Summary

_05OutPacket(ByteBuffer buf, int length, QQUser user)

_05OutPacket(ByteBuffer buf, QQUser user)

_05OutPacket(char command, boolean ack, QQUser user)

Method Summary

protected byte[]	decryptBody(byte[] body, int offset, int length) decrypt packet body 解密包体
protected byte[]	encryptBody(byte[] b, int offset, int length) encrypt packet body 加密包体
protected byte[]	getBodyBytes(ByteBuffer buf, int length) get byte array of packet body 得到包体的字节数组
int	getFamily()
protected int	getHeadLength()
protected int	getLength(int bodyLength) get total length of UDP form packet, rule out TCP form 得到UDP形式包的总长度，不考虑TCP形式
String	getPacketName()
protected int	getTailLength()
protected void	parseHeader(ByteBuffer buf) parse packet header from current position of buf 从buf的当前位置解析包头
protected void	parseTail(ByteBuffer buf) parse packet tail from current position of buf 从buf的当前未知解析包尾
protected void	postFill(ByteBuffer buf, int startPos) backfill, some field must fill whole packet to make sure its content, for example length field, then this method will be used after tail filling.
protected void	putHead(ByteBuffer buf) change packet header to byte stream, and write into appointed ByteBuffer object.
protected void	putTail(ByteBuffer buf) change packet tail to byte stream, and write into appointed ByteBuffer object.
String	toString()
protected boolean	validateHeader() checkout header 校验头部

Methods inherited from class net.sf.jqql.packets.OutPacket

dump, fill, getKey, getNextSeq, getSendCount, getTimeout, needAck, needResend, parseBody, setKey, setSendCount, setTimeout

Methods inherited from class net.sf.jqql.packets.Packet

equals, getCommand, getCryptographStart, getHeader, getSequence, getSource, hash, hashCode, isDuplicated, putBody, setDuplicated, setHeader, setSequence

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

_05OutPacket

public _05OutPacket(char command,
                    boolean ack,
                    QQUser user)

Parameters:

header -

command -

ack -

user -

_05OutPacket

public _05OutPacket(ByteBuffer buf,
                    int length,
                    QQUser user)
             throws PacketParseException

Parameters:

buf -

length -

user -

Throws:

PacketParseException

_05OutPacket

public _05OutPacket(ByteBuffer buf,
                    QQUser user)
             throws PacketParseException

Parameters:

buf -

user -

Throws:

PacketParseException

Method Detail

getLength

protected int getLength(int bodyLength)

Description copied from class: Packet

get total length of UDP form packet, rule out TCP form 得到UDP形式包的总长度，不考虑TCP形式

Specified by:

getLength in class Packet

Parameters:

bodyLength - packet body length 包体长度

Returns:

packet length 包长度

validateHeader

protected boolean validateHeader()

Description copied from class: Packet

checkout header 校验头部

Specified by:

validateHeader in class Packet

Returns:

true means header usable true表示头部有效

getHeadLength

protected int getHeadLength()

Specified by:

getHeadLength in class Packet

Returns:

packet header length 包头长度

getTailLength

protected int getTailLength()

Specified by:

getTailLength in class Packet

Returns:

packet tail length 包尾长度

getPacketName

public String getPacketName()

Overrides:

getPacketName in class OutPacket

Returns:

descriptive name of packet 包的描述性名称

putHead

protected void putHead(ByteBuffer buf)

Description copied from class: Packet

change packet header to byte stream, and write into appointed ByteBuffer object. 将包头部转化为字节流, 写入指定的ByteBuffer对象.

Specified by:

putHead in class Packet

Parameters:

buf - ByteBuffer object whicn packet need to write into 写入的ByteBuffer对象.

putTail

protected void putTail(ByteBuffer buf)

Description copied from class: Packet

change packet tail to byte stream, and write into appointed ByteBuffer object. 将包尾部转化为字节流, 写入指定的ByteBuffer对象.

Specified by:

putTail in class Packet

Parameters:

buf - ByteBuffer object whicn packet need to write into 写入的ByteBuffer对象.

postFill

protected void postFill(ByteBuffer buf,
                        int startPos)

Description copied from class: OutPacket

backfill, some field must fill whole packet to make sure its content, for example length field, then this method will be used after tail filling. 回填，有些字段必须填完整个包才能确定其内容，比如长度字段，那么这个方法将在 尾部填充之后调用

Specified by:

postFill in class OutPacket

Parameters:

buf - ByteBuffer

startPos - packet initial position 包起始位置

parseHeader

protected void parseHeader(ByteBuffer buf)
                    throws PacketParseException

Description copied from class: Packet

parse packet header from current position of buf 从buf的当前位置解析包头

Specified by:

parseHeader in class Packet

Parameters:

buf - ByteBuffer

Throws:

PacketParseException - if parse error 如果解析出错

parseTail

protected void parseTail(ByteBuffer buf)
                  throws PacketParseException

Description copied from class: Packet

parse packet tail from current position of buf 从buf的当前未知解析包尾

Specified by:

parseTail in class Packet

Parameters:

buf - ByteBuffer

Throws:

PacketParseException - if parse error 如果解析出错

decryptBody

protected byte[] decryptBody(byte[] body,
                             int offset,
                             int length)

Description copied from class: Packet

decrypt packet body 解密包体

Specified by:

decryptBody in class Packet

Parameters:

body - byte array of packet body 包体字节数组

offset - offset of packet body begin 包体开始偏移

length - packet length 包体长度

Returns:

解密的包体字节数组 // byte array of decrypted packet body

encryptBody

protected byte[] encryptBody(byte[] b,
                             int offset,
                             int length)

Description copied from class: Packet

encrypt packet body 加密包体

Specified by:

encryptBody in class Packet

Parameters:

b - unencrypt byte array 未加密的字节数组

offset - offset of packet body begin 包体开始的偏移

length - packet body length 包体长度

Returns:

encrypted packet body 加密的包体

getBodyBytes

protected byte[] getBodyBytes(ByteBuffer buf,
                              int length)

Description copied from class: Packet

get byte array of packet body 得到包体的字节数组

Specified by:

getBodyBytes in class Packet

Parameters:

buf - ByteBuffer

length - packet total length 包总长度

Returns:

byte array of packet body 包体字节数组

toString

public String toString()

Overrides:

toString in class Object

getFamily

public int getFamily()

Specified by:

getFamily in class Packet

Returns:

sign this packet belong which protocol family 标识这个包属于哪个协议族