- RESTful Java with JAX-RS 2.0 (Second Edition)
- Introduction
- 1. Introduction to REST
- 2. Designing RESTful Services
- 3. Your First JAX-RS Service
- 4. HTTP Method and URI Matching
- 5. JAX-RS Injection
- 6. JAX-RS Content Handlers
- 7. Server Responses and Exception Handling
- 8. JAX-RS Client API
- 9. HTTP Content Negotiation
- 10. HATEOAS
- 11. Scaling JAX-RS Applications
- 12. Filters and Interceptors
- 13. Asynchronous JAX-RS
- 14. Deployment and Integration
- 15. Securing JAX-RS
- 16. Alternative Java Clients
- 17. Workbook Introduction
- 18. Examples for Chapter 3
- 19. Examples for Chapter 4
- 20. Examples for Chapter 5
- 21. Examples for Chapter 6
- 22. Examples for Chapter 7
- 23. Examples for Chapter 9
- 24. Examples for Chapter 10
- 25. Examples for Chapter 11
- 26. Examples for Chapter 12
- 27. Examples for Chapter 13
- 28. Examples for Chapter 14
- 29. Examples for Chapter 15
-
30.
Workbook
- 30.1. ex03_1:Your first JAX_RS Client and Server
- 30.2. ex04_1:Custom HTTP Method Annotations
- 30.3. ex04_2:@Path expressions
- 30.4. ex04_3:Locators and Subresources
- 30.5. ex05_1:Injection Annotations (1)
- 30.6. ex05_2:Injection Annotations (2)
- 30.7. ex06_1:JAX-RS and JAXB
- 30.8. ex06_2:MessageBodyReader/Writer
- 30.9. ex07_1:Exception Mappers
- 30.10. ex09_1:Content Negotiation
- 30.11. ex09_2:HTTP Content Negotiation
- 30.12. ex10_1:Linking and UriBuilder
- 30.13. ex10_2:Link Headers and UriBuilder
- 30.14. ex11_1:CacheControl and Other things
- 30.15. ex12_1:Response Filter with DynamicFeature
- 30.16. ex12_2:WriterInterceptor
- 30.17. ex13_1:Customer Chat
- 30.18. ex14_1:JAX-RS and EJB
- 30.19. ex14_2:Spring and JAX-RS
- 30.20. ex15_1:@NameBinding and SecurityContext
- 30.21. ex15_2:JSON Web Encryption with Customer Chat
Installing RESTEasy and the Examples
The workbook examples are embedded within the RESTEasy distribution so that as future versions of RESTEasy are released, the workbook examples will be updated along with that release. (I discovered that having a separate download for the workbook examples causes various problems—users can get confused about which package to download, and the examples can get out of sync with specific software versions.)
You can download the distribution by following the download links at http://jboss.org/resteasy.
Download the latest RESTEasy JAX-RS distribution (for example, resteasy-jaxrs-3.0.5.Final.zip). Figure 17-1 shows the directory structure of the distribution.
Table 17-1 describes the purpose of the various directories.
Table 17-1. RESTEasy directories
| Directory | Directory |
|---|---|
| docs/javadocs | Generated Javadocs for both the JAX-RS APIs and RESTEasy |
| docs/userguide | Reference guide for RESTEasy in both HTML and PDF format |
| examples | Top-level directory containing all RESTEasy examples |
| examples/oreilly-jaxrs-2.0-workbook | Contains workbook example code for each workbook chapter |
| lib | All the RESTEasy JARs and the third-party libraries they depend on |
| embedded-lib | Optional JAR files used when you are running RESTEasy in embedded mode |
| resteasy-jaxrs.war | Sample RESTEasy servlet deployment |
Don’t get confused by the other examples/oreilly-workbook directories. These are examples from the previous revision of this book.
For Apache Maven users, RESTEasy also has a Maven repository at http://bit.ly/HCHZm6.
The groupId for all RESTEasy artifacts is org.jboss.resteasy. You can view all available artifacts at http://bit.ly/1esCSDp.