类 ara::crypto::x509::X509DN

接口 ara::crypto::x509::X509DN 用于在加密模块内将 X.509 Distinguished Name 封装并作为可序列化数据结构提供。通过别名 Sptrc，将实例的共享且不可变的所有权实现为 std::shared_ptr<const X509DN> [SWS_CRYPT_40401]。核心方法 ToString() 根据 RFC 4514 格式化完整名称，并且具有线程安全性且无标准化错误码 [SWS_CRYPT_40411]。调用方接收 ara::core::Result<ara::core::String> 作为结果，在进一步处理之前必须检查其有效性。

更多 ›

上下文

抽象接口 ara::crypto::x509::X509DN 在 AUTOSAR Adaptive Platform 的 crypto 模块中表示符合 X.509 标准的 Distinguished Name（DN）。通过继承自 ara::crypto::Serializable，该类作为可序列化的加密数据结构嵌入到类型层次结构中。该接口的主要任务是在软件侧封装证书、证书持有者（Subject）或证书颁发者（Issuer）的名称结构。其中，提供标准化的文本表示占据核心地位：根据 [SWS_CRYPT_40411]，方法 ToString() 将完整的 Distinguished Name 按照 RFC 4514 规范导出为字符串。如果底层的 Distinguished Name 包含非标准属性，则针对这些属性采用相应的 Object Identifier（OID）[SWS_CRYPT_40411]。

生命周期

由于 ara::crypto::x509::X509DN 是具有如 ToString() 等纯虚方法的抽象 C++ 接口，因此不能由应用开发人员直接实例化。负载未指定公共构造函数；具体实例的创建大概率由加密子系统的上层组件或证书解析器进行。 问题 Q-108d7589869c7370 (未决)

为了实现共享和持久访问，该接口定义了类型说明符 Sptrc 作为 std::shared_ptr<const X509DN> [SWS_CRYPT_40401] 的别名。使用常量共享指针（const shared pointer）凸显了所有权与访问设计概念：X509DN 的实例对外是不可变的（immutable）。多个使用者可以安全且无状态地共享同一个专有名称（Distinguished Name）的表示形式，而无需在读访问时产生同步开销。在并发方面，核心方法 ToString() 被明确声明为线程安全（thread-safe）[SWS_CRYPT_40411]。因此，通过同一共享指针或跨不同线程进行并发调用均无需外部锁即可允许执行。此外，该规范保证了此调用具有完全的异常安全性（exception safe）[SWS_CRYPT_40411]。

使用路径

典型的使用路径聚焦于读取并进一步处理格式化后的专有名称，以用于日志记录、身份验证或身份校验。应用程序通常会接收一个 ara::crypto::x509::X509DN::Sptrc 类型的指针 [SWS_CRYPT_40401]。

在该实例上，调用方执行方法 ToString() [SWS_CRYPT_40411]。该调用为 noexcept 并返回一个 ara::core::Result<ara::core::String> [SWS_CRYPT_40411]。评估成功时，该 Result 对象包含根据 RFC 4514 格式化的字符串，例如采用标准化的属性值对形式（如 CN=...），或在专有属性中使用 OID [SWS_CRYPT_40411]。应用程序随后可以提取生成的字符串，并将其进一步用于特定于应用程序的校验、比对或审计日志。

错误场景

在与 ara::crypto::x509::X509DN 交互时，错误处理体现出清晰且极简的设计。尽管 ToString() 使用了返回值类型 ara::core::Result<ara::core::String>，但规范明确规定该函数不定义标准化的错误代码 [SWS_CRYPT_40411]。这意味着在常规规范上下文中，并未针对序列化过程预设任何业务层面的拒绝原因或校验错误。

由于该函数还被指定为 noexcept 且具有异常安全性（exception safe）[SWS_CRYPT_40411]，因此排除了同步 C++ 异常。如果返回的 ara::core::Result 内部仍然出现错误状态，则推测可能是由于平台或实现特定的原因所致，例如在分配结果字符串时出现内存不足。 问题 Q-10477dd7d77e3b78 (未决)因此，调用方在解包该值之前必须始终检查 Result 是包含有效值还是错误，即使 AUTOSAR 未为此提供特定于领域的错误常量。