Book Image

RESTful Java Web Services - Third Edition

By : Balachandar Bogunuva Mohanram, Jobinesh Purushothaman
Book Image

RESTful Java Web Services - Third Edition

By: Balachandar Bogunuva Mohanram, Jobinesh Purushothaman

Overview of this book

Representational State Transfer (REST) is a simple yet powerful software architecture style to create lightweight and scalable web services. The RESTful web services use HTTP as the transport protocol and can use any message formats, including XML, JSON(widely used), CSV, and many more, which makes it easily inter-operable across different languages and platforms. This successful book is currently in its 3rd edition and has been used by thousands of developers. It serves as an excellent guide for developing RESTful web services in Java. This book attempts to familiarize the reader with the concepts of REST. It is a pragmatic guide for designing and developing web services using Java APIs for real-life use cases following best practices and for learning to secure REST APIs using OAuth and JWT. Finally, you will learn the role of RESTful web services for future technological advances, be it cloud, IoT or social media. By the end of this book, you will be able to efficiently build robust, scalable, and secure RESTful web services using Java APIs.

Related Content you might be interested in

Current Title:

Small book image
RESTful Java Web Services - Third Edition
Balachandar Bogunuva Mohanram | Jobinesh Purushothaman
Nov, 2017 | 420 pages
Small book image
Building RESTful Web Services with Java EE 8
MarioLeander Reimer
Jul, 2018 | 116 pages
Small book image
Java EE 8 and Angular
Prashant Padmanabhan
Jan, 2018 | 348 pages
Small book image
Java EE 8 Application Development
David R Heffelfinger
Dec, 2017 | 372 pages
Table of Contents (11 chapters)
Preface
Preface
What this book covers
What you need for this book
Who this book is for
Conventions
Reader feedback
Customer support
Free Chapter
1
Introducing the REST Architectural Style
Introducing the REST Architectural Style
The REST architectural style
Introducing HTTP
The evolution of RESTful web services
The core architectural elements of a RESTful system
The description and discovery of RESTful web services
Java tools and frameworks for building RESTful web services
Summary
2
Java APIs for JSON Processing
Java APIs for JSON Processing
A brief overview of JSON
Processing JSON data
Using JSR 353 – Java API for processing JSON
Using the Jackson API for processing JSON
Using the Gson API for processing JSON
Java EE 8 enhancements for processing JSON
Summary
3
Introducing the JAX-RS API
Introducing the JAX-RS API
An overview of JAX-RS
JAX-RS annotations
Returning additional metadata with responses
Understanding data binding rules in JAX-RS
Building your first RESTful web service with JAX-RS
Client APIs for accessing RESTful web services
Summary
4
Advanced Features in the JAX-RS APIs
Advanced Features in the JAX-RS APIs
Understanding subresources and subresource locators in JAX-RS
JAX-RS response builder explained
Exception handling in JAX-RS
Reporting errors using application exceptions
Introducing validations in JAX-RS applications
Supporting custom request-response message formats
Asynchronous RESTful web services
Asynchronous RESTful web service client
Server-sent events
Managing an HTTP cache in a RESTful web service
Understanding filters and interceptors in JAX-RS
Understanding the JAX-RS resource life cycle
Summary
5
Introducing JAX-RS Implementation Framework Extensions
Introducing JAX-RS Implementation Framework Extensions
Jersey framework extensions
Generating a chunked output using Jersey APIs
RESTEasy framework extensions
Summary
6
Securing RESTful Web Services
Securing RESTful Web Services
Securing and authenticating web services
HTTP basic authentication
HTTP digest authentication
JWT authentication
Securing RESTful web services with OAuth
Authorizing the RESTful web service accesses via the security APIs
Input validation
Key considerations for securing RESTful services
Summary
7
Description and Discovery of RESTful Web Services
Description and Discovery of RESTful Web Services
The need for an interface contract
Web Application Description Language
RESTful API Modeling Language
Swagger
Revisiting the features offered in WADL, RAML, and Swagger
Summary
8
RESTful API Design Guidelines
RESTful API Design Guidelines
Designing RESTful web APIs
Fine-grained and coarse-grained resource APIs
Using header parameters for content negotiation
Multilingual RESTful web API resources
Representing date and time in RESTful web resources
Implementing partial response
Implementing partial update
Returning modified resources to the caller
Paging a resource collection
Implementing search and sort operations
Versioning RESTful web APIs
Caching RESTful web API results
Using HTTP status codes in RESTful web APIs
Overriding HTTP methods
Documenting RESTful web APIs
Asynchronous execution of RESTful web APIs
Microservice architecture style for RESTful web application
A quick recap
Summary
9
The Role of RESTful APIs in Emerging Technologies
The Role of RESTful APIs in Emerging Technologies
Cloud services
Internet of things
Modern web applications
Social media
Using Open Data Protocol with RESTful web APIs
Summary
10
Useful Features and Techniques
Useful Features and Techniques
Tools for building a JAX-RS application
Integration testing of JAX-RS resources with Arquillian
Using third-party entity provider frameworks with Jersey
Packaging and deploying JAX-RS applications
Summary

RESTful API Design Guidelines

REST is a software architectural style, not a specification, for building scalable web services. Since RESTful web services do not have any strict specifications for designing and building APIs, you may find many interpretations for how a RESTful web API should work.

In this chapter, you will learn standards, best practices, conventions, and tips and tricks that you can apply to your RESTful web service applications today. Some of the important topics discussed in this chapter are as follows:

  • Designing RESTful APIs
  • Implementing partial response
  • Paging a resource collection
  • Versioning RESTful web APIs
  • Caching RESTful web API results
  • Microservice architecture style for RESTful web applications
Previous Section
End of Section 1
Next Section