This repository implements a minimal Sling application using the Aries JAX-RS Whiteboard modules to implement HTTP APIs that can be documented with OpenAPI.
The org.fipro.modifier.jaxrs example was useful in setting this up.
To start this, run
mvn clean install exec:java
Adding the required MAVEN_OPTS for debugging if desired.
Then open http://localhost:8080 - which might require logging in at http://localhost:8080/system/console first.
http://localhost:8080/api/jaxrs/test/testing.this (for example) should then address the JAX-RS TestService
resource.
The corresponding OpenAPI JSON document is available at http://localhost:8080/api/openapi/openapi.json with an API browser at http://localhost:8080/api/openapi/openapi-browser.html
All other URLs outside of /api/jaxrs
and /api/openapi
, like http://localhost:8080/api/sling.json are served by Sling as usual.
A POST can increment the test counter, such as:
curl -XPOST http://localhost:8080/api/jaxrs/test/increment/42