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分为请求和响应的命令,先看看请求的类图:

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

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

 

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

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

 

 

 

响应命令的类图如下:

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

请求命令只分为两类,带有消息集合的响应(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网络传输的基本数据结构后,接下来就要进入处理流程的分析了。