clase ara::rds::IEEE1722DatagramNTSCF

La clase ara::rds::IEEE1722DatagramNTSCF representa la estructura de datos para datagramas de control IEEE 1722 NTSCF dentro del módulo Raw Data Stream SWS RawDataStream «Specification of Raw Data Stream». Encapsula campos específicos del protocolo como número de secuencia, información de dirección e identificadores unívocos en atributos protegidos, los cuales están a disposición de clases de datagramas especializadas. Se garantiza un ciclo de vida seguro en el uso polimórfico mediante el destructor virtual [SWS_RDS_90310]. La condición de contorno más importante consiste en que la destrucción debe realizarse obligatoriamente sin excepciones y los campos opcionales deben verificarse en cuanto a su presencia antes del acceso.

más ›

Contexto

La clase ara::rds::IEEE1722DatagramNTSCF representa, dentro del módulo AUTOSAR Adaptive rds (Raw Data Stream) conforme a SWS RawDataStream «Specification of Raw Data Stream», la estructura de un datagrama IEEE 1722 en formato NTSCF (Non-Time-Synchronous Control Format). La clase agrupa campos de protocolo especificados para el intercambio de flujos de datos de control y datos útiles no críticos en el tiempo. El archivo de cabecera #include "ara/rds/raw_data_stream_IEEE1722.h" declara la clase en el espacio de nombres ara::rds. Entre los componentes especificados se incluyen el identificador único de flujo unique_id [SWS_RDS_90309], el número de secuencia sequenceNum [SWS_RDS_90307], así como la información de longitud y dirección ntscf_data_length y mac_address [SWS_RDS_90306], [SWS_RDS_90308].

Llama la atención que todos los elementos de datos presentan el modificador de acceso protected. Como interpretación se puede deducir que la clase sirve como clase base fundamental para estructuras de datagramas derivadas y específicas de protocolo, y probablemente no esté prevista para la instanciación directa por parte de la lógica de aplicación regular. Pregunta Q-10e9faa973973eda (abierta)

Ciclo de vida

El ciclo de vida de ara::rds::IEEE1722DatagramNTSCF está concebido para un funcionamiento seguro en jerarquías de herencia orientadas a objetos. El elemento central es el destructor virtual ~IEEE1722DatagramNTSCF() noexcept conforme a [SWS_RDS_90310]. Gracias a la virtualidad, se garantiza que, al destruirse una instancia derivada a través de un puntero a la clase base, la cadena de destructores se procese de manera completa y correcta.

La declaración con noexcept [SWS_RDS_90310] garantiza que la destrucción del objeto no lance excepciones bajo ninguna circunstancia. Esto satisface los requisitos esenciales de la gestión moderna de recursos en C++ y asegura la seguridad frente a excepciones en caso de fallo.

En el alcance de la especificación no se indican constructores públicos. Por tanto, la creación de objetos probablemente se realice mediante clases derivadas en el marco de su inicialización o a través de mecanismos de creación internos del módulo Raw Data Stream. Pregunta Q-4a0e75e3e565d2d5 (abierta) La clase no posee estados fijos ni una máquina de estados interna; el objeto permanece en un estado coherente como portador de información desde su creación hasta su destrucción.

Ruta de uso

El uso de la clase tiene lugar típicamente en el curso del procesamiento de flujos de datos de control según IEEE 1722. Las clases derivadas o componentes del framework de flujo de datos en bruto utilizan los atributos protegidos para la serialización o deserialización de los paquetes transmitidos. Los atributos están definidos como tipos de números enteros elementales o como ara::core::Optional. La cadena de procesamiento típica se divide en los siguientes pasos:

• Identificación del flujo de datos: Mediante unique_id [SWS_RDS_90309] se comprueba a qué flujo de datos lógico pertenece el datagrama.
• Comprobación del orden: Mediante el número de secuencia sequenceNum [SWS_RDS_90307] se puede determinar si los paquetes han llegado en el orden previsto o si existen pérdidas.
• Evaluación de longitud y dirección: A través de los campos ntscf_data_length y mac_address [SWS_RDS_90306], [SWS_RDS_90308] se determina el tamaño de los datos útiles y se evalúa la dirección de destino o de origen.

Tras evaluar los datos útiles, la ruta de uso concluye con la liberación de la instancia mediante el destructor virtual [SWS_RDS_90310].

Escenarios de error

Debido al carácter de ara::rds::IEEE1722DatagramNTSCF como estructura de datos y clase base, los errores no se presentan en forma de códigos de retorno de métodos, sino que afectan a precondiciones en el acceso a datos y en la destrucción:

• Acceso sin comprobar a campos opcionales: Atributos como sequenceNum [SWS_RDS_90307] y unique_id [SWS_RDS_90309] están declarados como ara::core::Optional. El acceso sin comprobación previa mediante has_value() provoca errores en tiempo de ejecución o comportamiento indefinido en el caso de paquetes incompletos.
• Vulneración de la garantía noexcept en el destructor: Dado que el destructor está especificado con noexcept [SWS_RDS_90310], cualquier excepción lanzada durante la limpieza en clases derivadas y no tratada localmente provoca la terminación inmediata del programa mediante std::terminate.
• Indicaciones de longitud incoherentes: Si el valor de ntscf_data_length [SWS_RDS_90306], [SWS_RDS_90308] no coincide con el tamaño real del búfer del controlador de red, pueden producirse desbordamientos de búfer o lecturas incompletas durante el procesamiento de datos.