Modern API management
This project tries to provide a modern approach to manage APIs combining Protobuf and OpenAPI specification.
The project tries to address the following challenges:
- Contract definitions
- Contract compatibility enforcement
- Contract versioning
- OpenAPI definition generation
- Stub generation to different languages
- Client SDK generation to different languages
- Swagger-UI to display the HTTP API
- API management guideline
- ETC
Free Advanced Java Course
I am the author of the Advanced Java for adults course. This course contains advanced and not conventional lessons. In this course, you will learn to think differently from those who have a limited view of software development. I will provoke you to reflect on decisions that you take in your day to day job, which might not be the best ones. This course is for middle to senior developers and we will not teach Java language features but how to lead complex Java projects.
This course's lectures are based on a Trading system, an opensource project hosted on my Github.
Get started
make generate
make install
Use the built Docker image
We are sharing a docker image with everything required by this project
docker run -it -v "$(pwd):/workspace" -v "$HOME"/.m2:/root/.m2 -w /workspace apssouza/proto-api-manager
make generate
make install
If you prefer to build a local image docker build . -f assets/Dockerfile -t apssouza/proto-api-manager
Stub generation
Generate stub code to different languages(Javascript, Java, Golang)
./bin/go-gen.sh
./bin/java-gen.sh
./bin/js-gen.sh ./protos 0.0.12
Code distribution
Share the API generated code to different languages(Java, Golang)
./bin/go-deploy.sh
./bin/js-deploy.sh ./protos
./bin/java-package.sh
./bin/java-install.sh
OpenAPI definition
Reads protobuf service definitions and generates service definition files. These files can then be used by the Swagger-UI project to display the API and Swagger-Codegen to generate clients in various languages.
./bin/swagger-gen.sh
./bin/swagger-assets-package.sh
HTTP Client SDKs
Use the service definition files along with Swagger-Codegen to generate HTTP clients for the service in Java and Golang.
./bin/gen-sdk-clients.sh
HTTP Client UI
Use the service definition files along with Swagger-UI project to display the HTTP API version
Swagger-UI
- Run the services/swaggerui/main.go
- Access https://localhost:8081/?def-file=./definition/book/v1/books.swagger.json
Quality assurance
Guarantee the quality of the API by using the project Buf to ensure that the API follows a code style
This is done using Github actions. Check out the .github/workflows/ci.yml
Back compatibility
Guarantee back-compatibility of the API by using the project Buf to ensure that the API changes doesn't break the existing contract.
This is done using Github actions. Check out the .github/workflows/ci.yml
API management guideline
Check out a guideline to help manage the APIs in a microservice environment
Microservice example
Check out 2 microservices examples inside ./services to get inspired. Book microservice is in Golang and
Shelf microservice is in Java.