【仿真建模-anylogic】开发规范

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

0. 说明

        实际模型开发过程中，对遇到的问题进行总结归纳出以下开发规范，仅供参考！

1. 强制性规范

        1.1 事件消费模式设置为FIFO

        anylogic默认事件消费模式为后入先出，违反直觉，并且考虑到绝大多数场景要求保证事件按产生顺序消费，故将事件消费模式统一为先入先出，便于后期多模型整合；方式如下：

        1.2 严禁以像素作为布局数据单位

       为模型提供布局数据时，选择具有实际物理空间含义的单位“米”；然后在模型内部根据所设定的scale转换为像素，以保证调整scale时，模型所表征的实际物理空间不变。

       1.3 严禁直接使用默认生成的外层智能体引用

       例如智能体A内嵌智能体B，则Anylogic会自动在智能体B内生成对智能体A的引用。如需访问外层智能体，则需在本智能体内明确定义对外层智能体的引用，并在初始化时将外层智能体注入，以便于后续将该智能体导出为通用组件。

      1.4 智能体自定义函数按需设定访问权限

      Anylogic默认设定函数访问权限为default。需要依据该函数未来的使用范围，重新在public、protected和private之间做选择。避免将智能体导出为自定义组件库后，其他模型内无权访问该方法。

       1.5 严禁在on startup处初始化（Top-level智能体除外）

       各智能体需自定义init函数，并在init函数内完成内嵌智能体的init函数调用以及自身的初始化。避免将智能体导出为自定义组件库后，其构造函数参数列表过长。

       1.6 严禁在Top-level智能体内添加业务功能

Top-level智能体仅做为实验运行的环境，负责实验所需智能体的创建和关系组装。

2. 推荐性规范

       2.1 优先使用普通Java类

       智能体本身也是Java类，只不过其增加了生命周期管理、消息通信、演示等一系列通用功能；在模型设计理念上，智能体是有实际业务概念(对象)与之相对应的。如果仅是数据载体，建议直接使用Java类而非智能体。

      2.2 合理使用组合状态，以业务概念表达为主

      采用状态图进行建模时，应以业务概念层级为标准，合理使用组合状态，使得状态图易于理解。

       2.3 内嵌智能体推荐使用智能体群

       执行引擎负责智能体的生命周期管理，其拥有严格的流转流程。若开发不规范，容易产生悬空智能体，导致流程出错。建议使用智能体群对内嵌智能体进行统一管理。

       2.4 集合推荐使用变量

       Anylogic同时提供了变量和集合变量，其集合变量的引用必须使用可实例化的集合类，不方便同流式操作相结合。推荐直接使用变量，并指定所需的集合接口。