Requisiti tecnici

• NetBeans IDE 8.0.2
• Linguaggio: Java
• Interfaccia: Java-swing
• Funzioni esterne: Geocoding e OpenWeather
• API: XPath, parser

Istruzioni

Aprire il progetto tramite NetBeans ed eseguirlo. Nella prima schermata è richiesto, se necessario, l'inserimento del proxy di rete altrimenti utilizzare l'apposita voce e continuare senza l'inserimento. Nella schermata seguente verrà richiesto di inserire il nome, anche approssimato, del luogo di cui si richiedono le caratteristiche. Latitudine, longitudine, temperatura attuale, temperatura minima, temperatura massima e condizione del cielo sono le informazioni ricavabili dal programma. Una volta inserito il nome desiderato compariranno i luoghi con il relativo nominativo e l'utente dovrà scegliere il risultato desiderato cliccandoci sopra. A questo punto compariranno le relative informazioni legate al posto e, tramite il bottone indietro, si può tornare alla schermata di ricerca del posto.

Strumenti e librerie utilizzati

Geocoding

Geocoding è un sito fornito da Google che effettua un servizio di ricerca e descrizione di una città o paese. I dati ricavati sono nel formato tipico dell'xml e tramite l'uso della libreria XPath si possono ottenere le informazioni desiderate.

OpenWeather

OpenWeather è un servizio di providing che provvede alla fornitura di un documento xml contenente i dati relativi al tempo atmosferico e alle temperature di un determinato posto. Tramite l'XPath si possono ottenere le informazioni desiderate.

XPath

E' un'API o libreria di sistema che sfruttando l'organizzazione gerarchica del formato del documento xml permette tramite l'uso del carattere "/" lo spostamento tra i nodi dell'albero mentre tramite alcune funzioni come "text()" permette l'interpretazione dei dati contenuti nei tag.

Parser

Un parser XML è una libreria di sistema che modifica il documento xml in modo da ottenere una struttura utilizzabile dall'XPath per la ricerca di informazioni.

#Struttura del software

Il software è raggruppato in 3 package:

1. jxg.GUI Contiene i quattro frame che definiscono l'interfaccia grafica e sono rispettivamente la definizione del proxy, la ricerca di una località, la scelta tra i risultati ottenuti e le informazioni relative alla località scelta
2. jxg.internet Questo package contiene la parte relative alle connessioni che vengono aperte con un oggeto URL e URLConnection. Questo package inoltre contiene la classe che gestice il proxy
3. jxg.meteo Questo package contiene la classe Luogo e Meteo e le rispettivi classi con il compito di gestire tramite l'XPath i documenti xml. Luogo si riferisce al sito di Geocoding mentre Meteo all'OpenWeather.