State Model(状态机模型)¶
要使用 ecu.test code Library,必须先了解可能的状态及其状态切换。相关状态包括 uninitialized(未初始化)、initialized(已初始化) 和 running(运行中)。根据当前状态不同,可用功能也不同。例如,必须先使用 ToolAccess.job("tool/myJob") 注册 job,之后才能调用。下方状态图说明了不同状态下可用的功能。
状态切换方式¶
状态切换可通过以下两种方式完成:
上下文管理器:进入上下文管理器时,新状态会立即生效。退出时,ecu.test code Library 会自动恢复到前一状态。即使发生异常,这种方式也能确保与 ecu.test 的连接被正常关闭。
显式调用:这种方式不使用上下文管理器,而是由用户调用
ecutest.toolaccess.ToolAccess.init()orecutest.toolaccess.ToolAccess.run(). 在这种情况下,用户必须手动调用ecutest.toolaccess.ToolAccess.stop()或ecutest.toolaccess.ToolAccess.deinit(),以返回前一状态。该方式更灵活,例如适用于基于类的测试。
说明
即使使用显式状态切换方式(不使用上下文管理器),如果由于意外错误(未捕获异常、强制终止等)导致 Python 进程结束,ecu.test 也会检测到连接已断开,并自动将其内部状态恢复为初始状态,就像调用了 ToolAccess.deinit() 一样。这样可避免 ecu.test 在后续会话中保持不一致状态。
ecu.test code Library 的状态机模型,展示了各状态及其切换关系。¶
示例¶
下面给出这两种状态切换方式的简短示例。
基于上下文管理器的状态切换¶
from ecutest.toolaccess import ToolAccess
with ToolAccess().init() as ta: # -> initialized
job = ta.job("PORT/MyJob")
with ta.run(): # -> running
result = job(1, 2)
# leaving run context -> initialized
# leaving init context -> uninitialized
显式状态切换¶
from ecutest.toolaccess import ToolAccess
ta = ToolAccess() # uninitialized
ta.init() # -> initialized
job = ta.job("PORT/MyJob")
ta.run() # -> running
result = job(1, 2)
ta.stop() # -> initialized
ta.deinit() # -> uninitialized