RESTful Web services target resources that are used explicitly by a Web service client using a subset of HTTP operators. The Web service requests are routed through a single Jersey servlet, through which all endpoint services are registered. The servlet routes incoming calls to the appropriate endpoint, depending on the composition of the request and the configuration of the endpoint class or method.
Some key capabilities of the JAX-RS framework are:
Annotation-based resource development
XML-based filtering and validation schema support, which is easily configured and extensible with configuration layering
Built-in support for API versioning, locking, transactions, caching, localization, filtering, validation, resource version tracking, exception mapping, relation registry, self-documentation with Swagger and asynchronous endpoints
Support for both the standard Oracle JSON REST media type, and the HAL media type and HATEOAS
Extensible with Nucleus component-based resources and framework feature providers
Support that allows endpoints to invoke form handlers, droplets or Actor chains to reuse preexisting functionality
A registry that provides extensible mapping of application exceptions to specific HTTP response codes
The ability to control the fields and links in the response and request representation of a resource
User authentication using OAuth
Custom annotations for creating service endpoints
For detailed information on creating your own resources and endpoints, refer to the Writing Resources and Endpoints section.
