【仿真建模-anylogic】Port原理解析

Author：赵志乾
Date：2024-06-14
Declaration：All Right Reserved！！！

1. 类图

2. 原理解析

2.1 核心函数：

Port作为各类型端口的基类，其核心方法如下：

函数	功能
Port(Agent owner)	构造函数，入参指定端口所属的智能体；
void connect(Port<OutMessageType,InMessageType> port) void disconnect(Port<OutMessageType,InMessageType> port)	与和owner同层级的Agent的端口建立或取消连接；
void map(Port<InMessageType,OutMessageType> port) void unmap(Port<InMessageType,OutMessageType> port)	与内嵌智能体的端口建立或取消连接；
void map(Statechart statechart) void unmap(Statechart statechart)	与owner内的状态图建立或取消连接；
void send(OutMessageType msg)	发出消息
void receive(InMessageType msg)	接收消息
List<Port<OutMessageType,InMessageType>> getFlatLinks()	获取该端口与owner同层级的Agent建立连接的端口列表；
List<Port<InMessageType,OutMessageType>> getUpLinks()	获取该端口与owner的容器智能体建立连接的端口列表；
List<Port<InMessageType,OutMessageType>> getDownLinks()	获取该端口与owner内嵌智能体建立连接的端口列表；
List<Statechart> getStatechartLinks()	获取该端口与owner内建立连接的状态图列表；

2.2 连接类型图形说明

2.3 代码解析

由于AnyLogic内核做过代码混淆，以下代码为二次加工后的内容，与源码不同；

//**************************** Port核心字段******************************************
// 该端口的owner
private transient Agent owner;
// 该端口与和owner同层级Agent建立连接的端口列表
protected transient List<Port<OutMessageType, InMessageType>> flatLinks;
// 该端口与owner的容器Agent建立连接的端口列表
protected transient List<Port<InMessageType, OutMessageType>> upLinks;
// 该端口与owner的内嵌Agent建立连接的端口列表
protected transient List<Port<InMessageType, OutMessageType>> downLinks; 
// 该端口与owner的状态图建立连接的状态图列表
protected transient List<Statechart> statecharts; //****************************构造函******************************************************
Port(Agent owner){this.owner = owner;this.flatLinks = new LinkedList<>();this.upLinks = new LinkedList<>();this.downLinks = new  LinkedList<>();this.statecharts = new LinkedList<>();
}//************依据建立或取消连接的场景，在对应的列表中进行元素的增删维护**********************
public void connect(Port<OutMessageType, InMessageType> port) {// 避免重复添加,即接口调用具有幂等性if (this.flatLinks.contains(port)) {return;}this.flatLinks.add(port);port.flatLinks.add(this);
}
public void disconnect(Port<OutMessageType, InMessageType> port) {this.flatLinks.remove(port);port.flatLinks.remove(this);
}public void map(Port<InMessageType, OutMessageType> port) {this.downLinks.add(port);port.upLinks.add(this);
}
public void unmap(Port<InMessageType, OutMessageType> port) {this.downLinks.remove(port);port.upLinks.remove(this);
}public void map(Statechart statechart) {this.statecharts.add(statechart);
}
public void unmap(Statechart statechart) {this.statecharts.remove(statechart);
}//****************************消息收发**************************************************
public void send(OutMessageType message) {if (this.owner.executeOnSendActionOf(this, message)) {// owner的容器Agent建立连接的端口逐个发送消息for(Port<OutMessageType,InMessageType> port : this.upLinks){port.send(message);}// owner同级Agent建立连接的端口逐个接收消息for(Port<OutMessageType,InMessageType> port : this.flatLinks){port.receive(message);}     }
}public void receive(InMessageType message) {boolean need = this.owner.executeOnReceiveActionOf(this, message);this.owner.onChange();if (need) {// owner内嵌Agent建立连接的端口逐个接收消息for(Port<InMessageType, OutMessageType> port : this.downLinks){port.receive(message);}// owner状态图建立连接的逐个接收消息for(Statechart statechart : this.statecharts){statechart.receiveMessage(message);}}
}