ui包中的类及代码分析

ui包（user interface）
Contains superclass for all user interfaces and a simple user interface(s).
包含所有用户接口的父类和一个简单用户接口



ui.DTNSimUI
功能：所有用户接口的抽象父类，也包含一些仿真设置（Abstract superclass for user interfaces; contains also some simulation settings.）

public abstract class DTNSimUI

outline：



意义
：
属性
public static final String NROF_REPORT_S = "Report.nrofReports";
//Number of reports（报告数量）
public static final String REPORT_S = "Report.report";
//Report class name（报告类名称）（注）Must be suffixed with numbers starting from one.

public static final String MM_WARMUP_S = movement.MovementModel.MOVEMENT_MODEL_NS + ".warmup"
//Movement model warmup time(移动模型准备时间)Defines how many seconds of movement simulation is run without connectivity etc

private static final String REPORT_PAC = "report.";
//report class' package name(报告类的包的名字)

protected World world;
//The World where all actors of the simulator are（所模拟的世界）
protected Vector<Report> reports;
//Reports that are loaded for this simulation（从模拟中获取的报告）
protected boolean simDone； //has simulation terminated normally（仿真是否正常结束）

protected boolean simCancelled; //is simulation termination requested（仿真是否求终止）

protected SimScenario scen;
//Scenario of the current simulation（正在模拟的场景）
protected double lastUpdate; //simtime of last UI update（上次更新的仿真时间）

方法
public DTNSimUI() //Constructor
public void start() //Starts the simulation(调用initModel()
和runSim()， 仿真开始
)
protected abstract void runSim();
//Runs simulation after the model has been initialized.
private void initModel() //Initializes the simulator model.（初始化移动模型）

从core.SimScenario
获得运行模拟的实例，添加多个报告（调用addReport() ），并设置模拟世界的warmupTime
。设置报错机制。

for (int i=1, n = settings.getInt(NROF_REPORT_S); i<=n; i++){

String reportClass = settings.getSetting(REPORT_S + i);

addReport((Report)settings.createObject(REPORT_PAC +

reportClass));
即所需报告的报的名字+报告类的名称class

}

public void done() //Runs maintenance jobs that are needed before exiting运行结束前所需的维护工作

public void done() {
for (Report r : this.reports) {

r.done(); //Called when the simulation is done, user requested premature termination or intervalled report generating decided that it's time for the next report.

}
}

protected void addReport(Report r) //Adds a new report for simulator(为仿真增加报告)先判断所需报告类是哪种实例，相应为所有节点增加 listener

this.reports.add(r)

类型：MessageListener，ConnectionListener， MovementListener，UpdateListener， ApplicationListener

ui.DTNSimTextUI
功能：简单的基于text的用户接口（Simple text-based user interface），是DTNSimUI 的子类

public class DTNSimTextUI extends DTNSimUI

outline：



意义
：
属性
private --- lastUpdateRt：上一次ui更新的时间（real time of last ui update）
startTime：模拟开始时间（simulation start time）
public static --- UI_UP_INTERVAL：ui多长时间更新一次（How often the UI view is updated (milliseconds)）

方法：
protected void runSim() //覆写
print("Running simulation '" + scen.getName()+"'");

在仿真时间内，更新世界内所有节点。
double duration = (System.currentTimeMillis() - startTime)/1000.0
//持续时间
this.update(true);
//调用update（）强制更新
print("Simulation done in " + String.format("%.2f", duration) + "s");

private void update（boolean forced） //Updates user interface if the long enough (real)time (update interval) has passed from the previous update(更新用户接口)

ssps = ((SimClock.getTime() - lastUpdate)*1000) / diff;
//simulated seconds/second calc

print(String.format("%.1f %d: %.2f 1/s", dur,

SimClock.getIntTime(),ssps));

private void print(String txt) // 打印txt