RESTful Java实战：基于JAX-RS

需积分: 10 78 浏览量更新于2024-07-24 收藏 2.05MB PDF 举报

"RESTful Java with JAX-RS" 《RESTful Java with JAX-RS》是由Bill Burke撰写的一本关于RESTful服务开发的书籍，主要关注使用Java API for RESTful Web Services (JAX-RS) 实现RESTful架构风格的Web服务。这本书详细介绍了如何在Java环境中构建高效、灵活且易于维护的REST接口。 REST（Representational State Transfer）是一种网络应用程序的设计风格和开发方式，基于HTTP协议，强调简洁和层次化的系统。JAX-RS是Java平台上的标准API，它提供了一种简单的方式来创建RESTful服务，通过注解将HTTP方法与Java方法关联，以及处理XML、JSON和其他数据格式。书中可能涵盖了以下关键知识点： 1. **RESTful原则**：解释REST的基本原则，包括资源、URI（统一资源标识符）、HTTP方法（GET、POST、PUT、DELETE等）和状态码。 2. **JAX-RS介绍**：介绍JAX-RS规范的核心概念，如`@Path`、`@GET`、`@POST`等注解，以及如何使用它们来定义资源和操作。 3. **数据交换格式**：探讨XML、JSON和YAML等数据交换格式，并展示如何在JAX-RS中处理这些格式，包括使用`@Consumes`和`@Produces`注解。 4. **客户端API**：介绍JAX-RS提供的客户端API，允许开发者以类型安全的方式调用REST服务。 5. **过滤器和拦截器**：讲解如何使用JAX-RS的过滤器和拦截器来处理请求和响应，例如添加认证或日志记录功能。 6. **错误处理**：讨论如何优雅地处理服务端和客户端错误，以及使用`@Provider`和异常处理器。 7. **容器集成**：涵盖与不同Java EE容器（如Tomcat、Glassfish、WildFly等）的集成，以及如何部署JAX-RS应用。 8. **测试与调试**：介绍如何编写单元测试和集成测试，以及调试REST服务的方法。 9. **最佳实践**：提供构建REST服务的最佳实践和设计模式，以确保服务的可扩展性和可维护性。 10. **案例研究**：可能包含实际项目案例，展示如何将所学应用于实际场景，帮助读者深入理解RESTful服务的开发流程。这本书对于希望使用Java和JAX-RS实现RESTful服务的开发者来说是一份宝贵的资源，无论你是初学者还是经验丰富的开发者，都能从中获得实用的指导和洞见。通过学习，你可以掌握创建高效、符合REST原则的Web服务，同时利用JAX-RS的便利性提高开发效率。

Bill Burke led the development of one of the JAX-RS implementations mentioned earlier

(RESTEasy) and was an active and attentive member of the expert group. His contri-

butions to expert group discussions are too numerous to list, but a few of the areas

where his input was instrumental include rules for annotation inheritance, use of reg-

ular expressions for matching request URIs, annotation-driven support for cookies and

form data, and support for streamed output.

This book, RESTful Java with JAX-RS, provides an in-depth tutorial on JAX-RS and

shows how to get the most from this new API while adhering to the REST architectural

style. I hope you enjoy the book and working with JAX-RS.

—Marc Hadley

JAX-RS Specification Lead

Sun Microsystems, Inc.

Burlington, MA

xiv | Foreword

Download at WoweBook.Com

Preface

Author’s Note

The bulk of my career has been spent working with and implementing distributed

middleware. In the mid-’90s I worked for the parent company of Open Environment

Corporation, working on DCE tools. Later on, I worked for Iona, developing their next-

generation CORBA ORB. Currently, I work for the JBoss division of Red Hat, which

is entrenched in Java middleware, specifically Java EE. So, you could say that I have a

pretty rich perspective when it comes to middleware.

I must tell you that I was originally very skeptical of REST as a way of writing SOA

applications. It seemed way too simple and shortsighted, so I sort of blew it off for a

while. One day though, back in mid-2007, I ran into my old Iona boss and mentor Steve

Vinoski while grabbing a sandwich at D’Angelo in Westford, MA near Red Hat’s offi-

ces. We ended up sitting down, having lunch, and talking for hours. The first shocker

for me was that Steve had left Iona to go work for a start-up. The second was when he

said, “Bill, I’ve abandoned CORBA and WS-* for REST.” For those of you who don’t

know Steve, he contributed heavily to the CORBA specification, wrote a book on the

subject (which is basically the CORBA bible), and is a giant in the distributed com-

puting field, writing regularly for C++ Report and IEEE. How could the guy I looked

up to and was responsible for my foundation in distributed computing abandon

CORBA, WS-*, and the distributed framework landscape he was instrumental in cre-

ating? I felt a little betrayed and very unnerved (OK, maybe I’m exaggerating a little…).

We ended up arguing for a few hours on which was better, WS-*/CORBA or REST.

This conversation spilled into many other lengthy email messages, with me trying to

promote WS-* and him defending REST. The funniest thing to me was that as I re-

searched REST more and more I found that my arguments with Steve were just another

endless replay of debates that had been raging across the blogosphere for years. They

are still raging to this day.

Anyway, it took months for me to change my mind and embrace REST. You would

figure that my distributed computing background was an asset, but it was not. DCE,

