4 Funcionalidad JSONPath

Descripción general

Esta sección describe la funcionalidad JSONPath admitida dentro de los pasos de preprocesamiento del valor del elemento.

JSONPath se compone de segmentos separados por puntos. Un segmento puede tomar la forma de una palabra simple, que representa un nombre de valor JSON, el carácter comodín (*) o una construcción más compleja encerrada entre corchetes. El punto antes de un segmento entre corchetes es opcional y se puede omitir.

Consulte también: Escapar de caracteres especiales de valores de macro LLD en JSONPath.

Segmentos admitidos

Para encontrar un segmento coincidente ignorando su ascendencia (segmento separado), debe tener el prefijo dos puntos (..). Por ejemplo, $..name o $..['name'] devuelven valores de todas las propiedades de name.

Los nombres de elementos coincidentes se pueden extraer agregando un sufijo de tilde (~) 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 definida se devuelven "tal cual" y los resultados de la ruta indefinida se devuelven en una matriz. Sin embargo, tiene un valor mínimo extraer el nombre de un elemento que coincida con una ruta definitiva, como 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. Se pueden encadenar varias funciones si la función anterior devuelve un valor aceptado por la siguiente función.

Funciones soportadas:

Las funciones agregadas JSONPath aceptan valores numéricos entre comillas. Estos valores se convierten automáticamente de cadenas a tipos numéricos cuando es necesario agregarlos. La 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 sólo un valor nulo o una única coincidencia. Una ruta indefinida puede devolver múltiples coincidencias: JSONPaths con múltiples listas de nombres/índices separadas, sectores de matriz o segmentos de expresión. Sin embargo, cuando se utiliza una función, JSONPath se vuelve definitivo, ya que las funciones siempre generan un valor único.

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

::: nota importante Es posible que el orden de las propiedades en los resultados de la consulta JSONPath no se alinee con el orden de las propiedades JSON originales debido a métodos de optimización internos. Por ejemplo, JSONPath $.books[1]["autor", "título"] puede devolver ["título", "autor"]. Si es esencial preservar el orden de propiedad original, se deben considerar métodos alternativos de procesamiento posterior a la consulta. :::

Reglas de formato de ruta

Los espacios en blanco (espacio, carácter de tabulación) se pueden utilizar en expresiones y segmentos de notación entre corchetes, por ejemplo: $[ 'a' ][ 0 ][ ?( $.b == 'c' ) ][ : -1 ].first ( ).

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

Ejemplo

{
         "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"
         ]
       }