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
- 6. Representations and Responses
- 7. JAX-RS Entity Providers
- 8. Support for Common Media Type Representations
- 9. Filters and Interceptors
- 10. Asynchronous Services and Clients
- 11. URIs and Links
- 12. Declarative Hyperlinking
- 13. Programmatic API for Building Resources
- 14. Server-Sent Events (SSE) Support
- 15. Security
- 16. WADL Support
- 17. Bean Validation Support
- 18. Entity Data Filtering
- 18.1. Enabling and configuring Entity Filtering in your application
- 18.2. Components used to describe Entity Filtering concepts
- 18.3. Using custom annotations to filter entities
- 18.4. Role-based Entity Filtering using (
javax.annotation.security) annotations - 18.5. Entity Filtering based on dynamic and configurable query parameters
- 18.6. Defining custom handling for entity-filtering annotations
- 18.7. Supporting Entity Data Filtering in custom entity providers or frameworks
- 18.8. Modules with support for Entity Data Filtering
- 18.9. Examples
- 19. MVC Templates
- 20. Monitoring and Diagnostics
- 21. Custom Injection and Lifecycle Management
- 22. Spring DI
- 23. Jersey Test Framework
- 24. Building and Testing Jersey
- 25. Migration Guide
- 25.1. Migrating from Jersey 2.11 to 2.12
- 25.2. Migrating from Jersey 2.10 to 2.11
- 25.3. Migrating from Jersey 2.9 to 2.10
- 25.4. Migrating from Jersey 2.8 to 2.9
- 25.5. Migrating from Jersey 2.7 to 2.8
- 25.6. Migrating from Jersey 2.6 to 2.7
- 25.7. Migrating from Jersey 2.5.1 to 2.6
- 25.8. Migrating from Jersey 2.5 to 2.5.1
- 25.9. Migrating from Jersey 2.4.1 to 2.5
- 25.10. Migrating from Jersey 2.4 to 2.4.1
- 25.11. Migrating from Jersey 2.3 to 2.4
- 25.12. Migrating from Jersey 2.0, 2.1 or 2.2 to 2.3
- 25.13. Migrating from Jersey 1.x to 2.0
- A. Configuration Properties
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
- 8.1. Default property values for MOXy MessageBodyReader<T> / MessageBodyWriter<T>
- 25.1. List of changed configuration properties:
- 25.2. Mapping of Jersey 1.x to JAX-RS 2.0 client classes
- 25.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 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. Hooking up Jersey as a Servlet
- 4.10. Hooking up Jersey as a Servlet Filter
- 4.11.
Configuring Jersey container Servlet or Filter to use custom
Applicationsubclass - 4.12. Configuring Jersey container Servlet or Filter to use package scanning
- 4.13. Configuring Jersey container Servlet or Filter to use a list of classes
- 4.14. Deployment of a JAX-RS application using
@ApplicationPathwith Servlet 3.0 - 4.15. Configuration of maven-war-plugin to ignore missing
web.xml - 4.16. Deployment of a JAX-RS application using
web.xmlwith Servlet 3.0 - 4.17.
web.xmlof a JAX-RS application without anApplicationsubclass - 4.18.
- 4.19.
- 5.1. POST request with form parameters
- 5.2. Using JAX-RS Client API
- 5.3. Using JAX-RS Client API fluently
- 5.4. Sending restricted headers with
HttpUrlConnector - 5.5. Closing connections
- 5.6. ServiceLocatorClientProvider example
- 6.1. Using
Filewith a specific media type to produce a response - 6.2. Returning 201 status code and adding
Locationheader in response to POST request - 6.3. Adding an entity body to a custom response
- 6.4. Throwing exceptions to control response
- 6.5. Application specific exception implementation
- 6.6. Mapping generic exceptions to responses
- 6.7. Conditional GET support
- 7.1. Example resource class
- 7.2. MyBean entity class
- 7.3. MessageBodyWriter example
- 7.4. Example of assignment of annotations to a response entity
- 7.5. Client code testing MyBeanMessageBodyWriter
- 7.6. Result of MyBeanMessageBodyWriter test
- 7.7. MessageBodyReader example
- 7.8. Testing MyBeanMessageBodyReader
- 7.9. Result of testing MyBeanMessageBodyReader
- 7.10. MessageBodyReader registered on a JAX-RS client
- 7.11. Result of client code execution
- 7.12. Usage of MessageBodyWorkers interface
- 8.1. Simple JAXB bean implementation
- 8.2. JAXB bean used to generate JSON representation
- 8.3. Tweaking JSON format using JAXB
- 8.4. JAXB bean creation
- 8.5. Constructing a
JsonObject(JSON-Processing) - 8.6. Constructing a
JSONObject(Jettison) - 8.7. MoxyJsonConfig - Setting properties.
- 8.8. Creating
ContextResolver<MoxyJsonConfig> - 8.9. Setting properties for MOXy providers into Configurable
- 8.10. Building client with MOXy JSON feature enabled.
- 8.11. Creating JAX-RS application with MOXy JSON feature enabled.
- 8.12. Building client with JSON-Processing JSON feature enabled.
- 8.13. Creating JAX-RS application with JSON-Processing JSON feature enabled.
- 8.14.
ContextResolver<ObjectMapper> - 8.15. Building client with Jackson JSON feature enabled.
- 8.16. Creating JAX-RS application with Jackson JSON feature enabled.
- 8.17. JAXB beans for JSON supported notations description, simple address bean
- 8.18. JAXB beans for JSON supported notations description, contact bean
- 8.19. JAXB beans for JSON supported notations description, initialization
- 8.20.
XML namespace to JSON mapping configuration for Jettison based
mappednotation - 8.21. JSON expression with XML namespaces mapped into JSON
- 8.22.
JSON Array configuration for Jettison based
mappednotation - 8.23. JSON expression with JSON arrays explicitly configured via Jersey
- 8.24. JSON expression produced using
badgerfishnotation - 8.25.
ContextResolver<ObjectMapper> - 8.26. Building client with Jettison JSON feature enabled.
- 8.27. Creating JAX-RS application with Jettison JSON feature enabled.
- 8.28. Simplest case of using
@JSONP - 8.29. JaxbBean for @JSONP example
- 8.30. Example of
@JSONPwith configured parameters. - 8.31. Low level XML test - methods added to
HelloWorldResource.java - 8.32. Planet class
- 8.33. Resource class
- 8.34. Method for consuming Planet
- 8.35. Resource class - JAXBElement
- 8.36. Client side - JAXBElement
- 8.37. PlanetJAXBContextProvider
- 8.38. Using Provider with JAX-RS client
- 8.39. Add
jersey-media-moxydependency. - 8.40. Register the
MoxyXmlFeatureclass. - 8.41. Configure and register an
MoxyXmlFeatureinstance. - 8.42. Building client with MultiPart feature enabled.
- 8.43. Creating JAX-RS application with MultiPart feature enabled.
- 8.44.
MultiPartentity - 8.45.
MultiPartentity in HTTP message. - 8.46.
FormDataMultiPartentity - 8.47.
FormDataMultiPartentity in HTTP message. - 8.48. Multipart - sending files.
- 8.49. Resource method using
MultiPartas input parameter / return value. - 8.50. Use of
@FormDataParamannotation - 9.1. Container response filter
- 9.2. Container request filter
- 9.3. Pre-matching request filter
- 9.4. Client request filter
- 9.5. GZIP writer interceptor
- 9.6. GZIP reader interceptor
- 9.7.
@NameBindingexample - 9.8. Dynamic binding example
- 9.9. Priorities example
- 10.1. Simple async resource
- 10.2. Simple async method with timeout
- 10.3. CompletionCallback example
- 10.4. ChunkedOutput example
- 10.5. Simple client async invocation
- 10.6. Simple client fluent async invocation
- 10.7. Client async callback
- 10.8. Client async callback for specific entity
- 10.9. ChunkedInput example
- 11.1. URI building
- 11.2. Building URIs using query parameters
- 12.1. Creating JAX-RS application with Declarative Linking feature enabled.
- 13.1. A standard resource class
- 13.2. A programmatic resource
- 13.3. A programmatic resource
- 13.4. A programmatic resource
- 13.5. A programmatic resource
- 13.6. A programmatic resource
- 14.1. Add
jersey-media-ssedependency. - 14.2. Simple SSE resource method
- 14.3. Broadcasting SSE messages
- 14.4. Registering
EventListenerwithEventSource - 14.5. Overriding
EventSource.onEvent(InboundEvent)method - 15.1. Using
SecurityContextfor a Resource Selection - 15.2. Injecting
SecurityContextinto a singleton resource - 15.3. Securing resources using
web.xml - 15.4. Registering RolesAllowedDynamicFeature using ResourceConfig
- 15.5. Registering RolesAllowedDynamicFeature by extending ResourceConfig
- 15.6. Applying
javax.annotation.securityto JAX-RS resource methods. - 15.7. Build the authorization flow utility
- 15.8. Perform the OAuth Authorization Flow
- 15.9. Authenticated requests
- 15.10. Build feature from Access Token
- 15.11. Specifying Access Token on a Request.
- 15.12. Creating Public/Private RSA-SHA1 keys
- 15.13. Building OAuth 2 Authorization Flow.
- 16.1. A simple WADL example - JAX-RS resource definition
- 16.2. A simple WADL example - WADL content
- 16.3. OPTIONS method returning WADL
- 16.4. More complex WADL example - JAX-RS resource definition
- 16.5. More complex WADL example - WADL content
- 17.1. Configuring Jersey specific properties for Bean Validation.
- 17.2. Using
ValidationConfigto configureValidator. - 17.3. Constraint annotations on input parameters
- 17.4. Constraint annotations on fields
- 17.5. Constraint annotations on class
- 17.6. Definition of a constraint annotation
- 17.7. Validator implementation.
- 17.8. Entity validation
- 17.9. Entity validation 2
- 17.10. Response entity validation
- 17.11. Validate getter on execution
- 17.12. Injecting UriInfo into a ConstraintValidator
- 17.13. Support for injecting Jersey's resources/providers via ConstraintValidatorFactory.
- 17.14.
ValidationErrortotext/plain - 17.15.
ValidationErrortotext/html - 17.16.
ValidationErrortoapplication/xml - 17.17.
ValidationErrortoapplication/json - 18.1. Registering and configuring entity-filtering feature on server.
- 18.2. Registering and configuring entity-filtering feature with security annotations on server.
- 18.3. Registering and configuring entity-filtering feature based on dynamic and configurable query parameters.
- 18.4. Registering and configuring entity-filtering feature on client.
- 18.5. Project
- 18.6. User
- 18.7. Task
- 18.8. ProjectsResource
- 18.9. ProjectDetailedView
- 18.10. Annotated Project
- 18.11. Annotated User
- 18.12. Annotated Task
- 18.13. ProjectsResource - Response entity-filtering annotations
- 18.14. ProjectsResource - Entity-filtering annotations on methods
- 18.15. Client - Request entity-filtering annotations
- 18.16. Client - Request entity-filtering annotations
- 18.17. Sever - Query Parameter driven entity-filtering
- 18.18.
- 18.19. Entity-filtering annotation with custom meaning
- 18.20. Entity Data Filtering support in MOXy JSON binding provider
- 19.1. Using
Viewablein a resource class - 19.2. Using
@Templateon a resource method - 19.3. Using
@Templateon a resource class - 19.4. Using absolute path to template in
Viewable - 19.5. Using
@ErrorTemplateon a resource method - 19.6. Using
@ErrorTemplatewith Bean Validation - 19.7. Iterating through
ValidationErrorin JSP - 19.8. Registering
MvcFeature - 19.9. Registering
FreemarkerMvcFeature - 19.10. Setting
MvcFeature.TEMPLATE_BASE_PATHvalue inResourceConfig - 19.11. Setting
FreemarkerMvcProperties.TEMPLATE_BASE_PATHvalue inweb.xml - 19.12. Including JSP page into JSP page
- 19.13. Custom TemplateProcessor
- 19.14. Registering custom TemplateProcessor
- 20.1. Application event listener
- 20.2. Request event listener
- 20.3. Event listener test resource
- 20.4. Injecting MonitoringStatistics
- 20.5. Summary level messages
- 20.6. On demand request, snippet of MVC JSP forwarding
- 25.1. Jersey 1 reloader implementation
- 25.2. Jersey 1 reloader registration
- 25.3. Jersey 2 reloader implementation
- 25.4. Jersey 2 reloader registration
- 25.5. Initializing JAXB-based support with MOXy