دمج معالجة الاستثناءات

جزء من قسم Object Oriented Programming في رحلة Java على Coddy — الدرس 82 من 87.

التحدي

سهل

دعنا نجعل نظام إدارة المكتبة الخاص بك أكثر قوة من خلال دمج معالجة الاستثناءات (exception handling) بشكل صحيح! يحتاج نظام المكتبة الحقيقي إلى التعامل مع حالات الخطأ بلباقة—ماذا يحدث عندما يحاول شخص ما استعارة كتاب غير موجود، أو عندما يحاول مستخدم استعارة كتب أكثر من المسموح به؟ ستقوم بإنشاء استثناءات مخصصة توفر ملاحظات ذات معنى لهذه السيناريوهات.

ستستمر في البناء على كودك الحالي عبر ستة ملفات:

Book.java: احتفظ بفئة Book مع جميع الوظائف الموجودة—isbn، title، author، isAvailable، borrowedBy، getDetails()، والـ getters/setters المناسبة.
User.java: احتفظ بفئة User مع id، name، و ArrayList الخاص بـ borrowedBooks، و borrowBook()، و returnBook()، و getBorrowedCount()، و toString().
LibraryException.java: أنشئ فئة استثناء مخصصة أساسية تسمى LibraryException ترث من Exception. ستكون هذه هي الفئة الأب لجميع الاستثناءات الخاصة بالمكتبة. قم بتضمين منشئ (constructor) يقبل رسالة ويمررها إلى الفئة الأب.
BookNotAvailableException.java: أنشئ استثناءً مخصصاً يرث من LibraryException. يجب رمي هذا الاستثناء عندما يحاول شخص ما استعارة كتاب تمت استعارته بالفعل. قم بتضمين منشئ يقبل ISBN الخاص بالكتاب وينشئ رسالة ذات معنى مثل Book not available: [isbn].
Library.java: قم بتحديث فئة Library لرمي الاستثناءات بدلاً من طباعة رسائل الخطأ. قم بتعديل طريقة borrowBook(String userId, String isbn) لتقوم بـ:
- رمي LibraryException مع الرسالة User not found: [userId] إذا كان المستخدم غير موجود
- رمي LibraryException مع الرسالة Book not found: [isbn] إذا كان الكتاب غير موجود
- رمي BookNotAvailableException إذا كان الكتاب مستعاراً بالفعل
- عند النجاح، اجعل المستخدم يستعير الكتاب وأرجع رسالة التأكيد [userName] borrowed [bookTitle]
قم بتغيير توقيع الطريقة (method signature) إلى throws LibraryException وتغيير نوع الإرجاع إلى String.

حافظ على عمل جميع الطرق الأخرى (addBook، registerUser، findBookByIsbn، findUserById، returnBook، removeBook، searchByTitle، searchByAuthor، getAvailableBooks) كما كانت من قبل.
Main.java: أظهر مهاراتك في معالجة الاستثناءات! ستتلقى سلسلة نصية من الأوامر مفصولة بفاصلة. يتبع كل أمر أحد التنسيقات التالية:
- ADD_BOOK:isbn:title:author
- REGISTER_USER:id:name
- BORROW:userId:isbn
قم بمعالجة كل أمر. بالنسبة لـ ADD_BOOK، اطبع Added: [title]. بالنسبة لـ REGISTER_USER، اطبع Registered: [name]. بالنسبة لأوامر BORROW، استخدم كتلة try-catch للتعامل مع الاستثناءات—عند النجاح اطبع رسالة التأكيد، وعند حدوث أي LibraryException اطبع Error: [exception message].

بعد معالجة جميع الأوامر، اطبع Operations completed.

ستتلقى مدخلاً واحداً: سلسلة نصية من الأوامر مفصولة بفاصلة.

على سبيل المثال، مع المدخل ADD_BOOK:ISBN-001:Clean Code:Robert Martin,REGISTER_USER:U001:Alice,BORROW:U001:ISBN-001,BORROW:U001:ISBN-001,BORROW:U002:ISBN-001، سيكون مخرجك:

Added: Clean Code
Registered: Alice
Alice borrowed Clean Code
Error: Book not available: ISBN-001
Error: User not found: U002
Operations completed

لاحظ كيف توفر الاستثناءات المخصصة رسائل خطأ واضحة ومحددة. تنجح عملية الاستعارة الأولى، وتفشل الثانية لأن الكتاب مستعار بالفعل (BookNotAvailableException)، وتفشل الثالثة لأن المستخدم U002 غير موجود (LibraryException). هذا النهج يجعل نظام مكتبتك أكثر إفادة وأسهل في تصحيح الأخطاء من رسائل الخطأ العامة!

جرّب بنفسك

import java.util.Scanner;
import java.util.ArrayList;

class Main {
    public static void main(String[] args) {
        Scanner scanner = new Scanner(System.in);
        
        // قراءة الأوامر المفصولة بفاصلة
        String input = scanner.nextLine();
        String[] commands = input.split(",");
        
        // إنشاء المكتبة وخدمة المسؤول
        Library library = new Library();
        AdminService adminService = new AdminService(library);
        
        // معالجة كل أمر
        for (String command : commands) {
            String[] parts = command.split(":");
            String operation = parts[0];
            
            if (operation.equals("ADD_BOOK")) {
                String isbn = parts[1];
                String title = parts[2];
                String author = parts[3];
                if (adminService.addBook(isbn, title, author)) {
                    System.out.println("Added: " + title);
                }
            } else if (operation.equals("REMOVE_BOOK")) {
                String isbn = parts[1];
                if (adminService.removeBook(isbn)) {
                    System.out.println("Removed: " + isbn);
                } else {
                    System.out.println("Cannot remove: " + isbn);
                }
            } else if (operation.equals("REGISTER_USER")) {
                String id = parts[1];
                String name = parts[2];
                if (adminService.registerUser(id, name)) {
                    System.out.println("Registered: " + name);
                }
            } else if (operation.equals("BORROW")) {
                String userId = parts[1];
                String isbn = parts[2];
                // TODO: استخدم كتلة try-catch لاستدعاء library.borrowBook(userId, isbn)
                // عند النجاح، اطبع رسالة التأكيد المستلمة
                // عند حدوث LibraryException، اطبع "Error: " + e.getMessage()
            }
        }
        
        // TODO: اطبع "Operations completed"
    }
}