Table of Contents
- Preface
- 1. Getting Started
- 2. Modules and dependencies
- 3. JAX-RS Application, Resources and Sub-Resources
- 4. Application Deployment and Runtime Environments
- 5. Client API
- 5.1. Uniform Interface Constraint
- 5.2. Ease of use and reusing JAX-RS artifacts
- 5.3. Overview of the Client API
- 5.4. Java instances and types for representations
- 5.5. Client Transport Connectors
- 5.6. Using client request and response filters
- 5.7. Closing connections
- 5.8. Injections into client providers
- 5.9. Securing a Client
- 5.10. InvocationInterceptors
- 5.11. InvocationBuilderListener
- 5.12. Header Expect:100-continue support
- 6. Reactive JAX-RS Client API
- 7. Representations and Responses
- 8. JAX-RS Entity Providers
- 9. Support for Common Media Type Representations
- 10. Filters and Interceptors
- 11. Asynchronous Services and Clients
- 12. URIs and Links
- 13. Declarative Hyperlinking
- 14. Programmatic API for Building Resources
- 15. Jersey configuration
- 16. Micrometer - application observability facade
- 17. Server-Sent Events (SSE) Support
- 18. Security
- 19. WADL Support
- 20. Bean Validation Support
- 21. Entity Data Filtering
- 21.1. Enabling and configuring Entity Filtering in your application
- 21.2. Components used to describe Entity Filtering concepts
- 21.3. Using custom annotations to filter entities
- 21.4. Role-based Entity Filtering using (
javax.annotation.security) annotations - 21.5. Entity Filtering based on dynamic and configurable query parameters
- 21.6. Defining custom handling for entity-filtering annotations
- 21.7. Supporting Entity Data Filtering in custom entity providers or frameworks
- 21.8. Modules with support for Entity Data Filtering
- 21.9. Examples
- 22. MVC Templates
- 23. Logging
- 24. Monitoring and Diagnostics
- 25. Custom Injection and Lifecycle Management
- 26. Jersey CDI Container Agnostic Support
- 27. Spring DI
- 28. GraalVM native-image generation
- 29. Jersey Test Framework
- 30. Building and Testing Jersey
- 31. Migration Guide
- 31.1. Migrating from Jersey 2.40 to 2.41
- 31.2. Migrating from Jersey 2.37 to 2.38
- 31.3. Migrating from Jersey 2.29 to 2.29.1 and 2.30+
- 31.4. Migrating from Jersey 2.26 to 2.27 (2.28, 2.29)
- 31.5. Migrating from Jersey 2.25 to 2.26.
- 31.6. Migrating from Jersey 2.22.1 to 2.25
- 31.7. Breaking Changes
- 31.8. Migrating from Jersey 2.22 to 2.22.1
- 31.9. Migrating from Jersey 2.21 to 2.22
- 31.10. Migrating from Jersey 2.19 to 2.20
- 31.11. Migrating from Jersey 2.18 to 2.19
- 31.12. Migrating from Jersey 2.17 to 2.18
- 31.13. Migrating from Jersey 2.16 to 2.17
- 31.14. Migrating from Jersey 2.15 to 2.16
- 31.15. Migrating to 2.15
- 31.16. Migrating from Jersey 2.11 to 2.12
- 31.17. Migrating from Jersey 2.10 to 2.11
- 31.18. Migrating from Jersey 2.9 to 2.10
- 31.19. Migrating from Jersey 2.8 to 2.9
- 31.20. Migrating from Jersey 2.7 to 2.8
- 31.21. Migrating from Jersey 2.6 to 2.7
- 31.22. Migrating from Jersey 2.5.1 to 2.6
- 31.23. Migrating from Jersey 2.5 to 2.5.1
- 31.24. Migrating from Jersey 2.4.1 to 2.5
- 31.25. Migrating from Jersey 2.4 to 2.4.1
- 31.26. Migrating from Jersey 2.3 to 2.4
- 31.27. Migrating from Jersey 2.0, 2.1 or 2.2 to 2.3
- 31.28. Migrating from Jersey 1.x to 2.0
- A. Configuration Properties
- A.1. Common (client/server) configuration properties
- A.2. Server configuration properties
- A.3. Servlet configuration properties
- A.4. Client configuration properties
- A.5. Jersey configuration properties for message & entity processing
- A.6. The default HttpUrlConnector properties
- A.7. Apache HTTP client configuration properties
- A.8. Apache 5 HTTP client configuration properties
- A.9. Helidon HTTP client configuration properties
- A.10. JDK HTTP client configuration properties
- A.11. Jetty HTTP client configuration properties
- A.12. Netty HTTP client configuration properties
- A.13. Multipart configuration properties
List of Figures
List of Tables
- 2.1. Jersey Core
- 2.2. Jersey Containers
- 2.3. Jersey Connectors
- 2.4. Jersey Media
- 2.5. Jersey Extensions
- 2.6. Jersey Test Framework
- 2.7. Jersey Test Framework Providers
- 2.8. Jersey Glassfish Bundles
- 2.9. Security
- 2.10. Jersey Examples
- 3.1. Resource scopes
- 3.2. Overview of injection types
- 4.1. Servlet 3 Pluggability Overview
- 5.1. List of Jersey Connectors
- 9.1. Default property values for MOXy MessageBodyReader<T> / MessageBodyWriter<T>
- 31.1. List of changed configuration properties:
- 31.2. Mapping of Jersey 1.x to JAX-RS 2.0 client classes
- 31.3. JSON approaches and usage in Jersey 1 vs Jersey 2
- A.1. List of common configuration properties
- A.2. List of server configuration properties
- A.3. List of servlet configuration properties
- A.4. List of client configuration properties
- A.5. List of Apache HTTP client configuration properties
- A.6. List of the default HttpUrlConnectorProvider properites
- A.7. List of Apache HTTP client configuration properties
- A.8. List of Apache 5 HTTP client configuration properties
- A.9. List of Helidon HTTP client configuration properties
- A.10. List of Jdk HTTP client configuration properties
- A.11. List of Jetty HTTP client configuration properties
- A.12. List of Netty HTTP client configuration properties
- A.13. List of multipart configuration properties settable in the MultiPartProperties.MULTI_PART_CONFIG_RESOURCE configuration file.
List of Examples
- 3.1. Simple hello world root resource class
- 3.2. Specifying URI path parameter
- 3.3. PUT method
- 3.4. Specifying output MIME type
- 3.5. Using multiple output MIME types
- 3.6. Server-side content negotiation
- 3.7. Specifying input MIME type
- 3.8. Query parameters
- 3.9. Custom Java type for consuming request parameters
- 3.10. Processing POSTed HTML form
- 3.11. Obtaining general map of URI path and/or query parameters
- 3.12. Obtaining general map of header parameters
- 3.13. Obtaining general map of form parameters
- 3.14. Example of the bean which will be used as @BeanParam
- 3.15. Injection of MyBeanParam as a method parameter:
- 3.16. Injection of more beans into one resource methods:
- 3.17. Sub-resource methods
- 3.18. Sub-resource locators
- 3.19. Sub-resource locators with empty path
- 3.20. Sub-resource locators returning sub-type
- 3.21. Sub-resource locators created from classes
- 3.22. Sub-resource locators returning resource model
- 3.23. Injection
- 3.24. Wrong injection into a singleton scope
- 3.25. Injection of proxies into singleton
- 3.26. Example of possible injections
- 4.1. Deployment agnostic application model
- 4.2. Reusing Jersey implementation in your custom application model
- 4.3. Registering SPI implementations using ResourceConfig
- 4.4. Registering SPI implementations using
ResourceConfigsubclass - 4.5. Using Jersey with JDK HTTP Server
- 4.6. Using Jersey with Grizzly HTTP Server
- 4.7. Using Jersey with the Simple framework
- 4.8. Using Jersey with Jetty HTTP Server
- 4.9. Using Jersey with Netty HTTP Server
- 4.10. Hooking up Jersey as a Servlet
- 4.11. Hooking up Jersey as a Servlet Filter
- 4.12.
Configuring Jersey container Servlet or Filter to use custom
Applicationsubclass - 4.13. Configuring Jersey container Servlet or Filter to use package scanning
- 4.14. Configuring Jersey container Servlet or Filter to use a list of classes
- 4.15. Deployment of a JAX-RS application using
@ApplicationPathwith Servlet 3.0 - 4.16. Configuration of maven-war-plugin to ignore missing
web.xml - 4.17. Deployment of a JAX-RS application using
web.xmlwith Servlet 3.0 - 4.18.
web.xmlof a JAX-RS application without anApplicationsubclass - 4.19.
- 4.20.
- 5.1. POST request with form parameters
- 5.2. Using JAX-RS Client API
- 5.3. Using JAX-RS Client API fluently
- 5.4. Setting JAX-RS Client ExecutorService
- 5.5. Sending restricted headers with
HttpUrlConnector - 5.6. Closing connections
- 5.7. InjectionManagerClientProvider example
- 6.1. Excerpt from a synchronous approach while implementing the orchestration layer
- 6.2. Excerpt from an asynchronous approach while implementing the orchestration layer
- 6.3. Excerpt from a reactive approach while implementing the orchestration layer
- 6.4. Synchronous invocation of HTTP requests
- 6.5. Asynchronous invocation of HTTP requests
- 6.6. Reactive invocation of HTTP requests
- 6.7. Creating JAX-RS Client with RxJava reactive extension
- 6.8. Obtaining Observable<Response> from Jersey/RxJava Client
- 6.9. Creating JAX-RS Client with RxJava2 reactive extension
- 6.10. Obtaining Flowable<Response> from Jersey/RxJava Client
- 6.11. Creating Jersey/Guava Client
- 6.12. Obtaining ListenableFuture<Response> from Jersey/Guava Client
- 6.13. Extending RxIvoker
- 6.14. Extending RxInvokerProvider
- 7.1. Using
Filewith a specific media type to produce a response - 7.2. Returning 201 status code and adding
Locationheader in response to POST request - 7.3. Adding an entity body to a custom response
- 7.4. Throwing exceptions to control response
- 7.5. Application specific exception implementation
- 7.6. Mapping generic exceptions to responses
- 7.7. Conditional GET support
- 8.1. Example resource class
- 8.2. MyBean entity class
- 8.3. MessageBodyWriter example
- 8.4. Example of assignment of annotations to a response entity
- 8.5. Client code testing MyBeanMessageBodyWriter
- 8.6. Result of MyBeanMessageBodyWriter test
- 8.7. MessageBodyReader example
- 8.8. Testing MyBeanMessageBodyReader
- 8.9. Result of testing MyBeanMessageBodyReader
- 8.10. MessageBodyReader registered on a JAX-RS client
- 8.11. Result of client code execution
- 8.12. Usage of MessageBodyWorkers interface
- 9.1. Simple JAXB bean implementation
- 9.2. JAXB bean used to generate JSON representation
- 9.3. Tweaking JSON format using JAXB
- 9.4. JAXB bean creation
- 9.5. Constructing a
JsonObject(JSON-Processing) - 9.6. Constructing a
JSONObject(Jettison) - 9.7. MoxyJsonConfig - Setting properties.
- 9.8. Creating
ContextResolver<MoxyJsonConfig> - 9.9. Setting properties for MOXy providers into Configurable
- 9.10. Building client with MOXy JSON feature enabled.
- 9.11. Creating JAX-RS application with MOXy JSON feature enabled.
- 9.12. Building client with JSON-Processing JSON feature enabled.
- 9.13. Creating JAX-RS application with JSON-Processing JSON feature enabled.
- 9.14.
ContextResolver<ObjectMapper> - 9.15. Building client with Jackson JSON feature enabled.
- 9.16. Creating JAX-RS application with Jackson JSON feature enabled.
- 9.17. JAXB beans for JSON supported notations description, simple address bean
- 9.18. JAXB beans for JSON supported notations description, contact bean
- 9.19. JAXB beans for JSON supported notations description, initialization
- 9.20.
XML namespace to JSON mapping configuration for Jettison based
mappednotation - 9.21. JSON expression with XML namespaces mapped into JSON
- 9.22.
JSON Array configuration for Jettison based
mappednotation - 9.23. JSON expression with JSON arrays explicitly configured via Jersey
- 9.24. JSON expression produced using
badgerfishnotation - 9.25.
ContextResolver<ObjectMapper> - 9.26. Building client with Jettison JSON feature enabled.
- 9.27. Creating JAX-RS application with Jettison JSON feature enabled.
- 9.28. Simplest case of using
@JSONP - 9.29. JaxbBean for @JSONP example
- 9.30. Example of
@JSONPwith configured parameters. - 9.31.
ContextResolver<Jsonb> - 9.32.
Register the feature and ContextResolver<Jsonb> - 9.33. Low level XML test - methods added to
HelloWorldResource.java - 9.34. Planet class
- 9.35. Resource class
- 9.36. Method for consuming Planet
- 9.37. Resource class - JAXBElement
- 9.38. Client side - JAXBElement
- 9.39. PlanetJAXBContextProvider
- 9.40. Using Provider with JAX-RS client
- 9.41. Add
jersey-media-moxydependency. - 9.42. Register the
MoxyXmlFeatureclass. - 9.43. Configure and register an
MoxyXmlFeatureinstance. - 9.44. Building client with MultiPart feature enabled.
- 9.45. Creating JAX-RS application with MultiPart feature enabled.
- 9.46.
MultiPartentity - 9.47.
MultiPartentity in HTTP message. - 9.48.
FormDataMultiPartentity - 9.49.
FormDataMultiPartentity in HTTP message. - 9.50. Multipart - sending files.
- 9.51. Resource method using
MultiPartas input parameter / return value. - 9.52. Use of
@FormDataParamannotation - 10.1. Container response filter
- 10.2. Container request filter
- 10.3. Pre-matching request filter
- 10.4. Client request filter
- 10.5. GZIP writer interceptor
- 10.6. GZIP reader interceptor
- 10.7.
@NameBindingexample - 10.8. Dynamic binding example
- 10.9. Priorities example
- 11.1. Simple async resource
- 11.2. Simple async method with timeout
- 11.3. CompletionCallback example
- 11.4. ChunkedOutput example
- 11.5. Simple client async invocation
- 11.6. Simple client fluent async invocation
- 11.7. Client async callback
- 11.8. Client async callback for specific entity
- 11.9. ChunkedInput example
- 12.1. URI building
- 12.2. Building URIs using query parameters
- 13.1. Creating JAX-RS application with Declarative Linking feature enabled.
- 14.1. A standard resource class
- 14.2. A programmatic resource
- 14.3. A programmatic resource
- 14.4. A programmatic resource
- 14.5. A programmatic resource
- 14.6. A programmatic resource
- 16.1. Annotated Micrometer resource methods
- 17.1. Adding the SSE dependency
- 17.2. Simple SSE resource method
- 17.3. Broadcasting SSE messages (with JAX-RS 2.1 API)
- 17.4. Consuming SSE events with SseEventSource
- 17.5. SseEventSource subscribe() methods
- 17.6. Add
jersey-media-ssedependency. - 17.7. Simple SSE resource method
- 17.8. Broadcasting SSE messages
- 17.9. Registering
EventListenerwithEventSource - 17.10. Overriding
EventSource.onEvent(InboundEvent)method - 18.1. Using
SecurityContextfor a Resource Selection - 18.2. Injecting
SecurityContextinto a singleton resource - 18.3. Securing resources using
web.xml - 18.4. Registering RolesAllowedDynamicFeature using ResourceConfig
- 18.5. Registering RolesAllowedDynamicFeature by extending ResourceConfig
- 18.6. Applying
javax.annotation.securityto JAX-RS resource methods. - 18.7. Build the authorization flow utility
- 18.8. Perform the OAuth Authorization Flow
- 18.9. Authenticated requests
- 18.10. Build feature from Access Token
- 18.11. Specifying Access Token on a Request.
- 18.12. Creating Public/Private RSA-SHA1 keys
- 18.13. Building OAuth 2 Authorization Flow.
- 19.1. A simple WADL example - JAX-RS resource definition
- 19.2. A simple WADL example - WADL content
- 19.3. OPTIONS method returning WADL
- 19.4. More complex WADL example - JAX-RS resource definition
- 19.5. More complex WADL example - WADL content
- 20.1. Configuring Jersey specific properties for Bean Validation.
- 20.2. Using
ValidationConfigto configureValidator. - 20.3. Constraint annotations on input parameters
- 20.4. Constraint annotations on fields
- 20.5. Constraint annotations on class
- 20.6. Definition of a constraint annotation
- 20.7. Validator implementation.
- 20.8. Entity validation
- 20.9. Entity validation 2
- 20.10. Response entity validation
- 20.11. Validate getter on execution
- 20.12. Injecting UriInfo into a ConstraintValidator
- 20.13. Support for injecting Jersey's resources/providers via ConstraintValidatorFactory.
- 20.14.
ValidationErrortotext/plain - 20.15.
ValidationErrortotext/html - 20.16.
ValidationErrortoapplication/xml - 20.17.
ValidationErrortoapplication/json - 21.1. Registering and configuring entity-filtering feature on server.
- 21.2. Registering and configuring entity-filtering feature with security annotations on server.
- 21.3. Registering and configuring entity-filtering feature based on dynamic and configurable query parameters.
- 21.4. Registering and configuring entity-filtering feature on client.
- 21.5. Project
- 21.6. User
- 21.7. Task
- 21.8. ProjectsResource
- 21.9. ProjectDetailedView
- 21.10. Annotated Project
- 21.11. Annotated User
- 21.12. Annotated Task
- 21.13. ProjectsResource - Response entity-filtering annotations
- 21.14. ProjectsResource - Entity-filtering annotations on methods
- 21.15. Client - Request entity-filtering annotations
- 21.16. Client - Request entity-filtering annotations
- 21.17. Sever - Query Parameter driven entity-filtering
- 21.18.
- 21.19. Entity-filtering annotation with custom meaning
- 21.20. Entity Data Filtering support in MOXy JSON binding provider
- 22.1. Using
Viewablein a resource class - 22.2. Using
@Templateon a resource method - 22.3. Using
@Templateon a resource class - 22.4. Using absolute path to template in
Viewable - 22.5. Using
@ErrorTemplateon a resource method - 22.6. Using
@ErrorTemplatewith Bean Validation - 22.7. Iterating through
ValidationErrorin JSP - 22.8. Registering
MvcFeature - 22.9. Registering
FreemarkerMvcFeature - 22.10. Setting
MvcFeature.TEMPLATE_BASE_PATHvalue inResourceConfig - 22.11. Setting
FreemarkerMvcProperties.TEMPLATE_BASE_PATHvalue inweb.xml - 22.12. Including JSP page into JSP page
- 22.13. Custom TemplateProcessor
- 22.14. Registering custom TemplateProcessor
- 23.1. Logging on the client side
- 23.2. Register
LoggingFeaturevia constructor - 23.3. Register
LoggingFeatureclass - 24.1. Application event listener
- 24.2. Request event listener
- 24.3. Event listener test resource
- 24.4. Injecting MonitoringStatistics
- 24.5. Summary level messages
- 24.6. On demand request, snippet of MVC JSP forwarding
- 26.1. Bootstrapping Jersey application with Weld support on Grizzly
- 31.1. Jersey 1 reloader implementation
- 31.2. Jersey 1 reloader registration
- 31.3. Jersey 2 reloader implementation
- 31.4. Jersey 2 reloader registration
- 31.5. Initializing JAXB-based support with MOXy