classe ara::rds::IEEE1722DatagramNTSCF

A classe ara::rds::IEEE1722DatagramNTSCF representa a estrutura de dados para datagramas de controle IEEE 1722 NTSCF dentro do módulo Raw Data Stream SWS RawDataStream «Specification of Raw Data Stream». Ela encapsula campos específicos do protocolo, como número de sequência, informações de endereço e identificadores exclusivos em atributos protegidos que estão disponíveis para classes especializadas de datagrama. Um ciclo de vida seguro no uso polimórfico é garantido pelo destruidor virtual [SWS_RDS_90310]. A condição marginal mais importante é que a destruição deve obrigatoriamente ocorrer sem exceções e os campos opcionais devem ser verificados quanto à sua presença antes do acesso.

mais ›

Contexto

A classe ara::rds::IEEE1722DatagramNTSCF representa, dentro do módulo AUTOSAR Adaptive rds (Raw Data Stream), de acordo com SWS RawDataStream «Specification of Raw Data Stream», a estrutura de um datagrama IEEE 1722 no formato NTSCF (Non-Time-Synchronous Control Format). A classe reúne campos de protocolo especificados para o intercâmbio de fluxos de dados de controle e de dados úteis não críticos em termos de tempo. O arquivo de cabeçalho #include "ara/rds/raw_data_stream_IEEE1722.h" declara a classe no namespace ara::rds. Entre os componentes especificados estão o identificador exclusivo do fluxo unique_id [SWS_RDS_90309], o número de sequência sequenceNum [SWS_RDS_90307], bem como as informações de comprimento e de endereço ntscf_data_length e mac_address [SWS_RDS_90306], [SWS_RDS_90308].

Chama a atenção o fato de todos os elementos de dados possuírem proteção de acesso protected. Como interpretação, pode-se deduzir disso que a classe serve como classe base fundamental para estruturas de datagramas derivadas e específicas de protocolo, presumivelmente não sendo destinada à instanciação direta pela lógica de aplicação regular. Pergunta Q-10e9faa973973eda (aberta)

Ciclo de vida

O ciclo de vida de ara::rds::IEEE1722DatagramNTSCF foi projetado para uma operação segura em hierarquias de herança orientadas a objetos. O elemento central é o destruidor virtual ~IEEE1722DatagramNTSCF() noexcept de acordo com [SWS_RDS_90310]. A virtualidade garante que, na destruição de uma instância derivada por meio de um ponteiro para a classe base, a cadeia de destruidores seja processada de forma completa e correta.

A declaração com noexcept [SWS_RDS_90310] assegura que a destruição do objeto não lance exceções sob nenhuma circunstância. Isso atende aos requisitos fundamentais do gerenciamento moderno de recursos em C++ e garante a segurança contra exceções em caso de erro.

Construtores públicos não são listados no escopo da especificação. Portanto, a criação de objetos provavelmente ocorre por meio de classes derivadas no âmbito de sua inicialização ou por meio de mecanismos internos de criação do módulo Raw Data Stream. A classe não possui estados fixos ou uma máquina de estados interna; da criação até a destruição, o objeto permanece em um estado consistente como portador de informações. Pergunta Q-4a0e75e3e565d2d5 (aberta)

Caminho de utilização

O uso da classe ocorre tipicamente no curso do processamento de fluxos de dados de controle de acordo com o IEEE 1722. Classes derivadas ou componentes do framework de fluxo de dados brutos utilizam os atributos protegidos para serialização ou desserialização dos pacotes transmitidos. Os atributos são definidos como tipos inteiros elementares ou como ara::core::Optional. A cadeia de processamento típica é dividida nas seguintes etapas:

• Identificação do fluxo de dados: com base em unique_id [SWS_RDS_90309], verifica-se a qual fluxo de dados lógico o datagrama pertence.
• Verificação de sequência: por meio do número de sequência sequenceNum [SWS_RDS_90307], é possível determinar se os pacotes chegaram na ordem esperada ou se ocorreram perdas.
• Avaliação de comprimento e endereço: por meio dos campos ntscf_data_length e mac_address [SWS_RDS_90306], [SWS_RDS_90308], o tamanho dos dados úteis é determinado e o endereço de destino ou de origem é avaliado.

Após a avaliação dos dados úteis, o caminho de utilização termina com a liberação da instância por meio do destruidor virtual [SWS_RDS_90310].

Cenários de erro

Devido ao caráter de ara::rds::IEEE1722DatagramNTSCF como estrutura de dados e classe base, os erros não ocorrem na forma de códigos de retorno de métodos, mas afetam pré-condições no acesso a dados e na destruição:

• Acesso não verificado a campos opcionais: atributos como sequenceNum [SWS_RDS_90307] e unique_id [SWS_RDS_90309] são declarados como ara::core::Optional. O acesso sem verificação prévia por meio de has_value() leva a erros de tempo de execução ou comportamento indefinido em pacotes incompletos.
• Violação da garantia noexcept no destruidor: como o destruidor é especificado com noexcept [SWS_RDS_90310], qualquer exceção lançada durante a limpeza em classes derivadas e não tratada localmente causará o encerramento imediato do programa via std::terminate.
• Indicações de comprimento inconsistentes: se o valor de ntscf_data_length [SWS_RDS_90306], [SWS_RDS_90308] não corresponder ao tamanho real do buffer do driver de rede, podem ocorrer estouros de buffer ou leituras incompletas durante o processamento dos dados.