omnet++：cMessage、cSimpleModule、cGate

cMessage

Message可以被调度（self-message）、取消、从一个Gate发送出去、直接发给另一个module；所有以上，都是通过cSimpleModule来实现的。

Message在创建时可以指定名字，其它信息包括消息类型、优先级、时间戳。控制信息字段允许我们使用模型模拟协议层间的通信。context pointer字段允许我们在同一时间是用多个计时器。一个Message中也存储了关于该消息的最后一次发送的信息，例如发送时间、到达时间、到达的module和gate。

isSelfMessage可以帮助我们区分self-message和来自其他节点的消息。

如果需要一些更多的字段，可以通过msg文件创建一个Message，它会自动继承cMessage的相关方法。

方法（msg->xxx()）	说明
setName(const char *)	设置消息名
const char * getName()	返回消息名
dup()	返回消息的副本； cMessage * copy = msg->dup();
int getSenderModuleId()	获得发送该消息的Module的ID
int getSenderGateId()	获得发送该消息的Gate的ID
int getArrivalModuleId()	获得该消息将要到达的Module的ID
int getArrivalGateId()	获取该消息将要到达的Gate的ID
bool isSelfMessage()	判断消息是否是SelfMessage
cModule  * getSenderModule()	获取指向发送该消息Module的指针

cGate * getSenderGate()	返回一个指针，指向该消息上一次发送时的gate
cModule * getArrivalModule()	返回指向该消息到达Module的指针
cGate * getArrivalGate（）	返回一个指针，指向该消息从哪个Gate到达
bool arrivedOn(int gateId) bool arrivedOn(char * gateName , int gateIndex)	如果该消息通过给定的gate到达了，就返回true
long getId()	获取消息ID
virtual const char * getDisplayString()	展示消息在运行时的显示String
void setArrival(int moduleId,int gateId)	定制调度器，直接由调度器设置消息要到达的模块和Gate

cModule

cModule是cSimpleModule的父类，cSimpleModuel在cModule的基础上添加了许多方法。

方法	说明
virtual void setName(const char * s)	给Module命名
virtual const char * getFullName()	返回Module的全名，格式为：module名[i]
virtual string getFullPath()	返回Module的路径，格式为：网络名.vector名.mudule名[i]
virtual string str()	重写该方法以添加module ID
virtual cModule * getParentModule() const	返回该Module的父Module，具体分级可以通过getFullPath()方法得到
int getIndex()	获得该module在vector中的索引
getVectorSize()	获得该module所在vector的大小
virtual cModule * getSubmodule(const char * name,int index=-1)	返回指向 通过名字和索引指定 的Module
virtual cModule * getModuleByPath(const char * path)	返回通过 module路径指定的Module 的指针
virtual int gateSize(const char * gatename)	返回gate vector的size
virtual void arrived(cMessage * msg , cGate * ongate , simtime_t)	与send()方法相对应的方法，不过是在另一个Module中调用的。
virtual cCanvas *getCanvas()	返回这个Module的默认canvas

cSimpleModule

主要方法有四个initialize()、handleMessage(cMessage * msg)、finish()

initialize()：omnet++在创建一个Module时调用该方法。

handleMessage(cMessage * msg)：当Module收到一个Message时调用该方法。

我们可以使用send()方法向另一个Module发送消息，或者使用scheduleAt()和cancelEvent()方法来部署延迟、计时器、超时。

finish()函数当仿真成功结束时被调用。该方法的经典用法是记录下载仿真过程中的统计信息。

方法	说明
virtual void setName(const char * s)	给Module命名
virtual const char * getFullName()	返回Module的全名，格式为：module名[i]
virtual string getFullPath()	返回Module的路径，格式为：网络名.vector名.mudule名[i]
virtual string str()	重写该方法以添加module ID
virtual cModule * getParentModule() const	返回该Module的父Module，具体分级可以通过getFullPath()方法得到
int getIndex()	获得该module在vector中的索引
getVectorSize()	获得该module所在vector的大小
virtual cModule * getSubmodule(const char * name,int index=-1)	返回指向 通过名字和索引指定 的Module
virtual cModule * getModuleByPath(const char * path)	返回通过 module路径指定的Module 的指针
virtual int gateSize(const char * gatename)	返回gate vector的size
virtual void arrived(cMessage * msg , cGate * ongate , simtime_t)	与send()方法相对应的方法，不过是在另一个Module中调用的。
virtual cCanvas *getCanvas()	返回这个Module的默认canvas

virtual void handleMessage(cMessage * msg)	消息处理函数，当有消息到达时被调用
virtual void send( cMessage * msg , const char *gatename , int gateindex=-1)	从指定gate把消息发送出去
virtual sendDelayed(cMessage * msg, simtime_t delay,const char * gatename , int gateindex=-1 )	延迟delay秒后把消息发送出去
void sendDirect(cMessage * msg,simtime_t propagation Delay,simtime_t duration,cModule * mod,const char * inputGateName , int gateindex=-1)	直接把一个消息发送到其他Module，
void scheduleAt(simtime_t t,cMessage * msg)	发送一个self-message
cMessage * cancelEvent(cMessage * msg)	移除一个消息。常用于我们之前用scheduleAt()部署的消息，用来取消一个计时器
void cancelAndDelete(cMessage * msg)	对msg调用cancelEvent()，之后删除它。该方法常用于SimpleModule的析构函数中，用于销毁self-message
void wait(simtime_t time)	等待一段时间。 只用于我们不希望其他消息在这段时间内到达的时候。

cGate

代表了一个Module的gate。

cGate对象被Module创建并管理，使用者通常不会直接创建和销毁cGate。

const char * getName()	返回gate的名字，不包含索引
const char * getFullName()	返回gate的全名，包含索引
cObject * getOwner()	返回gate的所属Module
cModule * getOwnerModule()	指向gate所属Module
int getIndex()	返回gate的索引号
int getVectorSize()	返回gate vector的size
cGate * getPreviousGate()	指向与这个gate相连接的上一个gate
cGate * getNextGate()	指向与这个Gate相连接的下一个Gate