CORBA, WS-*, and Java EE were all baggage. All were an invisible barrier for me to

accept REST as a viable (and better) alternative for writing SOA applications. I think

Download at WoweBook.Com

that’s what I liked most about REST. It required me to rethink and reformulate the

foundation of my distributed computing knowledge. Hopefully your journey isn’t as

difficult as mine and you will be a little less stubborn and more open-minded than I was.

Who Should Read This Book

This book teaches you how to design and develop distributed web services in Java using

RESTful architectural principles on top of the HTTP protocol. It is mostly a compre-

hensive reference guide on the JAX-RS specification, which is a JCP standardized an-

notation framework for writing RESTful web services in Java.

While this book does go into many of the fundamentals of REST, it does not cover

them all and focuses more on implementation rather than theory. You can satisfy your

craving for more RESTful theory be obtaining RESTful Web Services by Leonard Ri-

chardson and Sam Ruby (O’Reilly). If you are familiar writing Java EE applications,

you will be very comfortable reading this book. If you are not, you will be at a disad-

vantage, but some experience with web application development, HTTP, and XML is

a huge plus. Before reading this book, you should also be fairly fluent in the Java lan-

guage and specifically know how to use and apply Java annotations. If you are unfa-

miliar with the Java language, I recommend Learning Java by Patrick Niemeyer and

Jonathan Knudsen (O’Reilly).

How This Book Is Organized

This book is organized into two parts: the technical manuscript, followed by the

JAX-RS workbook. The technical manuscript explains what REST and JAX-RS are,

how they work, and when to use them. The JAX-RS workbook provides step-by-step

instructions for installing, configuring, and running the JAX-RS examples from the

manuscript with the JBoss RESTEasy framework, an implementation of JAX-RS.

Part I, REST and the JAX-RS Standard

Part I starts off with a brief introduction to REST and HTTP. It then guides you through

the basics of the JAX-RS specification, and then in later chapters shows you how you

can apply JAX-RS to build RESTful web services:

Chapter 1, Introduction to REST

This chapter gives you a brief introduction to REST and HTTP.

Chapter 2, Designing RESTful Services

This chapter walks you through the design of a distributed RESTful interface for

an e-commerce order entry system.

xvi | Preface

Download at WoweBook.Com

Chapter 3, Your First JAX-RS Service

This chapter walks you through the development of a RESTful web service written

in Java as a JAX-RS service.

Chapter 4, HTTP Method and URI Matching

This chapter defines how HTTP requests are dispatched in JAX-RS and how you

can use the @Path annotation and subresources.

Chapter 5, JAX-RS Injection

This chapter walks you through various annotations that allow you to extract in-

formation from an HTTP request (URI parameters, headers, query parameters,

form data, cookies, matrix parameters, encoding, and defining default values).

Chapter 6, JAX-RS Content Handlers

This chapter explains how to marshal HTTP message bodies to and from Java

objects using built-in handlers or writing your own custom marshallers.

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

This chapter walks through the JAX-RS Response object and how you use it to

return complex responses to your client (ResponseBuilder). It also explains how

exception and error handling work in JAX-RS.

Chapter 8, HTTP Content Negotiation

This chapter explains how HTTP content negotiation works, its relationship to

JAX-RS, and how you can leverage this within RESTful architectures.

Chapter 9, HATEOAS

This chapter dives into Hypermedia As The Engine Of Application State and how

it relates to JAX-RS (UriInfo and UriBuilder).

Chapter 10, Scaling JAX-RS Applications

This chapter explains how you can increase the performance of your services by

leveraging HTTP caching protocols. It also shows you how to manage concurrency

conflicts in high-volume sites.

Chapter 11, Deployment and Integration

This chapter explains how you can deploy and integrate your JAX-RS services

within Java Enterprise Edition, servlet containers, EJB, Spring, and JPA.

Chapter 12, Securing JAX-RS

This chapter walks you through the most popular mechanisms to perform authen-

tication on the Web. It then shows you how to implement secure applications with

JAX-RS.

Chapter 13, RESTful Java Clients

This chapter shows you how to write RESTful clients in Java using various libraries

and frameworks as an example (java.net.URL, Apache HTTP Client, and

RESTEasy).

Chapter 14, JAX-RS Implementations

This chapter provides a short review of available JAX-RS implementations.

Preface | xvii

Download at WoweBook.Com

剩余311页未读，继续阅读

alpha_zh

粉丝: 0
资源: 9

RESTful Java实战：基于JAX-RS

RESTful Java with JAX-RS 2.0, 2nd Edition.pdf 高清 带书签

[Jax-RS] RESTful Java 开发 (Jax-RS 实现) (英文版)

book--restful-java-jax-rs_2_0:示例来自 RESTful Java with JAX-RS 2.0, 2nd Edition（由 Trifon 改编以在 JDK 1.7 上运行）

RESTful_Java_with_JAX-RS

Restful java with jax-rs

RESTful Java with JAX-RS 2.0

[Jax-RS] RESTful Java 开发 (Jax-RS 2.0 实现) (英文版)

JAX-WS-and-JAX-RS-Web-Services-integrated-with-JPA

RESTful Java with JAX-RS 2.0 无水印pdf

RESTful Java with JAX-RS 2 0 epub

最新资源

RESTful Java with JAX-RS 2.0, 2nd Edition.pdf 高清带书签