Ehilà! In qualità di fornitore di API, spesso mi viene chiesto come effettuare una chiamata API in Java. All'inizio potrebbe sembrare un po' scoraggiante, ma una volta capito come funziona, in realtà è piuttosto semplice. In questo blog ti guiderò attraverso il processo passo dopo passo, così potrai iniziare a effettuare chiamate API in Java come un professionista.
Cos'è un'API?
Prima di approfondire le chiamate API in Java, esaminiamo rapidamente cos'è un'API. API sta per Application Programming Interface. È un insieme di regole e protocolli che consente a diverse applicazioni software di comunicare tra loro. Consideralo come un ponte che consente alla tua applicazione Java di interagire con servizi o origini dati esterni.
Perché utilizzare Java per le chiamate API?
Java è un linguaggio di programmazione popolare per effettuare chiamate API per diversi motivi. È indipendente dalla piattaforma, il che significa che puoi scrivere il codice una volta ed eseguirlo su qualsiasi sistema operativo. Ha anche una community ampia e attiva, quindi puoi trovare facilmente librerie e risorse che ti aiutino con le chiamate API. Inoltre, la forte tipizzazione e la natura orientata agli oggetti di Java lo rendono una scelta affidabile e sicura per la creazione di applicazioni che interagiscono con le API.
Prerequisiti
Prima di iniziare a effettuare chiamate API in Java, avrai bisogno di alcune cose:
- Kit di sviluppo Java (JDK): dovrai avere il JDK installato sul tuo computer. Puoi scaricarlo dal sito Web ufficiale di Oracle o utilizzare un'alternativa open source come OpenJDK.
- Ambiente di sviluppo integrato (IDE): Un IDE come IntelliJ IDEA o Eclipse può rendere il processo di sviluppo molto più semplice. Fornisce funzionalità come completamento del codice, debug e gestione dei progetti.
- Chiave API (se richiesta): alcune API richiedono una chiave API per autenticare le tue richieste. Assicurati di avere la chiave API necessaria prima di iniziare a effettuare chiamate.
Effettuare una semplice chiamata API in Java
Iniziamo effettuando una semplice chiamata API a un'API pubblica. Per questo esempio utilizzeremo l'API JSONPlaceholder, che fornisce dati falsi per test e prototipazione.
Innanzitutto, dovrai aggiungere le dipendenze necessarie al tuo progetto. Se stai utilizzando Maven, puoi aggiungere la seguente dipendenza al tuo filepom.xmlfile:
<dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpclient</artifactId> <version>4.5.13</version> </dependency>
Ecco il codice Java per effettuare una richiesta GET all'API JSONPlaceholder:
importare org.apache.http.HttpResponse; importa org.apache.http.client.HttpClient; importa org.apache.http.client.methods.HttpGet; importare org.apache.http.impl.client.HttpClients; importa org.apache.http.util.EntityUtils; import java.io.IOException; public class APICallExample { public static void main(String[] args) { try { // Crea un client HTTP HttpClient httpClient = HttpClients.createDefault(); // Crea una richiesta HTTP GET HttpGet httpGet = new HttpGet("https://jsonplaceholder.typicode.com/posts/1"); // Esegue la richiesta HttpResponse risposta = httpClient.execute(httpGet); // Ottieni il corpo della risposta come stringa String ResponseBody = EntityUtils.toString(response.getEntity()); // Stampa il corpo della risposta System.out.println(responseBody); } catch (IOException e) { e.printStackTrace(); } } }
In questo codice creiamo prima un fileHttpClientoggetto, che viene utilizzato per inviare richieste HTTP. Quindi creiamo unHttpGetoggetto con l'URL dell'endpoint API che vogliamo chiamare. Eseguiamo la richiesta utilizzando il fileeseguiremetodo delHttpClientoggetto, quindi otteniamo il corpo della risposta come stringa utilizzando il fileEntityUtils.toStringmetodo. Infine, stampiamo il corpo della risposta sulla console.
Gestione delle risposte API
Dopo aver effettuato una chiamata API, dovrai gestire la risposta. La risposta da un'API può essere in diversi formati, ad esempio JSON, XML o testo semplice. Nella maggior parte dei casi, le API restituiscono dati in formato JSON, quindi vediamo come analizzare le risposte JSON in Java.
Puoi utilizzare una libreria come Gson per analizzare le risposte JSON. Innanzitutto, aggiungi la dipendenza Gson al tuo filepom.xmlfile:
<dependency> <groupId>com.google.code.gson</groupId> <artifactId>gson</artifactId> <version>2.8.8</version> </dependency>
Ecco un esempio di come analizzare una risposta JSON utilizzando Gson:
importa com.google.gson.Gson; importare org.apache.http.HttpResponse; importa org.apache.http.client.HttpClient; importa org.apache.http.client.methods.HttpGet; importare org.apache.http.impl.client.HttpClients; importa org.apache.http.util.EntityUtils; import java.io.IOException; importa java.util.Map; public class JSONParsingExample { public static void main(String[] args) { try { HttpClient httpClient = HttpClients.createDefault(); HttpGet httpGet = nuovo HttpGet("https://jsonplaceholder.typicode.com/posts/1"); Risposta HttpResponse = httpClient.execute(httpGet); String rispostaBody = EntityUtils.toString(response.getEntity()); // Analizza la risposta JSON utilizzando Gson Gson gson = new Gson(); Map<String, Object> jsonMap = gson.fromJson(responseBody, Map.class); // Stampa il titolo del post System.out.println("Titolo: " + jsonMap.get("titolo")); } catch (IOException e) { e.printStackTrace(); } } }
In questo codice, innanzitutto effettuiamo una chiamata API all'API JSONPlaceholder e otteniamo il corpo della risposta come stringa. Quindi creiamo unGsonoggetto e usarlodaJsonmetodo per analizzare la stringa JSON in un fileMappaoggetto. Infine, stampiamo il titolo del post accedendo al filetitolodigitare ilMappa.
Effettuare richieste POST
Oltre alle richieste GET, potresti anche dover effettuare richieste POST a un'API. Le richieste POST vengono utilizzate per inviare dati a un'API, ad esempio per creare una nuova risorsa.
Ecco un esempio di come effettuare una richiesta POST in Java:
importare org.apache.http.HttpResponse; importa org.apache.http.client.HttpClient; importa org.apache.http.client.methods.HttpPost; importa org.apache.http.entity.StringEntity; importare org.apache.http.impl.client.HttpClients; importa org.apache.http.util.EntityUtils; import java.io.IOException; public class PostRequestExample { public static void main(String[] args) { try { HttpClient httpClient = HttpClients.createDefault(); HttpPost httpPost = nuovo HttpPost("https://jsonplaceholder.typicode.com/posts"); // Imposta il corpo della richiesta String json = "{\"title\": \"foo\", \"body\": \"bar\", \"userId\": 1}"; Entità StringEntity = nuova StringEntity(json); httpPost.setEntity(entità); httpPost.setHeader("Tipo di contenuto", "application/json"); // Esegue la richiesta HttpResponse risposta = httpClient.execute(httpPost); String rispostaBody = EntityUtils.toString(response.getEntity()); // Stampa il corpo della risposta System.out.println(responseBody); } catch (IOException e) { e.printStackTrace(); } } }
In questo codice creiamo prima un fileHttpPostoggetto con l'URL dell'endpoint API che vogliamo chiamare. Successivamente impostiamo il corpo della richiesta creando un fileStringEntityoggetto e impostandolo come entità diHttpPostoggetto. Impostiamo anche ilTipo di contenutointestazione aapplicazione/jsonper indicare che stiamo inviando dati JSON. Infine, eseguiamo la richiesta e stampiamo il corpo della risposta.


Le nostre offerte API
In qualità di fornitore di API, offriamo un'ampia gamma di API per diversi settori e casi d'uso. Sia che tu stia cercandoScheda di preparazione standard da 1 mm, 1,5 mm, 2 mm Scheda PLC standard Piastra standard in gel di silice Dimensioni 200*200 m,3-BUTIL-2-(1-ETILPENTIL)OSSAZOLIDINA CAS N. 165101-57-5, OPiastra di preparazione ad alta efficienza PLC da 0,5 mm, 1 mm, 1,5 mm, 2 mm Piastra di preparazione piastra in gel di silice PLC di grandi dimensioni 200 * 200 mm, ti abbiamo coperto.
Le nostre API sono progettate per essere facili da usare e integrarsi nelle tue applicazioni esistenti. Forniamo documentazione dettagliata e supporto per aiutarti a iniziare rapidamente. Se sei interessato a utilizzare le nostre API, non esitare a contattarci per una prova gratuita o per discutere le tue esigenze specifiche.
Conclusione
Effettuare chiamate API in Java è un'abilità preziosa che può aprire un mondo di possibilità per le tue applicazioni. Seguendo i passaggi descritti in questo blog, ora dovresti avere una buona conoscenza di come effettuare chiamate API in Java, gestire le risposte ed effettuare richieste POST.
Se hai domande o hai bisogno di ulteriore assistenza, non esitare a contattarci. Siamo qui per aiutarti a sfruttare al massimo le nostre API e portare le tue applicazioni al livello successivo.
Riferimenti
- Documentazione di Apache HttpClient
- Documentazione Gson
- Documentazione dell'API JSONPlaceholder