JAX-RS实战：RESTful Java教程

需积分: 9 132 浏览量更新于2024-07-23 1 收藏 2.05MB PDF 举报

"RESTful Java with JAX-RS" 是一本专门探讨JAX-RS（Java API for RESTful Web Services）的英文技术书籍，由业内知名专家Bill Burke撰写。JAX-RS，全称Java Architecture for XML Binding over RESTful Web Services，是Java平台标准之一，旨在提供一种统一的方法来开发和实现RESTful风格的Web服务。REST（Representational State Transfer）是一种软件架构风格，强调通过HTTP协议进行无状态、统一接口和资源定位。该书深入浅出地介绍了如何在Java环境中利用JAX-RS规范来构建RESTful服务，包括如何设计符合REST原则的API，如何使用JAX-RS提供的注解如@GET、@POST、@PUT、@DELETE等来定义资源操作，以及如何处理HTTP响应和错误处理。书中还可能涵盖了JSON和XML序列化与反序列化、URI设计、HTTP缓存控制、安全性和授权等内容。对于Java开发者特别是Web服务开发者来说，这是一本极具实用价值的参考资料，它可以帮助读者理解和实践RESTful架构，提升服务端编程能力。由于版权原因，这本书可能只能通过合法渠道如O'Reilly官网或者特定的电子书平台（如http://my.safaribooksonline.com）获取。书中详细阐述了如何利用JAX-RS的客户端和服务器端API，包括使用Jersey、RESTEasy或其他JAX-RS实现框架。此外，作者Bill Burke以其丰富的经验，可能会分享他在实际项目中的最佳实践和遇到的问题解决方案。 "RESTful Java with JAX-RS"是一本既适合初学者学习RESTful设计原则，又适合有经验的开发者深化理解并提升其Java Web服务开发技能的宝贵资源。阅读此书，读者不仅能掌握JAX-RS的基础知识，还能获得将REST理念应用于Java开发的实际指导。

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页未读，继续阅读

lxbccsu

粉丝: 66
资源: 49

JAX-RS实战：RESTful Java教程

RESTful Java with JAX-RS 2.0

RESTful Java with JAX-RS 2.0 无水印pdf

Restful java with jax-rs

class doesn't contain any jax-rs annotated methods

restfulapi中jax-rx的具体运用

jax-rs和restful

什么是JAX-RS？

jax-rs demo

javaRMI和java-RS

jboss-jax-rs底层是通过什么方法获取request中的参数的

最新资源