classe ara::fw::FwErrorDomain

O alias de tipo Errc está definido, em conformidade com [AP_SWS_Fw_83007], como um alias para a enumeração de códigos de erro FwErrc (using Errc = FwErrc;). O elemento está declarado no âmbito da classe ara::fw::FwErrorDomain e deve ser incluído através do ficheiro de cabeçalho ara/fw/fw_error_domain.h [AP_SWS_Fw_83007].

No que diz respeito à utilização, Errc não representa uma chamada de função executável, não dispondo, portanto, de parâmetros, valores de retorno, nem de semântica síncrona ou assíncrona [AP_SWS_Fw_83007]. Em vez disso, disponibiliza um identificador uniforme para a enumeração das causas de erro específicas do domínio. Interpretação: presume-se que o alias ofereça aos programadores um acesso simplificado e consistente aos valores de enumeração de FwErrc dentro de ara::fw::FwErrorDomain, a fim de tipificar e consultar estados de erro [AP_SWS_Fw_83007]. Pergunta Q-bd8949830961e459 (aberta)

Uma vez que se trata de uma construção puramente em tempo de compilação, não existem restrições de tempo de execução relativas a reentrância, segurança de threads ou ordem de chamadas [AP_SWS_Fw_83007]. Valores de erro específicos ou associações a mensagens DET ou DEM não estão predefinidos no elemento de especificação e regem-se pelos valores da enumeração subjacente [AP_SWS_Fw_83007].

O construtor padrão FwErrorDomain() está declarado como excluído ([AP_SWS_Fw_83009]). Uma instanciação direta de objetos da classe ara::fw::FwErrorDomain através deste construtor está, portanto, excluída no código da aplicação. Interpretação: presume-se que a exclusão garanta que o domínio de erro seja gerenciado exclusivamente como singleton. Pergunta Q-54f7bc341f074e2c (aberta)

Para a utilização do domínio de erro, está disponível a função livre GetFwErrorDomain() ([AP_SWS_Fw_83002]). Esta fornece, de forma thread-safe, uma referência ao objeto de domínio existente do tipo ara::core::ErrorDomain. Através desta referência, as interfaces do domínio podem ser utilizadas:

• Consulta do nome do domínio de erro via Name() ([AP_SWS_Fw_83010]).
• Determinação de textos descritivos para códigos de erro por meio de Message() ([AP_SWS_Fw_83011]).
• Disparo de exceções via ThrowAsException() ([AP_SWS_Fw_83012]), em que o alias Exception faz referência a FwException ([AP_SWS_Fw_83008]).

Os códigos de erro correspondentes são definidos pela enumeração FwErrc ([AP_SWS_Fw_83001]), que também está disponível dentro da classe através do alias Errc ([AP_SWS_Fw_83007]). Valores válidos são kServiceNotAvailable bem como kInvalidStateDependentFirewall. Desenvolvedores não devem, portanto, criar instâncias próprias, mas sim utilizar sempre a referência global.

Utilização e semântica

A função-membro Name da classe ara::fw::FwErrorDomain destina-se à obtenção do identificador do domínio de erro [AP_SWS_Fw_83010]. A chamada processa-se de forma síncrona e requer a inclusão do ficheiro de cabeçalho ara/fw/fw_error_domain.h [AP_SWS_Fw_83010]. A função não aceita parâmetros de passagem e retorna um ponteiro do tipo const char *, o qual representa o nome do domínio [AP_SWS_Fw_83010]. No caso do retorno, deverá tratar-se de uma cadeia de caracteres terminada em nulo, cuja validade está vinculada ao tempo de vida do domínio de erro. Pergunta Q-6bd465d82e79a682 (aberta)

Tratamento de erros

O método está declarado com o identificador noexcept [AP_SWS_Fw_83010]. Por conseguinte, não lança exceções e não prevê códigos de erro específicos ou retornos de erro [AP_SWS_Fw_83010].

Simultaneidade e restrições

De acordo com a especificação, a função está classificada como segura para threads (thread-safe) [AP_SWS_Fw_83010]. Por se tratar de uma função-membro constante (const), o acesso não altera o estado da instância e pode ser chamada em concorrência com segurança a partir de diferentes contextos de execução [AP_SWS_Fw_83010]. Não existem condições prévias especiais ou requisitos de ordenação segundo a especificação [AP_SWS_Fw_83010].

usar

A função-membro Message da classe ara::fw::FwErrorDomain é declarada através do ficheiro de cabeçalho ara/fw/fw_error_domain.h e serve para a obtenção síncrona de uma mensagem de erro [AP_SWS_Fw_83011]. Na chamada, o chamador passa um código de erro errorCode do tipo CodeType. Como valor de retorno, a função devolve um ponteiro do tipo const char * para a cadeia de caracteres atribuída ao código de erro [AP_SWS_Fw_83011]. A função substitui, como override, a respetiva interface da classe base [AP_SWS_Fw_83011].

Concorrência e segurança de threads

A especificação define Message expressamente como thread-safe [AP_SWS_Fw_83011]. Os chamadores podem, portanto, chamar o método em paralelo a partir de diferentes threads para a mesma instância sem medidas adicionais de sincronização. Devido à qualificação como método const, o estado do domínio de erro não é alterado durante a chamada [AP_SWS_Fw_83011].

Tratamento de erros e condições de contorno

Devido à declaração como noexcept, o método garante que não são lançadas exceções C++ [AP_SWS_Fw_83011]. Não estão definidos no elemento códigos de erro ou valores de erro específicos para códigos não resolvíveis [AP_SWS_Fw_83011]. O ponteiro retornado deverá referenciar presumivelmente uma cadeia de caracteres imutável e alocada estaticamente, não havendo, assim, qualquer obrigação de gestão de memória para o chamador. Pergunta Q-2e98884ffd517367 (aberta)

A função-membro ThrowAsException da classe ara::fw::FwErrorDomain serve para instanciar e lançar uma FwException a partir de um código de erro errorCode passado [AP_SWS_Fw_83012]. A função é incluída através do ficheiro de cabeçalho ara/fw/fw_error_domain.h e aceita como único parâmetro uma referência constante para ara::core::ErrorCode [AP_SWS_Fw_83012]. Não possui valor de retorno (void) e está declarada com const bem como override [AP_SWS_Fw_83012].

Através da cláusula de especificação noexcept(false), fica explicitamente definido que é permitido lançar exceções aquando da chamada do método; a função gera e lança deterministicamente uma FwException para o respetivo caso de erro [AP_SWS_Fw_83012]. No que diz respeito à segurança contra exceções, o método está classificado como not exception safe [AP_SWS_Fw_83012]. O código chamador deve, por conseguinte, estar preparado para o facto de que a exceção resultante interrompe o fluxo de controlo regular e exige as respetivas medidas para o tratamento de exceções.

Em termos de concorrência, o método está especificado como thread-safe, sendo permitida uma chamada simultânea a partir de múltiplas threads [AP_SWS_Fw_83012]. Através da palavra-chave override, o método substitui presumivelmente a função de interface homónima de um domínio de erro superior [AP_SWS_Fw_83012]. Pergunta Q-aae02c046243335c (aberta)