Comunicazione tra Rest WebServices

[acronalb]

Ciao a tutti,
sto lavorando ad un progetto composto da servizi Rest tramite l'ausilio del framework Jersey.
I vari servizi funzionando perfettamente se testati uno ad uno in modo indipendente ma qui sorge il mio problema.

come faccio a far comunicare tra loro dei servizi rest?

faccio un esempio:
Servizio A: mi prende in dati dal FrontEnd (idAccount, Nome, Cognome etc...) e li mette in formato JSON
servizio B: prende alcuni dati dal servizio A e fa dei controlli sul DB.

come faccio ad inviare tali dati dal servizio A al servizio B?

Grazie

[andbin]

Ciao a tutti,
come faccio ad inviare tali dati dal servizio A al servizio B?

Devi usare una API/libreria di "HTTP client" per fare delle request verso altri servizi. E visto che hai parlato di REST, sarebbe utile una API/libreria che permetta di ragionare meglio in termini di REST.

Non so che versione di Jersey usi ma se implementa JAX-RS 2.x (e non la 1.x), allora sappi che in JAX-RS 2 c'è già una client API standard.

Poi dove/come tenere gli url (se cablarli nel codice o renderli configurabili ecc...) è un altro discorso.

[acronalb]

Devi usare una API/libreria di "HTTP client" per fare delle request verso altri servizi. E visto che hai parlato di REST, sarebbe utile una API/libreria che permetta di ragionare meglio in termini di REST.

Non so che versione di Jersey usi ma se implementa JAX-RS 2.x (e non la 1.x), allora sappi che in JAX-RS 2 c'è già una client API standard.

Poi dove/come tenere gli url (se cablarli nel codice o renderli configurabili ecc...) è un altro discorso.

è da poco che mi sono messo a studiare i Rest Service, sapresti indicarmi qualche esempio su libri o siti? ho provato a cercare esempi concreti ma non ho trovato quasi nulla.

al momento quello che faccio è questo :

System.out.println(StringInJson.stringFromJson(gson.toJson(WalletAdaptor.fromGiocataToWallet(g1)).toString()));        
        String stringToSend = StringInJson.stringFromJson(gson.toJson(WalletAdaptor.fromGiocataToWallet(g1)).toString());
        
        String url = "http://localhost:8080/orches/webapi/wallet/saldo/"+stringToSend; 
         // create request.
         HttpClient client = HttpClientBuilder.create().build(); 
         HttpGet request = new HttpGet(url); 
         // execute your request. 
         HttpResponse response = client.execute(request); 
        
         HttpEntity entity = response.getEntity();
         // Read the contents of an entity and return it as a String.
         String content = EntityUtils.toString(entity);
         System.out.println(content);

in pratica all'url che chiama l'altro servizio Rest ci ho aggiunto in coda un parametro stringa che contiene tutto il JSON dei dati che voglio inviargli.
la classe StringInJson rimpiazza i caratteri "illegali" che non potrei inviare con l'url (es parentesi graffe e virgolette).

è corretto o si fa in un altro modo ?

la versione di jersey che sto utilizzando al momento è la 2.27

[andbin]

è da poco che mi sono messo a studiare i Rest Service, sapresti indicarmi

System.out.println(StringInJson.stringFromJson(gson.toJson(WalletAdaptor.fromGiocataToWallet(g1)).toString()));        
        String stringToSend = StringInJson.stringFromJson(gson.toJson(WalletAdaptor.fromGiocataToWallet(g1)).toString());
        
        String url = "http://localhost:8080/orches/webapi/wallet/saldo/"+stringToSend;

è corretto o si fa in un altro modo ?

No, non è proprio un buon modo. A parte che per encodare dei dati da usare nel url ci sono già funzionalità apposite es. la java.net.URLEncoder del framework standard.

Ma la questione comunque è più "profonda". Perché mai dovresti mettere un pezzo di JSON dentro un url?? Non si fa ....

E quel /orches/webapi/wallet/saldo/ concettualmente cosa fa? Un insert o update?? E se sì, allora perché lo fa con metodo GET?

