classe <DataIdentifier-Namespace>::<DataIdentifierInterface>

usar

A função construtora <DataIdentifierInterface> serve para a instanciação de um identificador de dados a partir de um ara::core::InstanceSpecifier [SWS_DM_00585]. A declaração ocorre dentro do namespace <DataIdentifier-Namespace> por meio do arquivo de cabeçalho #include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h" [SWS_DM_00585]. A chamada síncrona é especificada como noexcept e possui as propriedades “exception safe” bem como “thread-safe” [SWS_DM_00585].

A função recebe os seguintes parâmetros de passagem [SWS_DM_00585]:

• instanceSpec (ara::core::InstanceSpecifier): Identificador da instância concreta de um serviço [SWS_DM_00585].
• concurrencyType (ara::diag::ConcurrencyType): Define se a interface opera de forma thread-safe com kConcurrent ou não thread-safe com kNotConcurrent [SWS_DM_00585].

Tratamento de erros e regras de modelagem

A função não fornece valor de retorno e não lança exceções. Em vez disso, erros na configuração ou modelagem resultam em violações definidas [SWS_DM_00585]:

• InstanceSpecifierMappingIntegrityViolation: O instanceSpec não pode ser resolvido no contexto do executável ou não aponta para um PortPrototype [SWS_DM_00585].
• PortInterfaceMappingViolation: Um PortPrototype tipificado por DiagnosticDataIdentifierInterface não é referenciado por um DiagnosticDataPortMapping [SWS_DM_00585].
• ProcessMappingViolation: Não existe processo modelado correspondente para a referência de instância em relação ao processo de tempo de execução atual [SWS_DM_00585].
• InstanceSpecifierAlreadyInUseViolation: O construtor foi chamado com um instanceSpec que já está em uso no processo atual [SWS_DM_00585].

Interpretação: Como a função é declarada como noexcept, as violações constatadas devem ser tratadas internamente pelo framework como erros críticos de inicialização. Pergunta Q-8616025446bf33f2 (aberta)

simultaneidade

A própria função construtora é executada de forma thread-safe [SWS_DM_00585]. Por meio do argumento concurrencyType, controla-se se chamadas de interface subsequentes da instância podem ocorrer concorrentemente [SWS_DM_00585].

Utilização e contexto de chamada

O método síncrono Offer() permite que o Diagnostic Management (DM) encaminhe solicitações de diagnóstico de entrada para a respectiva instância de <DataIdentifierInterface> ([SWS_DM_00599]). A função não recebe parâmetros de entrada e é especificada como noexcept ([SWS_DM_00599]). Interpretação: a chamada deve ocorrer tipicamente durante a fase de inicialização da aplicação, já que o DM não pode entregar solicitações antes da disponibilização. Pergunta Q-4ba81ff234a09f46 (aberta)

Tratamento de erros e valores de retorno

Como valor de retorno serve ara::core::Result<void> ([SWS_DM_00599]). Se o registro foi bem-sucedido, o resultado não contém nenhum valor. Se o manipulador já tiver sido disponibilizado anteriormente, a chamada falha e retorna o código de erro DiagOfferErrc::kAlreadyOffered com semântica de reversão ([SWS_DM_00599]; cf. [SWS_DM_00514]).

Simultaneidade e restrições

A função garante segurança contra exceções (exception safe), mas é expressamente especificada como não segura para threads (not thread-safe) ([SWS_DM_00599]). Chamadas paralelas na mesma instância devem ser sincronizadas pela aplicação.

Interação

O padrão de disponibilização corresponde à abordagem unificada de ativação no DM: métodos Offer() análogos existem para identificadores genéricos ([SWS_DM_00638]), elementos de dados ([SWS_DM_00597]), rotinas ([SWS_DM_00557], [SWS_DM_00594]) e serviços DoIP ([SWS_DM_00725], [SWS_DM_00735]). Enquanto Offer() não tiver sido executado, o DM não encaminha solicitações para o manipulador e responde com valores padrão no caso de serviços DoIP ([SWS_DM_01525], [SWS_DM_01527]).

usar

O método Read destina-se ao fornecimento de dados de um identificador de dados de diagnóstico (DataIdentifier) no papel de leitura de um DiagnosticDataIdentifierInterface [SWS_DM_00640]. A chamada ocorre de forma assíncrona pelo Diagnostic Manager (DM) em caso de solicitações de diagnóstico externas AUTOSAR_AP_SWS_Diagnostics p. 143 §7.3.2.6.1 «NRCs created by application». Como parâmetros são passados metaInfo para avaliação das propriedades da solicitação, bem como um cancellationHandler [SWS_DM_00640]. A aplicação de processamento pode consultar o status de cancelamento por meio de cancellationHandler.IsCanceled() ou registrar, através de cancellationHandler.SetNotifier(), um callback para o caso de a sessão ser cancelada prematuramente [SWS_DM_00640]. O resultado é retornado de forma assíncrona como ara::core::Future com um objeto ReadOutput [SWS_DM_00640], [SWS_DM_00579].

