MOOON-server新消息处理接口

    MOOON-server提供了一个通用的TCP框架，并对包的解析抽象出了IPacketHandler接口，这个接口提供了无限制的宽容度，支持任何协议，但是增加了使用复杂。

    由于大多数协议，都会定义一个消息包大小字段，基于这个前提，MOOON-server引用了新的接口IMessageObserver，它能够解析任何包头是net::TCommonMessageHeader的消息，在一个包解析完整后(包括包头和包体都已经接收完成)，通过回调on_message()将消息传递给使用者，这样就大大简化了MOOON-server的编程。

下面是接口的定义：

点击(此处)折叠或打开

1. /***
   
2.   * 消息观察者
   
3.   * 收到一个完整的消息时调用
   
4.   * 如果你的消息头和net::TCommonMessageHeader一致，
   
5.   * 则建议使用IMessageObserver，而不是IPacketHandler,
   
6.   * IMessageObserver相对于IPacketHandler是更高级别的接口
   
7.   */
   
8. class CALLBACK_INTERFACE IMessageObserver
   
9. {
   
10. public:
    
11.     virtual ~IMessageObserver() {}
    
12. 
    
13.     /***
    
14.       * 收到一个完整消息时被回调
    
15.       * @request_header 输入参数，收到的消息头
    
16.       * @request_body 输入参数，收到的消息体
    
18.      *  这里需要注意，框架不会释放request_body的内存，需要使用者去释放
19.       *  释放方法为：delete []request_body;，否则将有内存泄漏
20.       * @response_buffer 输出参数，发送给对端的响应，默认值为NULL
    
21.       * 请注意*response_buffer必须是new char[]出来的，
    
22.       * 并且将由框架delete []它
    
23.       * @response_size 输出参数，需要发送给对端的响应数据字节数，默认值为0
    
24.       * @return 处理成功返回true，否则返回false
    
25.       */
    
26.     virtual bool on_message(const net::TCommonMessageHeader& request_header
    
27.                           , const char* request_body
    
28.                           , char** response_buffer
    
29.                           , size_t* response_sizer) = 0;
    
30. 
    
31.     /***
    
32.       * 连接被关闭
    
33.       */
    
34.     virtual void on_connection_closed()
    
35.     {
    
36.     }
    
37. 
    
38.     /***
    
39.       * 连接超时
    
40.       * @return 如果返回true，确认是连接超时，连接将被关闭
    
41.       * ；否则表示并未超时，连接会继续使用，同时时间戳会被更新
    
42.       */
    
43.     virtual bool on_connection_timeout()
    
44.     {
    
45.         return true;
    
46.     }
    
47. 
    
48.     /***
    
49.      * 包发送完后被回调
    
50.      * @return util::handle_continue 表示不关闭连接继续使用，
    
51.      * 返回其它值则会关闭连接
    
52.      */
    
53.     virtual util::handle_result_t on_response_completed()
    
54.     {
    
55.         //return util::handle_close; // 短连接时
    
56.         return util::handle_continue; // 长连接时
    
57.     }
    
58. };