本章讲述了如何基于Java设计聊天程序和时间管理程序,两个程序都是控制台程序。聊天程序相当于4.3节的GNU C++聊天程序;时间管理程序相当于4.4节的GNU C++程序。对于不同的程序设计语言而言,基于HLA/RTI设计仿真应用的方法都差不多,其关键在于RTI软件能否支持相应程序设计语言的开发,用户只需要关心一下调用接口即可,通过调用接口可以设计形式多样的程序。与C++调用接口的一个显著区别在于句柄和时间的表示,Java中的各种句柄全部用int表示,各类时间则用double表示。
本项目需要实现一个类似微信群或者QQ群聊天功能的Java程序,每个人发送的消息都能够被群里的其他人看到。
每条聊天信息应包含2个内容:聊天者昵称、聊天的一句话,这样接收者就会知道是谁在发言。“聊天者昵称”用name表示,“聊天的一句话”用sentence表示,两个都是字符串类型。因为HLA是面向对象的,发送的数据要么采用对象类,要么采用交互类。本项目可采用交互类,将name和sentence封装到一个名叫“chat”的交互类中,如下列伪代码所示。
class chat { //交互类
string name; //参数
string sentence; //参数
}
下面采用KY-OMT创建fed文件,相应的chat.fed文件已经在3.3.3中创建完成,将该文件保存到KY-RTI的bin目录。
本项目对时间没有特别要求,不需要采用HLA时间管理机制。
该程序由3个源文件组成:GlobalVariables.java、Chat.java、HwFederateAmbassador.java。GlobalVariables.java定义了其他两个文件需要用到的公用变量;Chat.java调用RTI服务访问RTI;HwFederateAmbassador.java接收RTI回调服务。
GlobalVariables.java定义了可由Chat.java、HwFederateAmbassador.java共享使用的静态变量;因为Java不支持C++的全局变量概念,这里的静态变量就相当于C++的全局变量。
表6.1 Java聊天示例:GlobalVariables.java
- public class GlobalVariables
- {
- public static int hChatClass;
- public static int hChatName;
- public static int hChatSentence;
- }
|
Chat.java代码说明:
21-25行:创建联邦执行;
27-33行:加入联邦执行;
36-38行:获取交互类及其参数句柄;
41行:公布交互类,只有公布之后才能够向RTI发送交互;
43行:订购交互类,只有订购之后才能够从RTI收到其他人的聊天内容;
46-59行:循环操作,每次输入一句话,并调用sendInteraction服务发送给RTI;当用户输入“exit”时则退出执行;
65行:该行为注释行,表示仿真成员在结束时不需要调用'resignFederationExecution'和 'destroyFederationExecution'服务,RTI服务器会自动执行这两个服务。
表6.2 Java聊天示例:Chat.java
- import MID.*;
- import RTI.*;
- public class Chat
- {
- public static void main(String[] args) {
- String federationName = "chat";
- String federateName = System.console().readLine("Please input your name: ");
- HwFederateAmbassador fed;
- RTI_RTIambassador rti;
- try {
- fed = new HwFederateAmbassador();
- rti = new RTI_RTIambassador();
- } catch(Exception ex) {
- ex.printStackTrace();
- return;
- }
- try {
- rti.createFederationExecution(federationName, "chat.fed");
- } catch(Exception ex) {
- // According to the HLA standard, only the first federate can call createFederationExecution successfully. Don't return.
- }
- try {
- int federateHandle = rti.joinFederationExecution(federateName, federationName, fed);
- //System.out.println("my federate handle is "+federateHandle);
- } catch(Exception ex) {
- ex.printStackTrace();
- return;
- }
- try {
- GlobalVariables.hChatClass = rti.getInteractionClassHandle("chat");
- GlobalVariables.hChatName = rti.getParameterHandle("name", GlobalVariables.hChatClass);
- GlobalVariables.hChatSentence = rti.getParameterHandle("sentence", GlobalVariables.hChatClass);
- //如果向外发送,则需要公布
- rti.publishInteractionClass(GlobalVariables.hChatClass);
- //如果需要接收,则必须订购
- rti.subscribeInteractionClass(GlobalVariables.hChatClass);
- String szSentence = "";
- while (!szSentence.equals("exit")) {
- szSentence = System.console().readLine("Please input a sentence: ");
- HandleValuePair[] theParameters = new HandleValuePair[2];
- theParameters[0] = new HandleValuePair();
- theParameters[0].aHandle = GlobalVariables.hChatName;
- theParameters[0].aValue = federateName; //int -> String
- theParameters[1] = new HandleValuePair();
- theParameters[1].aHandle = GlobalVariables.hChatSentence;
- theParameters[1].aValue = szSentence; //int -> String
- rti.sendInteraction(GlobalVariables.hChatClass, theParameters, "");
- }
- } catch (Exception ex) {
- ex.printStackTrace();
- return;
- }
- //After the program exits, the RTI will automatically calls 'resignFederationExecution' and 'destroyFederationExecution'.
- }
- }
|
HwFederateAmbassador.java代码说明:
5-8行:由于不处理时间参数,因此如果接收到这种类型的receiveInteraction交互,则直接调用不带时间参数的服务来统一处理;
10-28行:处理接收到的聊天信息,将其简单输出即可。
表6.3 Java聊天示例:HwFederateAmbassador.java
- import MID.*;
- public class HwFederateAmbassador extends RTIFederateAmbassador
- {
- public final void receiveInteraction(int theInteraction, MID.HandleValuePair[] theParameters, double theTime, String theTag, MID.EventRetractionHandle theHandle) {
- //call the next service.
- receiveInteraction(theInteraction, theParameters, theTag);
- }
- public final void receiveInteraction(int theInteraction, MID.HandleValuePair[] theParameters, String theTag) {
- String name = new String(); //name of sender
- String sentence = new String(); //sentence of sender
- for ( int i = 0; i < theParameters.length; i++ ) {
- if (theParameters[i].aHandle == GlobalVariables.hChatName) {
- name = theParameters[i].aValue;
- } else if (theParameters[i].aHandle == GlobalVariables.hChatSentence) {
- sentence = theParameters[i].aValue;
- } else {
- System.out.println("Receive wrong parameter handle.");
- }
- }
- System.out.println();
- System.out.println(name + ": " + sentence);
- }
- }
|
编译Java程序,只要将kyrti.jar文件加入到CLASSPATH环境变量,或者在编译时作为命令参数添加。
(1)如果在CLASSPATH环境变量中已经设置,则编译命令如下。
javac *.java
(2)在编译时作为参数添加,则编译命令如下。
javac -classpath .;C:\KY-RTI\jar\ky-rti.jar *.java #Windows
javac -classpath .:/home/lbq/RTI-1.3NGv6/Linux-x86_64-opt-mt/jar/ky-rti.jar *.java #Linux
测试项目:在银河麒麟操作系统上运行2个Java仿真成员,测试KY-RTI通信功能。
测试步骤:
第1步:修改RTI.rid,关闭tick开关。
因为本程序没有使用tick服务,所以需要关闭tick开关。
查看当前目录下是否存在RTI.rid,若没有则在运行程序之后会自动生成该文件。将RTI.rid文件中的“;; UsingTickSwitch On”改为“;; UsingTickSwitch Off”。
第2步:启动KY-RTI控制台。注意,bin目录中configure.rti的IP地址和端口号,要与仿真程序目录中的RTI.rid一致。
第3步:如图6.1和图6.2所示,开启两个终端,运行2个仿真成员,开始仿真。运行命令:
java Chat
测试结果表明:Java仿真成员的聊天功能正常,KY-RTI支持中英文传输。
图6.1 Java聊天者1
图6.2 Java聊天者2
6.2 时间管理程序
本仿真项目的名称为“TimeManagementExample”,名称规定了不是“TimeManagementExample”的程序不属于本项目。对HLA/RTI程序来说,联邦名称为“TimeManagementExample”,不是该名字的仿真成员不属于本项目。
每个仿真成员拥有3架飞机,但其中只有1架飞机会起飞,飞机的x、y坐标为随机数(不考虑合理性),飞机会每隔1秒发布自己的位置信息。
飞机每隔1秒发布自己的位置信息,意味着该仿真应采用时间管理服务,仿真步长为1。
飞机发送的是自己的x、y二维态势信息,用一个对象类plane来封装,两个属性为xPos和yPos,类型为整型;但不管什么类型,在RTI中都是作为字符串来传送。如下列代码所示。
class plane { //对象类
int xPos; //属性
int yPos; //属性
}
下面采用KY-OMT创建fed文件,相应的tracer.fed文件已经在3.3.2中创建完成,将该文件保存到KY-RTI的bin目录。
该程序由3个源文件组成:GlobalVariables.java、TimeManagement.java、HwFederateAmbassador.java。GlobalVariables.java定义了其他两个文件需要用到的公用变量;Chat.java调用RTI服务访问RTI;HwFederateAmbassador.java接收RTI回调服务。
GlobalVariables.java定义了可由TimeManagement.java、HwFederateAmbassador.java共享使用的静态变量;因为Java不支持C++的全局变量概念,这里的静态变量就相当于C++的全局变量。
表6.4 Java时间管理示例:GlobalVariables.java
- public class GlobalVariables
- {
- public static double g_currentTime = 0.0;
- public static double g_lookahead = 1.0;
- public static boolean g_bConstrained = false;
- public static boolean g_bRegulation = false;
- public static boolean g_granted = false;
- public static int g_hxPos;
- public static int g_hyPos;
- //3 planes
- public static int g_hInstance1, g_hInstance2, g_hInstance3;
- }
|
TimeManagement.java代码说明:
7行:联邦名称定义为“TimeManagementExample”;
21-26行:创建联邦执行;
28-34行:加入联邦执行;
37-39行:获取对象类及其属性句柄;
45行:公布对象类属性,只有公布之后才能够向RTI发送二维态势信息,即xPos和yPos;
46行:订购交互类属性,只有订购之后才能够从RTI收到二维态势信息;
48-53行:注册3架飞机;
60行:将仿真成员设置为时间管理受限的;
61-63行:等待RTI同意将该仿真成员设置为时间管理受限的;
65行:将仿真成员设置为时间管控成员;
66-68行:等待RTI同意将该仿真成员设置为时间管控成员;
70行:打开异步消息开关;
77行:仿真周期设置为1秒;这里的逻辑时间1对应物理时间的1秒(假设设置为2,则1个逻辑时间单位对应物理时间的0.5秒,2个逻辑时间单位对应仿真周期1秒);
83-167行:每隔1秒循环推进仿真,直到中断退出仿真;
100行:发送飞机在下一时刻的二维态势信息(如果采用RO消息也可以发送当前时刻的态势,当前或下一步信息依项目要求来抉择);
131行:将仿真请求推进到下一步;
132-134行:等待RTI同意该仿真成员推进到下一步;
169行:该行为注释行,表示仿真成员在结束时不需要调用'resignFederationExecution'和 'destroyFederationExecution'服务,RTI服务器会自动执行这两个服务。
表6.5 Java时间管理示例:TimeManagement.java
- import MID.*;
- import RTI.*;
- public class TimeManagement
- {
- public static void main(String[] args) {
- String federationName = "TimeManagementExample";
- String federateName = System.console().readLine("Please input the federate name: ");
- HwFederateAmbassador fed;
- RTI_RTIambassador rti;
- try {
- fed = new HwFederateAmbassador();
- rti = new RTI_RTIambassador();
- } catch(Exception ex) {
- ex.printStackTrace();
- return;
- }
- try {
- rti.createFederationExecution(federationName, "tracer.fed");
- } catch(Exception ex) {
- // According to the HLA standard, only the first federate can call createFederationExecution successfully. Don't return.
- ex.printStackTrace();
- }
- try {
- int federateHandle = rti.joinFederationExecution(federateName, federationName, fed);
- System.out.println("my federate handle is "+federateHandle);
- } catch(Exception ex) {
- ex.printStackTrace();
- return;
- }
- try {
- int hPlaneClass = rti.getObjectClassHandle("plane");
- GlobalVariables.g_hxPos = rti.getAttributeHandle("xPos", hPlaneClass); //different from p1516
- GlobalVariables.g_hyPos = rti.getAttributeHandle("yPos", hPlaneClass); //different from p1516
- int[] theAttributes = new int[2];
- theAttributes[0] = GlobalVariables.g_hxPos;
- theAttributes[1] = GlobalVariables.g_hyPos;
- rti.publishObjectClass(hPlaneClass, theAttributes);
- rti.subscribeObjectClassAttributes(hPlaneClass, theAttributes);
- //register one plane
- GlobalVariables.g_hInstance1 = rti.registerObjectInstance(hPlaneClass);
- //register 2nd plane
- GlobalVariables.g_hInstance2 = rti.registerObjectInstance(hPlaneClass);
- //register 3rd plane
- GlobalVariables.g_hInstance3 = rti.registerObjectInstance(hPlaneClass);
- } catch (Exception ex) {
- ex.printStackTrace();
- return;
- }
- try {
- rti.enableTimeConstrained();
- while(!GlobalVariables.g_bConstrained) {
- Thread.sleep(1); //1 millisecond
- }
- rti.enableTimeRegulation(0.0, GlobalVariables.g_lookahead);
- while(!GlobalVariables.g_bRegulation) {
- Thread.sleep(1); //1 millisecond
- }
- rti.enableAsynchronousDelivery();
- } catch (Exception ex) {
- ex.printStackTrace();
- return;
- }
- double targetTime = GlobalVariables.g_currentTime;
- double intervalTime = 1;
- int xPos, yPos;
- String tag = "F15";
- int step = 0;
- java.util.Random r = new java.util.Random(); //get a random number
- while(true) {
- step++;
- System.out.println("Step: "+step);
- xPos=r.nextInt();
- yPos=r.nextInt();
- HandleValuePair[] theAttributeValues = new HandleValuePair[2];
- theAttributeValues[0] = new HandleValuePair();
- theAttributeValues[0].aHandle = GlobalVariables.g_hxPos;
- theAttributeValues[0].aValue = String.valueOf(xPos); //int -> String
- theAttributeValues[1] = new HandleValuePair();
- theAttributeValues[1].aHandle = GlobalVariables.g_hyPos;
- theAttributeValues[1].aValue = String.valueOf(yPos); //int -> String
- try {
- rti.updateAttributeValues(GlobalVariables.g_hInstance1, theAttributeValues, GlobalVariables.g_currentTime + GlobalVariables.g_lookahead, tag);
- } catch(RTI.ObjectNotKnown ex) {
- ex.printStackTrace();
- return;
- } catch(RTI.AttributeNotDefined ex) {
- ex.printStackTrace();
- return;
- } catch(RTI.AttributeNotOwned ex) {
- ex.printStackTrace();
- return;
- } catch(RTI.InvalidFederationTime ex) {
- ex.printStackTrace();
- return;
- } catch(RTI.FederateNotExecutionMember ex) {
- ex.printStackTrace();
- return;
- } catch(RTI.SaveInProgress ex) {
- ex.printStackTrace();
- return;
- } catch(RTI.RestoreInProgress ex) {
- ex.printStackTrace();
- return;
- } catch(Exception ex) {
- ex.printStackTrace();
- return;
- }
- targetTime = GlobalVariables.g_currentTime + intervalTime;
- System.out.println("This federate will advance to "+targetTime);
- try {
- rti.timeAdvanceRequest(targetTime);
- while(!GlobalVariables.g_granted) {
- Thread.sleep(1);//1 millisecond
- }
- GlobalVariables.g_granted = false;
- System.out.println("The federate has advanced to "+GlobalVariables.g_currentTime);
- System.out.println();
- } catch(RTI.InvalidFederationTime ex) {
- ex.printStackTrace();
- return;
- } catch(RTI.FederationTimeAlreadyPassed ex) {
- ex.printStackTrace();
- return;
- } catch(RTI.TimeAdvanceAlreadyInProgress ex) {
- ex.printStackTrace();
- return;
- } catch(RTI.EnableTimeRegulationPending ex) {
- ex.printStackTrace();
- return;
- } catch(RTI.EnableTimeConstrainedPending ex) {
- ex.printStackTrace();
- return;
- } catch(RTI.FederateNotExecutionMember ex) {
- ex.printStackTrace();
- return;
- } catch(RTI.SaveInProgress ex) {
- ex.printStackTrace();
- return;
- } catch(RTI.RestoreInProgress ex) {
- ex.printStackTrace();
- return;
- } catch (Exception ex) {
- ex.printStackTrace();
- return;
- }
- }
- //After the program exits, the RTI will automatically calls 'resignFederationExecution' and 'destroyFederationExecution'.
- }
- }
|
HwFederateAmbassador.java代码说明:
5-7行:将发现的飞机输出到终端;
9-33行:将收到的飞机态势信息输出到终端;
35-39行:RTI同意将仿真成员设置为时间管控成员;
41-45行:RTI同意将仿真成员设置为时间管理受限的成员;
47-51行:RTI同意仿真成员推进到下一步。
表6.6 Java时间管理示例:HwFederateAmbassador.java
- import MID.*;
- public class HwFederateAmbassador extends RTIFederateAmbassador
- {
- public final void discoverObjectInstance(int theObject, int theObjectClass, String theObjectName) {
- System.out.println("discoverObjectInstance: "+theObject+","+theObjectClass+","+theObjectName);
- }
- public final void reflectAttributeValues(int theObject, HandleValuePair[] theAttributes, double theTime, String theTag, MID.EventRetractionHandle theHandle) {
- //call the next service.
- reflectAttributeValues(theObject, theAttributes, theTag);
- }
- public final void reflectAttributeValues(int theObject, MID.HandleValuePair[] theAttributes, String theTag) {
- System.out.println("reflectAttributeValues: " + theObject);
- String value = new String();
- for (int i = 0; i < theAttributes.length; ++i) {
- if (theAttributes[i].aHandle == GlobalVariables.g_hxPos) {
- value = theAttributes[i].aValue;
- } else if (theAttributes[i].aHandle == GlobalVariables.g_hyPos) {
- value = theAttributes[i].aValue;
- } else {
- System.out.println("Receive wrong parameter handle.");
- }
- System.out.println(" <"+theAttributes[i].aHandle+","+value+">");
- }
- System.out.println(" tag:" + theTag);
- }
- public final void timeRegulationEnabled(double theFederateTime) {
- GlobalVariables.g_currentTime = theFederateTime;
- GlobalVariables.g_bRegulation = true;
- System.out.println("timeRegulationEnabled: " + theFederateTime);
- }
- public final void timeConstrainedEnabled(double theFederateTime) {
- GlobalVariables.g_currentTime = theFederateTime;
- GlobalVariables.g_bConstrained = true;
- System.out.println("timeRegulationEnabled: " + theFederateTime);
- }
- public final void timeAdvanceGrant(double theTime) {
- GlobalVariables.g_currentTime = theTime;
- GlobalVariables.g_granted = true;
- System.out.println("timeAdvanceGrant: " + theTime);
- }
|
编译方法参照6.1.4.1执行,生成可执行程序之后就可以进行测试。
测试项目:在银河麒麟操作系统上运行2个Java仿真成员,两个仿真成员启动后尽可能快地向前推进;测试KY-RTI的HLA的基本服务功能,特别是时间管理同步功能。
测试步骤:
第1步:修改RTI.rid,关闭tick开关。
因为本程序没有使用tick服务,所以需要关闭tick开关。
查看当前目录下是否存在RTI.rid,若没有则在运行程序之后会自动生成该文件。将RTI.rid文件中的“;; UsingTickSwitch On”改为“;; UsingTickSwitch Off”。
第2步:启动KY-RTI控制台。注意,bin目录中configure.rti的IP地址和端口号,要与仿真程序目录中的RTI.rid一致。
第3步:如图6.3和图6.4所示,开启两个终端,运行2个Java仿真成员,开始仿真。运行命令:
java TimeManagement
测试结果表明:KY-RTI支持基于麒麟操作系统的Java仿真技术,时间管理同步功能强。
测试说明:
(1)图6.3是仿真成员“Air01”被Ctrl+C中断执行时的界面。此时,它能收到仿真成员“Air02”发送的二维态势信息。
(2)图6.4是仿真成员“Air02”被Ctrl+C中断执行时的界面。此时,只显示它自己的运行信息,不会有其他仿真成员的二维态势信息。
图6.3 使用时间管理服务的HLA仿真成员Air01
图6.4 使用时间管理服务的HLA仿真成员Air02
KY-RTI的Linux、Windows版本和源码请联系作者:walt_lbq@163.com
KY-RTI分布仿真技术:前 言
KY-RTI分布仿真技术:第一章 简介
KY-RTI分布仿真技术:第二章 系统安装
KY-RTI分布仿真技术:第三章 KY-OMT对象模型模板工具
KY-RTI分布仿真技术:第四章 C++程序设计
KY-RTI分布仿真技术:第五章 Qt程序设计
KY-RTI分布仿真技术:第六章 Java程序设计
KY-RTI分布仿真技术:第七章 Visual C++程序设计
KY-RTI分布仿真技术:第八章 Visual C#程序设计
KY-RTI分布仿真技术:第九章 综合演示
KY-RTI分布仿真技术:第十章 Python程序设计
KY-RTI分布仿真技术:附录1 分组聊天(HLA数据分发管理的应用)
KY-RTI分布仿真技术:附录2 大联邦(构建1000个成员的HLA/RTI仿真系统)
KY-RTI分布仿真技术:附录3 国产化(操作系统+CPUs)