شرح Connect to database

خيارات الـ ddl-auto:

تحويل Employee لـ Entity

@Entity
@Table(name = "employee")
@Getter
@Setter
@AllArgsConstructor
@NoArgsConstructor
public class Employee {

    @Id
    @GeneratedValue
    @UuidGenerator
    private UUID id;

    @Column(name = "first_name", nullable = false, length = 100)
    private String firstName;

    @Column(name = "last_name", nullable = false, length = 100)
    private String lastName;

    @Column(name = "email", nullable = false, unique = true)
    private String email;

    @Column(name = "phone_number", length = 25)
    private String phoneNumber;

    @Column(name = "hire_date", nullable = false)
    private LocalDate hireDate;

    @Column(name = "position", nullable = false, length = 100)
    private String position;

    @Column(name = "department_id")
    private UUID departmentId;
}

الـ Annotations المهمة:

• @Entity - يخبر Hibernate إنو هذا الكلاس هو جدول بالـ Database
• @Table(name = "employee") - يحدد اسم الجدول
• @Id - يحدد الـ Primary Key
• @GeneratedValue + @UuidGenerator - Hibernate ينشئ الـ UUID تلقائياً
• @Column - يضبط تفاصيل العمود (الاسم، nullable، unique، length)
• @NoArgsConstructor - Hibernate يحتاج Constructor بدون Parameters

إنشاء Repository

الـ Repository هي طبقة للتواصل مع الـ Database:

@Repository
public interface EmployeeRepository extends JpaRepository<Employee, UUID> {
}

• JpaRepository<Employee, UUID> - Generic بياخذ نوع الـ Entity ونوع الـ Primary Key
• توفر مباشرةً: save(), findAll(), findById(), deleteById() وكثير غيرها

تحديث الـ Service

بنضيف الـ Repository بالـ Service ونستخدمه بدل الـ ArrayList:

@Service
public class EmployeeServiceImpl implements EmployeeService {

    @Autowired
    private EmployeeRepository employeeRepository;

    @Override
    public List<Employee> findAll() {
        return employeeRepository.findAll();
    }

    @Override
    public Employee findOne(UUID employeeId) {
        return employeeRepository.findById(employeeId)
            .orElseThrow(() -> CustomResponseException.resourceNotFound(
                "Employee with ID " + employeeId + " not found"
            ));
    }

    @Override
    public Employee create(EmployeeCreate dto) {
        Employee employee = new Employee();
        employee.setFirstName(dto.firstName());
        // ... باقي الخصائص
        return employeeRepository.save(employee);
    }

    @Override
    public Employee updateOne(UUID employeeId, EmployeeUpdate dto) {
        Employee existing = findOne(employeeId);
        existing.setFirstName(dto.firstName());
        // ... باقي الخصائص
        return employeeRepository.save(existing);
    }

    @Override
    public void deleteOne(UUID employeeId) {
        Employee employee = findOne(employeeId);
        employeeRepository.deleteById(employee.getId());
    }
}

لاحظ في الـ updateOne: الـ save() بتعرف تلقائياً إنو هذا Update مش Insert لأن الـ ID موجود. ما تنسى تعمل save() بعد التعديل وإلا ما رح تنحفظ التغييرات.

التحقق من النتيجة

بعد تشغيل التطبيق، افتح pgAdmin وتحقق من الجداول:

1. روح على Schemas > public > Tables
2. بتلاقي جدول employee تم إنشاؤه
3. اعمل View/Edit Data > All Rows لتشوف البيانات

البيانات اللي بتضيفها عبر API رح تظهر مباشرة بالجدول.

بالدرس الجاي رح نبني الـ Department Entity ونربطها مع الـ Employee.