Spring Boot 4 Complete Guide · درس

إنشاء وحدات تحكم REST

صمّم نقاط نهاية RESTful ونفّذها باستخدام `@RestController` وتعليقات التعيين التوضيحية المتنوعة

إنشاء وحدات تحكم REST درس مجاني في Spring Boot 4 Complete Guide على CoddyKit. هذا هو الدرس 1 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Spring Boot 4 Complete Guide، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Spring Boot 4 Complete Guide 4 دروس في المجموع.

بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.

Welcome to REST Controllers!

You're about to dive into building powerful web services with Spring Boot! Today, we'll learn how to create RESTful APIs, which are the backbone of modern web applications.

Think of a REST API as a standard way for different computer systems to talk to each other over the internet.

What are RESTful APIs?

REST stands for REpresentational State Transfer. It's an architectural style for networked applications.

Resources: Everything is a resource (e.g., a user, a product).
Unique Identifiers: Each resource has a unique URL (e.g., /users/123).
Standard Methods: We use standard HTTP methods like GET, POST, PUT, DELETE to interact with resources.

Spring Boot makes implementing these a breeze!

Introducing `@RestController`

In Spring Boot, the @RestController annotation is key to building RESTful web services. It's a special type of Spring component.

It tells Spring that this class handles incoming web requests.
It combines @Controller and @ResponseBody.

@ResponseBody means the return value of your methods should be directly bound to the web response body.

Your First GET Endpoint

Let's create a simple endpoint that responds to a GET request. GET requests are used to retrieve data.

We use the @GetMapping annotation to map HTTP GET requests to specific handler methods.

Runnable GET Example

Try running this simple Spring Boot application. It defines a /hello endpoint that returns a greeting.

package com.coddykit;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
public class MyApplication {
  public static void main(String[] args) {
    SpringApplication.run(MyApplication.class, args);
  }
}

@RestController
class HelloController {
  @GetMapping("/hello")
  public String sayHello() {
    return "Hello from CoddyKit!";
  }
}

Testing Your GET Endpoint

After running the previous code, your Spring Boot application starts on port 8080 by default.

You can access your new endpoint by opening a web browser and navigating to:

http://localhost:8080/hello

You should see the message "Hello from CoddyKit!" displayed.

Introducing `@PostMapping`

While GET is for retrieving data, POST requests are typically used to create new resources on the server.

The @PostMapping annotation maps HTTP POST requests to a specific method. When you send data, it often comes in the 'request body'.

We use @RequestBody to tell Spring to convert the incoming body into a Java object (or a simple String).

Runnable POST Example

Let's add a POST endpoint to our existing controller. This endpoint will accept a name in the request body and return a personalized greeting.

package com.coddykit;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
public class MyApplication {
  public static void main(String[] args) {
    SpringApplication.run(MyApplication.class, args);
  }
}

@RestController
class HelloController {
  @GetMapping("/hello")
  public String sayHello() {
    return "Hello from CoddyKit!";
  }

  @PostMapping("/greet")
  public String greetUser(@RequestBody String name) {
    return "Hello, " + name + "!";
  }
}

Path Variables with `@PathVariable`

Sometimes, you want to extract a value directly from the URL path itself. This is where path variables come in handy.

The @PathVariable annotation allows you to bind a URL template variable to a method parameter.

Example URL: /users/123
Here, 123 is a path variable representing a user ID.

Using Path Variables in Code

This example adds an endpoint that uses a path variable to greet a specific person whose name is part of the URL.

package com.coddykit;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
public class MyApplication {
  public static void main(String[] args) {
    SpringApplication.run(MyApplication.class, args);
  }
}

@RestController
class HelloController {
  @GetMapping("/hello")
  public String sayHello() {
    return "Hello from CoddyKit!";
  }

  @PostMapping("/greet")
  public String greetUser(@RequestBody String name) {
    return "Hello, " + name + "!";
  }

  @GetMapping("/greet/{name}")
  public String greetPathVar(@PathVariable String name) {
    return "Greetings, " + name + " from path!";
  }
}

Quick Check: Controller Basics

You've learned about `@RestController` and basic mapping annotations. Let's test your understanding.

Recap: Creating REST Controllers

Great job! You've taken your first steps into building RESTful APIs with Spring Boot:

We understood what RESTful APIs are and their purpose.
We learned about the fundamental @RestController annotation.
You implemented and tested endpoints for GET requests using @GetMapping.
You also created a basic POST endpoint with @PostMapping and used @RequestBody.
Finally, you saw how to extract dynamic data from URLs using @PathVariable.

Next, we'll dive deeper into handling various HTTP requests and crafting responses!

الأسئلة الشائعة

هل درس «إنشاء وحدات تحكم REST» مجاني؟

نعم — نص درس «إنشاء وحدات تحكم REST» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Spring Boot 4 Complete Guide، انتقل إلى CoddyKit PRO. تتضمن دورة Spring Boot 4 Complete Guide 4 دروس في المجموع.

ماذا ستتعلم في «إنشاء وحدات تحكم REST»؟

صمّم نقاط نهاية RESTful ونفّذها باستخدام `@RestController` وتعليقات التعيين التوضيحية المتنوعة تتمرن على Spring Boot 4 Complete Guide مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Spring Boot 4 Complete Guide؟

لا تُشترط خبرة سابقة. Spring Boot 4 Complete Guide على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 4.

كم من الوقت يستغرق درس «إنشاء وحدات تحكم REST»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Spring Boot 4 Complete Guide هذا؟

نعم. كل درس في Spring Boot 4 Complete Guide يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

إنشاء وحدات تحكم REST
معالجة طلبات HTTP واستجاباتها
التحقق من المدخلات ومعالجة الأخطاء
توثيق REST APIs باستخدام OpenAPI وSwagger

← العودة إلى Spring Boot 4 Complete Guide