CloudSim源代码之SimEntity.doc

package org.cloudbus.cloudsim.core; import org.cloudbus.cloudsim.Log; import org.cloudbus.cloudsim.NetworkTopology; import org.cloudbus.cloudsim.core.predicates.Predicate; /**仿真实体 * This class represents a simulation entity. An entity handles events and can * send events to other entities. When this class is extended, there are a few * methods that need to be implemented: * ul * li 【{@link #startEntity()}】 is invoked by the {@link Simulation} class when * the simulation is started. This method should be responsible for starting the * entity up. * li 【{@link #processEvent(SimEvent)}】 is invoked by the {@link Simulation} * class whenever there is an event in the deferred queue, which needs to be * processed by the entity. * li 【{@link #shutdownEntity()}】 is invoked by the {@link Simulation} before the * simulation finishes. If you want to save data in log files this is the method * in which the corresponding code would be placed. * /ul * * @author Marcos Dias de Assuncao * @since CloudSim Toolkit 1.0 */ public abstract class SimEntity implements Cloneable { /** The name. 名称*/ private String name; /** The id. 编号*/ private int id; /** The buffer for selected incoming events. 选定将来临的事件缓冲*/ private SimEvent evbuf; /** The entitys current state. 实体现在状态*/ private int state; /**【创建新实体】 * Creates a new entity. * * @param name the name to be associated with this entity */ public SimEntity(String name) { if (name.indexOf( ) != -1) { throw new IllegalArgumentException( Entity names cant contain spaces.); } this.name = name; id = -1; state = RUNNABLE;//运行 CloudSim.addEntity(this); } /**实体名 * Get the name of this entity. * * @return The entitys name */ public String getName() { return name; } /**分配给实体的ID号 * Get the unique id number assigned to this entity. * * @return The id number */ public int getId() { return id; } // The schedule functions 【调度函数】 /** * Send an event to another entity by id