# AliTianchi

**Repository Path**: xingfeng_coder/alitianchi

## Basic Information

- **Project Name**: AliTianchi
- **Description**: 阿里中间件比赛
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2017-05-15
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

>写在前面: 
> 1. 在开始coding前请仔细阅读以下内容


## 1. 题目背景
支撑阿里双十一的万亿级消息中间件RocketMQ在去年10月进入Apache基金会进行孵化。异步解耦，削峰填谷，让消息中间件在现代软件架构中扮演者举足轻重的地位。天下大势，分久必合，合久必分，软件领域也是如此。市场上消息中间件种类繁多，阿里消息团队在此当口，推出厂商无关的[Open-Messaging](https://openmessaging.github.io)规范，促进消息领域的进行一步发展。

## 2. 题目描述

### 2.1 题目内容
阅读Open-Messaging的接口代码(本工程内除了demo目录外的其他代码)，了解Topic，Queue的基本概念，并实现一个进程内消息引擎。

提示：Topic类似于水坝（蓄积功能，消峰填谷之利器），Queue类似于水渠；每当新建一个Queue的时候，可以选择绑定到几个Topic，类似于水渠从水坝引水；
每个Topic可以被任意多个Queue绑定，这点与现实生活不太一样，因为数据可以多次拷贝；
在发送的时候，可以选择发送到Topic，也可以选择直接发送到Queue；直接发送到Queue的数据只能被对应Queue消费，不能被其他Queue读取到；
在消费的时候，除了要读取绑定的Topic的数据，还要去取直接发送到该Queue的数据；


### 2.2 语言限定
限定使用JAVA语言

## 3.  程序目标

你的coding目标是实现以下接口:

 * Producer的createBytesMessageToTopic(topic, body)
 * Producer的createBytesMessageToQueue(queue, body)
 * Producer的send(message)
 * PullConsumer的attachQueue(queue, topics)
 * PullConsumer的poll()

实现类名字分别叫做:DefaultProducer,DefaultPullConsumer，包名均是：io.messaging.demo
请参考demo目录，建议是名字不要改，修改实现内容即可
注意，消息内容需要存入磁盘中，并能再次读取出来


## 4.参赛方法说明
1. 在阿里天池找到"中间件性能挑战赛"，并报名参加
2. 在code.aliyun.com注册一个账号，并新建一个仓库名，并将大赛官方账号middlewarerace2017添加为项目成员，权限为reporter
3. fork或者拷贝本仓库的代码到自己的仓库，并实现自己的逻辑
4. 在天池提交成绩的入口，提交自己的仓库git地址，等待评测结果
5. 坐等每天10点排名更新


## 4. 测试环境描述
测试环境为相同的4核虚拟机(暂定)。限定使用的最大JVM大小为4GB(-Xmx4g)，磁盘使用不做限制。

## 5. 程序校验逻辑

1. 10~20个线程(位于同一进程中)各自独立调用Producer发送消息(每个线程启动一个Producer，每条消息随机发送到某个Topic或者Queue)，持续时间**T1**，请注意把消息数据写入磁盘中
2. 强行kill Producer进程，未写入磁盘的消息都会丢失
3. 10~20个线程(位于同一进程中)独立调用Consumer收取消息(每个线程启动一个Consumer，attach到指定的Queue，不同的Consumer不会attach同一个Queue），验证消息顺序准确性，可靠性，消费持续的时间为**T2**，消费到的总消息数目为**N**
4. 以**N/(t1+t2)**来衡量性能

    PS：请仔细阅读本仓库内Demo代码，尤其是DemoTester

### 5.1 补充说明
1. 测试时，topic和queue的数目大约是100个(其中queue的数目与消费者线程数相等)；
2. 测试时，消息大小不会超过256K；
3. 可靠性是指，消息不能丢失，且消息的内容不能被篡改；在测试消费的时候，会对消息的body,headers,properties的内容进行校验；
4. header与properties中key和value都不会插入null或空值
5. 发送消息时，消息一定要写入磁盘，最简单的组织形式就是，一个topic或者queue一个文件，每条消息一行（这样做性能可能较低，请自行优化设计）

### 5.2 消息顺序的说明
顺序只针对单个topic或者queue，不同topic，不同queue，topic与queue之间都不用考虑顺序

消息产品的一个重要特性是顺序保证，也就是消息消费的顺序要与发送的时间顺序保持一致；在多发送端的情况下，保证全局顺序代价比较大，只要求各个发送端的顺序有保障即可；
举个例子P1发送M11,M12,M13，P2发送M21,M22,M23，在消费的时候，只要求保证  M11,M12,M13(M21,M22,M23)的顺序，也就是说，实际消费顺序为:    
M11,M21,M12,M13,M22,M23 正确；
M11,M21,M22,M12,M13,M23 正确；
M11,M13,M21,M22,M23,M12 错误，M12与M13的顺序颠倒了；  

## 6. 排名规则

在结果校验100%正确的前提下，按照N/(t1 + t2)从高到低来排名


## 7. 第二/三方库规约

* 仅允许依赖JavaSE 8 包含的lib
* 可以参考别人的实现，拷贝少量的代码
* 我们会对排名靠前的代码进行review，如果发现大量拷贝别人的代码，将扣分