Il punto è che penso (temo ....) che in quello che hai fatto, di REST ci sia poco/nulla. REST non vuol dire "ah, faccio tutti gli endpoint che voglio, mettendo quello che mi pare nel url e usando i verbi HTTP come capita". No, questo non è REST ... è HTTP usato a cavolo ...

[acronalb]

Ma la questione comunque è più "profonda". Perchè mai dovresti mettere un pezzo di JSON dentro un url?? Non si fa ....

è proprio questo il mio dubbio, non mi sembrava molto bello aggiungere un JSON in un url ma è l'unico modo che ho trovato "funzionante".

Faccio un esempio riguardo quello che non ho capito.
Leggendo su vari siti e guide, creare un progetto basato su microservizi Rest consiste nel creare dei microservizi ognuno per ogni azione "basilare".
Partendo da questa frase per effettuare una semplice chiamata al DB mi viene da pensare così
- creo un servizio Rest (lo chiamo A) che mi legge i dati dal Client (es l'idAccount) .
- creo un servizio Rest (lo chiamo B) che mi interroga il DB con l'idAccount per vedere il saldo nel wallet.

Fin qui la struttura è più o meno corretta?
ora quello che mi manca è come faccio ad inviare il mio idAccount dal servizio A al B con cui poi va a fare l'interrogazione al DB?

Ovviamente è un esempio semplice, giusto per capire un concetto a me non molto chiaro, ma il servizio A comprende altre operazioni che richiama in base ai dati che riceve dal client.

[andbin]

è proprio questo il mio dubbio, non mi sembrava molto bello aggiungere un JSON in un url ma è l'unico modo che ho trovato "funzionante".

Non è questione se "funziona" ... NON è REST.

consiste nel creare dei microservizi ognuno per ogni azione "basilare".

Sì ma non c'entra nulla direttamente con REST. Poi non è che deve fare solo una cosa, può anche fare più cose purché molto correlate. Se un microservizio si occupa di gestire gli utenti (elencarli, registrarli, ecc..) allora non si occuperà di certo di ricevere gli ordini di prodotti, perché è un contesto ben diverso.

Fin qui la struttura è più o meno corretta?
ora quello che mi manca è come faccio ad inviare il mio idAccount dal servizio A al B con cui poi va a fare l'interrogazione al DB?

Non è questo il punto. La vera questione è REST, che temo non hai affatto usato.

REST innanzitutto è uno "stile architetturale". L'obiettivo generale è di utilizzare HTTP come protocollo di livello "applicativo", sfruttando tutto ciò che HTTP ha da offrire, cioè: url, header, verbi, status code, content-negotiation, ecc...

REST vuol dire Representational State Transfer, il concetto essenziale è quello di trasferire avanti e indietro delle "rappresentazioni" delle risorse. Che possono essere in vari formati, JSON, XML, altro. Se l'applicazione è fatta e gestita opportunamente, può anche offrire più formati per una stessa risorsa in base alla content-negotiation tra client e server. Un client A potrebbe chiedere la rappresentazione XML di un libro con ID 1234 e un altro client B potrebbe chiedere la rappresentazione JSON dello stesso libro con ID 1234.


A livello basilare vuol dire:
- sfruttare gli url per rappresentare delle "risorse"
- usare i verbi HTTP (es. GET, POST ecc...) per realizzare le classiche operazioni CRUD (create-read-update-delete)


Esempio semplice: gestione di libri. Si stabilire un url che rappresenta la "collezione" dei libri es.
http://blabla/api/books
(nota, books al plurale!)


GET http://blabla/api/books
per ottenere la lista dei libri (eventualmente filtrata e/o paginata e/o ordinata usando appositi query param)

GET http://blabla/api/books/1234
per ottenere la rappresentazione del libro di ID 1234

POST http://blabla/api/books
per inserire un nuovo libro (rappresentazione del libro nel body della request)

PUT http://blabla/api/books/1234
per aggiornare il libro di ID 1234 (nuova rappresentazione del libro nel body della request)

DELETE http://blabla/api/books/1234
per eliminare il libro di ID 1234


Se hai fatto qualcosa già di abbastanza/molto diverso da una cosa del genere .... non è REST ..... è HTTP usato a casaccio ...