classe ara::diag::ExternalAuthentication

O construtor explícito [SWS_DM_01193] inicializa uma instância da classe de porto ara::diag::ExternalAuthentication [SWS_DM_01191] para autenticação de clientes de diagnóstico externos (SWS Diagnostics §8.17 «Header: ara/diag/external_authentication.h»). Como parâmetro, a função espera um ara::core::InstanceSpecifier, que tem de referenciar um PortPrototype, modelado no manifesto, de uma instância de serviço DiagnosticExternalAuthenticationInterface [SWS_DM_01193].

A chamada síncrona está declarada como noexcept e especificada tanto como thread-safe quanto como exception-safe [SWS_DM_01193]. Como não são lançadas exceções, erros de modelação e de configuração conduzem a violações definidas da framework [SWS_DM_01193]:

• InstanceSpecifierMappingIntegrityViolation: o identificador não pode ser resolvido no contexto do executável ou referencia outro elemento de modelo que não um PortPrototype.
• PortInterfaceMappingViolation: o PortPrototype referenciado não está tipificado por um DiagnosticExternalAuthenticationInterface.
• ProcessMappingViolation: não existe nenhum processo de runtime modelado adequado para a referência.
• InstanceSpecifierAlreadyInUseViolation: o identificador já está a ser utilizado por outra instância no processo em execução.

As operações de cópia estão explicitamente impedidas para ExternalAuthentication [SWS_DM_01196] [SWS_DM_01197], enquanto as operações de movimento são suportadas [SWS_DM_01194] [SWS_DM_01195]. Ao contrário do construtor, o destrutor associado não é seguro entre threads [SWS_DM_01198]. Após uma instanciação bem-sucedida, o objeto serve para consultar instâncias de autenticação de clientes associadas através de métodos como Get ou GetAll [SWS_DM_01201] [SWS_DM_01202].

O método síncrono ara::diag::ExternalAuthentication::Get serve para que uma aplicação adaptativa obtenha a instância de ara::diag::ClientAuthentication responsável por uma solicitação de diagnóstico [SWS_DM_01199]. Como parâmetro, é passada uma referência para metaInfo (const ara::diag::MetaInfo&), que disponibiliza metainformações do contexto da solicitação de diagnóstico SWS Diagnostics §7.3.1.1 «MetaInfo class». O valor de retorno do tipo ara::core::Result<ClientAuthentication> encapsula o respectivo objeto de autenticação para gerenciar o estado de autenticação do cliente [SWS_DM_01202].

Se ocorrer um erro, o Result retornado conterá o código de erro específico DiagErrc::kServiceNotAvailable [SWS_DM_01199]. Este sinaliza com semântica de rollback que a chamada não pode ser executada porque funções essenciais do Diagnostic Manager (DM) não estão disponíveis no momento da chamada [SWS_DM_01199].

Quanto à concorrência, a função está especificada como thread-safe bem como exception safe e declarada com noexcept [SWS_DM_01199]. Portanto, ela pode ser chamada com segurança a partir de threads paralelas sem mecanismos de bloqueio no lado da aplicação.

O método atua em conjunto com a variante sobrecarregada Get(Address sourceAddress) [SWS_DM_01200], a qual possibilita a mesma obtenção diretamente por meio do endereço de origem do cliente [SWS_DM_01202]. A quantidade de instâncias disponíveis é determinada pelos elementos de modelo DiagnosticExternalAuthenticationIdentification SWS Diagnostics «Get ClientAuthentication Instance». Interpretação: a função deve determinar internamente o endereço de origem necessário para a associação a partir dos dados de transporte encapsulados em metaInfo. Pergunta Q-50d416201ccb5825 (aberta)

O método síncrono Get da classe ara::diag::ExternalAuthentication serve para que uma aplicação adaptativa obtenha a instância de ClientAuthentication que gerencia o estado de autenticação do cliente de diagnóstico para o endereço de origem especificado [SWS_DM_01200]. O Diagnostic Manager resolve aqui o objeto de autenticação responsável por meio do endereço de origem passado [SWS_DM_01202].

A utilização e as condições de contorno abrangem os seguintes aspectos:

