Merge Patch JSON
Crie ou aplique um Merge Patch JSON conforme definido na RFC 7396. No modo de criação, compare um documento original com um documento de destino para obter o menor merge patch entre eles. No modo de aplicação, mescle um patch em um documento: null remove uma chave e objetos são mesclados recursivamente.
Perguntas frequentes
O que é um Merge Patch JSON?
Um merge patch, definido na RFC 7396, é um documento JSON que representa as alterações que descreve. Chaves recebem ou têm seus valores substituídos; chaves definidas como null são removidas; e objetos aninhados são mesclados. APIs o aceitam com o tipo de mídia application/merge-patch+json.
Qual é a diferença em relação ao Patch JSON?
O Patch JSON (RFC 6902) é uma lista de operações com caminhos. Um merge patch é mais simples de ler e escrever, mas não pode definir um valor como null e sempre substitui arrays inteiros, em vez de alterar itens individuais.
Por que o modo de criação rejeita meu destino?
Em um merge patch, null significa remover a chave, então não é possível expressar um destino que define como null uma chave dentro de um objeto. A mensagem informa o caminho. Use o Patch JSON para esse tipo de alteração.
Como os arrays são tratados?
Os itens dos arrays nunca são mesclados individualmente. Se um array for diferente, o patch contém o array novo inteiro, e aplicá-lo substitui completamente o array antigo.
O que acontece se o patch não for um objeto?
Segundo a RFC 7396, um patch que não seja um objeto, como um array ou uma string, substitui o documento inteiro.
O que significa um patch vazio?
No modo de criação, {} significa que os dois documentos são iguais. Aplicar {} a um objeto JSON não o altera.