تعلم الأساسيات والبدء في إنشاء الواجهات البرمجية

الكلاس هذا بحاجة لـ Getters وSetters وConstructor. بدون Lombok رح نحتاج كتابة كل هاد يدوياً - حوالي 90 سطر!

Lombok - تبسيط الكود

Lombok بيوفر علينا كتابة الـ Boilerplate Code عن طريق Annotations. بدل ما نكتب كل الـ Getters والSetters يدوياً، بنضيف:

@Getter
@Setter
@AllArgsConstructor
public class Employee {
    private UUID id;
    private String firstName;
    private String lastName;
    private String email;
    private String phoneNumber;
    private LocalDate hireDate;
    private String position;
    private UUID departmentId;
}

وهيك الكلاس صار 21 سطر بدل 90!

• @Getter - ينشئ Getter لكل خاصية تلقائياً عند الـ Compilation
• @Setter - ينشئ Setter لكل خاصية
• @AllArgsConstructor - ينشئ Constructor يأخذ كل الخصائص كـ Parameters

للتأكد من أن Lombok شغالة، فوت على target/classes/entities/Employee.class وشوف إذا الكود المولّد موجود.

بناء الـ Controller

بننشئ Package جديد اسمه controllers وفيه كلاس EmployeeController. Spring Boot بيعرف إنو هذا الكلاس هو Controller عن طريق الـ Annotation:

@RestController
@RequestMapping("/employees")
public class EmployeeController {

    private ArrayList<Employee> employees = new ArrayList<>();

    @GetMapping
    public ArrayList<Employee> findAll() {
        return employees;
    }
}

• @RestController - بيحدد إن هذا الكلاس هو Controller يستلم HTTP Requests
• @RequestMapping("/employees") - بيحدد الـ Base URL للـ Controller
• @GetMapping - بيعرف Endpoint تستجيب لطلبات GET

لما نشغّل التطبيق ونفتح http://localhost:8080/employees، رح يرجع لنا Array فاضي.

إضافة Employees تجريبية

خلينا نضيف موظفين بالـ ArrayList لنتأكد من الشغل:

private ArrayList<Employee> employees = new ArrayList<>(List.of(
    new Employee(UUID.randomUUID(), "John", "Smith", "john@example.com",
                 "0912345678", LocalDate.of(2022, 1, 15), "Developer", UUID.randomUUID()),
    new Employee(UUID.randomUUID(), "Sara", "Jones", "sara@example.com",
                 "0987654321", LocalDate.of(2021, 6, 1), "Designer", UUID.randomUUID())
));

بعد ما نعمل Run ونفتح localhost:8080/employees رح يرجع لنا:

[
  { "id": "...", "firstName": "John", "lastName": "Smith", ... },
  { "id": "...", "firstName": "Sara", "lastName": "Jones", ... }
]

جلب موظف بالـ ID

لنضيف Endpoint لجلب موظف واحد بالـ ID، بنستخدم Path Variable:

@GetMapping("/{employeeId}")
public Optional<Employee> findOne(@PathVariable UUID employeeId) {
    return employees.stream()
        .filter(emp -> emp.getId().equals(employeeId))
        .findFirst();
}

الـ {employeeId} جوا الـ Curly Brackets بيعني إنو هذا Dynamic Variable، يعني قيمة متغيرة في كل طلب.

• @PathVariable بتأخذ القيمة من الـ URL وتحطها بالـ Parameter
• نستخدم stream().filter() لنبحث بالـ List عن الموظف اللي عنده نفس الـ ID
• findFirst() بترجع Optional لأنو ممكن ما نلاقي الموظف

الـ Endpoint رح تكون: GET /employees/{id}

GET http://localhost:8080/employees/3fa85f64-5717-4562-b3fc-2c963f66afa6

وبترجع بيانات الموظف اللي عنده هالـ ID.

هيكل الطلب والاستجابة

الفكرة الأساسية للـ Controller هي:

• الـ Client بيبعث Request للسيرفر على Endpoint معينة
• الـ Controller بيستلم الطلب وبيدور على الـ Method اللي عندها نفس الـ Mapping
• بنفذ الـ Method وبرجع النتيجة للـ Client

بالفيديو الجاي رح نضيف POST وPUT وDELETE Endpoints، ونشوف كيف نتعامل مع بيانات الطلب.