命名空间 apext::log

命名空间 apext::log 通过函数模板 TraceArti 提供用于将建模的跟踪消息转发至外部运行时跟踪工具的接口 [SWS_LOG_20000]。该函数仅在日志记录和跟踪之间切换时由记录器框架在内部调用，并处理特定于消息的标识符以及可变参数 [SWS_LOG_20000]。核心约束条件包括最小的运行时开销、完全的线程安全以及无错误或返回值的异常安全执行。

更多 ›

上下文

命名空间 apext::log 为 AUTOSAR Adaptive Platform 的日志记录和跟踪子系统提供功能接口。其主要职责在于通过函数模板 TraceArti 为外部运行时跟踪工具提供专用接口 [SWS_LOG_20000]。带有前缀 apext 的命名作为解释可能表明，它是一个平台扩展（Adaptive Platform Extension），用于将特定跟踪机制（例如 AUTOSAR 运行时接口，ARTI）连接到日志记录框架。 问题 Q-325896ce9f6b8e42 (未决)

在系统架构中，该命名空间充当内部日志记录基础设施与下游分析或跟踪工具之间的纽带。在此，主要有三个组件相互交互：内部记录器框架、位于 apext::log 内的接口函数 TraceArti 以及所连接的跟踪工具 [SWS_LOG_20000]。记录器框架处理应用程序事件，并在相应切换时将建模消息转发至 TraceArti，后者将数据移交给特定于厂商的跟踪工具 [SWS_LOG_20000]。

上下文图：TraceArti 在记录器框架与跟踪工具之间的嵌入。来源：[SWS_LOG_20000]

生命周期

命名空间 apext::log 不封装具有独立生命周期的长寿命类实例、会话对象或有状态实体。命名空间中不存在显式的初始化或终止例程；相反，该功能完全通过自由模板函数实现 [SWS_LOG_20000]。因此，跟踪功能的生命周期完全绑定到记录器框架的上级运行生命周期。

关于并发行为和操作安全性，适用严格的保证：接口 TraceArti 被显式指定为线程安全的（thread-safe）[SWS_LOG_20000]。这允许记录器框架在无需外部同步的情况下，并行从多个执行上下文和线程将跟踪调用委托给该命名空间。同时，该函数被声明为异常安全的（exception safe）和 noexcept [SWS_LOG_20000]，从而在调用期间任何时候都不会发生资源泄漏或不受控制的栈展开状态。

使用路径

命名空间 apext::log 的函数并非设计用于常规应用程序软件直接调用。相反，当记录器框架在传统日志记录与基于 ARTI 的跟踪之间切换时，TraceArti 仅在内部被该框架调用 [SWS_LOG_20000]。开发者或集成人员在需要时包含相应的头文件 #include "apext/log/trace_arti.h"，以获得对声明的访问权 [SWS_LOG_20000]。

在调用时，该函数处理特定于所使用的相应跟踪工具的建模消息（modeled messages）[SWS_LOG_20000]。为此，接口接受一个用于标识消息且属于实现定义类型 MsgId 的标识符 msg_id，以及一个任意类型的可变参数包 params... Params... [SWS_LOG_20000]。为了使跟踪路径中的运行时开销尽可能低，规范要求严格最小化运行时开销；例如，这应通过基于相应 MsgId 的定制模板特化来实现 [SWS_LOG_20000]。可以推测，此类特化通常由工具生成器在针对相应目标系统的工具链集成框架内生成。

错误场景

在错误处理方面，apext::log 采用容错设计，不向调用方指示运行时错误。TraceArti 的函数签名未定义返回值（void），并通过 noexcept 规范完全禁止抛出 C++ 异常 [SWS_LOG_20000]。因此，前置条件（例如消息 ID 和传入有效载荷的有效性）必须强制由调用记录器框架或相应特化来保证，因为在出错时无法传递错误代码 [SWS_LOG_20000]。