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

جزء من قسم البرمجة كائنية التوجه في رحلة Java على Coddy. الدرس 82 من 87.

التحدي

سهل

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

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

Book.java: احتفظ بفئة Book مع جميع الوظائف الحالية: isbn وtitle وauthor وisAvailable وborrowedBy وgetDetails()، بالإضافة إلى أساليب getter/setter المناسبة.
User.java: احتفظ بفئة User التي تحتوي على id وname وArrayList الخاص بـ borrowedBooks، بالإضافة إلى borrowBook() وreturnBook() وgetBorrowedCount() وtoString().
LibraryException.java: أنشئ فئة استثناء مخصصة أساسية تسمى LibraryException وتمتد من Exception. ستكون هذه الفئة الأصل لجميع الاستثناءات الخاصة بالمكتبة. أدرج مُنشئًا يقبل رسالة ويمررها إلى الفئة الأصل.
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]
غيّر توقيع الأسلوب إلى 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 و AdminService
        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: Print "Operations completed"
    }
}