RESTful Java Web Services

✍ Scribed by Jose Sandoval

• Year: 2009
• Tongue: English
• Leaves: 257
• Category: Library

✦ Synopsis

The approach we take is ideal for software developers with some, or extensive, programming experience: we design a RESTful API, which serves as our software specification, and implement it with every framework discussed in the book-there are no hypothetical examples; only practical working applications. This book is for Java developers who want to code RESTful web services using any of the open source RESTful frameworks available to date, for example, JAX-RS implementations such as Jersey and RESTEasy, the Restlet lightweight framework, or Struts 2 with the REST plug-in. You don't need to know REST, as we cover the theory of REST and web services; however, you should be familiar with the Java language and have some understanding of Java web applications. For each framework, we develop the same web service outlined in Chapter 4, so there is lots of working code available. This is a practical guide and the majority of the book is about coding RESTful web services, and not just about the theory of REST.

✦ Table of Contents

Cover......Page 0
Copyright......Page 2
Credits......Page 3
About the Author......Page 4
About the Reviewers......Page 5
Table of Contents......Page 7
Preface......Page 13
What is REST?......Page 19
Resources......Page 21
URI......Page 22
Uniform interfaces through HTTP
requests......Page 23
GET/RETRIEVE......Page 24
POST/CREATE......Page 28
PUT/UPDATE......Page 30
DELETE/DELETE......Page 32
Web services and the big picture......Page 33
Summary......Page 35
Getting the tools......Page 37
RESTful clients......Page 38
Java command-line application......Page 39
Jakarta Commons HTTP Client......Page 42
Java desktop application......Page 44
JSP application......Page 48
Servlet application......Page 50
Summary......Page 54
Semantic search mashup......Page 55
Application architecture......Page 57
Web application definition......Page 58
User interface layer......Page 60
Parsing JSON structures......Page 70
Servlet layer......Page 72
SemanticHacker parser Servlet......Page 73
Google search Servlet......Page 75
Twitter search Servlet......Page 76
Yahoo search Servlet......Page 78
Yahoo image search Servlet......Page 79
Summary......Page 80
Designing a RESTful web service......Page 81
Requirements of sample web service......Page 82
Resource identification......Page 83
XML representations......Page 84
JSON representations......Page 87
URI definition......Page 88
Using URIs to request representation types......Page 90
Summary......Page 91
Getting the tools......Page 93
Jersey the JAX-RS 1.1 reference
implementation......Page 94
@Path......Page 95
@GET......Page 96
@DELETE......Page 97
@PathParam......Page 98
@Consumes......Page 100
@Produces......Page 101
@FormParam......Page 102
Web service architecture......Page 103
Persistence layer......Page 104
RESTful web service implementation
with Jersey......Page 105
Application deployment......Page 106
/users......Page 107
/users/{username}......Page 115
/messages......Page 121
/messages/{messageID}......Page 127
/messages/users/{username}......Page 131
/messages/search/{search_item}......Page 133
Summary......Page 136
Getting the tools......Page 137
Restlet......Page 138
Restlet application and URI mappings......Page 139
HTTP GET and content negotiation (HTTP Accept header)......Page 140
HTTP POST......Page 142
HTTP PUT......Page 143
HTTP DELETE......Page 144
Restlet application and URI mappings......Page 145
/users......Page 147
/users/{username}......Page 151
/messages......Page 155
/messages/{messageID}......Page 156
/messages/users/{username}......Page 158
/messages/search/{search_item}......Page 159
Restlet application and URI mappings......Page 161
@Get and content negotiation (HTTP Accept header)......Page 162
@Post......Page 163
@Delete......Page 164
Implementation using Restlet 2.0......Page 165
URIs and resources......Page 166
/users......Page 167
/users/{username}......Page 170
/messages......Page 174
/messages/{messageID}......Page 175
/messages/users/{username}......Page 177
/messages/search/{search_item}......Page 178
Summary......Page 179
Getting the tools......Page 181
Web service architecture......Page 182
RESTful web service implementation with RESTEasy......Page 183
Application deployment......Page 184
/users......Page 186
/users/{username}......Page 187
/messages......Page 188
/messages/{messageID}......Page 189
/messages/users/{username}......Page 190
Summary......Page 191
Getting the tools......Page 193
REST plugin......Page 194
URI mappings......Page 195
HTTP request handlers......Page 196
Web service architecture......Page 197
RESTful web service implementation with Struts 2......Page 198
Application deployment......Page 199
/users and /users/{username}......Page 201
/messages and /messages/{messageID}......Page 209
/usermessages/{username}......Page 212
/searchmessages/{search_item}......Page 213
Summary......Page 214
Getting the tools......Page 215
HTTP GET requests......Page 216
HTTP POST requests......Page 217
HTTP PUT requests......Page 219
HTTP DELETE requests......Page 220
Restlet servers......Page 221
Summary......Page 230
Securing web services......Page 231
Custom token authentication......Page 232
HTTP basic authentication......Page 234
OAuth — accessing web services on behalf
of users......Page 240
High availability......Page 242
Scalability......Page 243
On-demand infrastructures......Page 244
Performance recommendations......Page 245
Summary......Page 246
Index......Page 247