1. REST and the JAX-RS Standard

   1. Chapter 1 Introduction to REST

      1. REST and the Rebirth of HTTP
      2. RESTful Architectural Principles
      3. Wrapping Up

   2. Chapter 2 Designing RESTful Services

      1. The Object Model
      2. Model the URIs
      3. Defining the Data Format
      4. Assigning HTTP Methods
      5. Wrapping Up

   3. Chapter 3 Your First JAX-RS Service

      1. Developing a JAX-RS RESTful Service
      2. Deploying Our Service
      3. Wrapping Up

   4. Chapter 4 HTTP Method and URI Matching

      1. Binding HTTP Methods
      2. @Path
      3. Subresource Locators
      4. Wrapping Up

   5. Chapter 5 JAX-RS Injection

      1. The Basics
      2. @PathParam
      3. @MatrixParam
      4. @QueryParam
      5. @FormParam
      6. @HeaderParam
      7. @CookieParam
      8. Common Functionality
      9. Wrapping Up

   6. Chapter 6 JAX-RS Content Handlers

      1. Built-in Content Marshalling
      2. JAXB
      3. Custom Marshalling
      4. Wrapping Up

   7. Chapter 7 Response Codes, Complex Responses, and Exception Handling

      1. Default Response Codes
      2. Complex Responses
      3. Exception Handling
      4. Wrapping Up

   8. Chapter 8 HTTP Content Negotiation

      1. Conneg Explained
      2. Language Negotiation
      3. Encoding Negotiation
      4. JAX-RS and Conneg
      5. Leveraging Content Negotiation
      6. Wrapping Up

   9. Chapter 9 HATEOAS

      1. HATEOAS and Web Services
      2. HATEOAS and JAX-RS
      3. Wrapping Up

   10. Chapter 10 Scaling JAX-RS Applications

       1. Caching
       2. Concurrency
       3. Wrapping Up

   11. Chapter 11 Deployment and Integration

       1. Deployment
       2. Configuration
       3. EJB Integration
       4. Spring Integration
       5. Wrapping Up

   12. Chapter 12 Securing JAX-RS

       1. Authentication
       2. Authorization
       3. Authentication and Authorization in JAX-RS
       4. Wrapping Up

   13. Chapter 13 RESTful Java Clients

       1. java.net.URL
       2. Apache HttpClient
       3. RESTEasy Client Framework
       4. RESTEasy Client Proxies
       5. Wrapping Up

   14. Chapter 14 JAX-RS Implementations

       1. Jersey
       2. Apache CXF
       3. JBoss RESTEasy
       4. Wrapping Up

2. JAX-RS Workbook

   1. Chapter 15 Workbook Introduction

      1. Installing RESTEasy and the Examples
      2. Example Requirements and Structure

   2. Chapter 16 Examples for Chapter 3

      1. Build and Run the Example Program
      2. Examining the Source Code

   3. Chapter 17 Examples for Chapter 4

      1. Example ex04_1: HTTP Method Extension
      2. Example ex04_2: @Path with Expressions
      3. Example ex04_3: Subresource Locators

   4. Chapter 18 Examples for Chapter 5

      1. Example ex05_1: Injecting URI Information
      2. Example ex05_2: Forms and Cookies

   5. Chapter 19 Examples for Chapter 6

      1. Example ex06_1: Using JAXB
      2. Example ex06_2: Creating a Content Handler

   6. Chapter 20 Examples for Chapter 7

      1. Example ex07_1: ExceptionMapper

   7. Chapter 21 Examples for Chapter 8

      1. Example ex08_1: Conneg with JAX-RS
      2. Example ex08_2: Conneg via URL Patterns

   8. Chapter 22 Examples for Chapter 9

      1. Example ex09_1: Atom Links
      2. Example ex09_2: Link Headers

   9. Chapter 23 Examples for Chapter 10

      1. Example ex10_1: Caching and Concurrent Updates

   10. Chapter 24 Examples for Chapter 11

       1. Example ex11_1: EJB and JAX-RS
       2. Example ex11_2: Spring and JAX-RS

1. Colophon

The animal on the cover of RESTful Java with JAX-RS is an Australian bee-eater (Merops ornatus). It is commonly referred to as a rainbow bee-eater because of the vibrant colored feathers that adorn its body. Its bronze crown and nape, blue rump, and green and bronze wings make it easily distinguishable. Its red eye sits inside of a black stripe, outlined in blue, that extends from its bill to its ears. Females and males look alike and are only differentiated by the female's shorter and thicker tail streamers. Distributed throughout Australia, Papua New Guinea, and eastern Indonesia, the Australian bee-eater usually lives in cleared areas and often uses quarries or mines to build its nesting tunnels. Of course, tunnels in such places are subject to destruction as a result of human activity. Other threats to the bee-eater's survival include foxes and wild dogs that dig up its nesting tunnels.It is believed that Australian bee-eaters are monogamous. The female builds the nesting tunnels, while her male partner catches food for both of them. To dig the tunnel, the female balances on her wings and feet, using her bill to dig and her feet to move loose soil backward. On average, she can dig about three inches per day.Although the nesting tunnels are very narrow, bee-eaters have been known to share tunnels with other bee-eaters and sometimes even other bird species. The female can lay as many as seven eggs at a time. Both parents are responsible for incubating them (for about 24 days) and feeding them once they hatch. Often older birds that never found a mate or whose mate has died will help feed others' young as well. Not surprisingly, the Australian bee-eater preys on bees, and though it is unaffected by the bee's sting, it is very careful to rub the bee on its perch to remove its stinger before consuming it. The bird always takes care to close its eye to prevent any poison from the bee's broken poison sac getting in it. The Australian bee-eater can consume several bees in the course of a single day and thus beekeepers generally aren't fans of the bird. Its diet consists of other insects as well, including dragonflies, beetles, butterflies, and moths.