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 tanto una palabra simple como 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 caracteres especiales de valores de macro LLD en JSONPath.

Supported segments

To find a matching segment ignoring its ancestry (detached segment) it must be prefixed with '..' , for example $..name or $..['name'] return values of all 'name' properties.

Matched element names can be extracted by adding a ~ suffix to the JSONPath. It returns the name of the matched object or an index in string format of the matched array item. The output format follows the same rules as other JSONPath queries - definite path results are returned 'as is' and indefinite path results are returned in array. However there is not much point of extracting the name of an element matching a definite path - it's already known.

Filter expression

Filter expression is a arithmetical expression in infix notation.

Supported operands:

Supported operators:

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

Input data

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