MetaQ技术内幕——源码分析(六)

前几天不小心茶水泼到了笔记本上，这两天才修好，就赶紧写上一篇。

 

 

前面介绍过MetaQ使用gecko框架作为网络传输框架，Gecko采用请求/响应的方式组织传输。MetaQ依据定义了请求和响应的命令，由于命令Client和Broker均需要使用，所以放在了common工程的类MetaEncodeCommand中：

    public String GET_CMD = "get";  //请求数据请求
    public String RESULT_CMD = "result"; //结果响应(不包括消息)
    public String OFFSET_CMD = "offset"; //查询最近有效的offset请求
    public String PUT_CMD  = "put";  //发送消息命令请求
    public String SYNC_CMD = "sync"; //同步数据请求
    public String QUIT_CMD = "quit";  //退出请求，客户端发送此命令后，服务器将主动关闭连接
    public String VERSION_CMD = "version"; //查询服务器版本请求，也用于心跳检测
    public String STATS_CMD = "stats"; //查询统计信息请求
    public String TRANS_CMD = "transaction"; //事务请求
    //还有一个响应，这里没有响应头的定义，就是返回的消息集

在分析Broker启动类MetaMorphosisBroker时，分析过registerProcessors()方法，针对于不同的请求，Broker注册了不同的处理器，详情见registerProcessors()方法。MetaQ传输采用文本协议设计，非常透明，MetaEncodeCommand定义是请求类型。

 

Broker分为请求和响应的命令，先看看请求的类图：

 

 

注：由于类图工具出现问题，AbstractRequestCommand跟RequestCommand的实现关系并画成依赖关系，请大家理解成实现关系，以后类图同样这样理解(除非接口与接口或者类与类关系使用依赖箭头一定是描述成依赖的)。

 

所有的请求的命令均继承AbstractRequestCommand类并实现RequestCommand接口，RequestCommand是Gecko框架定义的接口，所有的命令均在编码后能被Gecko框架组织传输，传输协议是透明的文本协议。AbstractRequestCommand定义了基本属性topic和opaque。

public abstract class AbstractRequestCommand implements RequestCommand, MetaEncodeCommand {
	private Integer opaque; //主要用于标识请求，响应的时候该标识被带回，用于客户端区分是哪个请求的响应
	private String topic; 
}

 

 

 

响应命令的类图如下：

 

请求命令只分为两类，带有消息集合的响应（DataCommand）；带有其他结果的响应(BooleanCommand)。DataCommand里携带的消息的格式与消息的存储结构一直，这样可以提高Broker的处理能力，将消息解析、正确性等验证放在Client，充分发挥Client的计算能力。这里比较麻烦的一点就是其他结果的响应均有BooleanCommand完成，BooleanCommand中只有code和message熟悉，code用来返回响应状态码，比如统计结果的信息的携带就必须由message熟悉来完成，所以结果的响应能力有限，而且必须先转换成字符串，具体如下：

 

/**
 * 应答命令,协议格式如下：</br> result code length opaque\r\n message
 */
public class BooleanCommand extends AbstractResponseCommand implements BooleanAckCommand {
	private String message;
	/**
	 * status code in http protocol
	 */
	private final int code;//响应的状态码
	public BooleanCommand(final int code, final String message, final Integer opaque) {
		super(opaque);
		this.code = code;
		switch (this.code) {
			case HttpStatus.Success:
				this.setResponseStatus(ResponseStatus.NO_ERROR);
				break;
			default:
				this.setResponseStatus(ResponseStatus.ERROR);
				break;
		}
		this.message = message;
	}

	public String getErrorMsg() {
		return this.message;
	}

	public int getCode() {
		return this.code;
	}

	public void setErrorMsg(final String errorMsg) {
		this.message = errorMsg;
	}

	public IoBuffer encode() {
//对结果进行编码，以便能在网络上传输
		final byte[] bytes = ByteUtils.getBytes(this.message);
		final int messageLen = bytes == null ? 0 : bytes.length;
		final IoBuffer buffer = IoBuffer.allocate(11 + ByteUtils.stringSize(this.code)
				+ ByteUtils.stringSize(this.getOpaque()) + ByteUtils.stringSize(messageLen) + messageLen);
		ByteUtils.setArguments(buffer, MetaEncodeCommand.RESULT_CMD, this.code, messageLen, this.getOpaque());
		if (bytes != null) {
			buffer.put(bytes);
		}
		buffer.flip();
		return buffer;
	}
}

 

前面讲到的每个请求都会携带一个属性opaque并且该opaque将会在响应里被带回， AbstractResponseCommand里定义了该被带回的属性opaque。

 

/**
 * 应答命令基类
 */
public abstract class AbstractResponseCommand implements ResponseCommand, MetaEncodeCommand {
	private Integer opaque; 
	private InetSocketAddress responseHost; // responseHost和responseTime尚未发现在哪来调用，预计是作者预留的属性
	private long responseTime;
	private ResponseStatus responseStatus; //响应状态
}

 

 

不知道研究过MetaQ源码的朋友们发现DataCommand的encode()是一个空实现没，虽然作者有注释，运行Broker确实不存在问题，但就从设计者的角度来看，还是有些小问题的，代码如下：

 

public class DataCommand extends AbstractResponseCommand {
	private final byte[] data;
……
	@Override
	public IoBuffer encode() {
	//作者注释： 不做任何事情，发送data command由transferTo替代
       //笔者注释：因为Borker采用了BrokerCommandProcessor 中zeroCopy的机制，所以不会该encode方法的调用，但如果以后改动后，允许zeroCopy变成可配置项，如果该方法不实现，就会出现解析问题，因为配置容易加上，但容易忘记该处的实现。
		return null;
	}
}

 

在介绍完Broker网络传输的基本数据结构后，接下来就要进入处理流程的分析了。