消息

从概念上讲，消息机制和邮箱机制很类似，区别在于邮箱一般只能容纳一条消息，而消息则会包含一系列的消息。

系统定义了一个全局变量g_msgctr_header，通过它可以查找到任一已创建的消息容器。
每一个消息容器都可以根据其参数性质（1VS1：1对1的消息通信、1VSn：1对多的消息通信、nVSn：多对多的消息通信、nVS1等）来实现不同的通信方式。

这里的消息容器，只是一个线程间的通信结构acoral_msgctr_t，是消息的存储容器，一个消息容器可以通过它的消息链指针成员，挂载多条消息结构。
而消息结构是消息的容器，一个消息结构包含一条消息。

aCoral并没有采用数组之间存储消息指针的经典实现形式，而是在消息上又包装了一层结构，这样的实现是为了功能上的扩展，只要稍作改进，就可以实现消息功能的进一步增加，如消息最大生存时间，一次唤醒多个等待线程等功能。

//消息容器
typedef struct
{
	acoral_res_t res; //消息容器也是资源
	char *name;
	acoral_list_t msgctr_list;//全局消息容器的挂载钩子
	unsigned int count; //消息数量
	unsigned int wait_thread_num; //等待线程数
	acoral_list_t waiting; //等待线程指针链
	acoral_list_t msglist;//消息指针链，用于挂载消息
}acoral_msgctr_t;

//消息
typedef struct
{
	acoral_res_t res;
	acoral_list_t msglist; //挂载钩子成员，用于将消息结构挂载到消息容器上
	unsigned int id; //消息标识，用于区分一个消息容器不同消息结构类型的成员，通过它可以实现1VSn的结构。
	unsigned int count;//消息被接收次数，每接受一次减一，直到0为止。通过它可以实现一次发送，多次接收的功能。
	unsigned int ttl;//消息最大生存周期，当一个消息生存周期到时，将自动删除，不可以再被接收。
	void *data; //消息指针
}acoral_msg_t;

如何创建消息容器，以供线程间传递数据使用。

acoral_msgctr_t *acoral_msgctr_create()
{
	acoral_msgctr_t *msgctr;
	msgctr = acoral_alloc_msgctr();//申请一片内存空间，分配的方式和过程与线程TCB的分配类似，即从内存资源池中获取一个资源对象供消息容器acoral_msgctr_t使：return (acoral_msgctr_t *)acoral_get_res(&acoral_msgctr_pool_ctrl);
	if(msgctr == NULL)
		return NULL;
	msgctr->name = NULL;
	msgctr->count = 0;
	msgctr->wait_thread_num = 0;
	
	acoral_init_list(&msgctr->msgctr_list);
	acoral_init_list(&msgctr->msglist);
	acoral_init_list(&msgctr->waiting);

	acoral_list_add2_tail(&msgctr->msgctr_list, &(g_msgctr_header));
	return msgctr;
}

创建消息，前面提到，消息容器并不直接包含消息，在消息容器之下，还有一层消息结构因而消息的创建，即是先创建消息结构，再将消息挂到消息结构的过程。

acoral_msg_t *acoral_msg_create(unsigned int count,unsigned int id, unsigned int nTtl, void *data)
{
	acoral_msg_t *msg;
	msg = acoral_alloc_msg();
	if(msg == NULL)
		return NULL;
	msg->id = id;
	msg->count = count;
	msg->ttl = nTtl;
	msg->data = data;
	acoral_init_list(&msg->msglist);
}

一个消息的创建接口需要五个参数：消息被接收次数、错误码、消息ID、生存周期和消息指针（指向被发送的消息）。

其中前三个参数都是为了扩展而引入的，aCoral只提供了接口和基本实现，但并未在消息传递具体过程中使用，如果需要进行扩展，只需要简单更改源代码即可，用于功能的扩充。

发送消息：aCoral消息发送是需要先前创建的消息容器队列和消息队列。消息发送时，首先将包含消息的消息结构挂到消息容器的消息链上，然后判断是否有等待的线程，如果有的话，则唤醒最高优先级的线程。

unsigned int acoral_msg_send(acoral_msgctr_t *msgctr, acoral_msg_t *msg)
{
	acoral_enter_critical();
	if (NULL == msgctr)
	{
		acoral_exit_critical();
		return MST_ERR_NULL;
	}

	if (NULL == msg)
	{
		acoral_exit_critical();
		return MSG_ERR_NULL;
	}
	//消息数限制
	if(ACORAL_MESSAGE_MAX_COUNT <= msgctr->count)
	{
		acoral_exit_critical();
		return MSG_ERR_COUNT;
	}
	//增加消息
	msgctr->count++;
	msg->ttl += acoral_get_ticks();
	acoral_list_add2_tail(&msg->msglist, &msgctr->msglist);

	//唤醒等待
	if(msgctr->wait_thread_num > 0)
	{
		wake_up_thread(&msgctr->wiating);
		msgctr->wait_thread_num--;
	}
	acoral_exit_critical();
	acoral_sched();
	return MSGCTR_SUCCED;
}