Tratamento de erros

A função é especificada como exception safe e não deve propagar exceções para o exterior [SWS_DM_00640]. Se ocorrer um erro durante a obtenção dos dados, a aplicação retorna no ara::core::Future um valor de retorno negativo na forma de um código de erro UDS correspondente (NRC de acordo com a ISO 14229-1 via DiagUdsNrcErrc) ou de um ApApplicationError [SWS_DM_00640], AUTOSAR_AP_SWS_Diagnostics p. 143 §7.3.2.6.1 «NRCs created by application».

Concorrência e interação

A função de interface é por padrão not thread-safe [SWS_DM_00640]. Uma execução concorrente de acessos de leitura e escrita pelo Diagnostic Manager é regulada pelo tipo ara::diag::DataIdentifierConcurrencyType::readWrite, que é pré-configurado por padrão como kNotConcurrent [SWS_DM_00939]. Operações de leitura relacionadas existem para elementos de dados individuais através de DiagnosticDataElementInterface [SWS_DM_00596], bem como para identificadores genéricos [SWS_DM_00636].

O método StopOffer desinstala o encaminhamento de requisições de diagnóstico recebidas do Diagnostic Management (DM) para a instância de interface concreta [SWS_DM_00600]. Ao efetuar a chamada, a aplicação adaptativa sinaliza que, temporária ou permanentemente, não está mais disponível para processar requisições para este DataIdentifier.

Utilização e semântica

A chamada é síncrona, não tem parâmetros e não fornece valor de retorno [SWS_DM_00600]. O arquivo de interface gerado #include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h" deve ser incluído como cabeçalho [SWS_DM_00600]. A nomenclatura segue o padrão conhecido de ara::com, mas representa uma interface independente do domínio de diagnóstico AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

Tratamento de erros e simultaneidade

• Segurança contra exceções: A função está declarada com noexcept e garante segurança completa contra exceções (exception safe) [SWS_DM_00600]. Nenhuma exceção é lançada.
• Thread-safety: A operação está especificada como not thread-safe [SWS_DM_00600]. A chamada deve ocorrer sincronizada, para que não ocorra acesso paralelo à mesma instância da interface.

Interação

O comportamento corresponde ao padrão de desativação uniforme do Diagnostic Management, conforme definido analogamente para interfaces relacionadas, como rotinas [SWS_DM_00558], elementos de dados genéricos [SWS_DM_00639] ou serviços de download [SWS_DM_00793]. Após a desativação bem-sucedida, as requisições recebidas do DM para este DataIdentifier não são mais encaminhadas para o manipulador da aplicação [SWS_DM_00600]; o DM deve, em seguida, gerar códigos de resposta negativa correspondentes. Pergunta Q-d301740d097f9946 (aberta)

A função de interface serve para a disponibilização com segurança de tipos de um DataIdentifier (DID) de escrita no papel Write [SWS_DM_00598]. Ela é chamada pela instância do Diagnostic Server aquando da receção de solicitações de diagnóstico do serviço UDS 0x2E (WriteDataByIdentifier) [SWS_DM_00186], desde que o DID seja suportado no sistema e as verificações da sessão de diagnóstico ativa bem como do nível de segurança tenham sido aprovadas com sucesso [SWS_DM_00415] [SWS_DM_00416] [SWS_DM_00417]. Ao contrário da variante genérica com span de bytes brutos [SWS_DM_00637], o método vincula parâmetros de entrada tipificados específicos do modelo [SWS_DM_00598].

• Parâmetros: Além dos argumentos de entrada gerados, o método recebe metainformações sobre a solicitação através de metaInfo, bem como um cancellationHandler [SWS_DM_00598]. Através do manipulador de cancelamento, a aplicação pode verificar via IsCanceled se a conversação foi cancelada, ou registar com SetNotifier uma notificação para o caso de cancelamento [SWS_DM_00598].
• Valor de retorno e tratamento de erros: A execução ocorre de forma assíncrona através de ara::core::Future<void> [SWS_DM_00598]. Em caso de sucesso, o future fornece o tipo void. Em caso de erro, deve ser retornado um NRC UDS aplicável de acordo com a ISO 14229-1 mediante ara::diag::DiagUdsNrcErrc ou um ApplicationError correspondente [SWS_DM_00598]. A função é declarada como segura contra exceções (exception safe) [SWS_DM_00598].
• Concorrência: O método é classificado como não seguro para threads (not thread-safe) [SWS_DM_00598]. Se acessos de leitura e de escrita podem ser chamados em paralelo pelo Diagnostic Management é controlado através do elemento de configuração readWrite em DataIdentifierConcurrencyType [SWS_DM_00939].