1 package iotruntime.master;
3 import java.util.ArrayList;
4 import java.util.HashMap;
5 import java.util.HashSet;
8 import java.util.Random;
11 /** Class CommunicationHandler is a class that maintains
12 * a data structure that preserves a collection of host name,
13 * port numbers, and objects that are running
14 * +-----------------+----+--------+------------------+--------------+----------------+
15 * | HOST-ADDRESS | ...|IN-PORT | RMIREGISTRY-PORT | RMISTUB-PORT | ACTIVE OBJECTS |
16 * +-----------------+----+--------+------------------+--------------+----------------+
17 * | XXX.XXX.XXX.XXX | | XXXXX | XXXXX | XXXXX | XXXXXXXXXXXXXX |
18 * | | | XXXXX | XXXXX | XXXXX | XXXXXXXXXXXXXX |
19 * | | | XXXXX | XXXXX | XXXXX | XXXXXXXXXXXXXX |
20 * | | ...| ... | ... | ... | ... |
21 * +-----------------+----+--------+------------------+--------------+----------------+
22 * In this case we use ACTIVE OBJECTS names as the key
23 * So ACTIVE OBJECTS maps to numbers and these numbers map to each other
24 * entry in hashmaps (HostAddress can be repetitive)
25 * e.g. ACTIVE OBJECTS ProximitySensorPS0 - 0
26 * ProximitySensorPS1 - 1
29 * IN-PORT / RMIREGISTRY-PORT / RMISTUB-PORT / HOST-ADDRESS: 0 - XXXXX
40 * We add a Set structure to handle all the other ports that are used by devices
41 * when communicating with their respective drivers
43 * @author Rahmadi Trimananda <rahmadi.trimananda @ uci.edu>
47 public final class CommunicationHandler {
50 * CommunicationHandler class properties
52 * Random, host name, port number, active objects
53 * HostAdd is the key to the table so we use it
54 * as a key to elements
55 * HostList gives a mapping from hostname to list of objects
57 private Random random;
58 private List<String> listActiveControllerObj;
59 private List<String> listFieldObjectID;
60 private List<ObjectCreationInfo> listObjCrtInfo;
61 private List<Object[]> listArrFieldValues;
62 private List<Class[]> listArrFieldClasses;
63 private Map<String, Integer> hmActiveObj;
64 private Map<Integer, String> hmHostAdd;
65 private Map<String, ArrayList<String> > hmHostList;
66 private Map<Integer, Integer> hmComPort;
67 private Map<Integer, Integer> hmRMIRegPort;
68 private Map<Integer, Integer> hmRMIStubPort;
69 private Set<Integer> hsDevicePort;
70 private Map<Integer, Integer> hmAdditionalPort;
71 private int iNumOfObjects;
72 private int iNumOfHosts;
73 private boolean bVerbose;
76 * CommunicationHandler class constants
78 private final int INT_MAX_PORT = 65535;
79 private final int INT_MIN_PORT = 10000;
84 public CommunicationHandler(boolean _bVerbose) {
86 random = new Random();
87 listActiveControllerObj = new ArrayList<String>();
88 listFieldObjectID = new ArrayList<String>();
89 listObjCrtInfo = new ArrayList<ObjectCreationInfo>();
90 listArrFieldValues = new ArrayList<Object[]>();
91 listArrFieldClasses = new ArrayList<Class[]>();
92 hmActiveObj = new HashMap<String, Integer>();
93 hmHostAdd = new HashMap<Integer, String>();
94 hmHostList = new HashMap<String, ArrayList<String>>();
95 hmComPort = new HashMap<Integer, Integer>();
96 hmRMIRegPort = new HashMap<Integer, Integer>();
97 hmRMIStubPort = new HashMap<Integer, Integer>();
98 hsDevicePort = new HashSet<Integer>();
99 hmAdditionalPort = new HashMap<Integer, Integer>();
102 bVerbose = _bVerbose;
103 RuntimeOutput.print("CommunicationHandler: Creating a new CommunicationHandler object!", bVerbose);
107 * Method addPortConnection()
109 * Add a new connection then generate new in-port and out-port numbers
111 * @param sHAddress String host address
112 * @param sAObject String active object name
115 public void addPortConnection(String sHAddress, String sAObject) {
117 // Increment counter first before we add objects as we start from 0
118 // Objects are named uniquely so we record this and match with the host
119 // Hostname occurrence can be repetitive as there can be more than
120 // one host on one compute node
122 // Add a new object in the list of objects
123 hmActiveObj.put(sAObject, iNumOfObjects);
125 // Check host existence in our data structure
126 // Add a new host and a new object
127 if(hmHostList.containsKey(sHAddress) == false) {
129 hmHostList.put(sHAddress, new ArrayList<String>());
131 hmHostList.get(sHAddress).add(sAObject);
133 // Map object to host
134 hmHostAdd.put(iNumOfObjects, sHAddress);
138 iComPort = random.nextInt(INT_MAX_PORT - INT_MIN_PORT + 1) + INT_MIN_PORT;
139 // Check port existence in HashMap
140 } while (portIsAvailable(iComPort) == false);
141 hmComPort.put(iNumOfObjects, iComPort);
145 iRMIRegPort = random.nextInt(INT_MAX_PORT - INT_MIN_PORT + 1) + INT_MIN_PORT;
146 // Check port existence in HashMap
147 } while (portIsAvailable(iRMIRegPort) == false);
148 hmRMIRegPort.put(iNumOfObjects, iRMIRegPort);
150 int iRMIStubPort = 0;
152 iRMIStubPort = random.nextInt(INT_MAX_PORT - INT_MIN_PORT + 1) + INT_MIN_PORT;
153 // Check port existence in HashMap
154 } while (portIsAvailable(iRMIStubPort) == false);
155 hmRMIStubPort.put(iNumOfObjects, iRMIStubPort);
161 * A private method to add a new active controller object
163 * @params strFieldObjectID String field object ID
164 * @params strObjName String object name
165 * @params strObjClassName String object class name
166 * @params strObjClassInterfaceName String object class interface name
167 * @params strIoTSlaveObjectHostAdd String IoTSlave host address
168 * @params arrFieldValues Array of field values
169 * @params arrFieldClasses Array of field classes
172 public void addActiveControllerObject(String strFieldObjectID, String strObjName, String strObjClassName,
173 String strObjClassInterfaceName, String strObjStubClsIntfaceName, String strIoTSlaveObjectHostAdd, Object[] arrFieldValues,
174 Class[] arrFieldClasses) {
176 listActiveControllerObj.add(strObjName);
177 listFieldObjectID.add(strFieldObjectID);
178 listArrFieldValues.add(arrFieldValues);
179 listArrFieldClasses.add(arrFieldClasses);
180 ObjectCreationInfo objCrtInfo = new ObjectCreationInfo(strIoTSlaveObjectHostAdd, strObjName,
181 strObjClassName, strObjClassInterfaceName, strObjStubClsIntfaceName);
182 listObjCrtInfo.add(objCrtInfo);
186 * Method addDevicePort()
188 * Add a port that is used by a device when communicating with its driver
189 * This port will be taken into account when checking for port availability
191 * @param iDevPort Device port number
194 public void addDevicePort(int iDevPort) {
196 hsDevicePort.add(iDevPort);
201 * Method addAdditionalPort()
203 * Add a new port for new connections for any objects in the program.
204 * This newly generated port number will be recorded.
206 * @return int One new port
208 public int addAdditionalPort(String sAObject) {
210 hmActiveObj.put(sAObject, iNumOfObjects);
212 int iAdditionalPort = 0;
214 iAdditionalPort = random.nextInt(INT_MAX_PORT - INT_MIN_PORT + 1) + INT_MIN_PORT;
215 // Check port existence in HashMap
216 } while (portIsAvailable(iAdditionalPort) == false);
217 hmAdditionalPort.put(iNumOfObjects, iAdditionalPort);
221 return iAdditionalPort;
225 * Method portIsAvailable()
227 * Checks the availability of the newly generated port.
228 * If port number has been used in any of the lists then
229 * it is not available
231 * @param iPortNumber Device port number
234 public boolean portIsAvailable(int iPortNumber) {
236 if (hmComPort.containsValue(iPortNumber) == true) {
238 } else if (hmRMIRegPort.containsValue(iPortNumber) == true) {
240 } else if (hmRMIStubPort.containsValue(iPortNumber) == true) {
242 } else if (hmAdditionalPort.containsValue(iPortNumber) == true) {
244 } else if (hsDevicePort.contains(iPortNumber) == true) {
252 * Method getNumOfObjects()
256 public int getNumOfObjects() {
258 return iNumOfObjects;
263 * Method getNumOfHosts()
267 public int getNumOfHosts() {
274 * Method objectExists()
276 * @param sObjName String object name
279 public boolean objectExists(String sObjName) {
281 return hmActiveObj.containsKey(sObjName);
286 * Method hostExists()
288 * @param sHostName String host name
291 public boolean hostExists(String sHostName) {
293 return hmHostList.containsKey(sHostName);
298 * Method getHostAddress()
300 * User finds HostAddress using Object name
302 * @param sAObject String active object name
305 public String getHostAddress(String sAObject) {
307 return hmHostAdd.get(hmActiveObj.get(sAObject));
314 * User gets the set of hostnames
318 public Set<String> getHosts() {
320 return hmHostList.keySet();
325 * Method getComPort()
327 * User finds In-Port number using Object name
329 * @param sAObject String active object name
332 public Integer getComPort(String sAObject) {
334 return hmComPort.get(hmActiveObj.get(sAObject));
338 * Method getAdditionalPort()
340 * User finds a port number using Object name
342 * @param sAObject String active object name
345 public Integer getAdditionalPort(String sAObject) {
347 return hmAdditionalPort.get(hmActiveObj.get(sAObject));
351 * Method getRMIRegPort()
353 * User finds Out-Port number using Object name
355 * @param sAObject String active object name
358 public Integer getRMIRegPort(String sAObject) {
360 return hmRMIRegPort.get(hmActiveObj.get(sAObject));
365 * Method getRMIStubPort()
367 * User finds Out-Port number using Object name
369 * @param sAObject String active object name
372 public Integer getRMIStubPort(String sAObject) {
374 return hmRMIStubPort.get(hmActiveObj.get(sAObject));
379 * Method getFieldObjectID()
381 * User finds field object ID using Object name
383 * @param sAObject String active object name
386 public String getFieldObjectID(String sAObject) {
388 return listFieldObjectID.get(listActiveControllerObj.indexOf(sAObject));
393 * Method getObjectCreationInfo()
395 * User finds ObjectCreationInfo using Object name
397 * @param sAObject String active object name
398 * @return ObjectCreationInfo
400 public ObjectCreationInfo getObjectCreationInfo(String sAObject) {
402 return listObjCrtInfo.get(listActiveControllerObj.indexOf(sAObject));
407 * Method getArrayFieldClasses()
409 * User finds array of field classes using Object name
411 * @param sAObject String active object name
414 public Class[] getArrayFieldClasses(String sAObject) {
416 return listArrFieldClasses.get(listActiveControllerObj.indexOf(sAObject));
421 * Method getArrayFieldValues()
423 * User finds array of field values using Object name
425 * @param sAObject String active object name
428 public Object[] getArrayFieldValues(String sAObject) {
430 return listArrFieldValues.get(listActiveControllerObj.indexOf(sAObject));
435 * Method getActiveControllerObjectList()
437 * @return List<String>
439 public List<String> getActiveControllerObjectList() {
441 return listActiveControllerObj;
446 * Method printLists()
450 public void printLists() {
452 // Iterate on HostAddress
453 for(String s : hmHostList.keySet()) {
455 for(String str : hmHostList.get(s)) {
457 int iIndex = hmActiveObj.get(str);
458 RuntimeOutput.print("Active Object: " + str, bVerbose);
459 RuntimeOutput.print("Communication Port: " + hmComPort.get(iIndex), bVerbose);
460 RuntimeOutput.print("RMI Registry Port: " + hmRMIRegPort.get(iIndex), bVerbose);
461 RuntimeOutput.print("RMI Stub Port: " + hmRMIStubPort.get(iIndex), bVerbose);
462 RuntimeOutput.print("\n", bVerbose);
466 for(int iPort : hsDevicePort) {
467 RuntimeOutput.print("Device Port: " + iPort, bVerbose);
469 RuntimeOutput.print("\n", bVerbose);