classe ara::diag::DynamicAccessListDiagServiceBuilder

usar

O método síncrono Add da classe ara::diag::DynamicAccessListDiagServiceBuilder serve para adicionar um único byte (Byte value) a um DynamicAccessListPattern [SWS_DM_01175]. O valor de byte passado é verificado quanto à correspondência exata na avaliação dos direitos de acesso para serviços de diagnóstico [SWS_DM_01175]. Ao retornar uma referência para a instância do mesmo objeto (DynamicAccessListDiagServiceBuilder&), a função suporta a chamada como API fluente [SWS_DM_01175].

Tratamento de erros e segurança de exceções

A operação é declarada como noexcept e especificada como segura contra exceções (exception safe) [SWS_DM_01175]. Não são retornados códigos de erro nem valores de retorno do tipo ara::core::Result; mensagens específicas de DET ou DEM não constam no payload para esta função.

Simultaneidade e restrições

O método é especificado como não seguro para threads (not thread-safe) [SWS_DM_01175]. Interpretação: chamadas na mesma instância de builder devem, portanto, ocorrer tipicamente de forma sequencial dentro de uma única thread, antes que o padrão de acesso criado seja avaliado no servidor de diagnóstico. Pergunta Q-69d895fc6bf90cb4 (aberta)

Interação

Dentro da interface DynamicAccessListDiagServiceBuilder, este método complementa sobrecargas correlatas de Add, com as quais sequências de bytes via ByteString [SWS_DM_01176] ou intervalos de valores via ByteRange [SWS_DM_01177] podem ser adicionados a um DynamicAccessListPattern.

A função-membro Add da classe ara::diag::DynamicAccessListDiagServiceBuilder serve para adicionar uma sequência de bytes a um DynamicAccessListPattern [SWS_DM_01176]. Por meio do parâmetro de entrada values do tipo ByteString, é passada uma sequência de bytes que é verificada quanto a uma correspondência exata na avaliação posterior de direitos de acesso para serviços de diagnóstico [SWS_DM_01176]. Como valor de retorno, o método fornece uma referência à mesma instância de builder (DynamicAccessListDiagServiceBuilder&), o que viabiliza o uso de uma interface fluente (Fluent API) mediante encadeamento de múltiplas chamadas [SWS_DM_01176].

Em relação ao tratamento de erros, a função é declarada como noexcept e especificada como segura contra exceções (exception safe) [SWS_DM_01176]. Não são reportados códigos de erro nem exceções C++.

Quanto à concorrência, o método é definido como não seguro para threads (not thread-safe) [SWS_DM_01176]. Se múltiplas threads acessarem a mesma instância de builder em paralelo, as chamadas deverão ser sincronizadas no lado da aplicação. Interpretação: a chamada deve ocorrer de forma síncrona no contexto de execução da thread da aplicação configuradora, visto que nenhum mecanismo assíncrono está especificado. Pergunta Q-d93498e82292a88e (aberta)

Na interação do gerenciamento de diagnóstico, este método complementa funções de builder correlatas para a definição de padrões de acesso dinâmicos: enquanto sequências completas de bytes são registradas com esta função, alternativamente também podem ser adicionados ao padrão bytes individuais ([SWS_DM_01175]) ou intervalos de valores ([SWS_DM_01177]) por meio de funções Add sobrecarregadas.

A função Add da classe ara::diag::DynamicAccessListDiagServiceBuilder serve para que aplicações adicionem um intervalo de valores de bytes a um DynamicAccessListPattern [SWS_DM_01177]. O parâmetro range passado, do tipo ByteRange, define um intervalo de valores que é verificado quanto à correspondência durante a avaliação de direitos de acesso para serviços de diagnóstico [SWS_DM_01177].

Para a chamada e a integração no gerenciamento de diagnóstico, aplicam-se as seguintes propriedades:

