类 ara::diag::DynamicAccessListDiagServiceBuilder

使用

类 ara::diag::DynamicAccessListDiagServiceBuilder 的同步方法 Add 用于向 DynamicAccessListPattern 添加单个字节（Byte value）[SWS_DM_01175]。在对诊断服务的访问权限进行求值时，传入的字节值将被检查是否完全匹配 [SWS_DM_01175]。通过返回对同一对象实例的引用（DynamicAccessListDiagServiceBuilder&），该函数支持作为 Fluent API 进行调用 [SWS_DM_01175]。

错误处理与异常安全性

该操作被声明为 noexcept 并被指定为异常安全（exception safe）[SWS_DM_01175]。既不返回错误代码，也不返回类型为 ara::core::Result 的返回值；在有效负载中未针对该函数指出特定的 DET 或 DEM 消息。

并发性与限制

该方法被指定为非线程安全（not thread-safe）[SWS_DM_01175]。解释：因此，在诊断服务器中对创建的访问模式进行求值之前，对同一构建器实例的调用通常可能在单个线程内顺序执行。 问题 Q-69d895fc6bf90cb4 (未决)

相互作用

在接口 DynamicAccessListDiagServiceBuilder 内，该方法补充了 Add 的相关重载，通过这些重载可以经由 ByteString [SWS_DM_01176] 将字节序列或经由 ByteRange [SWS_DM_01177] 将值范围添加到 DynamicAccessListPattern 中。

类 ara::diag::DynamicAccessListDiagServiceBuilder 的成员函数 Add 用于向 DynamicAccessListPattern 添加字节序列 [SWS_DM_01176]。通过类型为 ByteString 的输入参数 values 传递一个字节序列，在后续对诊断服务的访问权限进行求值时，将检查该序列是否完全匹配 [SWS_DM_01176]。作为返回值，该方法返回对同一构建器实例的引用（DynamicAccessListDiagServiceBuilder&），这通过链式调用实现了流畅接口使用方式（Fluent API）[SWS_DM_01176]。

在错误处理方面，该函数被声明为 noexcept 并被指定为异常安全（exception safe）[SWS_DM_01176]。既不报告错误代码，也不报告 C++ 异常。

关于并发性，该方法被定义为非线程安全（not thread-safe）[SWS_DM_01176]。如果多个线程并行访问同一构建器实例，则必须在应用程序端对调用进行同步。解释：由于未指定异步机制，该调用可能在配置应用程序线程的执行上下文中同步发生。 问题 Q-d93498e82292a88e (未决)

在诊断管理的交互中，该方法补充了用于定义动态访问模式的相关构建器函数：使用此函数注册完整字节序列的同时，也可以备选通过重载的 Add 函数将单个字节（[SWS_DM_01175]）或值范围（[SWS_DM_01177]）添加到模式中。

类 ara::diag::DynamicAccessListDiagServiceBuilder 的函数 Add 用于供应用程序向 DynamicAccessListPattern 添加字节值范围 [SWS_DM_01177]。传入的类型为 ByteRange 的参数 range 定义了一个值区间，在评估诊断服务的访问权限期间将检查其匹配性 [SWS_DM_01177]。

对于该调用及其在诊断管理中的集成，适用以下属性：

• 调用上下文与语义：该调用同步执行。作为返回值，该函数提供对同一 Builder 实例的对象引用（DynamicAccessListDiagServiceBuilder&），以支持通过方法链实现的流畅接口使用（Fluent API）[SWS_DM_01177]。
• 错误处理：该操作被声明为 noexcept，并具有规范属性 exception safe [SWS_DM_01177]。既不返回特定错误码，也不引发异常。
• 并发性：该函数被显式指定为 not thread-safe [SWS_DM_01177]。解释：若多个执行线程访问同一 Builder 实例，调用方应用程序必须从外部对该访问进行同步。 问题 Q-c51760a8fe29bd5f (未决)
• 交互：该方法补充了 Builder 类的相关函数，用于通过 [SWS_DM_01175] 添加单个字节值以及通过 [SWS_DM_01176] 定义字节序列，从而配置灵活的访问模式。

使用

方法 ara::diag::DynamicAccessListDiagServiceBuilder::Any 用于供应用软件在访问模式中定义通配符 ([SWS_DM_01178])。同步调用在 Builder 实例上执行。通过参数 numberOfBytesToIgnore 指定有多少个连续字节虽被包含在访问模式中，但在随后与传入诊断请求进行模式匹配（Pattern Matching）时被忽略 ([SWS_DM_01220])。通过返回对同一 Builder 的对象引用，支持链式 API 调用风格 (AUTOSAR_AP_SWS_Diagnostics §8.15.1.2.3.4 “Any”)。

错误处理与异常行为

该函数被指定为 noexcept 且异常安全 (exception safe) ([SWS_DM_01178])。既未规定错误代码，也未规定对 DET 或 DEM 的反馈。解释：当为 numberOfBytesToIgnore 传递值 0 时，调用应无错误返回且不在模式中注册通配符字节。 问题 Q-e372cda9f8840893 (未决)

