واجهة المسؤول

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

التحدي

سهل

دعنا نوسع نظام إدارة المكتبة الخاص بك بواجهة مسؤول (Admin Interface)! تحتاج المكتبة الحقيقية إلى قدرات إدارية — إضافة كتب جديدة إلى المجموعة، وإزالة الكتب القديمة، وتسجيل أعضاء جدد. ستقوم بإنشاء واجهة تحدد هذه العمليات الإدارية وتنفذها في فئة مسؤول مخصصة.

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

Book.java: احتفظ بفئة Book الخاصة بك مع جميع الوظائف الحالية — isbn، title، author، isAvailable، borrowedBy، getDetails()، والـ getters/setters المناسبة.
User.java: احتفظ بفئة User دون تغيير مع id، name، و ArrayList الخاص بـ borrowedBooks، و borrowBook()، و returnBook()، و getBorrowedCount()، و toString().
Library.java: احتفظ بفئة Library مع جميع الطرق (methods) الحالية. أضف طريقة جديدة removeBook(String isbn) تبحث عن كتاب وتزيله من المجموعة بواسطة ISBN الخاص به. يجب أن تعيد الطريقة true إذا تم العثور على الكتاب وإزالته، و false خلاف ذلك. لا يمكن إزالة الكتاب إلا إذا كان متاحاً حالياً (غير مستعار).
LibraryAdmin.java: أنشئ واجهة تسمى LibraryAdmin تحدد العقد للعمليات الإدارية. يجب أن تعلن واجهتك عن ثلاث طرق:
- addBook(String isbn, String title, String author) - تعيد قيمة منطقية (boolean) تشير إلى النجاح
- removeBook(String isbn) - تعيد قيمة منطقية تشير إلى النجاح
- registerUser(String id, String name) - تعيد قيمة منطقية تشير إلى النجاح
ثم أنشئ فئة تسمى AdminService تنفذ هذه الواجهة. يجب أن يحتفظ AdminService بمرجع إلى Library (يتم تمريره عبر المنشئ الخاص به) وينفذ جميع الطرق الثلاث عن طريق تفويضها إلى Library مع إضافة ملاحظات مناسبة. عند إضافة كتاب، أنشئ Book جديداً وأضفه إلى المكتبة. عند تسجيل مستخدم، أنشئ User جديداً وقم بتسجيله.
Main.java: استعرض نظام المسؤول الخاص بك! ستتلقى سلسلة من أوامر المسؤول كسلسلة واحدة مفصولة بفاصلة. يتبع كل أمر أحد التنسيقات التالية:
- ADD_BOOK:isbn:title:author
- REMOVE_BOOK:isbn
- REGISTER_USER:id:name
- BORROW:userId:isbn
أنشئ Library و AdminService. قم بمعالجة كل أمر واطبع النتيجة:
- لـ ADD_BOOK: اطبع Added: [title] عند النجاح
- لـ REMOVE_BOOK: اطبع Removed: [isbn] عند النجاح، أو Cannot remove: [isbn] إذا كان الكتاب غير موجود أو مستعاراً
- لـ REGISTER_USER: اطبع Registered: [name]
- لـ BORROW: استخدم وظيفة استعارة المكتبة الحالية
بعد معالجة جميع الأوامر، اطبع Library status: متبوعاً بتفاصيل كل كتاب وحالة توفره بالتنسيق [details] - [Available/Borrowed].

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

على سبيل المثال، مع المدخل REGISTER_USER:U001:Alice,ADD_BOOK:ISBN-001:Clean Code:Robert Martin,ADD_BOOK:ISBN-002:Design Patterns:Gang of Four,BORROW:U001:ISBN-001,REMOVE_BOOK:ISBN-001,REMOVE_BOOK:ISBN-002، سيكون مخرجك:

Registered: Alice
Added: Clean Code
Added: Design Patterns
Alice borrowed Clean Code
Cannot remove: ISBN-001
Removed: ISBN-002
Library status:
[ISBN-001] Clean Code by Robert Martin - Borrowed

لاحظ كيف توفر واجهة المسؤول عقداً نظيفاً للعمليات الإدارية، بينما يتعامل تنفيذ AdminService مع المنطق الفعلي. يمنع النظام بشكل صحيح إزالة كتاب مستعار مع السماح بإزالة الكتب المتاحة. هذا الفصل بين الواجهة والتنفيذ هو مبدأ أساسي في البرمجة كائنية التوجه (OOP) يجعل كودك أكثر قابلية للصيانة والاختبار!

جرّب بنفسك

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];
                library.borrowBook(userId, isbn);
            }
        }
        
        // طباعة حالة المكتبة
        System.out.println("Library status:");
        ArrayList<Book> allBooks = library.getAllBooks();
        for (Book book : allBooks) {
            String status = book.isAvailable() ? "Available" : "Borrowed";
            System.out.println(book.getDetails() + " - " + status);
        }
    }
}