5.2.1 - Lectura

JSONTokener

El primer que haurem de fer serà analitzar el document per a obtenir l'element arrel (que com hem vist normalment serà un objecte, però de vegades pot ser un array).

El constructor de JSONTokener admet un String, amb la qual cosa analitzarem una cadena que posem directament, o també un InputStream o un Reader, amb la qual cosa podrem analitzar directament el contingut d'un fitxer

El mètode nextValue() de JSONTokener tornarà l'arrel del document Json, i només haurem de fer un cast a l'ojecte que és l'arrel: un JSONObject o un JSONArray

En el següent exemple agafem el json directament d'un string, on teníem els números parells.

{ "p1" : 2 , "p2" : 4 , "p3" : 6 , "p4" : 8 , "p5" : 10 }

Observeu com per a la definició del String ens ha tocat escapar les dobles cometes. Copieu el següent codi en el fitxer Kotlin Exemple_3_5_11_JSONAnalitzarCadena.kt

package exemples

import org.json.JSONTokener
import org.json.JSONObject

fun main(args: Array<String>) {

    val cadena = "{ \"p1\" : 2 , \"p2\" : 4 , \"p3\" : 6 , \"p4\" : 8 , \"p5\" : 10 }"

    val arrel = JSONTokener(cadena).nextValue() as JSONObject

    println(arrel.get("p1"))
}

Mentre que en aquest exemple accedim al fitxer parelles.json (que assumirem que té el mateix contingut). Podríem passar el contingut del fitxer a una cadena, però és molt més còmode passar el Reader com paràmetre en el constructor, i ell s'encarrega de llegir-lo tot. Copieu el següent codi en el fitxer Exemple_3_5_12_JSONAnalitzarFitxer.kt :

package exemples

import org.json.JSONTokener
import org.json.JSONObject
import java.io.FileReader

fun main(args: Array<String>) {

    val r_json = FileReader("parelles.json")

    val arrel = JSONTokener(r_json).nextValue() as JSONObject

    println(arrel.get("p3"));
}

JSONObject

Contindrà un objecte json. Recordeu que l'objecte es delimita amb les claus: {  }

El mètode més important serà get(clau) al qual li passem la clau del membre que volem obtenir. Si el membre és una parella clau-valor, obtindrem directament el valor. Si és un altre objecte, doncs obtindrem l'objecte o també podria ser un array. El cas que siga una parella clau-valor, ja l'hem vist en l'exemple anterior.

En el següent exemple, en el fitxer Empleat.json tindrem un empleat

{ "empleat" :
  { "num": 1 ,
    "nom": "Andreu" ,
    "departament": 10 ,
    "edat": 32 ,
    "sou": 1000.0
  }
}

Observeu com ara de l'element arrel hem d'agafar empleat, que és un objecte amb les parelles clau-valor num, nom, ....

Copieu el segúent codi en el fitxer Kotlin Exemple_3_5_13_JSONAnalitzarEmpleat.kt :

package exemples

import org.json.JSONTokener
import org.json.JSONObject
import java.io.FileReader

fun main(args: Array<String>) {

    val r_json = FileReader("Empleat.json")

    val arrel = JSONTokener(r_json).nextValue() as JSONObject

    val empleat = arrel.get("empleat") as JSONObject

    println("" + empleat.get("nom") + " (" + empleat.get("sou") + ")")
}

També podem utilitzar els mètodes getJSONObject(), getJSONArray, getInt(), getString(), ..., que directament ens ho dóna en el tipus especificat, i no cal fer cast.

JSONArray

Serà l'array, que recordem que ve limitat per els claudàtors: [  ]

Per a obtenir els elements de l'array utilitzarem el mètode get(index), on l'índex és el número d'ordre de l'element que volem obtenir.

També tindrem els mètodes getJSONObject(index), getJSONArray(index), getInt(index), ..., que tornen directament el tipus especificat

Posem el primer exemple sobre un json que només té un array els elements del qual són valors:

[ 5 , 7 , 8 , 7 ]

Observeu com ara l'arrel és un Array, i ens muntem un bucle per obtenir tots els elements. Copieu el següent codi en el fitxer Exemple_3_5_14_JSONAnalitzarArray.kt

package exemples

import org.json.JSONTokener
import org.json.JSONArray

fun main(args: Array<String>) {

    val cadena = "[ 5 , 7 , 8 , 7 ]"

    val arrel = JSONTokener(cadena).nextValue() as JSONArray

    for (i in arrel)
        println(i)
}

Com veieu podem fer servir els bucles foreach, però lamentablement no podem obtenir directament un JsonObject, i per tant l'hem de reconvertir. Ho mostrarem en el següent exemple en el qual agafem tots els empleats de l'empresa, on Empresa.json és així:

{ "empresa" :
    { "empleats":
           [
        { "num":1, "nom": "Andreu", "departament": 10, "edat": 32, "sou": 1000.0}  ,
        { "num":2, "nom": "Bernat", "departament": 20, "edat": 28, "sou": 1200.0}  ,
        { "num":3, "nom": "Clàudia", "departament": 10, "edat": 26, "sou": 1100.0}  ,
        { "num":4, "nom": "Damià", "departament": 10, "edat": 40, "sou": 1500.0}
       ]
    }
}

Tindrem un objecte arrel, amb només un objecte, empresa, que té un únic membre empleat que és un array amb 4 elements, cadascun dels empleats. Copieu el següent exemple en el fitxer kotlin Exemple_3_5_15_JSONAnalitzarEmpresa.kt

package exemples

import org.json.JSONTokener
import org.json.JSONObject
import java.io.FileReader

fun main(args: Array<String>) {

    val r_json = FileReader("Empresa.json")

    val arrel = JSONTokener(r_json).nextValue() as JSONObject
    val empresa = arrel.getJSONObject("empresa")

    for (e in empresa.getJSONArray("empleats")){
        val emp = e as JSONObject
        println("" + emp.get("nom") + " (" + emp.get("sou") + ")")
    }
}

Mireu com ens hem estalviat un pas, i no hem definit la variable empleats, sinó que ho especifiquem en el bucle. També podríem haver estalviat la variable empresa si en el bucle haguérem posat :

for (e in arrel.getJSONObject("empresa").getJSONArray("empleats")){