In this video we are going to implement a basic REST API for books.

In this video we are extending the book API. We add loans for books using a sub resource (since loans are dependent on books).

Now there are several ways to implement Subresource locators. In all cases you can perform partial processing by annotating methods using @Path only. The return type will then be scanned for further JAX-RS annotations.

For REST APIs it is considered best practice to signal errors and abnormal behaviour using HTTP Status code. This includes expected as well as unexpected exceptional behaviour.

There are a couple of options you can choose from:

• Handle the error explicitly, by checking or catching an exception and then set a suitable HTTP status code on the Response object. This could be a 404 if something could not be found.
• The other alternative you have is to throw WebApplicationException or one of its subclasses. JAX-RS will handle these and translate them to the appropriate HTTP status code.
• The final and most flexible option is to implement the ExceptionMapper interface and perform a custom mapping from exception to Response.

In this video we add a small standalone CLI client program that uses the JAX-RS Client APIs to access the Library Service REST API. The client performs several CRUD interactions with Book and Loan.

When you want to use the Payara Server Full base image, write the following Dockerfile:

FROM payara/server-full:5.181
COPY target/library-service.war $DEPLOY_DIR

When you want to use the Payara Micro base image, write the following Dockerfile:

FROM payara/micro:5.181
COPY target/library-service.war /opt/payara/deployments

$ docker build -t library-service:1.0 .

$ docker run -it -p 8080:8080 library-service:1.0
$ docker run -d -p 8080:8080 library-service:1.0