Starter kit per la pubblicazione di API interoperabili in Java

Questo repository contiene il template di un'API interoperabile scritta in Java.

Contenuto

• Un progetto di esempio in java jax-rs
• Una directory openapi con le specifiche

Istruzioni

Gli step per la creazione di API interoperabili sono:

1. scrivere le specifiche in formato OpenAPI v3 partendo dagli esempi in openapi;

2. scrivere o generare il codice a partire dalle specifiche. Ora i tool di swagger per Java supportano correttamente OpenAPI v3.

3. scrivere i metodi dell'applicazione

Scrivere le specifiche

Le specifiche devono essere scritte in formato OpenAPIv3 e rispettando le Linee Guida di interoperabilità.

Queste presentazioni possono essere d'aiuto:

• Introduzione ad OpenAPI
• REST nel nuovo modello di interoperabilità

Risolvere le dipendenze negli OpenAPI

Le specifiche OpenAPI possono contenere riferimenti a schemi esterni o yaml anchors. E' possibile risolverli tramite il modulo python openapi_resolver, richamato dal Makefile.

In questo repository, i file con anchor e ref hanno estensione .yaml.src ma sono a tutti gli effetti file OAS3 validi e la maggior parte dei tool li interpreta correttamente. E' comunque possibile dereferenziarli per comodità tramite il comando:

make yaml

Generare il codice del server

Il Makefile contiene:

• un esempio di code generation java direttamente via openapi v3. Basta lanciare:

  make java-jaxrs
  

Il generatore non sovrascrive i file contenuti in .swagger-codegen-ignore.

Il .war generato viene eseguito all'interno di un container jboss

Dipendenze

Per eseguire questa app servono:

make
python 3 + tox
docker

Test

E' possibile testare in locale tramite circleci, con:

    circleci build