Ktor è un web framework per Kotlin per la creazione di applicazione asincrone sia client che server.
In questo articolo vediamo come usarlo per creare una web api; ovviamente faremo un esempio basico.
Io ho creato il progetto partendo dalla pagina di start, aggiungendo i plugins GSON e Routing.
ExchangeRate API è un servizio gratuito per ottenere informazioni sulle valute.
Non sembrano esserci limiti alle richieste, ed non è richiesta una registrazione.
Dalle FAQ si evince che i dati vengono aggiornati ogni 24 ore.
Prendendo l'esempio di base dalla documentazione, vediamo come interrogare queste API in Java.
Abbiamo già visto Gson precedentemente: ottima libreria per Java per manipolare JSON.
Oggi vediamo due esempi:
Oggi vediamo un semplice esempio di come usare AJAX insieme a Java Spring.
Il servizio che andremo a interrogare è OMDb, che abbiamo visto anche altre volte.
I dati verranno forniti in formato JSON e quindi useremo la libreria Gson per l'elaborazione dei dati.
Un esempio lo potete trovare qui; addesso lo applicheremo al web!
Prima di tutto scaricate la libreria Gson e incorporatela al progetto.
Poi creiamo la classe che farà da wrapper per il film di risposta:
public class Film {
public String Title;
public String Released;
public String Genre;
public String Director;
public String Writer;
public String Actors;
public String Plot;
public String Poster;
public String Runtime;
public String imdbID;
}
Ogni campo corrisponde a un valore di risposta che poi visualizzeremo nella pagina.
Ad oggi si nota sempre di più il proliferare di web service che usano JSON per rappresentare i dati, o accanto o in sostituzione del più classico XML.
Java non ha una libreria in grado di decodificare JSON.
Ma ci sono tantissime librerie esterne in grado di farlo.
Su consiglio del forum ioProgrammo mi sono diretto su questa: Gson.
E' molto semplice da usare ed è in grado sia di codificare che di decoficare il formato JSON.
Qui lo useremeo per la seconda operazione.
Vediamo come connetterci al servizio imdbapi per recuperare informazioni sui film.
Prima di tutto scaricate la libreria e aggiungetela al vostro progetto.
Poi dovete vedere come il servizio vi restituisce i dati in modo da creare una classe che li rappresenta.
Ad esempio imdbapi restituisce una cosa del genere (vi mostro solo una parte):
{
"Title":"The Immature",
"Year":"2011",
"Rated":"T",
"Released":"21 Jan 2011",
"Genre":"Comedy",
.........
}
Quindi la mia classe completa è questa:
public class Film {
public String Title;
public String Released;
public String Genre;
public String Director;
public String Writer;
public String Actors;
public String Plot;
public String Poster;
public String Runtime;
public String ID;
}
Qui ci sono tutti i dati che io personalmente voglio estrapolare dalla stringa JSON.