APRENDER. PRATICAR. EVOLUIR.Conceito e mecanismo
Antes de criar Apex para um LWC, avaliar base components e Lightning Data Service para os objetos e operações suportados. UI API aplica segurança de objetos, campos e registos. O wire fornece um fluxo de valores que devem ser tratados como imutáveis e pode emitir novamente quando dependências mudam. Uma transformação visual deve usar uma cópia local, preservando propriedade dos dados. Métodos Apex usados com wire exigem cacheable true e leitura sem mutação. Uma operação de escrita deliberada, como confirmar uma decisão, deve usar um caminho adequado, frequentemente uma chamada imperativa. Esta devolve uma Promise, cujo sucesso ou erro deve ser tratado explicitamente.
Aplicação guiada
Uma escrita confirmada não atualiza automaticamente todos os caminhos de leitura. Para Apex wire, guardar o resultado provisionado e passá-lo a refreshApex; o valor resolvido da Promise de refresh não é o array de dados a apresentar. Quando Apex imperativo altera registos usados por LDS, notificar os IDs afetados pelo mecanismo apropriado. Não assumir um TTL fixo nem repetir a decisão de negócio para forçar atualização visual. Entre componentes, transmitir um contrato pequeno: um CustomEvent com ID primitivo pode bastar para comunicar seleção. Se for necessário um objeto, evitar entregar uma referência mutável aos dados internos do emissor. Separar estados pendente, concluído e falhado na experiência do operador.
Uma consola mostra uma lista Apex wire e um painel LDS. Depois de confirmar a decisão por Apex, atualiza os dois consumidores através dos respetivos mecanismos. Enquanto a leitura é atualizada, apresenta estado pendente sem voltar a gravar.
Armadilhas comuns
Mutar dados wire; escrever num método cacheable; Promise sem tratamento; Map JavaScript como parâmetro serializável garantido; um refresh para todos os caminhos.
Tópicos relacionados: Modelo de dados, identidade e metadados · Coleções e escolha entre configuração e código · Consultas, DML e resultados de erro
Distinguir leitura reativa, escrita deliberada e atualização de cache. Comunicar entre componentes com contratos pequenos e claros.
Referência: Client-Side Caching of Apex Method Results · Platform Developer guide Summer 25