⌛⌛ Maiden tilastoja (JSON)¶

Tehtävän palautus koostuu Maven-projektista. Sijoita pom.xml-tiedosto paikallisen tietovarastosi round7/jsoncountries-hakemistoon ja tee tähän hakemistoon src/main/java-niminen alihakemisto. Tee luokkatiedostot Country.java ja CountryData.java ja liitä ne fi.tuni.prog3.jsoncountries-nimiseen pakkaukseen. Tiedostojesi tulee olla siten hakemistossa round7/jsoncountries/src/main/java/fi/tuni/prog3/jsoncountries. NetBeans osaa luoda tehtävässä pom.xml-tiedoston ja hakemistorakenteen automaattisesti, kun annat Maven-projektia luodessasi oikeat tiedot.

Materiaalien etätietovarastossa on saatavilla aineistoa (round7/jsoncountries-hakemisto).

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än pohja-aineistona toimii maailmanpankin julkaisemasta avoimesta datasta poimittu otos, joka sisältää tietoa maiden pinta-alasta, väkiluvusta ja bruttokansantuotteesta (GDP, gross domestic product). Tehtävän aineisto on 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.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. Desimaalierottimena käytetään pistettä. Voit muotoilla merkkijonon haluttuun muotoon String-luokan format-jäsenfunktiolla.

  • 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.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 projektitiedostoosi pom.xml seuraavat määritykset:

• artifactId-elementin arvo on jsoncountries.

• version-elementin arvo on 1.0.

• maven.compiler.source ja maven.compiler.target -elementtien arvo on 17 tai pienempi. Tarkistimella on asennettuna Java 17, joten tätä uudempaa versiota ei voi käyttää.

• Onejar-liitännäisen määritys, jonka mainClass-elementin arvo on CountryTest, joka on alla kuvattu valmiina annettu testiluokka.