Fornire sia interfacce RESTful che Java?

The problem is it's difficult to write same semantic Java interface to a RESTful one, I mean same semantic.

Che cosa è difficile? Il modo standard per eseguire le interfacce REST in Java consiste nella scrittura di un'interfaccia Java e nell'aggiunta di alcune annotazioni JAX-RS, tutto qui.

Non scrivo in Java, ma valgono gli stessi concetti.

Per la maggior parte dei progetti su cui lavoro, cerco di fare entrambe le cose. Fondamentalmente il mio progetto è impostato in modo tale che l'interfaccia REST usi solo l'API sottostante. Fondamentalmente il flusso è:

REST -> Front-end API -> Useful code

In questo modo posso scrivere front-end aggiuntivi per lo stesso back-end. Generalmente non rilascio l'API, ma cerco di tenerlo in uno stato che, se deve essere rilasciato, può essere.

Ad esempio, in un progetto, avevo bisogno di aprire un'API TCP usando JSON e fornire pacchetti di output UDP. Dato che tutto stava già attraversando l'API standard, questo era davvero semplice.

In risposta alla tua domanda, rilascerei solo l'API REST (come indicato da @MichaelBorgwardt, non è così terribile come sembra) quindi devi solo supportarne ufficialmente uno, ma sicuramente tenerli separati così è facile per rilasciarlo come libreria o aggiungere un front-end diverso.

Guarda le tue esigenze. Hai un solido requisito per REST? Questo cliente è di fronte o interno? Le risposte a queste domande possono rispondere per te.

Se esterno, vorrei solo fare REST e averlo fatto. Se interno, guarda i tuoi consumatori e prendi una decisione. Farei l'uno o l'altro e non entrambi.

Se hai la risorsa per creare l'interfaccia Java, fallo. Sono sicuro che l'API REST sia la tua API principale, solitamente perché è un sistema client-server. Non è difficile scrivere codice client che chiama REST api direttamente ma è anche più lungo e se lo usi molto, vedrai le ripetizioni dappertutto.

Ciò che accade di solito è scrivere un wrapper nativo per le interfacce più usate per aiutare le persone a scrivere applicazioni client. Inoltre, offre un ulteriore vantaggio che quando si modifica l'interfaccia REST è possibile aggiornare semplicemente il wrapper, ad es. quando cambi RIP api dal ritorno dell'applicazione / json all'applicazione / hal + json il tuo wrapper restituisce ancora l'array di oggetti.

Puoi vederlo ovunque. Twitter, ad esempio, ha più di un wrapper Java. Ovviamente non hanno il tempo di scrivere wrapper per ogni lingua là fuori, ma è anche molto utile che molte persone mettano del tempo per scriverne uno.