3 Funcionalidad JSONPath

Descripción general

Esta sección proporciona detalles de la funcionalidad JSONPath admitida en los pasos de preprocesamiento del valor de la métrica.

JSONPath consta de segmentos separados por puntos. Un segmento puede ser o bien una palabra simple o el nombre de un valor JSON, * o una construcción más compleja encerrada entre corchetes [ ]. El punto separador antes del segmento de soporte es opcional y se puede omitir. Por ejemplo:

Ver también: Escapar con caracteres especiales los valores de macro LLD en JSONPath.

Segmentos admitidos

Para encontrar un segmento coincidente ignorando su ascendencia (segmento separado) debe tener el prefijo '..', por ejemplo, $..nombre o $..['nombre'] retorna los valores de todas las propiedades de 'nombre'.

Los nombres de elementos coincidentes se pueden extraer agregando un sufijo ~ al JSONPath. Devuelve el nombre del objeto coincidente o un índice en formato de cadena del elemento de matriz coincidente. El formato de salida sigue las mismas reglas que otras consultas JSONPath: los resultados de la ruta definitiva son devueltos 'tal cual' y los resultados de ruta indefinida se devuelven en una matriz. Sin embargo, no tiene mucho sentido extraer el nombre de un elemento que coincide con un camino definido: ya se conoce.

Filtrar expresión

La expresión de filtro es una expresión aritmética en notación infija.

Operandos soportados:

Operadores soportados:

Funciones

Las funciones se pueden utilizar al final de JSONPath. Múltiples funciones pueden ser encadenadas si la función anterior devuelve un valor aceptado por la siguiente función.

Funciones soportadas:

Los valores numéricos citados son aceptados por las funciones agregadas JSONPath. Significa que los valores se convierten de tipo cadena a numérico si se requiere agregación.

Una entrada incompatible hará que la función genere un error.

Valor de salida

JSONPaths se puede dividir en rutas definidas e indefinidas. Una ruta definida puede devolver solo un valor nulo o una única coincidencia. Una ruta indefinida puede devolver múltiples coincidencias, básicamente segmentos JSONPaths con múltiples y separadas listas de nombres/índices, segmentos de matriz o segmentos de expresión. Sin embargo, cuando se utiliza la función, JSONPath se vuelve definido, como siempre lo hacen las funciones de salida de valor único.

Una ruta definida devuelve el objeto/matriz/valor al que hace referencia, mientras que una ruta indefinida devuelve una matriz de objetos/matrices/valores coincidentes.

Espacio en blanco

Los espacios en blanco (espacios, caracteres de tabulación) se pueden utilizar libremente notación y expresiones de segmentos entre paréntesis, por ejemplo, $[ 'a' ][ 0 ][ ?( $.b == 'c' ) ][ : -1 ].first().

Cadenas

Las cadenas deben estar entre comillas simples ' o dobles ". Dentro de las cadenas, las comillas simples o dobles (dependiendo de cuáles se utilicen para encerrar la cadena) y las barras invertidas \ se escapan con el carácter de barra invertida \.

Ejemplos

Datos de entrada

{
         "books": [
           {
             "category": "reference",
             "author": "Nigel Rees",
             "title": "Sayings of the Century",
             "price": 8.95,
             "id": 1
           },
           {
             "category": "fiction",
             "author": "Evelyn Waugh",
             "title": "Sword of Honour",
             "price": 12.99,
             "id": 2
           },
           {
             "category": "fiction",
             "author": "Herman Melville",
             "title": "Moby Dick",
             "isbn": "0-553-21311-3",
             "price": 8.99,
             "id": 3
           },
           {
             "category": "fiction",
             "author": "J. R. R. Tolkien",
             "title": "The Lord of the Rings",
             "isbn": "0-395-19395-8",
             "price": 22.99,
             "id": 4
           }
         ],
         "services": {
           "delivery": {
             "servicegroup": 1000,
             "description": "Next day delivery in local town",
             "active": true,
             "price": 5
           },
           "bookbinding": {
             "servicegroup": 1001,
             "description": "Printing and assembling book in A5 format",
             "active": true,
             "price": 154.99
           },
           "restoration": {
             "servicegroup": 1002,
             "description": "Various restoration methods",
             "active": false,
             "methods": [
               {
                 "description": "Chemical cleaning",
                 "price": 46
               },
               {
                 "description": "Pressing pages damaged by moisture",
                 "price": 24.5
               },
               {
                 "description": "Rebinding torn book",
                 "price": 99.49
               }
             ]
           }
         },
         "filters": {
           "price": 10,
           "category": "fiction",
           "no filters": "no \"filters\""
         },
         "closed message": "Store is closed",
         "tags": [
           "a",
           "b",
           "c",
           "d",
           "e"
         ]
       }