⌛⌛ Maiden tilastoja (JSON)¶

Palautus koostuu Maven-projektista. Aseta vastauksesi tiedostoihin pom.xml, src/main/java/fi/tuni/prog3/round8/jsoncountries/Country.java, src/main/java/fi/tuni/prog3/round8/jsoncountries/CountryData.java hakemistoon Round8/jsoncountries. Muista hakea materiaalit ``student_template_project``sta.

Tässä tehtävässä kokeillaan JSON-datan lukemista sekä kirjoittamista käyttäen valmista siihen sopivaa Googlen GSON-kirjastoa: https://github.com/google/gson/blob/master/UserGuide.md. Tämän linkin takaa löytyy tieto, millainen Maven-riippuvuus kirjaston käyttöön tarvitaan.

Tehtävä on oleellisesti samanlainen kuin maiden tilastoja XML-muodossa käsitellyt tehtävä: erona on vain JSON-muotoisen datan käsittely XML-datan sijaan. Tehtävän aineistokin on itseasiassa täysin sama, mutta se on vain muunnettu ohjelmallisesti XML-muodosta JSON-muotoon. Tämän vuoksi aineiston rakenne on hieman kömpelö: muunnostyökalu on pyrkinyt noudattamaan orjallisesti alkuperäisen XML-tiedoston muotoa.

Sinun tulee toteuttaa luokat Country ja CountryData, joilla on ainakin alla kuvatut ominaisuudet. Voit päättää muut yksityiskohdat itse.

• Luokka Country tallettaa maan nimen (merkkijono), pinta-alan (double), väkiluvun (long) ja bruttokansantuotteen (double).

  • Määritetty pakkaukseen fi.tuni.prog3.round8.jsoncountries.

  • Toteuttaa rajapinnan Comparable<Country> niin, että vertailu perustuu maan nimeen String-luokan luonnollisen järjestyksen mukaisesti.

  • Julkinen jäsenfunktio String toString(), joka palauttaa maan tiedot esimerkkitulosteissa kuvatulla tavalla: ensin maan nimi, ja sen alla kahdella välilyönnillä sisennettyinä omilla riveillään pinta-ala, väkiluku ja bruttokansantuote. Double-arvot yhden desimaalin tarkkuudella.

  • Julkiset jäsenfunktiot String getName(), double getArea(), long getPopulation() ja double getGdp(), jotka palauttavat nimiensä kuvaamat tiedot.

• Luokka CountryData tarjoaa kaksi julkista staattista jäsenfunktiota maita koskevan datan lukemiseen ja kirjoittamiseen JSON-muodossa.

  • Määritetty pakkaukseen fi.tuni.prog3.round8.jsoncountries.

  • List<Country> readFromJsons(String areaFile, String populationFile, String gdpFile) lukee maiden tietoja parametrien nimeämistä JSON-tiedostoista.

    • Tiedostot sisältävät parametrien nimien mukaisesti tietoa maiden pinta-aloista, väkiluvuista ja bruttokansantuotteista. Tiedot ovat siis kolmessa erillisessä tiedostossa.

    • Päättele tiedostojen rakenne tutkimalla annettuja esimerkkisyötetiedostoja. Kunkin tiedoston rakenne on keskenään samankaltainen: yhtä maata koskevat tiedot ovat record-objektin sisällä olevissa field-objekteissa. Kullakin field-objektilla on avaimen “attributes” alla avain “name”, jonka arvosta voit päätellä, minkä tiedon kyseinen field-objekti sisältää.

    • Funktio palauttaa jonkinlaisen rajapinnan List<Country> toteuttavan listan, joka sisältää luettua dataa kuvaavat Country-oliot. Sinun tulee näin ollen yhdistää kolmesta eri JSON-tiedostosta luetut tiedot Country-olioihin.

  • void writeToJson(List<Country> countries, String countryFile) kirjoittaa listan countries sisältämien Country-olioiden kuvaamat tiedot JSON-muodossa parametrin countryFile nimeämään tiedostoon.

    • JSON-taulukko, joka sisältää yhden JSON-objektin kutakin maata kohden. Kukin JSON-objekti kuvaa yhden maan tiedot avainten name, area, population ja gdp alla.

    • Katso tarkka muoto esimerkkitulosteista. Tulostuksen muoto vastaa GSON-kirjaston muotoilua setPrettyPrinting().

Automaattiset (sekä alla kuvatut) testit olettavat, että teet projektiedostoosi pom.xml seuraavat määritykset:

• artifactId-elementin arvo on jsoncountries.

• version-elementin arvo on 1.0.

• onejar-liitännäisen määritys, jonka mainClass-elementin arvo on CountryTest.

  • CountryTest on alla kuvattu valmiiksi annettu testiluokka.