• Contexto de chamada e semântica: a chamada ocorre de forma síncrona. Como valor de retorno, a função fornece uma referência de objeto para a mesma instância de builder (DynamicAccessListDiagServiceBuilder&), a fim de suportar um uso fluido da interface (Fluent API) por meio de encadeamento de métodos [SWS_DM_01177].
• Tratamento de erros: a operação é declarada como noexcept e possui a propriedade de especificação exception safe [SWS_DM_01177]. Não são retornados códigos de erro específicos e nenhuma exceção é lançada.
• Concorrência: a função é explicitamente especificada como not thread-safe [SWS_DM_01177]. Interpretação: se múltiplas threads de execução acessarem a mesma instância de builder, a aplicação chamadora deve sincronizar o acesso externamente. Pergunta Q-c51760a8fe29bd5f (aberta)
• Interação: o método complementa funções correlatas da classe builder para adicionar valores de byte individuais através de [SWS_DM_01175], bem como para definir sequências de bytes por meio de [SWS_DM_01176], a fim de configurar padrões de acesso flexíveis.

usar

O método ara::diag::DynamicAccessListDiagServiceBuilder::Any serve para o software de aplicação definir caracteres universais num padrão de acesso ([SWS_DM_01178]). A chamada síncrona é efetuada numa instância do builder. Através do parâmetro numberOfBytesToIgnore, define-se quantos bytes consecutivos são incluídos no padrão de acesso, mas ignorados na posterior correspondência de padrões (pattern matching) em relação a pedidos de diagnóstico recebidos ([SWS_DM_01220]). O retorno de uma referência de objeto para o mesmo builder permite um estilo de chamada de API fluente (AUTOSAR_AP_SWS_Diagnostics §8.15.1.2.3.4 «Any»).

Tratamento de erros e comportamento com exceções

A função está especificada como noexcept e segura em termos de exceções (exception safe) ([SWS_DM_01178]). Não estão previstos códigos de erro nem mensagens de retorno para o DET ou DEM. Interpretação: ao passar o valor 0 para numberOfBytesToIgnore, a chamada deverá retornar sem erro e não registar quaisquer bytes de carácter universal no padrão. Pergunta Q-e372cda9f8840893 (aberta)

Simultaneidade e restrições

A interface está explicitamente indicada como não segura entre threads (not thread-safe) ([SWS_DM_01178]). Múltiplas chamadas do builder na mesma instância de DynamicAccessListDiagServiceBuilder têm, por isso, de ser executadas obrigatoriamente de forma sequencial ou sincronizadas pelo chamador.

Interação

Definições de marcadores de posição através de Any são tipicamente combinadas com padrões como EndsWith ([SWS_DM_01221]). Após a composição de todos os componentes do padrão, a configuração deve ser finalizada com o método Build ([SWS_DM_01222]), antes de a lista de acesso resultante ficar disponível para verificações (AUTOSAR_AP_SWS_Diagnostics §7.3.2 «Adding wildcards to a DynamicAccessList»).

usar

O método síncrono Build da classe ara::diag::DynamicAccessListDiagServiceBuilder ([SWS_DM_01166]) conclui a criação de uma lista de acesso dinâmica ([SWS_DM_01181]). A função não aceita parâmetros de passagem e não possui valor de retorno ([SWS_DM_01181]). Através da chamada, a instância do Diagnostic Server responsável assume as regras de acesso compostas ([SWS_DM_01222]).

Tratamento de erros

A operação está declarada como noexcept e especificada como segura em termos de exceções (exception safe) ([SWS_DM_01181]). Não são devolvidos códigos de erro nem são lançadas exceções.

Simultaneidade e restrições

O método está classificado como não seguro entre threads (not thread-safe) ([SWS_DM_01181]). Os acessos simultâneos ao mesmo objeto builder a partir de múltiplos contextos de execução devem, por conseguinte, ser protegidos externamente. Além disso, existe uma condição estrita de ordenação: Build tem de ser obrigatoriamente chamado antes de o objeto service builder ser destruído ([SWS_DM_01181]). Interpretação: caso esta chamada não seja efetuada antes do fim de vida do objeto, os padrões previamente configurados deverão perder a validade e não produzir efeitos para a autorização. Pergunta Q-445ea33ece339d42 (aberta)

