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. Server-Sent Events (SSE) Support
- 17. Security
- 18. WADL Support
- 19. Bean Validation Support
- 20. Entity Data Filtering
- 20.1. Enabling and configuring Entity Filtering in your application
- 20.2. Components used to describe Entity Filtering concepts
- 20.3. Using custom annotations to filter entities
- 20.4. Role-based Entity Filtering using (
javax.annotation.security) annotations - 20.5. Entity Filtering based on dynamic and configurable query parameters
- 20.6. Defining custom handling for entity-filtering annotations
- 20.7. Supporting Entity Data Filtering in custom entity providers or frameworks
- 20.8. Modules with support for Entity Data Filtering
- 20.9. Examples
- 21. MVC Templates
- 22. Logging
- 23. Monitoring and Diagnostics
- 24. Custom Injection and Lifecycle Management
- 25. Jersey CDI Container Agnostic Support
- 26. Spring DI
- 27. GraalVM native-image generation
- 28. Jersey Test Framework
- 29. Building and Testing Jersey
- 30. Migration Guide
- 30.1. Migrating from Jersey 2.37 to 2.38
- 30.2. Migrating from Jersey 2.29 to 2.29.1 and 2.30+
- 30.3. Migrating from Jersey 2.26 to 2.27 (2.28, 2.29)
- 30.4. Migrating from Jersey 2.25 to 2.26.
- 30.5. Migrating from Jersey 2.22.1 to 2.25
- 30.6. Breaking Changes
- 30.7. Migrating from Jersey 2.22 to 2.22.1
- 30.8. Migrating from Jersey 2.21 to 2.22
- 30.9. Migrating from Jersey 2.19 to 2.20
- 30.10. Migrating from Jersey 2.18 to 2.19
- 30.11. Migrating from Jersey 2.17 to 2.18
- 30.12. Migrating from Jersey 2.16 to 2.17
- 30.13. Migrating from Jersey 2.15 to 2.16
- 30.14. Migrating to 2.15
- 30.15. Migrating from Jersey 2.11 to 2.12
- 30.16. Migrating from Jersey 2.10 to 2.11
- 30.17. Migrating from Jersey 2.9 to 2.10
- 30.18. Migrating from Jersey 2.8 to 2.9
- 30.19. Migrating from Jersey 2.7 to 2.8
- 30.20. Migrating from Jersey 2.6 to 2.7
- 30.21. Migrating from Jersey 2.5.1 to 2.6
- 30.22. Migrating from Jersey 2.5 to 2.5.1
- 30.23. Migrating from Jersey 2.4.1 to 2.5
- 30.24. Migrating from Jersey 2.4 to 2.4.1
- 30.25. Migrating from Jersey 2.3 to 2.4
- 30.26. Migrating from Jersey 2.0, 2.1 or 2.2 to 2.3
- 30.27. 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. Apache HTTP client configuration properties
- A.6. Apache 5 HTTP client configuration properties
- A.7. Helidon HTTP client configuration properties
- A.8. JDK HTTP client configuration properties
- A.9. Jetty HTTP client configuration properties
- A.10. Netty HTTP client 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>
- 30.1. List of changed configuration properties:
- 30.2. Mapping of Jersey 1.x to JAX-RS 2.0 client classes
- 30.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 Apache 5 HTTP client configuration properties
- A.7. List of Helidon HTTP client configuration properties
- A.8. List of Jdk HTTP client configuration properties
- A.9. List of Jetty HTTP client configuration properties
- A.10. List of Netty HTTP client configuration properties
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. Adding the SSE dependency
- 16.2. Simple SSE resource method
- 16.3. Broadcasting SSE messages (with JAX-RS 2.1 API)
- 16.4. Consuming SSE events with SseEventSource
- 16.5. SseEventSource subscribe() methods
- 16.6. Add
jersey-media-ssedependency. - 16.7. Simple SSE resource method
- 16.8. Broadcasting SSE messages
- 16.9. Registering
EventListenerwithEventSource - 16.10. Overriding
EventSource.onEvent(InboundEvent)method - 17.1. Using
SecurityContextfor a Resource Selection - 17.2. Injecting
SecurityContextinto a singleton resource - 17.3. Securing resources using
web.xml - 17.4. Registering RolesAllowedDynamicFeature using ResourceConfig
- 17.5. Registering RolesAllowedDynamicFeature by extending ResourceConfig
- 17.6. Applying
javax.annotation.securityto JAX-RS resource methods. - 17.7. Build the authorization flow utility
- 17.8. Perform the OAuth Authorization Flow
- 17.9. Authenticated requests
- 17.10. Build feature from Access Token
- 17.11. Specifying Access Token on a Request.
- 17.12. Creating Public/Private RSA-SHA1 keys
- 17.13. Building OAuth 2 Authorization Flow.
- 18.1. A simple WADL example - JAX-RS resource definition
- 18.2. A simple WADL example - WADL content
- 18.3. OPTIONS method returning WADL
- 18.4. More complex WADL example - JAX-RS resource definition
- 18.5. More complex WADL example - WADL content
- 19.1. Configuring Jersey specific properties for Bean Validation.
- 19.2. Using
ValidationConfigto configureValidator. - 19.3. Constraint annotations on input parameters
- 19.4. Constraint annotations on fields
- 19.5. Constraint annotations on class
- 19.6. Definition of a constraint annotation
- 19.7. Validator implementation.
- 19.8. Entity validation
- 19.9. Entity validation 2
- 19.10. Response entity validation
- 19.11. Validate getter on execution
- 19.12. Injecting UriInfo into a ConstraintValidator
- 19.13. Support for injecting Jersey's resources/providers via ConstraintValidatorFactory.
- 19.14.
ValidationErrortotext/plain - 19.15.
ValidationErrortotext/html - 19.16.
ValidationErrortoapplication/xml - 19.17.
ValidationErrortoapplication/json - 20.1. Registering and configuring entity-filtering feature on server.
- 20.2. Registering and configuring entity-filtering feature with security annotations on server.
- 20.3. Registering and configuring entity-filtering feature based on dynamic and configurable query parameters.
- 20.4. Registering and configuring entity-filtering feature on client.
- 20.5. Project
- 20.6. User
- 20.7. Task
- 20.8. ProjectsResource
- 20.9. ProjectDetailedView
- 20.10. Annotated Project
- 20.11. Annotated User
- 20.12. Annotated Task
- 20.13. ProjectsResource - Response entity-filtering annotations
- 20.14. ProjectsResource - Entity-filtering annotations on methods
- 20.15. Client - Request entity-filtering annotations
- 20.16. Client - Request entity-filtering annotations
- 20.17. Sever - Query Parameter driven entity-filtering
- 20.18.
- 20.19. Entity-filtering annotation with custom meaning
- 20.20. Entity Data Filtering support in MOXy JSON binding provider
- 21.1. Using
Viewablein a resource class - 21.2. Using
@Templateon a resource method - 21.3. Using
@Templateon a resource class - 21.4. Using absolute path to template in
Viewable - 21.5. Using
@ErrorTemplateon a resource method - 21.6. Using
@ErrorTemplatewith Bean Validation - 21.7. Iterating through
ValidationErrorin JSP - 21.8. Registering
MvcFeature - 21.9. Registering
FreemarkerMvcFeature - 21.10. Setting
MvcFeature.TEMPLATE_BASE_PATHvalue inResourceConfig - 21.11. Setting
FreemarkerMvcProperties.TEMPLATE_BASE_PATHvalue inweb.xml - 21.12. Including JSP page into JSP page
- 21.13. Custom TemplateProcessor
- 21.14. Registering custom TemplateProcessor
- 22.1. Logging on the client side
- 22.2. Register
LoggingFeaturevia constructor - 22.3. Register
LoggingFeatureclass - 23.1. Application event listener
- 23.2. Request event listener
- 23.3. Event listener test resource
- 23.4. Injecting MonitoringStatistics
- 23.5. Summary level messages
- 23.6. On demand request, snippet of MVC JSP forwarding
- 25.1. Bootstrapping Jersey application with Weld support on Grizzly
- 30.1. Jersey 1 reloader implementation
- 30.2. Jersey 1 reloader registration
- 30.3. Jersey 2 reloader implementation
- 30.4. Jersey 2 reloader registration
- 30.5. Initializing JAXB-based support with MOXy