Copyright

Foreword

Preface

Part 1: REST and the JAX-RS Standard

Chapter 1. Introduction to REST (Chester)

Section 1.1. REST and the Rebirth of HTTP

Section 1.2. RESTful Architectural Principles

Section 1.3. Wrapping Up

Chapter 2. Designing RESTful Services (Xin)

Section 2.1. The Object Model

Section 2.2. Model the URIs

Section 2.3. Defining the Data Format

Section 2.4. Assigning HTTP Methods

Section 2.5. Wrapping Up

Chapter 3. Your First JAX-RS Service (Greg)

Section 3.1. Developing a JAX-RS RESTful Service

Section 3.2. Deploying Our Service

Section 3.3. Wrapping Up

Chapter 4. HTTP Method and URI Matching (Yoonsoo)

Section 4.1. Binding HTTP Methods

Section 4.2. @Path

Section 4.3. Subresource Locators

Section 4.4. Wrapping Up

Chapter 5. JAX-RS Injection (Chester)

Section 5.1. The Basics

Section 5.2. @PathParam

Section 5.3. @MatrixParam

Section 5.4. @QueryParam

Section 5.5. @FormParam

Section 5.6. @HeaderParam

Section 5.7. @CookieParam

Section 5.8. Common Functionality

Section 5.9. Wrapping Up

Chapter 6. JAX-RS Content Handlers (Xin)

Section 6.1. Built-in Content Marshalling

Section 6.2. JAXB

Section 6.3. Custom Marshalling

Section 6.4. Wrapping Up

Chapter 7. Server Responses and Exception Handling (Greg)

Section 7.1. Default Response Codes

Section 7.2. Complex Responses

Section 7.3. Exception Handling

Section 7.4. Wrapping Up

Chapter 8. JAX-RS Client API (Yoonsoo)

Section 8.1. Client Introduction

Section 8.2. Bootstrapping with ClientBuilder

Section 8.3. Client and WebTarget

Section 8.4. Building and Invoking Requests

Section 8.5. Configuration Scopes

Section 8.6. Wrapping up

Chapter 9. HTTP Content Negotiation (Chester)

Section 9.1. Conneg Explained

Section 9.2. Language Negotiation

Section 9.3. Encoding Negotiation

Section 9.4. JAX-RS and Conneg

Section 9.5. Leveraging Content Negotiation

Section 9.6. Wrapping Up

Chapter 10. HATEOAS (Xin)

Section 9.1. HATEOAS and Web Services

Section 9.2. HATEOAS and JAX-RS

Section 9.3. Wrapping Up

Chapter 11. Scaling JAX-RS Applications (Greg)

Section 10.1. Caching

Section 10.2. Concurrency

Section 10.3. Wrapping Up

Chapter 12. Filters and Intercepters (Yoonsoo)

Section 12.1. Server-Side Filters

Section 12.2. Reader and Writer Interceptors

Section 12.3. Client-Side Filters

Section 12.4. Deploying Filters and Interceptors

Section 12.5. Ordering Filters and Interceptors

Section 12.6. Per-JAX-RS Method Bindings

Section 12.7. Exception Processing

Section 12.8. Wrapping Up

Chapter 13. Asynchronous JAX-RS (Chester)

Section 13.1. AsyncInvoker Client API

Section 13.2. Server Asynchronous Response Processing

Section 13.3. Wrapping Up

Chapter 14. Deployment and Integration (Xin)

Section 14.1. Deployment

Section 14.2. Configuration

Section 14.3. EJB Integration

Section 14.4. Spring Integration

Section 14.5. Wrapping Up

Chapter 15. Securing JAX-RS (Greg)

Section 14.1. Authentication

Section 15.2. Authorization

Section 15.3. Authentication and Authorization in JAX-RS

Section 15.4. Programmatic Security

Section 15.5. Client Security

Section 15.6. OAuth 2.0

Section 15.7. Signing and Encrypting Message Bodies

Section 15.8. Wrapping Up

Chapter 16. Alternative Java Clients (Yoonsoo)

Section 16.1. java.net.URL

Section 16.2. Apache HttpClient

Section 16.3. RESTEasy Client Framework

Section 16.4. RESTEasy Client Proxies

Section 16.5. Wrapping Up

Part 2: JAX-RS Workbook

Chapter 17. Workbook Introduction

Chapter 18. Examples for Chapter 3 (Greg)

Chapter 19. Examples for Chapter 4 (Yoonsoo)

Chapter 20. Examples for Chapter 5 (Chester)

Chapter 21. Examples for Chapter 6 (Xin)

Chapter 22. Examples for Chapter 7 (Greg)

Chapter 23. Examples for Chapter 9 (Chester)

Chapter 24. Examples for Chapter 10 (Xin)

Chapter 25. Examples for Chapter 11 (Greg)

Chapter 26. Examples for Chapter 12 (Yoonsoo)

Chapter 27. Examples for Chapter 13 (Chester)

Chapter 28. Examples for Chapter 14 (Xin)

Chapter 29. Examples for Chapter 15 (Greg)

Index