Interação

No âmbito da criação da lista, são definidos previamente padrões de serviço e de pedido, por exemplo através de caracteres universais via Any ([SWS_DM_01220]) ou padrões finais via EndsWith ([SWS_DM_01221]), tal como descrito em SWS Diagnostics §7.3.2.3.4 «DynamicAccessList Creation and Update». Build finaliza este processo de construção e transmite a lista ao servidor ([SWS_DM_01222]).

O método síncrono EndsWith da classe ara::diag::DynamicAccessListDiagServiceBuilder serve para aplicações definirem um único byte (Byte value) como padrão de terminação de uma lista de acesso dinâmica [SWS_DM_01179]. Na chamada, a instância do Diagnostic Server atribui esse padrão ao final da DynamicAccessList para verificar a correspondência exata durante a avaliação de direitos de serviços de diagnóstico [SWS_DM_01221]. A função não fornece valor de retorno.

Em relação ao tratamento de erros, a função está especificada como segura contra exceções (exception safe) e declarada com noexcept [SWS_DM_01179]. Códigos de erro específicos, mensagens de DET ou DEM não estão previstos no escopo da especificação para esta chamada de método.

Em relação à concorrência, o método está indicado como não seguro para threads (not thread-safe) [SWS_DM_01179]. Em caso de acesso concorrente à mesma instância de builder, é necessária uma sincronização externa pela aplicação. Interpretação: a definição do padrão final presume-se que deva ocorrer antes da chamada de Build [SWS_DM_01222], uma vez que o Diagnostic Server finaliza a DynamicAccessList com Build. Pergunta Q-a0afa7deaafa306b (aberta)

Na interação com requisitos relacionados, existe, além desta variante de valor único, uma sobrecarga EndsWith(ByteRange range) [SWS_DM_01180] que permite a especificação de um intervalo fechado de valores de bytes como padrão de terminação SWS Diagnostics §8.15.1.2.3.6 «EndsWith(ByteRange)». Ambas as variantes configuram o padrão final da mesma lista de acesso antes de sua utilização [SWS_DM_01221].

usar

O método EndsWith da classe ara::diag::DynamicAccessListDiagServiceBuilder serve para definir um intervalo de bytes fechado (ByteRange range) no final do padrão de busca de uma lista de acesso dinâmica (DynamicAccessList) [SWS_DM_01180]. Na chamada do método, a instância do Diagnostic Server anexa o padrão especificado ao final da DynamicAccessList [SWS_DM_01221]. Esse intervalo de valores é utilizado subsequentemente na avaliação dos direitos de acesso para serviços de diagnóstico AUTOSAR_AP_SWS_Diagnostics §8.15.1.2.3.6 «EndsWith(ByteRange)». A chamada ocorre de forma síncrona e não retorna valor (void) [SWS_DM_01180].

Tratamento de erros e simultaneidade

A operação é declarada como noexcept e especificada como segura contra exceções (exception safe); códigos de erro ou tratamentos de exceção específicos não existem [SWS_DM_01180]. Em relação à concorrência, o método é classificado como não seguro para threads (not thread-safe) [SWS_DM_01180]. O acesso paralelo à mesma instância de builder a partir de múltiplas threads não é permitido sem sincronização externa.

Zusammenspiel e ciclo de vida

No escopo da criação de padrões, existe, além desta variante para intervalos de valores, uma sobrecarga alternativa de EndsWith que define um único byte (Byte value) para a correspondência exata de padrão no final [SWS_DM_01179]. Após a configuração do padrão, a lista deve ser finalizada pela chamada de Build [SWS_DM_01222], antes que a aplicação possa utilizar a DynamicAccessList gerada para verificações de permissão AUTOSAR_AP_SWS_Diagnostics §7.3.2 «End patterns of a DynamicAccessList».