json — n_pbt_json #

← Riferimento dei componenti · Sommario della guida

Costruire un JSON tipo per tipo — stringa, numero, booleano, array, oggetto annidato — con l'escaping fatto per te, poi rileggerne uno lungo un percorso: of_load, of_get_string, of_type, of_count. Un solo oggetto costruisce le tue richieste e legge le tue risposte. Tutto in PowerScript puro: nessuna pagina, nessun motore, PowerBuilder 10 incluso.

▶ Vederlo dal vivo — Applicazione dimostrativa, riquadro JSON: i risultati, il codice che li produce e questa pagina, fianco a fianco.

In breve #

n_pbt_json è autoinstantiate: lo si dichiara come variabile locale, senza create né destroy. È lo stesso oggetto che, internamente, costruisce i payload inviati al motore — ora offerto al tuo codice, sul lato costruzione e lettura.

Avvio rapido #

Costruire un payload, poi rileggere una risposta — tutto in una variabile locale:

// Local variables
n_pbt_json  lnv_json
string      ls_customer
double      ld_total

// Write : each member is typed and escaped for you - a path may have levels
lnv_json.of_set_string(/*path*/ "customer", /*value*/ "Ada")
lnv_json.of_set_number(/*path*/ "total", /*value*/ 690.50)
lnv_json.of_set_boolean(/*path*/ "paid", /*value*/ true)

// lnv_json.of_text() -> {"customer":"Ada","total":690.5,"paid":true}

// Read : load a response, reach values by path
lnv_json.of_load(/*json*/ '{"order":{"customer":"Ada","total":690.50}}')
IF lnv_json.of_is_valid() THEN
	ls_customer = lnv_json.of_get_string(/*path*/ "order/customer")   // Ada
	ld_total    = lnv_json.of_get_number(/*path*/ "order/total")     // 690.5
END IF

Un percorso sono le chiavi dalla radice unite da /; l'indice di un array è la sua posizione, contata da 1, come ogni posizione della libreria: order/lines/1 è la prima riga, order/lines/0 non designa nulla. Un segmento vuoto (a//b, /a) o un indice 0 su un array non designa nulla — una scrittura lo rifiuta con -5 — e una chiave che contiene / non è indirizzabile. Se un oggetto scrive la stessa chiave due volte, è la sua PRIMA occorrenza a essere letta e scritta — un browser conserva l'ultima.

Costruire un payload #

Leggere un documento #

// Local variables
n_pbt_json  lnv_json
string      ls_tags[]
string      ls_compact
long        ll_count

// Read every element of an array at once, then store the document on one line
lnv_json.of_load(/*json*/ '{"customer":{"name":"Ada","tags":["vip","b2b"]}}')
ll_count = lnv_json.of_get_array(/*path*/ "customer/tags", /*values*/ ls_tags)   // 2 : vip, b2b

// The document on one line, without a space : the smallest text to store
ls_compact = lnv_json.of_pretty(/*indent*/ 0)

Modificare un documento #

Il lato scrittura cambia il documento caricato sul posto, poi of_text ne rende il risultato (compatto) — ciò che si riscrive. I setter sostituiscono il valore al percorso, o aggiungono l'ultima chiave quando manca a un oggetto padre. Ognuno rende 0, -4 quando il padre manca o è del tipo sbagliato, -5 su un percorso vuoto o un indice 0 su un array. Un array incontrato lungo il percorso si attraversa con un indice ESISTENTE (items/1/qty aggiunge qty al primo elemento); si crea sempre e solo una chiave di oggetto. Un valore null (numero, booleano, JSON grezzo vuoto) si scrive null.

// Local variables
n_pbt_json  lnv_json

// Load, edit in place, then read back the ONE document with of_text
lnv_json.of_load(/*json*/ '{"name":"Ada","active":false}')
lnv_json.of_set_string(/*path*/ "name", /*value*/ "Grace")   // replace
lnv_json.of_set_boolean(/*path*/ "active", /*value*/ true)
lnv_json.of_set_number(/*path*/ "count", /*value*/ 3)        // added : the key was absent

// lnv_json.of_text() -> {"name":"Grace","active":true,"count":3}

Ambito. Il JSON si analizza in PowerScript puro, senza pagina né motore: n_pbt_json resta autoinstantiate e funziona ovunque, PowerBuilder 10 incluso. Per l'XML, vedi xml (che si appoggia al motore); per mostrare un JSON come albero comprimibile, vedi jsontree.

← Riferimento dei componenti · Sommario della guida