并发性与限制

该接口被明确标明为非线程安全 (not thread-safe) ([SWS_DM_01178])。因此，对 DynamicAccessListDiagServiceBuilder 的同一实例进行多次 Builder 调用必须严格按顺序进行，或由调用方进行同步。

相互作用

通过 Any 进行的占位符定义通常与 EndsWith 等模式组合 ([SWS_DM_01221])。在组装完所有模式组成部分后，必须使用方法 Build 完成配置 ([SWS_DM_01222])，然后生成的访问列表才可用于验证 (AUTOSAR_AP_SWS_Diagnostics §7.3.2 “Adding wildcards to a DynamicAccessList”)。

使用

类 ara::diag::DynamicAccessListDiagServiceBuilder ([SWS_DM_01166]) 的同步方法 Build 结束动态访问列表的创建 ([SWS_DM_01181])。该函数不接受任何传入参数且没有返回值 ([SWS_DM_01181])。通过该调用，主管的 Diagnostic Server 实例将接管所组装的访问规则 ([SWS_DM_01222])。

错误处理

该操作被声明为 noexcept，并被指定为异常安全（exception safe）([SWS_DM_01181])。既不返回错误代码，也不抛出异常。

并发性与限制

该方法被归类为非线程安全（not thread-safe）([SWS_DM_01181])。因此，必须在外部保护来自多个执行上下文对同一 Builder 对象的并发访问。此外，还存在严格的顺序条件：在销毁 Service Builder 对象之前，必须强制调用 Build ([SWS_DM_01181])。解释：若在对象生命周期结束前未执行此调用，先前配置的模式可能会失效且不会对授权生效。 问题 Q-445ea33ece339d42 (未决)

相互作用

在列表创建过程中，预先定义服务和请求模式，例如通过 Any 定义通配符 ([SWS_DM_01220]) 或通过 EndsWith 定义结束模式 ([SWS_DM_01221])，如 SWS Diagnostics §7.3.2.3.4 “DynamicAccessList Creation and Update” 中所述。Build 完成此构建过程并将列表传递给服务器 ([SWS_DM_01222])。

类 ara::diag::DynamicAccessListDiagServiceBuilder 的同步方法 EndsWith 用于让应用程序指定单个字节（Byte value）作为动态访问列表的结束模式 [SWS_DM_01179]。调用时，Diagnostic Server 实例会将该模式分配给 DynamicAccessList 的末尾，以便在评估诊断服务权限时检查精确匹配 [SWS_DM_01221]。该函数没有返回值。

关于错误处理，该函数被指定为异常安全（exception safe），并使用 noexcept 声明 [SWS_DM_01179]。规范范围内未为此方法调用提供特定的错误码、DET 或 DEM 消息。

关于并发性，该方法被标明为非线程安全（not thread-safe）[SWS_DM_01179]。在并发访问同一构建器实例时，需要由应用程序进行外部同步。解释：结束模式的指定推测必须在调用 Build 之前发生 [SWS_DM_01222]，因为 Diagnostic Server 会使用 Build 最终确定 DynamicAccessList。 问题 Q-a0afa7deaafa306b (未决)

在与相关需求的交互中，除此单值变体外，还存在一个重载 EndsWith(ByteRange range) [SWS_DM_01180]，它允许指定闭合字节取值范围作为结束模式 SWS Diagnostics §8.15.1.2.3.6 “EndsWith(ByteRange)”。两种变体都在使用同一访问列表之前配置其结束模式 [SWS_DM_01221]。

使用

类 ara::diag::DynamicAccessListDiagServiceBuilder 的方法 EndsWith 用于在动态访问列表（DynamicAccessList）的搜索模式末尾指定闭合字节区间（ByteRange range）[SWS_DM_01180]。在方法调用时，Diagnostic Server 的实例将指定模式附加到 DynamicAccessList 的末尾 [SWS_DM_01221]。随后在对诊断服务的访问权限进行求值时使用此值范围 AUTOSAR_AP_SWS_Diagnostics §8.15.1.2.3.6 “EndsWith(ByteRange)”。该调用同步进行且不提供返回值（void）[SWS_DM_01180]。

错误处理与并发

该操作被声明为 noexcept 并被指定为异常安全（exception safe）；不存在特定的错误代码或异常处理 [SWS_DM_01180]。在并发性方面，该方法被归类为非线程安全（not thread-safe）[SWS_DM_01180]。在没有外部同步的情况下，跨多个线程对同一构建器实例进行并行访问是不允许的。

交互和生命周期

在模式创建过程中，除该值范围变体之外，还存在 EndsWith 的另一种备选重载，该重载定义用于末尾精确模式匹配的单个字节（Byte value）[SWS_DM_01179]。在配置模式后，必须通过调用 Build 来最终确定列表 [SWS_DM_01222]，然后应用程序才能将生成的 DynamicAccessList 用于权限检查 AUTOSAR_AP_SWS_Diagnostics §7.3.2 “End patterns of a DynamicAccessList”。