18.1. Introduction

In today’s web-based software systems, RESTful APIs (Application Programming Interfaces) serve as the backbone for enabling communication between client and server applications.

RESTful APIs are essential for modern web applications. They allow different software systems, such as a frontend application and a backend server, to communicate efficiently. REST stands for Representational State Transfer, which means that data can easily be transferred in a standardized format using the web's existing protocols (mainly HTTP).

Think of RESTful APIs like a waiter in a restaurant. The customers (client applications) tell the waiter (the API) what they want (requests), and the waiter brings them the right food (data from the server). The kitchen (the server) operates independently of the customers, following the orders directly without remembering past interactions.

REST (Representational State Transfer) is an architectural style that uses HTTP methods for creating scalable, stateless, and platform-independent services.

REST architecture emphasizes principles that make services easy to scale and interact with. The key concepts include statelessness, which means each request from a client contains all the information needed for the server to understand that request without retaining previous context. This leads to better performance and reliability.

Imagine visiting a library where you can borrow a book based solely on your request. Each time you come, you provide your library card, and the librarian helps you without needing to remember what books you borrowed previously. This is similar to how statelessness works in REST.

Java provides powerful frameworks for developing RESTful services, primarily through Spring Boot and Java EE (Jakarta EE). In this chapter, we will explore how to build RESTful APIs using both these technologies.

Java offers robust frameworks like Spring Boot and Java EE for creating RESTful APIs. These frameworks simplify development by providing ready-made components that handle common tasks such as dependency management, configuration, and routing of requests. Spring Boot is particularly favored for its simplicity and ability to quickly set up microservices.

Consider these frameworks like different tools in a toolbox for a handyman. Just as a hammer, screwdriver, or wrench serves a specific purpose, Spring Boot and Java EE provide the necessary tools to build web applications. Depending on the job’s complexity, a handyman might choose one tool over another.

You will learn how to design endpoints, manage requests/responses, and perform CRUD operations on resources.

CRUD stands for Create, Read, Update, Delete, which are the basic operations you can perform on resources (data). In a RESTful API, these operations correspond to specific HTTP methods: POST for Create, GET for Read, PUT for Update, and DELETE for Delete. Learning to implement these operations effectively is essential for working with RESTful services.

Imagine managing a contact list on your phone. If you want to add a new contact, you use a ‘Create’ action. To view your contacts, you ‘Read’ them. If you need to update a contact’s information, you perform an ‘Update’, and if you want to remove a contact, you ‘Delete’ it. Each of these actions corresponds to the CRUD operations in a RESTful API.

--