• Chamada e parâmetros: Como parâmetro é passado sourceAddress do tipo Address [SWS_DM_01200]. No modelo do sistema, a resolução baseia-se em elementos DiagnosticExternalAuthenticationIdentification configurados, que definem endereços de origem fixos ou faixas de endereços SWS Diagnostics p. 129 «ClientAuthentication». Além disso, existe uma sobrecarga de Get, a qual determina a instância por meio de um objeto MetaInfo [SWS_DM_01199], [SWS_DM_01202].
• Valor de retorno e tratamento de erros: A função retorna um ara::core::Result<ClientAuthentication> [SWS_DM_01200]. Se a execução não for possível porque funções essenciais do Diagnostic Manager não estão disponíveis, o erro DiagErrc::kServiceNotAvailable é retornado com semântica de rollback [SWS_DM_01200].
• Concorrência: A operação está especificada como thread-safe e exception safe, bem como declarada com noexcept, razão pela qual chamadas a partir de threads paralelas podem ser realizadas de forma segura contra exceções [SWS_DM_01200].

usar

O método GetAll da classe ara::diag::ExternalAuthentication (arquivo de cabeçalho ara/diag/external_authentication.h) serve para que aplicações consultem sincronamente todas as instâncias de ClientAuthentication atualmente gerenciadas pelo Diagnostic Manager [SWS_DM_01201], [SWS_DM_01203]. A chamada é feita sem parâmetros e retorna um ara::core::Vector<ClientAuthentication> contendo todos os objetos de autenticação associados [SWS_DM_01201].

Tratamento de erros e valores de retorno

A função está declarada como segura contra exceções (exception safe) e noexcept [SWS_DM_01201]. Não existem códigos de erro específicos ou mensagens para o DET ou DEM para esta interface. Caso não haja objetos de autenticação disponíveis, isso não é tratado como erro; em vez disso, o método retorna um vetor vazio [SWS_DM_01201].

Simultaneidade e restrições

A especificação define GetAll como segura para threads (thread-safe) [SWS_DM_01201]. Interpretação: chamadas a partir de múltiplas threads de aplicação paralelas devem, portanto, ser admissíveis sem sincronização adicional no lado da aplicação. Pergunta Q-9f26d94068ebd3fe (aberta)

Interação

A quantidade de instâncias recuperáveis corresponde aos elementos de modelo configurados do tipo DiagnosticExternalAuthenticationIdentification, os quais definem endereços de origem fixos ou faixas de endereços AUTOSAR_AP_SWS_Diagnostics p. 129. Enquanto GetAll disponibiliza a totalidade de todas as instâncias [SWS_DM_01203], o método Get permite a consulta direcionada para um endereço de origem específico ou metainformação [SWS_DM_01202].

O destrutor ~ExternalAuthentication() encerra o ciclo de vida de uma instância da classe ara::diag::ExternalAuthentication do cabeçalho ara/diag/external_authentication.h [SWS_DM_01198]. Ele é executado de forma síncrona ao sair do escopo ou na liberação do objeto, não requer parâmetros de passagem e não possui valor de retorno AUTOSAR_AP_SWS_Diagnostics §8.17.1.2.1.2 «Destructor».

Quanto ao tratamento de erros, a função é provida do especificador noexcept e formalmente definida como segura contra exceções (exception safe) [SWS_DM_01198]. A chamada garante, portanto, que em caso de erro nenhuma exceção C++ interrompa o processo de destruição ou seja repassada ao chamador.

No que diz respeito à concorrência e restrições, deve-se observar que o destrutor está especificado como não seguro para threads (not thread-safe) [SWS_DM_01198]. Os componentes chamadores devem garantir, portanto, que durante a destruição não ocorram acessos simultâneos por meio de threads separadas à mesma instância de ara::diag::ExternalAuthentication. Provavelmente, todas as operações ativas de diagnóstico e de autenticação dessa instância deveriam estar completamente finalizadas antes da chamada, a fim de evitar acessos descoordenados à memória. Pergunta Q-67c112ea87f722d2 (aberta)

No contexto funcional, a interface realiza o requisito de nível superior RS_Diag_04251 para o gerenciamento de diagnóstico (DM) AUTOSAR_AP_SWS_Diagnostics §8.17.1.2.1.2 «Destructor». A identificação tabular como destrutor de uma Dynamic-Access-List presume-se que seja uma imprecisão editorial da especificação, uma vez que o escopo e o namespace definem a vinculação a ExternalAuthentication [SWS_DM_01198]. Pergunta Q-30744aac322624cb (aberta)