jJsonObject1JSON / ArrayObrigatório
Base da comparação.
FUNçãOEm revisão
framework.types.json.Compare
framework.types.json.Compare( jJsonObject1, jJsonObject2, [@cRet] ) --> lRetCompara objetos JSON por propriedades e valores.
Visão geral
A função evita comparar apenas a serialização textual dos objetos. A ficha descreve comparação sem depender da ordem de propriedades ou arrays e diferencia nomes de propriedades por maiúsculas/minúsculas; se a ordem de um array fizer parte do contrato, não presumir igualdade estrita por posição. Exige LIB 20211004 ou superior e binário com suporte a TLPP. Os dois argumentos devem ter o mesmo tipo, JSON/JSON ou Array/Array, com ressalvas documentadas para arrays JSON na raiz. O exemplo usa somente objetos simples com propriedades reordenadas. code e qty são chaves fixas do contrato didático, preservadas nos idiomas. (TOTVS, s.d., ref. 1)
Sintaxe
framework.types.json.Compare( jJsonObject1, jJsonObject2, [@cRet] ) --> lRetParâmetros
jJsonObject2JSON / ArrayObrigatório
Objeto/array do mesmo tipo da base.
cRetCaractereOpcional
Diagnóstico passado por referência.
Retorno
Lógico da comparação; cRet pode receber diagnóstico por referência.
Exemplo comentado
#Include "Protheus.ch"
User Function Ed392()
Local jBase := JsonObject():New()
Local jComparado := JsonObject():New()
Local cDiferencas := ""
// JSONs fixos validos; apenas a ordem das propriedades difere.
jBase:FromJson('{"code":"A","qty":2}')
jComparado:FromJson('{"qty":2,"code":"A"}')
ConOut(cValToChar(framework.types.json.Compare(jBase,jComparado,@cDiferencas)))
FreeObj(jBase)
FreeObj(jComparado)
Return NilResultado esperado
Verdadeiro no ambiente compatível; ordem das propriedades não muda esse conteúdo. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Validar parse de entradas externas e interpretar diagnóstico. Comparação não valida regra de negócio nem autenticidade dos dados.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.